Wwise SDK 2022.1.18

Sound Engine Initialization

info

Note: Before initializing the sound engine itself, the memory manager and streaming manager must be initialized. Please refer to the section Initializing Sound Engine Modules for more information about global initialization.

Initializing the sound engine itself is done by calling the AK::SoundEngine::Init function. The default initialization shown in Initializing the sound engine is copied here for your convenience.

#include <AK/SoundEngine/Common/AkSoundEngine.h>                // Sound Engine
 
(...)
 
bool InitSoundEngine()
{
    (...)
 
    //
    // Initialize the sound engine
    // Using default initialization parameters
    //
    
    if ( AK::SoundEngine::Init( NULL, NULL ) != AK_Success )
    {
        assert( ! "Could not initialize the Sound Engine." );
        return false;
    }
 
    return true;
}

The AK::SoundEngine::Init function takes 2 parameters.

First parameter : AkInitSettings * in_pSettings

This structure contains platform-independent information to initialize the sound engine.

Second parameter : AkPlatformInitSettings * in_pPlatformSettings

This structure contains information specific to each platform to initialize the sound engine.

warning

Caution: Both parameters are considered optional, but we recommend you customize these values to the needs of the game, because some of the default values may cause unnecessarily high memory usage. Refer to the section Fixed-size allocations for more information.

Customizing the Creation Parameters

The AkInitSettings and AkPlatformInitSettings structures must be initialized using the AK::SoundEngine::GetDefaultInitSettings and AK::SoundEngine::GetDefaultPlatformInitSettings functions.

Initializing the structure using these two functions fills the structures with the default parameters. This is useful because:

Once initialized, the parameters that need to be modified can easily be changed to fit the needs of the game.
Using default parameters ensures code backward compatibility, since later versions of the SDK may add more initialization parameters to the structures.

The following sample code demonstrates how to initialize the sound engine with default parameters, while customizing a single parameter value.

#include <AK/SoundEngine/Common/AkSoundEngine.h>                // Sound Engine
 
(...)
 
bool InitSoundEngine()
{
    (...)
 
    //
    // Create the Sound Engine
    // Using modified initialization parameters
    //
    
    AkInitSettings          initSettings;
    AkPlatformInitSettings  platformInitSettings;
    
    AK::SoundEngine::GetDefaultInitSettings( initSettings );
    AK::SoundEngine::GetDefaultPlatformInitSettings( platformInitSettings );
    
    initSettings.uMaxNumPaths = 16;
    
    if ( AK::SoundEngine::Init( &initSettings, &platformInitSettings ) != AK_Success )
    {
        return false;
    }
 
    return true;
}

For more information on adjusting memory sizes, refer to Fixed-size allocations.

AkSoundEngine.h

AK::SoundEngine::Init

AKSOUNDENGINE_API AKRESULT Init(AkInitSettings *in_pSettings, AkPlatformInitSettings *in_pPlatformSettings)

AkPlatformInitSettings

Definition: AkOpenHarmonySoundEngine.h:38

AkInitSettings::uMaxNumPaths

AkUInt32 uMaxNumPaths

Maximum number of paths for positioning.

Definition: AkSoundEngine.h:234

NULL

#define NULL

Definition: AkTypes.h:46

AK_Success

@ AK_Success

The operation was successful.

Definition: AkTypes.h:201

AK::SoundEngine::GetDefaultInitSettings

AKSOUNDENGINE_API void GetDefaultInitSettings(AkInitSettings &out_settings)

AK::SoundEngine::GetDefaultPlatformInitSettings

AKSOUNDENGINE_API void GetDefaultPlatformInitSettings(AkPlatformInitSettings &out_platformSettings)

AkInitSettings

Definition: AkSoundEngine.h:231

Cette page a-t-elle été utile ?

Besoin d'aide ?

Des questions ? Des problèmes ? Besoin de plus d'informations ? Contactez-nous, nous pouvons vous aider !

Visitez notre page d'Aide

Décrivez-nous de votre projet. Nous sommes là pour vous aider.

Enregistrez votre projet et nous vous aiderons à démarrer sans aucune obligation !

Partir du bon pied avec Wwise