用途:在 Unity 项目中集成 Wwise 音频中间件,实现音效与音乐播放、动态音频参数控制、3D 定位音频、音频状态管理以及 SoundBank 的加载与卸载。
主要能力:通过 AK.Wwise.Event 的 Post 播放事件并获取 playingId 以便停止;使用 AkSoundEngine.StopPlayingID 或 StopAll 停止播放;通过 AK.Wwise.Bank 的 Load/Unload 与 AkSoundEngine.LoadBank 管理音频库,需先加载 Init bank;使用 AK.Wwise.RTPC 的 SetGlobalValue/SetValue 或 AkSoundEngine.SetRTPCValue 控制实时参数,支持插值;使用 AK.Wwise.State 与 AK.Wwise.Switch 切换音频状态与开关;通过 AkGameObj、RegisterGameObj、SetDefaultListeners 配置空间音频与听者;使用 AkRoom 配置混响与透射损失;通过回调处理 AK_EndOfEvent、AK_Marker 等事件,实现音频与动画、特效同步;提供音量线性值转 dB 的换算与静音控制。
使用方式:在 Unity 中为对象挂载 AkGameObj 并注册游戏对象,加载所需 SoundBank 后调用事件 Post;需要同步时传入回调类型与回调函数;需要动态变化时设置 RTPC 值;需要切换环境时设置 State 或 Switch。示例代码展示了异步加载、异步播放等待、对象池化音频发射器与批量事件投递等模式。
适用场景:游戏音效与音乐播放、动态音频参数控制、3D 空间音频、音频状态管理、按场景加载与卸载音频库。
限制与注意事项:资料未提供具体安装命令、版本要求、收费信息或平台支持范围;需先加载 Init bank,事件发布前需注册游戏对象,销毁时需注销以避免内存泄漏;建议使用回调同步、池化音频发射器、限制每帧事件数量、使用 RTPC 插值并管理音频库内存。常见问题包括无声音、事件未找到、RTPC 不生效、3D 音频异常、内存问题与爆音,需检查音频库加载、对象注册、名称匹配与采样率等。