(Tentative)

Definition Functional Requirements Syntax Semantics

Definition

Audio Action Status (PGM-AAS)

  1. Is produced by the Spatial Reasoning AIM.
  2. It provides a snapshot of the spatial and perceptual characteristics of audio sources within an M-Location, enabling downstream AIMs to interpret, prioritise, and act upon audio information in alignment with the A-User’s goals and context.
  3. It includes Source Mapping, Salience Scoring, Confidence Annotation, and Temporal Framing.

Functional Requirements

Function Description
Source Mapping Identifies and locates audio sources with Orientation and proximity.
Salience Scoring Assigns perceptual importance to each source.
Confidence Annotation Indicates reliability of spatial interpretation.
Temporal Framing Defines the time window during which the status is valid.
Traceability Includes provenance metadata for audit and debugging.

Syntax

https://schemas.mpai.community/PGM1/V1.0/data/AudioActionStatus.json

Semantics

Label Description
Header Audio Action Status Header
├─ Standard-AAS The characters “PGM-AAS-V”
├─ Version Major version – 1 or 2 characters
├─ Dot-separator The character “.” separating version components
└─ Subversion Minor version – 1 or 2 characters
AudioActionStatusID Unique identifier for this Audio Action Status instance
MInstanceID Metaverse instance ID
MEnvironmentID Environment ID
SoundSources List of sound sources with spatial and perceptual attributes
├─ SourceID Identifier of the sound source
├─ Azimuth Horizontal angle in degrees
├─ Elevation Vertical angle in degrees
├─ Proximity Relative distance: {near, mid, far}
├─ SalienceScore Perceptual importance (range: 0 to 1)
└─ Confidence Confidence score for spatial interpretation (range: 0 to 1)
TemporalScope Time window for status relevance
Time Start and end of time window
Trace Provenance metadata
├─ Origin Module or subsystem that issued the status
└─ Timestamp Time of creation (refers to MPAI Time schema)
DescrMetadata Descriptive metadata for audit, indexing, or semantic linking