| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics | 5. Conformance Testing | 6. Performance Assessment |
1. Definition
Metadata that associates measurable elements of the Script (e.g., characters, objects, participants, operator consoles) with data sources specific to the Real and Virtual Venue, as defined by the Qualifiers in the Venue Specification.
2. Functional Requirements
Associations define the correspondence between data elements from the Real and Virtual Environments as defined by the Real and Virtual Venue Specifications and elements of the Script listed below:
- Performance designations
- Designations of character instances
- Name (name of character in the Script)
- Nickname
- Mnemonic
- Performers’ avatars, including autonomous avatars and their identifying properties (Spatial Attitudes, animations, lighting, textures/materials, and effects).
- Theatrical Set list
- Describes sets of objects for all scenes in the Real and Virtual Environments referenced in the Script including Terrain, foliage, architectural structures.
- A Theatrical Set list is designated as
- Name (name of Theatrical Set in the Script)
- Nickname
- Mnemonic
- Each object instance within the Theatrical Set list is designated as
- Name
- Nickname
- Mnemonic
- Relevant Performance Statuses
- A list of Real and Virtual Performance Status Elements with parameters required for all Cue Conditions in the Script (see Performance Status).
- Relevant Status Elements include a Performers’ or Objects’ behaviours (e.g., gestures, position, orientation, utterances).
- Participant designations
- Participant instance general designations
- Meta-name (name in the Script to be converted to the actual participant name based on a variety of participant features or behaviours as described in the Script).
- Nickname
- Mnemonic
- Participants’ avatars and their properties (Spatial Attitudes, animations, lighting, textures/materials, and effects).
- Relevant Participant Statuses
- A list of Real and Virtual Participant Status Elements with parameters required for all Cue Conditions in the Script (see Participant Status)
- Relevant Status Elements include a Participants’ behaviours (e.g., gestures, position, orientation, utterances, controllers, apps)
- Operator designations
- Operator instance general designations
- Real or Virtual Console Name
- Mnemonic
- Relevant Operator Statuses
- A list of Real and Virtual Operator Status Elements with parameters required for all Cue Conditions in the Script (see Operator Status)
- Relevant Status Elements include all relevant console actions by Operator.
- Relevant Action Descriptors
- A list of Real and Virtual Action Descriptor Elements with parameters required for all Cue Actions in the Script.
- Relevant Action Elements include list of Actions called out in the Script.
- Operator instance general designations
- Participant instance general designations
- Designations of character instances
3. Syntax
https://schemas.mpai.community/XRV1/V1.0/data/ScriptVenueAssociations.json
4. Semantics
| Label | Description |
| Header | Script-Venue Associations Header. Shall have constant value “XRV-SVA-V1.0”. |
| MInstanceID | Identifier of M-Instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this Script-Venue Associations instance. |
| ScriptVenueAssociationsID | Identifier of Script-Venue Associations. |
| ScriptVenueAssociationsTime | Time information of Script-Venue Associations expressed using SimpleTime. |
| REAssociations | Associations between Script elements and the data sources and sinks of the Real Environment Venue. |
| – PerformanceDesignations | Designations of the Performance elements of the Script. |
| – Characters[] | Designations of the characters of the Script. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – PerformerAvatars[] | Avatars of Performers, including autonomous avatars. |
| – Nickname | Nickname of the Avatar. |
| – AvatarID | Identifier of the Avatar. |
| – SpatialAttitude | Spatial Attitude as defined in OSD V1.5. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – TheatricalSetList[] | Theatrical Set list. |
| – TheatricalSet[] | Array of Theatrical Sets. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – Objects[] | Array of Objects of the Theatrical Sets. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – PerformanceStatusElements[] | Relevant Performance Status Elements with the parameters required by the Cue Conditions. |
| – StatusElementID | Identifier of the Status Element. |
| – Parameters[] | Parameters of the Status Element. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – ParticipantDesignations | Designations of the Participant elements of the Script. |
| – Participants[] | Designations of the Participants of the Script. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – ParticipantAvatars[] | Avatars of Participants. |
| – Nickname | Nickname of the Avatar. |
| – AvatarID | Identifier of the Avatar. |
| – SpatialAttitude | Spatial Attitude as defined in OSD V1.5. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – ParticipantStatusElements[] | Relevant Participant Status Elements with the parameters required by the Cue Conditions. |
| – StatusElementID | Identifier of the Status Element. |
| – Parameters[] | Parameters of the Status Element. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – OperatorDesignations | Designations of the Operator elements of the Script. |
| – Consoles[] | Designations of the Consoles of the Script. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – OperatorStatusElements[] | Relevant Operator Status Elements with the parameters required by the Cue Conditions. |
| – StatusElementID | Identifier of the Status Element. |
| – Parameters[] | Parameters of the Status Element. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – ActionElements[] | Relevant Action Elements called out in the Script. |
| – ActionID | Identifier of the Action. |
| – Parameters[] | Parameters of the Action. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| VEAssociations | Associations between Script elements and the data sources and sinks of the Virtual Environment Venue. |
| – PerformanceDesignations | Designations of the Performance elements of the Script. |
| – Characters[] | Designations of the characters of the Script. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – PerformerAvatars[] | Avatars of Performers, including autonomous avatars. |
| – Nickname | Nickname of the Avatar. |
| – AvatarID | Identifier of the Avatar. |
| – SpatialAttitude | Spatial Attitude as defined in OSD V1.5. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – TheatricalSetList[] | Theatrical Set list. |
| – TheatricalSet[] | Array of Theatrical Sets. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – Objects[] | Array of Objects of the Theatrical Sets. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – PerformanceStatusElements[] | Relevant Performance Status Elements with the parameters required by the Cue Conditions. |
| – StatusElementID | Identifier of the Status Element. |
| – Parameters[] | Parameters of the Status Element. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – ParticipantDesignations | Designations of the Participant elements of the Script. |
| – Participants[] | Designations of the Participants of the Script. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – ParticipantAvatars[] | Avatars of Participants. |
| – Nickname | Nickname of the Avatar. |
| – AvatarID | Identifier of the Avatar. |
| – SpatialAttitude | Spatial Attitude as defined in OSD V1.5. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – ParticipantStatusElements[] | Relevant Participant Status Elements with the parameters required by the Cue Conditions. |
| – StatusElementID | Identifier of the Status Element. |
| – Parameters[] | Parameters of the Status Element. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – OperatorDesignations | Designations of the Operator elements of the Script. |
| – Consoles[] | Designations of the Consoles of the Script. |
| – Name | Name of the Script element. |
| – MetaName | Name in the Script to be converted to the actual name. |
| – Nickname | Nickname of the Script element. |
| – Mnemonic | Mnemonic of the Script element. |
| – VenueElementID | Identifier of the element in the Venue Specification. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| – OperatorStatusElements[] | Relevant Operator Status Elements with the parameters required by the Cue Conditions. |
| – StatusElementID | Identifier of the Status Element. |
| – Parameters[] | Parameters of the Status Element. |
| – DataSourceQualifier | Qualifier of the data source in the Venue Specification. |
| – ActionElements[] | Relevant Action Elements called out in the Script. |
| – ActionID | Identifier of the Action. |
| – Parameters[] | Parameters of the Action. |
| – DataSinkQualifier | Qualifier of the data sink in the Venue Specification. |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this Script-Venue Associations instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the Script-Venue Associations instance (plain text, max 2048 characters). |
5. Conformance Testing
A Data instance conforms with Script-Venue Associations (XRV-SVA-V1.0) if:
- The Data validates against the JSON Schema of Script-Venue Associations (ScriptVenueAssociations.json).
- All Data in the JSON Schema of Script-Venue Associations have the specified types.
6. Performance Assessment
Not part of this specification.