| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics | 5. Conformance Testing | 6. Performance Assessment |
1. Definition
An input to the Environment Description and the Real Experience Generation AIMs expressed as 3D Model Scene Descriptors that define the venue’s unique physical structure, position, and orientation of fixed objects plus an inventory of 3D Model Objects which do not have a specific position in the Venue. In addition, each object within the 3D Model Scene Descriptors and 3D Model Objects have an associated Annotation that specifies all the information, such as Qualifiers, necessary to characterise and send/receive data to/from that object. Specific venue equipment can vary widely, however, the XRV-LTP specification provides some Annotation examples for typical use including Biometric devices, Lighting Fixtures, MoCap devices, MIDI instruments.
2. Functional Requirements
This includes number, type, placement, and parameters of:
- DMX/RDM Universes and their associated Channel definitions for all Lighting fixtures, Special effects, DJ and VJ consoles, rigging, elevator stages, prop motions, pyro, and miscellaneous sensors.
- Audio sources (e.g., microphones, audio players) and formats.
- Visual sources (e.g., 2D/3D cameras, video servers, and all other video sources) and formats.
- Motion Capture devices (e.g., performer motion and object motion tracking).
- LiDAR sources (e.g. scans of performance and participant areas).
- Biometric sensors from performers and participants.
- Time Code Data formats.
- MIDI devices and their associated Channel definitions.
- App Data from performer and participant devices.
- Controller Data from performer and participant devices.
- Seating chart (Spatial distribution of individual seats).
The RE Venue Specification states the safe state of each device that acts on the Real Environment Venue, which the User Agent applies when the Module stops, fails or is degraded.
3. Syntax
https://schemas.mpai.community/XRV1/V1.0/data/REVenueSpecification.json
4. Semantics
Table 1 provides the semantics of the components of RE Venue Specification.
Table 1 – Semantics of RE Venue Specification
| Label | Description |
| Header | RE Venue Specification Header. Shall have constant value “XRV-RVS-V1.0”. |
| MInstanceID | Identifier of the M-Instance (Virtual Space) associated with this RE Venue Specification instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this RE Venue Specification instance. |
| REVenueSpecificationID | Identifier of RE Venue Specification. |
| REVenueSpecificationTime | Time information of RE Venue Specification expressed using SimpleTime. |
| REVenueSpecificationModel | 3D Model Scene Descriptors as defined in OSD V1.5. |
| RealObjects[] | Array of 3D Model Objects as defined in OSD V1.5. |
| DMXUniverses[] | DMX/RDM Universes and their associated Channel definitions for lighting fixtures, special effects, DJ and VJ consoles, rigging, elevator stages, prop motions, pyro, and miscellaneous sensors. |
| – UniverseID | Identifier (number) of the Universe. |
| – Protocol | DMX or RDM. |
| – Channels[] | Channels of the Universe. |
| – ChannelNumber | Channel number (1 to 512). |
| – ChannelDefinition | What the Channel controls. |
| – FixtureID | Identifier of the fixture or device the Channel controls (optional). |
| MIDIDevices[] | MIDI devices and their associated Channel definitions. |
| – DeviceID | Identifier of the MIDI device. |
| – Channels[] | Channels of the MIDI device. |
| – ChannelNumber | MIDI channel number (1 to 16). |
| – ChannelDefinition | What the Channel controls. |
| SeatingChart[] | Seating chart: the spatial distribution of the individual seats, by Sector and Row. |
| – SectorID | Identifier of the Sector. |
| – Rows[] | Rows of the Sector. |
| – RowID | Identifier of the Row. |
| – Seats[] | Seats of the Row. |
| – SeatID | Identifier of the Seat. |
| – SpatialAttitude | Spatial Attitude of the Seat as defined in OSD V1.5. |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this RE Venue Specification instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the RE Venue Specification instance (plain text, max 2048 characters). |
5. Conformance Testing
A Data instance conforms with RE Venue Specification (XRV-RVS-V1.0) if:
- The Data validates against the JSON Schema of RE Venue Specification (REVenueSpecification.json).
- All Data in the JSON Schema of RE Venue Specification have the specified types.
6. Performance Assessment
Not part of this specification.