AudioManager

Namespace: Molca.Audio
File: Packages/com.molca.core/Runtime/Audio/AudioManager.cs
Type: RuntimeSubsystem (child of RuntimeManager prefab)

When to use

Use AudioManager to play music, SFX, and voice audio from AudioLibrary collections. It handles clip caching via Addressables, volume ducking during speech, and mixer group routing through the configured AudioModule.

Role

Manages three dedicated AudioSource channels: music (looping), SFX (one-shot), voice (with ducking).
Loads audio clips from AudioLibrary collections through Addressables with ref-counted caching.
Voice playback temporarily ducks music/SFX volume (duck amount and fade time configurable via Inspector).
Volume control delegates to AudioModule on GlobalSettings and dispatches typed events on change.

API Reference

Playback controls

Method	Signature	Description
`PlayMusic`	`async void PlayMusic(string collectionName, string id)`	Play a looping music track from a collection. Crossfades from previous track.
`StopMusic`	`void StopMusic()`	Fade out and stop the current music track.
`PlaySFX`	`async void PlaySFX(string collectionName, string id, float volume = 1f, AudioSource audioSource = null)`	Play a one-shot SFX. Uses default SFX source or a custom AudioSource.
`PlayVoice`	`async void PlayVoice(string collectionName, string id, float volume = 1f, AudioSource audioSource = null)`	Play voice audio with ducking. Stops any current voice first.
`StopVoice`	`void StopVoice()`	Stop the current voice playback and restore ducked volumes.
`PlayFromSource`	`async void PlayFromSource(AudioSource source, string collection, string id, AudioLibrary.AudioType type, float volume = 1f)`	Play any audio type on a specified AudioSource.

Volume controls

Method	Signature	Description
`SetMasterVolume`	`void SetMasterVolume(float volume)`	Set master volume (delegates to `AudioModule`, dispatches `TypedEvents.MasterVolumeChanged`).
`SetMusicVolume`	`void SetMusicVolume(float volume)`	Set music volume.
`SetSFXVolume`	`void SetSFXVolume(float volume)`	Set SFX volume.
`SetVoiceVolume`	`void SetVoiceVolume(float volume)`	Set voice volume.
`SetupAudioSource`	`void SetupAudioSource(AudioSource source, AudioLibrary.AudioType type)`	Assign the correct mixer group to an AudioSource.

Properties

Property	Type	Description
`MusicLibrary`	`AudioLibrary`	Audio library for music clips (from `AudioModule`).
`SFXLibrary`	`AudioLibrary`	Audio library for SFX clips.
`VoiceLibrary`	`AudioLibrary`	Audio library for voice clips.
`MasterVolume`	`float`	Current master volume.
`MusicVolume`	`float`	Current music volume.
`SFXVolume`	`float`	Current SFX volume.
`VoiceVolume`	`float`	Current voice volume.

Code

using Molca;
using Molca.Audio;
using UnityEngine;

public class UISounds : MonoBehaviour
{
    [Inject] private AudioManager _audio;

    private async void Start()
    {
        await RuntimeManager.WaitForInitialization();
    }

    public void OnButtonPress()
    {
        _audio.PlaySFX("UI", "click");
    }

    public void PlayBGM()
    {
        _audio.PlayMusic("Ambient", "main-theme");
    }
}

RuntimeManager — AudioManager is a child subsystem
Global Settings — AudioModule configures mixer groups and libraries
EventDispatcher — dispatches TypedEvents.MasterVolumeChanged etc.

Overview

Common Tasks

Molca Core

Shared module (MolcaSDK)

Molca SDK - VR

Molca SDK - DT

When to use

Role

API Reference

Playback controls

Volume controls

Properties

Code

​When to use

​Role

​API Reference

​Playback controls

​Volume controls

​Properties

​Code

​Related

When to use

Role

API Reference

Playback controls

Volume controls

Properties

Code

Related