Manual Audio Initialization

Table of Contents

• Overview

Overview

If you want to initialize and release the audio system yourself, you can call fplAudioInit() and fplAudioRelease() respectively.

In addition you can set fplAudioSettings::manualLoad to true, so that fplPlatformInit() won't do any audio backend initialization.

fplAudioSettings audioSettings;
fplDefaultAudioSettings(&audioSettings);
 
fplSettings settings = fplZeroInit;
fplDefaultSettings(&settings);
settings.audio.manualLoad = true;
 
const char *newMediaFilePath = fpl_null;
 
// Initialize 
if (fplPlatformInit(fplInitFlags_Audio, &settings)) {
 
    // Main loop
    bool isAppRunning = true;
    while (isAppRunning) {
    
        // Use case: Loading media file from a request
        MediaFormat mediaFormat = fplZeroInit;
        if (newMediaFilePath != fpl_null && MyMediaLoad(newMediaFilePath, &mediaFormat)) {
            fplAudioSettings newAudioSettings;
            fplDefaultAudioSettings(&newAudioSettings);
            newAudioSettings.channels = mediaFormat.channels;
            newAudioSettings.format = mediaFormat.type;
            newAudioSettings.sampleRate = mediaFormat.sampleRate;
            
            // Manual initialize the audio system
            fplAudioResultType resultType = fplAudioInit(&newAudioSettings);
            if (resultType != newAudioSettings_Success) {
                // Handle error
                // No need to stop or release the audio system, this is done automatically
            } else {
                // Success, you can start the playback now
                fplPlayAudio();
            }
        }
        
    }
    
    // Manually release the audio system
    fplAudioRelease();
 
    // Release the platform
    fplPlatformRelease();
}

Warning

Do not remove the fplInitFlags_Audio from fplPlatformInit(), otherwise the audio system initialization in fplAudioInit() will always fail!