Go to XRV-LTP Data Types

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:

  1. 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.
  2. Audio sources  (e.g., microphones, audio players) and formats.
  3. Visual sources (e.g., 2D/3D cameras, video servers, and all other video sources) and formats.
  4. Motion Capture devices (e.g., performer motion and object motion tracking).
  5. LiDAR sources (e.g. scans of performance and participant areas).
  6. Biometric sensors from performers and participants.
  7. Time Code Data formats.
  8. MIDI devices and their associated Channel definitions.
  9. App Data from performer and participant devices.
  10. Controller Data from performer and participant devices.
  11. 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:

  1. The Data validates against the JSON Schema of RE Venue Specification (REVenueSpecification.json).
  2. All Data in the JSON Schema of RE Venue Specification have the specified types.

6. Performance Assessment

Not part of this specification.

Go to XRV-LTP Data Types