| 1 Definition | 2 Protocol | 3 Syntax | 4 Semantics |
1 Definition
The Action of a Process requesting a Locate Service to:
- Provide the portion of Audio-Visual Scene taken from a Point of View and comprised in a given field of view .
- Grant Rights to the MM-Captured Audio-Visual Scene based on Model Rights from a Point of View.
If the request is accepted, the Locate Service provides actual Rights to the requesting Process.
2 Protocol
- User sends “MM-Capture PA Request including Item, Point of View, Location, and Rights (Status=Model)” to MM-Capture Service.
- If MM-Capture Service is a free service, goto MM-Capture.
- If MM-Capture Service is a pay service:
- User sends “MM-Capture PA Request with Service Pricing Model (Status=Model)” to MM-Capture Service.
- MM-Capture Service sends “MM-Capture PA Response” to User:
- If “MM-Capture PA Response includes Status=Err”, goto End
- If ” MM-Capture PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, User:
- Transacts “Value included in Transaction”.
- Sends “MM-Capture PA Request including Service Pricing Model (Status=Model) with Transaction (both Status=Final)” to MM-Capture Service.
- MM-Capture: MM-Capture Service:
- MM-Captures “Data”.
- Identifies “Data with added Rights (Status=Model)”.
- Sends “MM-Capture PA Response” including
- “Rights (Status=Final)” to MM-Captured Item.
- “Service Pricing Model (Status=Final)” if MM-Capture Service is a pay service.
- End.
The protocol described using Workflow Description Language (WDL) is available at this link:
https://schemas.mpai.community/MMM4/V2.2/wdl/MMCapture.wdl
3 Syntax
The structure of the input and output messages, using JavaScript Object Notation (JSON) is available at this link:
https://schemas.mpai.community/MMM4/V2.2/actions/MMCapturePA.json
4 Semantics
| Label | Description |
| Header | MM-Capture Process Action Header – Standard “MMM-2CP-Vx.y” |
| MInstanceID | Identifier of M-Instance. |
| UEnvironmentID | Identifier of U-Environment. |
| MMCapturePAID | Identifier of this PA Instance. |
| MMCapturePATime | Creation time of this PA Instance. |
| MMCapturePAData | Data included in this PA Instance. |
| – Time | Time of PA Request emission and execution or PA Response emission. |
| – RQ-Complements | Request Complements. |
| – Nil LocationID | Portion of M-Instance Location to be MM-Captured. |
| – With PointOfView | The Point of View from which the Location is to be MM-Captured. |
| – With Aperture | The Aperture of the Point of View. |
| – With lRights | Requested Rights to the MM-Captured Item. |
| – With SPM | Service Pricing Model, if MM-Capture is a pay service. |
| – RS-Complements | Destination Complements. |
| – Nil Item | The Item of the MM-Captured portion of the Audio-Visual Scene. |
| – With Rights | Rights based on requested Rights if PA Request is accepted. |
| – With PAStatus | Possible Error Messages. |
| – Ack | If PA Request could be performed |
| – Err | If Error was found |
| – FaultyPA | Faulty PA Request. |
| – IncID | Incorrect ID of M-Location. |
| – MLocOOR | M-Location out of range. |
| – InsRights | Insufficient Rights. |
| – InsValue | Insufficient Value in Wallet. |
| DataXMData | Identity, provenance, authorised usage, source, type, governance context, security, legality, and annotation of exchanged data. |
| DescMetadata | Descriptive Metadata. |