Wwise ヘルプ

イベントをプリペアする場合に、SoundBankを設定するには:

1. “Event”というSoundBankを1つ作成して、SoundBank Editorにロードする。

2. 「Event」SoundBankに、プロジェクトのアクションイベントをいくつか追加するか、単純にイベントのWork Unitをいくつか、追加する。

3. Media 列のチェックボックスを外し、Events列とStructures列のチェックボックスだけを選択したままにする。 PrepareEvent()を使用する場合は、メディアをバンクでなくディスクから直接ロードする必要がある。

   	注釈
   	今回の例では、全てのイベントと構造を1つのSoundBankに入れてあります。これは小規模なプロジェクトでは可能ですが、一般的には、コンテンツを複数のSoundBankに分割した方が良いでしょう。また、それぞれのイベントにロードすべき他のSoundBankへのレファレンスが含まれるため、改めてロードしたりSDKコマンドからプリペアしなくてもよい構造用バンクを別に作成することもできます。

4. これらのSoundBankを生成して、生成されたSoundBankフォルダを、ゲームアプリケーションにコピーする。

   	注釈
   	1つのSoundBankに入っている構造データを、ランタイムに分割することはできません。このため、AK::SoundEngine::PrepareEventを使っている時に、他のSoundBankに入っている構造データが必要になると、そのSoundBankに入っている全ての構造データが、同時にロードされます。事前にプロジェクトの構造データを複数のSoundBankに分割すれば、メモリにロードされてしまう不要な情報の量を抑えることができます。

ゲーム中にイベントをプリペアするには:

1. ゲームの最初にイベントのSoundBankをロードして、イベントのプリペア（用意）を、そのイベントがゲームで必要となった時に行う。関連する構造やメディアは、自動的にロードされる。

   ゲーム中にイベントをプリペアする方法として、以下のサンプルコードを参照。

                 
                 // Initializing the sound engine. 
   
                 AkInitSettings initSettings;
                 AkPlatformInitSettings platformInitSettings;
                 AK::SoundEngine::GetDefaultInitSettings( initSettings ):
                 AK::SoundEngine::GetDefaultPlatformInitSettings( platformInitSettings ):
   
                 // Set the required settings. 
   
                 ...
   
                 // Set PrepareEvent related settings. 
                 initSettings.bEnableGameSyncPreparation = false; // Not used in the current sample. 
   
                 // (Optional) Allocate a memory pool into which prepared media will be loaded. 
                 // If this is not done, memory will be allocated directly in the default memory pool. 
                 {
                   initSettings.uPrepareEventMemoryPoolID = AK.MemoryMgr.CreatePool( NULL, 4*1024*1024, 1024, AkMalloc );
   
                   // (Optional) Give the memory pool a name. This can be very useful for profiling. 
                   AK::MemoryMgr::SetPoolName( initSettings.uPrepareEventMemoryPoolID, L"PrepareEventPool" );
                 }
   
                 AKRESULT eResult = AK.SoundEngine.Init( initSettings, platformInitSettings );
                 if( eResult != AK_Success )
                 {
                   // Handle error. 
                 }
   
                 // Load Init bank and the event/structure bank. 
                 AkBankID    bankID;  // Not used in the sample. 
                 AKRESULT eResult = AK::SoundEngine::LoadBank( L"Init.bnk", AK_DEFAULT_POOL_ID, bankID );
                 if( eResult == AK_Success )
                 {
                   eResult = AK::SoundEngine::LoadBank( L"Events.bnk", AK_DEFAULT_POOL_ID, bankID );
                 }
   
                 ...
   
                 // And then, at various points in the code:
   
                 AkLpCtstr pEventsNameArray[1] = { L"My_Event_Name" };
   
                 // Preparing an event:
                 eResult = AK::SoundEngine::PrepareEvent( Preparation_Load, pEventsNameArray, 1 ); // 1 is the array size. 
   
                 // Unpreparing an event:
                 eResult = AK::SoundEngine::PrepareEvent( Preparation_Unload, pEventsNameArray, 1 ); // 1 is the array size.