| 1 Definition | 2 Protocol | 3 Syntax | 4 Semantics |
1 Definition
The Action of a User requesting that an Export Service:
- Animate an MU-Added R-Item with
- A Stream Item equivalent to the one that is used to animate the Item of which the R-Item is an Analogue Twin, or
- Specific commands applied to an Item in the M-Instance that should be reflected to the R-Item that is its Analogue Twin.
- Grant Rights based on requested Rights to the MU-Animated R-Item.
If the request is accepted, the Export Service MU-Animates the the Item providing the requested Rights.
2 Protocol
- User sends MU-Animate PA Request including R-Item, Point of View, U-Location, Rights (Status=Model) to Export.
- If MU-Animate is a free service, goto MU-Animate.
- If MU-Animate is a pay service:
- User sends MU-Animate PA Request with Service Pricing Model (Status=Model) to Export.
- Export sends MU-Animate PA Response:
- If MU-Animate PA Response includes Status=Err, goto End
- If MU-Animate PA Response includes Status=Ack and Service Pricing Model including Transaction (both Status=Model), User:
- Transacts Value contained in Transaction.
- Sends MU-Animate PA Request with Service Pricing Model (Status=Model) including Transaction (Status=Final) to Export.
- MU-Animate: Export
- MU-Animates R-Item.
- Sends MU-Animate PA Response including
- Rights (both Status=Final) to MU-Animated R-Item.
- Service Pricing Model (Status=Final), if MU-Animate is a pay service.
- End.
3 Syntax
https://schemas.mpai.community/MMM4/V2.2/actions/MUAnimatePA.json
4 Semantics
| Label | Description |
| Header | MU-Animate Process Action Header – Standard “MMM-3AP-Vx.y” |
| MInstanceID | Identifier of M-Instance. |
| MEnvironmentID | Identifier of M-Environment. |
| UEnvironmentID | Identifier of U-Environment. |
| MUAnimatePAData | Data included in the MU-Animate Process Action. |
| – Time | Time of PA request emission and Time of PA request execution. |
| – RQ-Complements | Complements in the PA Request. |
| – Nil RItem | R-Item to be MU-Animated. |
| – At ULocationID | U-Location where the R-Item is to be MU-Animated. |
| – With Point of View | Initial Point of View of R-Item. |
| – With Stream | Stream Item used to MU-Animate R-Item. |
| – With Rights | Requested Rights to the MU-Animated R-Item. |
| – With SPM | Service Pricing Model, if MU-Animate is a pay service. |
| – RS-Complements | Complements in the PA-Response. |
| – With Rights | Actual Rights based on Model Rights if PA Request is accepted. |
| – With SPM | Service Pricing Model, if MU-Animate is a pay service. |
| – With PAStatus | Status of PA Request. |
| – Ack | If PA Request could be performed |
| – Err | If Error was found |
| – Clash | MU-Animated Item clashes with an existing R-Item, |
| – FaultyPA | Faulty PA Request. |
| – IncID | Incorrect ID. |
| – ULocOOR | 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. |