下面列出了 Unity Integration 中提供的所有 Wwise 组件：

• AkAmbient：使用此组件来将 Wwise Event 关联到场景中的对象。这样可以依据所选 Unity Trigger 来在不同时机播放声音。该组件尤其适用于环境声（与场景中的对象关联的声音），不过也可另作他用。AkAmbient 以 AkEvent 为基类，提供有 Play/Stop、Play Multiple、Stop Multiple 和 Stop All 按钮，方便预览关联的 Wwise Event。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkAmbient 。
• AkAudioListener：将此脚本绑定到代表听者的游戏对象上。该组件一般会添加到 Camera 或 Player 对象，但也可在运用 3D 总线时添加到其他游戏对象。isDefaultListener 决定游戏对象是否会被视为默认听者。该听者将自动监听所有 AkGameObjListenerList 中未绑定听者的游戏对象。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkAudioListener 。
• AkBank：在指定时机加载和卸载 SoundBank。您可以使用 Decode Compressed Data 选项在指定时机解压 Vorbis 声音。在这种情况下，会用准备的方式加载 SoundBank。另请参阅 SDK 文档：加载 SoundBank。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkBank 。
• AkEmitterObstructionOcclusion：在当前游戏对象对应的发声体和听者之间至少有一个障碍物时完全阻挡/遮蔽发声体。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEmitterObstructionOcclusion 。
• AkEnvironment：使用此组件来定义混响区域。为了确保能够正常工作，必须将该组件添加到 Collider 对象。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEnvironment 和 AkEnvironmentPortal (Reverb Zone) 。
• AkEnvironmentPortal：使用此组件来定义两个不同 AkEnvironment 区域的重叠区，以便在两个区域之间进行混音。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEnvironment 和 AkEnvironmentPortal (Reverb Zone) 。
• AkEvent：辅助类知道一个 Wwise 事件，以及何时在 Unity 中触发它。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEvent 。
• AkGameObj：此组件代表场景中的声音对象，用来追踪其位置和其他 Game Sync（如 Switch 以及 RTPC）和环境变量。您可以将该组件添加至任何发声体对象，它也会自动添加到已附加 AkAudioListener 组件的对象上。注意，若没有该组件，则 Wwise 会将其自动添加到传给 Wwise 的 Unity Game Object，并且使用默认值。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkGameObj 。
• AkInitializer：此组件用于初始化 Wwise 声音引擎并更新音频帧。它被标记为 DontDestroyOnLoad ，因此在整个游戏当中都会始终保持有效，并非只作用于一个场景。您可以通过修改此脚本来更改声音引擎的初始化参数。其中有些已经暴露在属性检视器中。为了确保能够正常初始化音频，在游戏开始时必须已将其绑定到一个 Game Object 上。在执行该脚本之后，才能执行其他使用 AkSoundEngine 的 MonoBehavior。
  

  参见

  • 调整 Wwise Initialization Settings
  • Wwise SDK 文档：初始化声音引擎的不同模块
  • AK::SoundEngine::Init()
  • AK::SoundEngine::Term()
  • AkCallbackManager

• AkState：此组件会在每次触发所选 Unity Event 时调用 AkSoundEngine.SetState()。比如，您可以将该组件添加到 Unity Collider 以便在有对象进入时进行触发。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkState 。
• AkSwitch：此组件会在每次触发所选 Unity Event 时调用 AkSoundEngine.SetSwitch()。比如，您可以将该组件添加到 Unity Collider 以便在有对象进入时进行触发。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkSwitch 。

Spatial Audio 组件：

• AkEarlyReflections：将此脚本绑定到代表发声体的游戏对象上。此游戏对象发出的声音会在 AkSurfaceReflector 附近产生早期反射。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkEarlyReflections 。
• AkRoom：AkRoom 是一个封闭的环境，仅可通过 AkRoomPortal 与外部/其他 Room 互通。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRoom 。
• AkRoomAwareObject：该游戏对象会感知 AkRoom 组件。将此脚本绑定到 Spatial Audio Listener 以及发出 Spatial Audio 声音的 GameObject 上。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRoomAwareObject 。
• AkRoomPortal：AkRoomPortal 可将两个 AkRoom 组件互连。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRoomPortal 和 AkRoomPortalObstruction 。
• AkRoomPortalObstruction：在当前游戏对象对应的 Spatial Audio Portal 和 Spatial Audio Listener 之间至少有一个障碍物时完全阻挡 Spatial Audio Portal。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkRoomPortal 和 AkRoomPortalObstruction 。
• AkSpatialAudioDebugDraw：将此脚本绑定到通过 Spatial Audio 发出声音的游戏对象上。该脚本可在当前游戏对象和 Spatial Audio Listener 之间绘制早期反射或衍射路径以方便进行调试。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkSpatialAudioDebugDraw 。
• AkSpatialAudioListener：将此脚本绑定到代表听者的游戏对象上。该组件一般会添加到 Camera 或 Player 对象，但也可在运用 3D 总线时添加到其他游戏对象。isDefaultListener 决定游戏对象是否会被视为默认听者。该听者将自动监听所有 AkGameObjListenerList 未绑定听者的游戏对象。
  • 有关其公共属性的说明，请参阅 在 Inspector 中使用 AkSpatialAudioListener 。
• AkSurfaceReflector：此组件会将 GameObject 几何构造所含的三角形转换为声音反射表面。
  • 有关公共属性的说明，请参阅 在 Inspector 中使用 AkSurfaceReflector 章节。

组件代码

如需查看 Wwise 组件的代码，请通过组件的“设置”按钮打开对应的 C# 脚本。

若想为自己的 Wwise Unity Integration 工程编写自定义脚本，建议使用 Wwise Types 来实现。

参见

• 添加 Wwise 组件