| 1 Definition | 2 Protocol | 3 Syntax | 4 Semantics |
1 Definition
The Action of a User requesting that a Locate Service
- Modify the characteristics of an Item:
- Change the Perceptibility of the Item.
- Apply an affine transformation to the Item.
- Change the attributes of:
- SourceType, ColourInfo, Intensity (if a Light Source)
- SourceType (If an Audio Source)
- Mass, Material, Gravity Property, TextureMap (if a Basic Visual Object or a Basic 3D Model Object)
- Set the Perceptibility of an Item.
- Display a specific Personal Status (if a Persona).
- Grant Rights to the Property-Managed Item based on requested Rights.
If the request is accepted, the Locate Service changes the Properties as requested and provides the requested Rights, if the request is accepted.
2 Protocol
- Process sends to Item Manage Property Change PA Request including Properties to be changed and Rights (Status=Model) to Property-Changed Item.
- If Property Change is a free service, goto Property Change.
- If Property Change is a pay service:
- User sends Property Change PA Request with Service Pricing Model (Status=Model) to Item Manage.
- Item Manage sends Property Change PA Response:
- If Property Change PA Response includes Status=Err, goto End
- If Property Change PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model), User
- Transacts Value contained in Transaction.
- Sends Property Manage PA Request including SPM with Transaction (both Status=Final) to Item Manage.
- Property Change: Item Manage
- Changes Item Properties.
- Identifies Property-Changed Item.
- Sends Property Change PA Response including:
- Property-Changed Item and Rights (Status=Final) to Property-Changed Item.
- .Service Pricing Model (Status=Final), if Property Change is a pay service,
- End
3 Syntax
https://schemas.mpai.community/MMM4/V2.2/actions/PropertyManagePA.json
4 Semantics
| Label | Description |
| Header | Property Change Process Action Header – Standard “MMM-PCP-Vx.y” |
| MInstanceID | Identifier of M-Instance. |
| MEnvironmentID | Identifier of M-Environment. |
| PropertyChangePAData | Data included in the Property Change Process Action. |
| – Time | Time of PA request emission and Time of PA request execution. |
| – RQ-Complements | Complements in the PA Request. |
| – Nil ItemID | Item whose Properties are to be Changed. |
| – With PerceptibilityStatus | 0= non perceptible, 1 = perceptible. |
| – With Resize | Resize the Item by Rx, Ry, Rz where x, y, and z are the Objects axes rotated according to an Orientation. |
| – With 3DModelObject | Change Mass, Material Property, and Gravity Property, TextureMap, Acoustic Profile. |
| – With VisualObject | Change Mass, Gravity and Material Property, TextureMap, Acoustic Profile. |
| – With Acoustic Profile | Change the Acoustic Profile of an Item. |
| – With LightSource | Change any of SourceType, ColourInfo, Intensity. |
| – With AudioSource | Change Source Type. |
| – With PersonalStatus | Display a specific Personal Status (if a Persona). |
| – With Rights | Requested Rights to the Property Changed Item. |
| – With SPM | Service Pricing Model, if Item Manage is a pay service. |
| – RS-Complements | Complements in the PA Request. |
| – With Rights | Rights based on requested Rights if PA Request is accepted. |
| – With SPM | Service Pricing Model, if Item Manage is a pay service. |
| – With PAStatus | Possible Error Messages. |
| – Ack | If PA Request could be performed. |
| – Err | If PA Request could not be performed. |
| – FaultyPA | Faulty PA Request. |
| – IncID | Incorrect ID. |
| – MLocOOR | M-Location out of range. |
| – InsRights | Insufficient Rights. |
| – InsValue | Insufficient Value in Wallet. |
| Trace | Authentication provenance information and time of PA production. |
| DescMetadata | Descriptive Metadata. |