<- Go to ProcessActions  ->

1 Definition 2 Protocol 3 Syntax 4 Semantics

1 Definition

The Action of a Device requesting that Import Service capture a scene at a U-Location with a Spatial Attitude based on the Rights to that U-Location. The UM-Captured Data reside in the Device.

If the request is accepted, the Device digitally represent the scene with a Qualifier.

2 Protocol

  1. Device sends “UM-Capture PA Request including Point of View, U- Location, and requested Rights (Status=Model)  to UM-Capture Service.
    1. If  UM-Capture Service is a free service, goto UM-Capture.
    2. If UM-Capture Service is a pay service:
      1. Device sends “UM-Capture PA Request with Service Pricing Model (Status=Model) to UM-Capture Service.
      2. UM-Capture Service sends “UM-Capture PA Response”:
        1. If “UM-Capture PA Response includes Status=Err”, goto End
        2. If “UM-Capture PA Response includes Status=”Ack” and Service Pricing Model with Transaction (both Status=Model)”, Device:
          1. Transacts “Value included in Transaction”.
          2. Sends “UM-Capture PA Request including Service Pricing Model (Status=Model) with Transaction (both Status=Final)” to UM-Capture Service .
  2. UM-Capture: UM-Capture Service
    1. Captures “Location with a Point of View”.
    2. Create “Item with Captured Data, Qualifier and requested Rights”.
    3. Sends “UM-Capture PA Response” including
      1. “Item and Rights”
      2. “Service Pricing Model (Status=Final)”, if UM-Capture is a pay service.
  3. End

The protocol described using Workflow Description Language (WDL) is available at this link:

https://schemas.mpai.community/MMM4/V2.2/wdl/UMCapturePA.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/UMCapturePA.json

4 Semantics

Label Description
Header UM-Capture Process Action Header – Standard “MMM-1CP-V”
MInstanceID Identifier of M-Instance.
UEnvironmentID Identifier of U-Environment.
UMCapturePAID Identifier of this PA Instance.
UMCaptureTime Creation time of this PA Instance.
UMCapturePAData Data included in this PA Instance.
– Time Time of PA Request emission and execution, or PA Response emission.
– RQ-Complements Complements in the PA Request.
  – Nil ULocation U-Location wrapping object or scene.
  – With Qualifier(s) The Qualifier(s) to be used to UM-Capture the Data.
  – With Rights Requested Rights to the UM-Captured Data.
  – With SPM Service Pricing Model, if UM-Capture is a pay service.
– RS-Complements Complements in the PA Response.
  – Nil Item Item produced by the UM-Capture Process Action.
  – With SpatialAttitude The Spatial Attitude of the UM-Captured Data.
  – With Rights Rights based on requested Rights if PA Request is accepted.
  – With SPM Service Pricing Model, if UM-Capture is a pay service.
  – With PAStatus Status of PA Request.
    – Ack If PA Request could be performed.
    – Err If PA Request could not be performed.
      – FaultyPA Faulty PA Request.
      – IncID Incorrect ID.
      – InsRights Insufficient Rights.
      – InsValue Insufficient Value in Wallet.
      – ULocOOR No such U-Location.
DataXMData Identity, provenance, authorised usage, source, type, governance context, security, legality, and annotation of exchanged data.
 DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->