Wwise ヘルプ

• アーリーリフレクション（ER）用にAuxiliary Busを追加します。

  

  • Auxiliary Bus Property EditorのGeneral Settingsタブで、Channel Configurationを1.0（モノ）に変更します。Reflectは、マルチチャンネルのインプットサウンドに対応できるものの、最初にそれをダウンミックスしてモノにします。このため、バスをモノにした方が、Wwiseで不用にもボイスのスペーシャリゼーションを計算してAuxiliary Busに送る手間を省けるので、より効率的です。

    info	注釈
    	バスをモノにしても、Reflectのアウトプットに影響しません（アウトプットはモノになりません）。アーリーリフレクションのスペーシャリゼーションを行うアウトプット側の設定は、ReflectのEffect Settingsで設定します。

    

  • Effectsタブで、Wwise Reflectのインスタンスを追加します

    

  • PositioningタブでListener Relative Routingオプションをチェックしますが、3D Spatializationの設定はNoneのままにします。そうしないとWwise Reflectによって生成され空間配置（spatialize）されたイメージソースを、Wwiseが更に変換（パンニングと減衰）させてしまうからです。

    info	注釈
    	減衰設定はこのバスで行わず、Reflect Effect Editorで減衰のカスタム設定を行います。

    

• 反射する音を確認します。

  • Sound Property EditorのGeneral Settingsタブで、Use game-defined auxiliary sendsオプションをチェックします。

    

  • 一般的に、サウンドのスペーシャリゼーションを3Dで行い、減衰を適用します。Sound Property EditorのPositioningタブで、Listener Relative Routingオプションをチェックし、3D Spatializationの設定をPosition + Orientationにします。Attenuationグループボックスで、Attenuationを1つ追加します。

    

• Reflect Effect Editorで、エフェクトの設定を行います。

  • Output Configプロパティを変更し、アウトプットチャンネルのコンフィギュレーションを設定します。Parent Busは、Auxiliary Busの親バスのアウトプットのチャンネルコンフィギュレーションを表します。

  • イメージソースが見えるように、Max Distanceの数値が低すぎないように注意します。

  

• サウンドバンクを生成します。

• Reflectのライセンスを取得してあることを確認します。

• 確実にReflectを登録するために AK/Plugin/AkReflectFXFactory.h を含めます。

• Spatial Audioヘッダーファイルである AK/SpatialAudio/Common/AkSpatialAudio.h を含めます。

• リスナーとエミッターを登録します。

  // Register the listener.
  static const AkGameObjectID LISTENER_ID = 10000;
  AK::SoundEngine::RegisterGameObj( LISTENER_ID, "Listener" );
  AK::SpatialAudio::RegisterListener( LISTENER_ID );
  
  // Register the emitter.
  static const AkGameObjectID LISTENER_ID = 100;
  AK::SoundEngine::RegisterGameObj( EMITTER_ID, "Emitter" );
  
  AkEmitterSettings emitterSettings = AkEmitterSettings();
  // ER is the name of the Auxiliary Bus with a Reflect effect.
  emitterSettings.reflectAuxBusID = AK::SoundEngine::GetIDFromString( "ER" );
  // This represent the maximum distance between the listener and the emitter for the listener to receive reflections from the emitter.
  emitterSettings.reflectionMaxPathLength = 500.f;
  
  AK::SpatialAudio::RegisterEmitter( EMITTER_ID, emitterSettings );
  
  // Associate the emitter with the listener
  static const AkGameObjectID aLstnrsForEmitter = LISTENER_ID;
  AK::SoundEngine::SetListeners( EMITTER_ID, &aLstnrsForEmitter, 1 );

• Reflectのジオメトリサーフェスをつくるためのジオメトリを定義し設定します。

  AkGeometryParamsを作成し、その中に、あなたのジオメトリの三角形、頂点、サーフェスを入れます。

  static const AkGeometrySetID GEOMETRY_ID = 200;
  AkGeometryParams geometryParam;
  
  // Fill triangles, vertices and surfaces into geometryParam.
  // See an example in the Integration Demo.
  // ...
  
  AK::SpatialAudio::SetGeometry( GEOMETRY_ID, geometryParams );

• エミッターが動くにつれ、エミッターのポジションを更新します。（SoundEngine::SetPosition からのコールを、SpatialAudio::SetPositionに置き換えます）

  AK::SpatialAudio::SetPosition( EMITTER_ID, soundPos );

• 確実にReflectを登録するために AK/Plugin/AkReflectFXFactory.h を含めます。

• Reflectヘッダーファイルである AK/Plugin/AkReflectGameData.h を含めます。

• 実行ファイルのインプットライブラリに、AkReflectFX.libを追加する必要があるかもしれません。

• Reflect APIを使いイメージソースを作成し、音を反射させたい場所に配置します。

  // Create an AkReflectGameData object.
  AkReflectGameData * reflectGameData = nullptr;
  reflectGameData = (AkReflectGameData *)_alloca(AkReflectGameData::GetSize(1));
  // Fill in the data.
  reflectGameData->listenerID = LISTENER_ID;
  reflectGameData->uNumImageSources = 1;
  reflectGameData->arSources[0].uID = 123;
  reflectGameData->arSources[0].params.sourcePosition = { 200, 0, 0 };
  // The following represents a distance factor between the listener and the image source.
  // If the source position corresponds to the reflective surface, the number should be two.
  reflectGameData->arSources[0].params.fDistanceScalingFactor = 1.f;
  reflectGameData->arSources[0].params.fLevel = 1.f;
  // Associate the image source with Acoustic Textures here if needed.
  reflectGameData->arSources[0].texture.uNumTexture = 0;
  reflectGameData->arSources[0].name.SetName("Img src 1");
  
  // Send to Reflect.
  AK::SoundEngine::SendPluginCustomGameData(AK::SoundEngine::GetIDFromString("ER"), EMITTER_ID, AkPluginTypeEffect, AKCOMPANYID_AUDIOKINETIC, 171, reflectGameData, AkReflectGameData::GetSize(1));

• イメージソースのポジションを更新する必要がある時に、新しい AkReflectGameData を送信する。

Wwise ReflectのデフォルトのFrequency Absorption Bandのマッピング

• Low: < 250 Hz

• Mid Low: > 250 Hz and < 1,000 Hz

• Mid High: > 1,000 Hz and < 4,000 Hz

• High: > 4,000 Hz