Wwise Help

• 添加用于早期反射的 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（3D 空间化）保留为 None（无）。否则，Wwise 会对 Wwise Reflect 生成和空间化的镜像声源实施进一步的摆位和衰减。

    info	备注
    	此总线上不能应用任何衰减，不过可在 Reflect Effect Editor（Reflect 效果器编辑器）中自定义衰减。

    

• 检查要反射的声音。

  • 在 Sound Property Editor（声音属性编辑器）的 General Settings 选项卡中，选中 Use game-defined auxiliary sends（使用游戏定义的辅助发送）选项。

    

  • 通常要以 3D 形式对声音进行空间化处理，同时应用衰减。为此，请在 Sound Property Editor 的 Positioning 选项卡中选中 Listener Relative Routing 选项，并将 3D Spatialization 设为 Position + Orientation（位置 + 朝向）。然后，在 Attenuation（衰减）分组框中添加衰减。

    

• 在 Reflect Effect Editor 中配置效果器。

  • 通过修改 Output Config（输出配置）属性，将输出声道设为所需配置。其中，Parent Bus（父总线）代表 Auxiliary Bus 的父总线的输出声道配置。

  • 确保将 Max Distance（最大距离）数值设置得足够大，确保可以看见镜像声源。

  

• 生成音频包。

• 确保已获取 Reflect 授权。

• 确保通过包含 AK/Plugin/AkReflectFXFactory.h 来注册 Reflect 插件。

• 包含 Spatial Audio 头文件：AK/SpatialAudio/Common/AkSpatialAudio.h。

• 注册听者和发声体。

  // 注册听者。
  static const AkGameObjectID LISTENER_ID = 10000;
  AK::SoundEngine::RegisterGameObj( LISTENER_ID, "Listener" );
  AK::SpatialAudio::RegisterListener( LISTENER_ID );
  
  // 注册发声体。
  static const AkGameObjectID LISTENER_ID = 100;
  AK::SoundEngine::RegisterGameObj( EMITTER_ID, "Emitter" );
  
  AkEmitterSettings emitterSettings = AkEmitterSettings();
  // ER 是应用有 Reflect 效果器的 Auxiliary Bus 的名称。
  emitterSettings.reflectAuxBusID = AK::SoundEngine::GetIDFromString( "ER" );
  // 此数值代表听者和发声体之间的最大距离，在该距离内听者可以收到来自发声体的反射。
  emitterSettings.reflectionMaxPathLength = 500.f;
  
  AK::SpatialAudio::RegisterEmitter( EMITTER_ID, emitterSettings );
  
  // 将发声体与听者关联。
  static const AkGameObjectID aLstnrsForEmitter = LISTENER_ID;
  AK::SoundEngine::SetListeners( EMITTER_ID, &aLstnrsForEmitter, 1 );

• 定义并设置构成 Reflect 几何构造表面的几何构造。

  创建 AkGeometryParams，并填入几何构造的三角形、顶点和表面。

  static const AkGeometrySetID GEOMETRY_ID = 200;
  AkGeometryParams geometryParam;
  
  // 将三角形、顶点和表面填入 geometryParam。
  // 参见 Integration Demo 中的示例。
  // ...
  
  AK::SpatialAudio::SetGeometry( GEOMETRY_ID, geometryParams );

• 在发声体移动时更新其位置（将调用由 SoundEngine::SetPosition 替换为 SpatialAudio::SetPosition）。

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

• 确保通过包含 AK/Plugin/AkReflectFXFactory.h 来注册 Reflect 插件。

• 包含 Reflect 头文件：AK/Plugin/AkReflectGameData.h。

• 另外可能还要将 AkReflectFX.lib 添加到可执行程序的输入库。

• 使用 Reflect API 创建镜像声源，并根据想要从哪里反射声音来设定其位置。

  // 创建 AkReflectGameData 对象。
  AkReflectGameData * reflectGameData = nullptr;
  reflectGameData = (AkReflectGameData *)_alloca(AkReflectGameData::GetSize(1));
  // 填入数据。
  reflectGameData->listenerID = LISTENER_ID;
  reflectGameData->uNumImageSources = 1;
  reflectGameData->arSources[0].uID = 123;
  reflectGameData->arSources[0].params.sourcePosition = { 200, 0, 0 };
  // 以下数值代表发声体和镜像声源之间的距离系数。
  // 若声源位置与反射表面相对应，则该数值应为 2。
  reflectGameData->arSources[0].params.fDistanceScalingFactor = 1.f;
  reflectGameData->arSources[0].params.fLevel = 1.f;
  // 在此将镜像声源与 Acoustic Texture 关联（如有必要）。
  reflectGameData->arSources[0].texture.uNumTexture = 0;
  reflectGameData->arSources[0].name.SetName("Img src 1");
  
  // 发送到 Reflect。
  AK::SoundEngine::SendPluginCustomGameData(AK::SoundEngine::GetIDFromString("ER"), EMITTER_ID, AkPluginTypeEffect, AKCOMPANYID_AUDIOKINETIC, 171, reflectGameData, AkReflectGameData::GetSize(1));

• 在需要更新镜像声源的位置时，发送新的 AkReflectGameData。

Wwise Reflect 吸收频段的默认映射

• Low（低）：< 250 Hz

• Mid Low（中低）：> 250 Hz 且 < 1,000 Hz

• Mid High（中高）：> 1,000 Hz 且 < 4,000 Hz

• High（高）：> 4,000 Hz