| 1 Definition | 2 Functional Requirements | 3 Syntax | 4 Semantics |
1 Definition
Action (MMM-ACT) is the Data Type that carries the keyword of an Action that a Process may perform in an M-Instance. Each Action is the keyword of a Process Action. The 30 Actions are specified in the Processes chapter and are the ones listed by the action_keyword production of the grammar of the Process Actions chapter.
2 Functional Requirements
- The Data shall have Header “MMM-ACT-V2.2”.
- The Data shall state the Action as one of the keywords of Table 1. The keyword is only a verb: the Process Action that uses it states on which Items and with which modifiers it is performed.
- The Data may identify the M-Instance and the M-Environment in which the Action is performed.
- The Data shall include DataXMData if provided and may include descriptive metadata.
3 Syntax
https://schemas.mpai.community/MMM4/V2.2/data/Actions.json
4 Semantics
Table 1 gives the semantics of the properties of Action and Table 2 the Actions.
Table 1 – Properties of Action
| Label | Description |
| Header | Header of the Data Type, with the version: “MMM-ACT-V2.2”. (required) |
| MInstanceID | Identifier of the M-Instance in which the Action is performed. |
| MEnvironmentID | Identifier of the M-Environment in which the Action is performed. |
| Action | One of the 30 Actions of Table 2. (required) |
| DataXMData | Data Exchange Metadata of MPAI-PTF. |
Table 2 – The Actions
| Name | Semantics |
| Authenticate | The Action of a Process producing an Authentication Response Item to confirm or not that an Item or Process is what it claims to be. |
| Author | The Action of a Process producing an Item based on provided Items and their Data and Qualifiers. |
| Convert | The Action of a Process changing the Data of an Item according to a given Qualifier. |
| Discover | The Action of a Process providing a Discovery Response Item relevant to the Items or Processes that are intended to be discovered. |
| Execute | The Action of a Process executing a Program and producing Items. |
| Hide | The Action of a Process making the ID of an Item unavailable to all other Processes. |
| Identify | The Action of a Process producing and labelling an Item from Data, its Qualifier, and Model Rights. |
| Interpret | The Action of a Process providing an Interpretation Response Item about an Item or Process. |
| License | The set of Actions enabling a User2 to obtain a Licence from User1 with Rights on an Asset made available to User1. |
| MM-Add | The Action of a Process placing an Item at an M-Location with a Spatial Attitude with a specified perceptible or imperceptible state. |
| MM-Animate | The Action of a Process animating an MM-Added Item with a Stream or Command Item. |
| MM-Capture | The Action of a Process capturing a Location from a Point of View with a Field of View. |
| MM-Move | The Action of a Process moving an MM-Added Item from an M-Location to another M-Location along a Trajectory, preserving any change that may have been effected on the Item since it was MM-Added. |
| MM-Send | The Action of a Process sending a Message to other Processes. |
| Modify | The Action of a Process producing a new Item starting from an existing Item using new Data and possibly with a new Qualifier. |
| MU-Actuate | The Action of a Process rendering an MM-Added Item as an R-Item at a U-Location with a Spatial Attitude. |
| MU-Add | The Action of a Process placing an R-Item at a U-Location with a Spatial Attitude. |
| MU-Animate | The Action of a Process animating an MU-Added R-Item with – A stream Item equivalent to the one used to animate the Persona of which the R-Item is an Analogue Twin, or – A specific command applied to an Item that is reflected in the R-Item that is its Analogue Twin. |
| MU-Move | The Action of a Process moving an MU-Added R-Item from a U-Location to another U-Location via a Trajectory giving it an assigned Spatial Attitude when the R-Item is at the new U-Location. |
| MU-Send | The Action of a Process in an M-Instance sending a Message to Processes in the Universe. |
| Post | The Action of a Process adding an Asset to its repository and making it perceptible. |
| Property Change | The Action of a Process modifying the characteristics of an Item:
|
| Register | The Action of a human opening an Account based on the human’s Personal Data. |
| Resolve | The Action of a Process setting up a multi-M-Instance Session that involves two/more than two Processes in two/more than two M-Instances. |
| Rights Change | The Action of a Process modifying the Rights of a Process or an Item. |
| Transact | The Action of a Process1 (“sender”)
|
| UM-Actuate | The Action of a User requesting that: – Import Service produce Data corresponding to a scene at a U-Location with a Spatial Attitude and provide Rights1 on the Data. – Locate Service MM-Add Item at an M-Location with a Spatial Attitude and provide Rights2 on the Item to the User. |
| UM-Capture | The Action of a Process capturing a scene at a U-Location as Data with a Qualifier. |
| UM-Send | The Action of a Process in the Universe sending a Message to Processes in an M-Instance. |
| Validate | The Action of a Process producing a Validation Response Item that confirms or not that an Item or Process has the Rights it claims to have. |