Playback Parameterization
Change the characteristics of in-flight audio by adjusting its properties at runtime.
Overview
Metaparameters control several features of a sound source or sound event, as they play back. For instance, metaparameters can adjust a switch node’s toggle, or the amount of reverb that a sound source emanates.
Attach Metaparameters to a Particular Sound
To use a metaparameter, you attach it to a sound event or sound source. PHASE provides the following ways to attach metaparameters:
- PHASEGeneratorNodeDefinition
- PHASEMixerDefinition
- PHASESwitchNodeDefinition
- PHASEBlendNodeDefinition
- PHASEMappedMetaParameterDefinition
- PHASESpatialPipelineEntry
Adjust a Property of a Single Audio Signal
The framework refers to metaparameters that you access through a sound event’s metaParameters dictionary as local metaparameters. When you adjust the value of a local metaparameter, it affects just the sound event.
The following code changes the volume on a specific sound event:
Share a Parameter with Multiple Audio Signals
The framework refers to parameters that affect many sound events or sound sources as global metaparameters. Real-time adjustments to global metaparameters affect the playback of all sound events that initialize with the metaparameter.
The following code changes a weather metaparameter for all of its associated sound events:
As part of the engine’s asset registry, the globalMetaParameters dictionary affects every playing sound event that shares a metaparameter that the dictionary contains.