| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics |
1. Definition
Cue List is the part of the Script that lists all Cues. Each Cue is Real, Virtual, or Mixed and carries the Cue Conditions that must be met (Performance, Participant, and Operator Descriptors and Status), the Actions to be executed in the Real and Virtual Environments when they are met, and the next Cue.
2. Functional Requirements
Cue List may include, for each Real, Virtual, or Mixed Cue:
- Cue ID
- Groups of Cue Conditions
- RE Cue Conditions: Performance, Participant, and Operator Descriptors and Status of the Real Environment
- VE Cue Conditions: Performance, Participant, and Operator Descriptors and Status of the Virtual Environment
- RE Actions and VE Actions to be executed
- Next Cue
3. Syntax
https://schemas.mpai.community/XRV1/V1.0/data/CueList.json
4. Semantics
| Label | Description |
| Header | Cue List Header. Shall have constant value “XRV-CLS-V1.0”. |
| MInstanceID | Identifier of the M-Instance (Virtual Space) associated with this Cue List instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this Cue List instance. |
| CueListID | Identifier of Cue List. |
| CueListTime | Time information of Cue List expressed using SimpleTime. |
| CueListData[] | Array of Cue List Data. |
| – Cue[] | Array of Cue. |
| – RealCue | Container of Real Cue. |
| – RECueID | Identifier of RE Cue. |
| – REGroups[] | Array of RE Groups. |
| – RECueConditions | Container of RE Cue Conditions. |
| – REPerformanceDescriptors | Performance Descriptors from RE. |
| – REPerformanceStatus | RE Performance Status as defined in XRV1 V1.0. |
| – REParticipantDescriptors | Participant Descriptors from RE. |
| – REParticipantStatus | RE Participant Status as defined in XRV1 V1.0. |
| – REOperatorDescriptors | Set of RE Operator Descriptors. |
| – REOperatorStatus | RE Operator Status as defined in XRV1 V1.0. |
| – REActions[] | Array of RE Actions. |
| – VEActions[] | Array of VE Actions. |
| – NextCue | Next Cue. |
| – VirtualCue | Container of Virtual Cue. |
| – VECueID | Identifier of VE Cue. |
| – VEGroups[] | Array of VE Groups. |
| – VECueConditions | Container of VE Cue Conditions. |
| – VEPerformanceDescriptors | Data provided via metaverse API. |
| – VEPerformanceStatus | VE Performance Status as defined in XRV1 V1.0. |
| – VEParticipantDescriptors | VE Participant Descriptors as defined in XRV1 V1.0. |
| – VEParticipantStatus | VE Participant Status as defined in XRV1 V1.0. |
| – VEOperatorDescriptors | Data provided via metaverse API. |
| – VEOperatorStatus | VE Operator Status as defined in XRV1 V1.0. |
| – REActions[] | Same structure as REActions. |
| – VEActions[] | Same structure as VEActions. |
| – NextCue | Next Cue. |
| – MixedCue | Container of Mixed Cue. |
| – MECueID | Identifier of ME Cue. |
| – MEGroups[] | Array of ME Groups. |
| – RECueConditions | Same structure as RECueConditions. |
| – VECueConditions | Same structure as VECueConditions. |
| – REActions[] | Array of RE Actions. |
| – VEActions[] | Array of VE Actions. |
| – NextCue | Next Cue. |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this Cue List instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the Cue List instance (plain text, max 2048 characters). |