Spatial Audio 对象
WAAPI 小组件

AkAudioEvent

代表 Wwise Event 的 Unreal 对象。可通过从 Wwise Picker 拖放 或在 Unreal Content Browser 中右键单击来创建。其名称必须与 Wwise 工程中 Event 的名称完全一致。

• 属性
  • Required Bank：指定包含此 Event 的 SoundBank 及其结构和媒体。
• Unreal Content Browser 上下文菜单选项
  • Play Event：发送 Event。
  • Stop Event：停止当前播放的所有 Event。

AkAuxBus

代表 Wwise Auxiliary Bus 的 Unreal 对象。可通过从 Wwise Picker 拖放 或在 Unreal Content Browser 中右键单击来创建。其名称必须与 Wwise 工程中 Auxiliary Bus 的名称完全一致。允许在 Unreal Editor 内将插件媒体添加到 SoundBank。

• 属性
  • Required Bank：指定包含此 Auxiliary Bus 的 SoundBank 及关联的插件媒体。

AkAudioBank

代表 Wwise SoundBank 的 Unreal 对象。可通过在 Unreal Content Browser 中右键单击来创建。

• 属性
  • Auto Load：若启用，则自动加载和卸载 SoundBank 及引用该 SoundBank 的集成包。注意：在启用此标记时，并不会在编辑器中马上加载 Bank；下次加载集成包时才会应用该设置。
• Unreal Content Browser 上下文菜单选项
  • Generate Selected SoundBank(s)...：打开对话框窗口以便针对一系列 SoundBank 执行 SoundBank Generation 操作。
  • Load Bank：加载此 SoundBank。
  • Unload Bank：卸载此 SoundBank。
  • Clear Banks：卸载当前加载的所有 SoundBank，包括 Init Bank。
  • Load Init Bank：加载 Init Bank。加载此 Bank 之后才能加载其他 SoundBank。
  • Refresh All Banks：停止播放所有声音；将当前加载的所有 SoundBank 先卸载再加载。

AkAmbientSound

AkAmbientSound 是一个 AActor 类，其使用方式与默认 Unreal Audio 系统提供的 AAmbientSound 对象相同。可通过其自有对象 Blueprint 函数或使用全局辅助函数（Start All Ambient Sounds 和 Stop All Ambient Sounds）来控制其播放行为。同时，AkAmbientSound 还包含 AkComponent （具有自己的属性）。

• 属性
  • Stop When Owner Is Destroyed：若启用，则在销毁 AkAmbientSound 时自动停止 Event。
  • Auto Post：在 BeginPlay 时自动发送关联的 AkAudioEvent 。
• Blueprint 函数
  • Start All Ambient Sounds：开始播放所有环境声。
  • Start Ambient Sound：开始播放所选环境声。
  • Stop All Ambient Sounds：停止播放所有环境声。
  • Stop Ambient Sound：停止播放所选环境声。

AkReverbVolume

AkReverbVolume 是一个 AVolume 类，其使用方式与默认 Unreal Audio 系统提供的 AReverbVolume 对象相同。它可以通过 Editor 中的任何 Brush 生成。通过 Ak Late Reverb Component 来获得混响效果。

Ak Late Reverb Component

此组件可添加到任何 Volume，允许通过其创建混响区域。通过将 Wwise Auxiliary Bus 指派给组件，并把所有进入此 Volume 的 AkComponent 发送到关联的 Wwise Auxiliary Bus，即可获得混响效果。若 Volume 之间存在重叠，则使用 Priority 属性来决定将目标 AkComponent 发送到哪条 Auxiliary Bus。在进入/离开 AkReverbVolume 时，会向 Auxiliary Bus 的电平应用即时淡入/淡出效果。注意，若 Actor 上绑定有活跃的 Ak Late Reverb Component，而且还带有 AkRoomComponent ，则将禁用 Late Reverb Component，并由 AkRoomComponent 处理混响，同时使用 Spatial Audio 引擎来渲染效果。

