Wwise SDK 2024.1.4

サウンドエンジンの初期化

info

注釈: サウンドエンジン自体を初期化する前に、メモリマネージャとストリーミングマネージャを初期化する必要があります。グローバルな初期化の詳細については、サウンドエンジンモジュールの初期化をご覧ください。

サウンドエンジン自体の初期化は、 AK::SoundEngine::Init 関数の呼び出しにより実行されます。ご参考までに、サウンドエンジンの初期化に示されているデフォルトの初期化を以下にコピーします。

#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;
}

AK::SoundEngine::Init 関数は、2つのパラメータを取ります。

1つ目のパラメータ : AkInitSettings * in_pSettings

この構造体は、プラットフォーム非依存のサウンドエンジン初期化情報を含んでいます。

2つ目のパラメータ : AkPlatformInitSettings * in_pPlatformSettings

この構造体は、各プラットフォーム固有のサウンドエンジン初期化情報を含んでいます。

warning

注意: いずれのパラメータも任意指定ですが、デフォルト値は不要に高いメモリ使用量の原因となることがあるため、ゲームのニーズに合わせてこれらの値をカスタマイズすることをお勧めします。詳細は、サイズ固定のメモリアロケーションのセクションを参照してください。

作成パラメータのカスタマイズ

AkInitSettings と AkPlatformInitSettings 構造体は、AK::SoundEngine::GetDefaultInitSettings と AK::SoundEngine::GetDefaultPlatformInitSettings 関数を使用して初期化する必要があります。

これらの2つの関数を用いて構造体を初期化すると、デフォルトパラメータによって構造体が埋められます。これは次のような理由で有用です：

いったん初期化されると、修正の必要なパラメータをゲームのニーズに合わせて簡単に変更可能です。
SDKの今後のバージョンは、構造体に初期化パラメータを更に追加する可能性がありますが、デフォルトパラメータの使用によりコードの下位互換性が保証されます。

以下のサンプルコードは、サウンドエンジンをデフォルトのパラメータで初期化し、パラメータ値を1つだけカスタマイズする方法を示します。

#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;
}