| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics |
1. Definition
Audio Console contains the commands issued by an Operator on an audio (e.g., DJ) console of the Real or Virtual Environment: the master volume and, for each audio track, its selection, volume, routing, and effects.
2. Functional Requirements
Audio Console may include:
- Manufacturer ID
- Master Volume
- Audio Console Data
- Track selection
- Volume
- Audio routing
- Audio effects: Point of View, Filters (type, Q factor, frequency), Reverb, Delay, Pitch shift, Tremolo, Vibrato
3. Syntax
https://schemas.mpai.community/XRV1/V1.0/data/AudioConsole.json
4. Semantics
| Label | Description |
| Header | Audio Console Header. Shall have constant value “XRV-AUC-V1.0”. |
| MInstanceID | Identifier of the M-Instance (Virtual Space) associated with this Audio Console instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this Audio Console instance. |
| AudioConsoleID | Identifier of Audio Console. |
| AudioConsoleTime | Time information of Audio Console expressed using SimpleTime. |
| ManufacturerID | Identifier of Manufacturer. |
| MasterVolume | Control volume of all tracks. Scale from 0 to 100. |
| AudioConsoleData[] | Commands for all audio channels |
| – MetaverseObject | Metaverse Object as defined in XRV1 V1.0. |
| – TrackSelection | Audio Track IDs |
| – Volume | Volume. Scale from 0 to 100. |
| – AudioRouting | Destination ID |
| – AudioEffects | Collection of parameters related to Audio in Track ID. |
| – PointOfView | Point Of View as defined in OSD V1.5. |
| – Filters | Filter Type (low-pass, band-pass, high-pass), Q Factor (number), Frequency (cut-off, center frequency, cut-off) |
| – FilterType[] | Array of Filter Type. |
| – LowPass | Low Pass (number). Range from 0.1 to 10. |
| – BandPass | Band Pass (number). Range from 0.1 to 10. |
| – HighPass | High Pass (number). Range from 0.1 to 10. |
| – QFactor | Q Factor (number). Range from 0.1 to 10. |
| – Frequency | Frequency (number). Unit: Hz. Range: 20 to 20000 Hz. |
| – Reverb | 1 byte according to RE Venue Specification. Range: 0 to 255 (1 byte). |
| – Delay | Expressed in ms Range: not less than 0 ms. |
| – PitchShift | (number of semitones) – number Range: -24 to 24 semitones. |
| – Tremolo[] | (Tremolo volume range – Tremolo frequency) – two numbers |
| – VolumeRange | Volume Range (number). Range: 0 to 100 (as Volume). |
| – TremoloFrequency | Tremolo Frequency (number). Unit: Hz. Range: 0.1 to 20 Hz. |
| – Vibrato[] | (Vibrato frequency range in cents – Vibrato frequency of oscillation) – two numbers |
| – FrequencyRange | Frequency Range (number). Unit: cents. Range: not less than 0 cents. |
| – VibratoFrequency | Vibrato Frequency (number). Unit: Hz. Range: 0.1 to 20 Hz. |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this Audio Console instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the Audio Console instance (plain text, max 2048 characters). |