• 属性
  • Enable Late Reverb：启用或禁用此组件。
  • Aux Bus：指派给此 Volume 的 AkAuxBus 。此辅助总线需启用游戏定义的辅助发送。若要结合 AkRoomComponent 和 AkAcousticPortal 使用 Late Reverb，则还需针对 Positioning 启用 Listener Relative Routing 并设置 3D Spatialization。
  • Send Level：与 Wwise Auxiliary Bus 关联的最大发送电平。
  • Fade Rate：进入/离开当前 Late Reverb Component 时的 SendLevel 淡入/淡出速率，单位为百分比每秒（在值为 0.2 时，淡变时间为 5 秒）。
  • Priority：Late Reverb Component 的应用优先级。若 Volume 之间存在重叠，则仅选择优先级最高的 Late Reverb Component（可在 Unreal Editor Project Settings 的 Plugins > Wwise 下配置同时可有多少个 Late Reverb Component）。若两个或多个重叠的 Late Reverb Component 拥有相同的优先级，则无法预测会选择哪个 Late Reverb Component。

AkComponent

AkComponent 由 USceneComponent 派生，代表活跃的 Wwise Event。

• 属性
  • Attenuation Scaling Factor：若 Ambient Sound 使用 Wwise 中的衰减，则此属性允许修改该环境声的衰减计算结果，以便模拟具有更大或更小传播区域的声音。
  • Occlusion Refresh Interval：设置声笼/声障检查之间的时间间隔（听者和此游戏对象之间的直接视线）。若设为 0，则针对此组件禁用声笼/声障。若要使用全方位 Spatial Audio 衍射，则建议将其禁用。
  • Ak Audio Event：在指示开始播放 AkAmbientSound 对象时发送的 AkAudioEvent 。若要使用 Spatial Audio 功能，则 Event 的音效需启用游戏定义的辅助发送。
  • Spatial Audio Properties：
    • Reflect：
      • Early Reflection Aux Bus：带有 AkReflect 插件的 AkAuxBus 。若设为 None，则禁用几何反射。此辅助总线需启用游戏定义的辅助发送，同时启用 Listener Relative Routing，但要将 3D Spatialization 设为 None。
      • Early Reflection Aux Bus Name：若未在 Early Reflection Aux Bus 中输入 AkAuxBus ，则将使用 Early Reflection Aux Bus Name。若设为 AK_INVALID_UNIQUE_ID ，则禁用几何反射。
      • Early Reflection Order：在通过几何反射 API 计算间接路径时最多可处理多少条反射。反射处理负荷随反射阶数呈指数级增加，所以要尽量将该数值设得低些。有效范围：1-4。
      • Early Reflection Bus Send Gain：在发送到带有 AkReflect 插件的总线时应用的发送增益 (0.f-1.f)。
      • Early Reflection Max Path Length：用于停止计算反射的启发值。应当不超过发声体的最大衰减距离（为了降低 CPU 用量，甚至会设得更短）。
      • Enable Spot Reflectors：在 AkSpotReflector 上启用反射。
    • Room：
      • Room Reverb Aux Bus Gain：在发送到与发声体所在房间关联的总线时应用的发送增益 (0.f-1.f)。
    • Geometric Diffraction：
      • Diffraction Order：声音在发声体和听者之间最多可绕过多少个边缘发生衍射。
      • Diffraction Max Paths：声音最多可有多少条绕过障碍物通往听者的路径。
      • Diffraction Max Path Length：衍射声音最多可传播多长的距离。应当不超过发声体的最大衰减距离（为了降低 CPU 用量，甚至会设得更短）。
    • Debug Draw options：允许以视觉形式呈现 Spatial Audio 引擎所执行的射线投射以及投射射线所碰到的三角形，以便轻松排除 Spatial Audio 引擎存在的问题。每次仅可针对一个组件执行此操作。
• Blueprint 函数
  • Post Ak Event：开始播放指定的 Event。
  • Post Trigger：将 Trigger 发送到与组件关联的 Event。
  • Set Listeners：设置此 UAkComponent 的听者。
  • Set Occlusion Refresh Interval：设置 UAkComponent 执行声笼计算的时间间隔。若设为 0，则针对组件禁用声笼。
  • Set RTPC Value：设置与组件关联的 Event 的 RTPC 值。
  • Set Stop when Owner Destroyed：针对组件设置 StopWhenOwnerDestroyed 值。
  • Set Switch：设置与组件关联的 Event 的 Switch。
  • Stop：停止播放与组件关联的 Event。
  • Use Reverb Volumes：指定组件是否会受 AAkReverbVolumes 影响。

AkAudioInputComponent

AkAudioInputComponent 由 AkComponent 派生，代表音频输入实例。

• Blueprint 函数
  • Post Associated Audio Input Event：开始播放指定的 Event，并注册对应的回调。