Wwise 帮助文档

• 添加用于早期反射的 Auxiliary Bus（辅助总线）。

  • 在 Project Explorer（工程资源管理器）中，右键单击要在其下创建 Early Reflection Auxiliary Bus 的总线。

  • 依次选择 New Child > Presets > Early Reflection Auxiliary Bus（新建子对象 > 预设 > Early Reflection Auxiliary Bus）。

    这时将添加新的 Auxiliary Bus。

    	备注
    	只有安装了 Wwise Reflect 并将 Wwise Reflect Factory Presets 添加到工程才会显示此预设。若尚未添加这些 Factory Preset，则可随时打开 Project > Import Factory Assets...（工程 > 导入出厂素材...）菜单来进行添加。

  • Early Reflection Auxiliary Bus 为标准 Auxiliary Bus，其采用了以下设置：

    • Bus Configuration（总线配置）为 1.0（单声道）。虽然 Reflect 能够处理多声道输入声音，但是其首先会将其下混为单声道。因此，将总线直接设置为单声道会更加高效，这样可以避免 Wwise 对发送到此 Auxiliary Bus 的声部执行不必要的空间化计算。

      	备注
      	在将总线设为单声道时，并不会影响 Reflect 的输出（不会转换为单声道）。您可以通过 Reflect 的 Effect Settings（效果器设置）来设定早期反射空间化所用的输出配置。

    • 它上面添加有 Wwise Reflect 插件。

    • 在 Positioning（定位）选项卡中，选中了 Listener Relative Routing（听者相对通路）选项，而将 3D Spatialization（3D 空间化）保留为了 None（无）。否则，Wwise 会对 Wwise Reflect 生成和空间化的镜像声源实施进一步的摆位和衰减。

      	备注
      	此总线本身不得应用任何衰减。不过，可在 Reflect Effect Editor 中自定义衰减。

  

• 检查要反射的声音。

  • 若要结合 Wwise Reflect 使用 Wwise Spatial Audio Geometry API（首选方式），请在 Sound Property Editor 的 General Settings 选项卡中将新建的总线指派给 Early Reflections 的 Auxiliary Bus。除此之外，还可调节发送音量。

    

  • 在 Sound Property Editor（声音属性编辑器）的 General Settings（常规设置）选项卡中，选中 Use game-defined auxiliary sends（使用游戏定义的辅助发送）选项，以便结合 Wwise Reflect 使用 Wwise Spatial Audio 的原始 SetImageSource API，或者将其发送到其他 Auxiliary Bus 来实施后期混响。

  • 通常要以 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。

• 初始化 Spatial Audio 模块，并注册 Spatial Audio 听者。

  // 初始化 Wwise Spatial Audio。
  AkSpatialAudioInitSettings settings;
  res = AK::SpatialAudio::Init(settings);
  
  // 注册“听者”游戏对象（如尚未注册），然后将其注册为唯一的 Spatial Audio 听者。
  static const AkGameObjectID LISTENER_ID = 10000;
  AK::SoundEngine::RegisterGameObj( LISTENER_ID, "Listener" );
  AK::SpatialAudio::RegisterListener( LISTENER_ID );
  

• 定义并设置构成 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