GS_Audio
Categories:
GS_Audio is the audio management gem for GS_Play. It provides a visual node-based audio event authoring system, a multi-layer music scoring system, mixing buses with effects chains, and a built-in Klatt formant voice synthesizer with 3D spatial audio. All audio features integrate with the GS_Play manager lifecycle and respond to standby mode automatically.
For architecture details, component properties, and extension patterns, see the GS_Audio API.
Quick Navigation
| I want to… | Feature | API |
|---|---|---|
| Manage the audio engine or control master volume | Audio Manager | API |
| Author sound events visually with filters, effects, routing, and phase lifecycle | Audio Event Graph | API |
| Configure mixing buses with filters, EQ, and environmental influence effects | Mixing & Effects | API |
| Layer music tracks dynamically based on gameplay state | Score Arrangement | API |
| Generate text-to-speech with configurable voice parameters and 3D spatial audio | Klatt Voice | API |
Installation
GS_Audio requires GS_Core and the MiniAudio gem. Add both to your project’s gem dependencies.
For a complete guided setup, follow the Simple Project Setup guide.
Quick Installation Summary
- Enable the GS_Audio gem in your project configuration.
- Create an Audio Manager prefab and add it to the Game Manager’s Managers list.
Audio Manager
The Audio Manager is the singleton controller for the entire audio system. It initializes the audio engine, manages mixing buses, loads audio event libraries, and coordinates score playback. Like all GS_Play managers, it extends the Manager base class and plugs into the Game Manager’s startup sequence automatically.
Audio Event Graph
The Audio Event Graph is a visual node editor for authoring complex sound events. Build audio processing chains with source nodes, filter nodes, effects, and conditional routing — all connected in a graph that evaluates as a live data-flow pipeline. Supports phase lifecycle (Start / Loop / Finish) and runtime variable control for dynamic sound behavior.
Mixing & Effects
The mixing system provides named audio buses with configurable effects chains. Each bus can have filters applied — low pass, high pass, band pass, notch, peaking EQ, shelving, delay, and reverb. Audio Bus Influence Effects allow environmental zones to dynamically modify bus effects based on the listener’s position.
Score Arrangement
Score Arrangement Tracks are multi-layer music assets. Each arrangement defines a time signature, BPM, fade behavior, and a set of Score Layers — individual audio tracks that can be enabled or disabled independently. This allows dynamic music that adds or removes instrument layers based on gameplay state.
Klatt Voice Synthesis
GS_Play includes a built-in text-to-speech system based on Klatt formant synthesis. The Klatt Voice component converts text to speech in real time with configurable voice parameters — frequency, speed, waveform, formants, and pitch variance. The system supports 3D spatial audio and inline KTT tags for expressive delivery.
See Also
For the full API, component properties, and C++ extension guide:
For step-by-step project setup:
Get GS_Audio
GS_Audio — Explore this gem on the product page and add it to your project.