バージョン
menu_open
Wwise SDK 2023.1.2
サウンドエンジン統合の詳細

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

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

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

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

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

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

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

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

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

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

AkInitSettingsAkPlatformInitSettings 構造体は、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;
initSettings.uMaxNumPaths = 16;
if ( AK::SoundEngine::Init( &initSettings, &platformInitSettings ) != AK_Success )
{
return false;
}
return true;
}

メモリサイズの調整に関する詳細は、 サイズ固定のメモリアロケーション を参照してください。

AKSOUNDENGINE_API AKRESULT Init(AkInitSettings *in_pSettings, AkPlatformInitSettings *in_pPlatformSettings)
AkUInt32 uMaxNumPaths
Maximum number of paths for positioning
#define NULL
Definition: AkTypes.h:46
@ AK_Success
The operation was successful.
Definition: AkTypes.h:215
AKSOUNDENGINE_API void GetDefaultInitSettings(AkInitSettings &out_settings)
AKSOUNDENGINE_API void GetDefaultPlatformInitSettings(AkPlatformInitSettings &out_platformSettings)

このページはお役に立ちましたか?

サポートは必要ですか?

ご質問や問題、ご不明点はございますか?お気軽にお問い合わせください。

サポートページをご確認ください

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。

プロジェクトを登録していただくことで、ご利用開始のサポートをいたします。

Wwiseからはじめよう