| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics |
1. Definition
VE Operator Descriptors include data pertaining to all identified operator consoles or interfaces within the Virtual Environment.
2. Functional Requirements
- Audio/DJ console data for all audio channels:
- Track selection
- Volume control
- Audio routing
- Audio effects
- Spatial positions and directionality
- Filters (low-pass, band-pass, high-pass), Q Factor, Frequency.
- Reverb (enumeration of reverb types)
- Delay (ms)
- Pitch shift (number of semitones)
- Tremolo (volume and frequency)
- Vibrato (extent in cent and frequency of oscillation).
- Video/VJ console data for all video channels:
- Video clip or source selection.
- Camera commands for position/orientation, zoom, focus, and aperture.
- Tonality (brightness, contrast, colour, highlight, shadows, gamma) control.
- Video routing
- Video effects
- spatial position,
- mapping,
- warping,
- colour cycling,
- kaleidoscope,
- playback speed, etc.
- Show Control/FX data including:
- fog, haze, clouds.
- Skybox.
- Scene selection.
- Participant and Performance controls and apps.
- Lighting data for all light sources including:
- Light source location, orientation, and motion.
- Light source type, colour, and beam shape.
- Projected image selection.
- Sequencing, strobing, and audio reactivity.
- Additional Descriptors if accessible via Metaverse API
3. Syntax
https://schemas.mpai.community/XRV1/V1.0/data/VEOperatorDescriptors.json
4. Semantics
| Label | Description |
| Header | VE Operator Descriptors Header. Shall have constant value “XRV-VOD-V1.0”. |
| MInstanceID | Identifier of M-Instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this VE Operator Descriptors instance. |
| VEOperatorDescriptorsID | Identifier of VE Operator Descriptors |
| VEOperatorDescriptorsTime | Time info of VE Operator Descriptors. |
| VEOperatorDescriptors | Set of VE Operator Descriptors |
| – AudioConsole | Audio Console as defined in XRV1 V1.0. |
| – VideoConsole | Video Console as defined in XRV1 V1.0. |
| – ShowConsole | Show Console as defined in XRV1 V1.0. |
| – LightingConsole | Lighting Console as defined in XRV1 V1.0. |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this VE Operator Descriptors instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the VE Operator Descriptors instance (plain text, max 2048 characters). |