|
Wwise Unity Integration Documentation
|
关于 Unity Addressables
Unity Addressables 是一个围绕 AssetBundle 构建的系统，用于将游戏素材与玩家内容分开打包。 该系统在 DLC 开发当中特别有用，方便将额外的素材存储到外部服务器上。
对于刚开始使用 Addressables 的用户，建议先参阅官方文档和相关教程。
要设置 Wwise Unity Addressables Package，建议从这里开始：
以下章节介绍了如何使用 Wwise Addressables Package：
 |
注意： 此 Package 为实验包。 作为 Unity Integration 的新增功能，对 Addressables 的支持可能会有变更。 |
|
注意： 不支持 Unity 2018。 鉴于在 Unity 2018 中使用外部包比较容易出现问题，我们不保证此数据包能在 2019 之前的 Unity 版本中正常使用。 |
Addressables 系统特别注意事项
在使用 Addressables 系统时应特别注意以下事项：
- “使用 Addressables 加载素材”本身属于异步操作：倘若加载的 SoundBank 和发送的 Event 被关联到了同一 Trigger，有可能会出现问题。在需要精确设定 Event 时机的情况下，建议先加载 SoundBank，再触发关联 Event。Init Soundbank 是个特例，其必须在场景中的所有其他 SoundBank 之前加载。若以远程方式更新 Init Soundbank 素材，则在场景启动并加载 SoundBank 时会稍有延迟，因为要先使用 Addressables 从 Web 服务器获取新的 Init Soundbank。
- 不可在场景中直接引用 Addressables 素材：Addressables 素材必须使用 Addressables 系统在场景中动态加载。场景中直接引用的素材会构建到场景的 AssetBundle 中，而不会通过 Addressables 加载。若将素材直接放在场景中，同时使用 Addressables 打包该素材，则游戏数据中将会有两份不同的素材：场景的 AssetBundle 中一份，Addressables 分组的 AssetBundle 中一份。
已知问题和限制
- 工程中的所有平台必须共用同一 Generated SoundBanks Path 根目录。
- 在 Unity 工程中设置 Generated SoundBank Path 不会自动更改 External Source 的输出路径。
- 暂不支持保存和加载 Decoded SoundBank。
- 暂不支持 Prepared Event。
- 暂不支持 External Source。
Wwise Addressable 示例
Wwise Addressables 示例 页面提供有关如何参照代码示例管理 Wwise Addressables 素材的附加信息。
Wwise Addressables 素材详解
Wwise 素材导入程序
在创建后，由 WwiseBankImporter 和 WwiseStreamingAssetImporter 类处理 .bnk 和 .wem 文件。 此脚本会创建包含所述文件二进制数据的素材。随后，我们的自定义素材后处理程序 WwiseBankPostProcess 会将新素材添加到相应平台的 Addressables 分组。 接着，针对每个平台将 Init SoundBank 添加到其各自的 Addressables 分组。之所以分开添加 Init SoundBank，是因为在发布后对工程实施更改（比如添加新的音频总线）时必须予以更新。 通过将 Init SoundBank 打包到各自的 Addressables 素材包，我们可以最大限度地缩短使用托管服务获取新版素材所需的时间。 若想自定义要将素材添加到哪个 Addressables 分组以及将哪些标签应用于素材，请参阅 Wwise Addressables 示例 页面。
SoundBank 和 AddressableSoundBank
素材后处理程序还会为工程中的每个 SoundBank 创建一个 WwiseAddressableSoundBank。 此素材包含用来将平台名称映射到相应 SoundBank 和流播放媒体素材的词典。
- WwiseAddressableSoundBank 存放在 Generated SoundBanks 文件夹的根目录下。
- WwiseAddressableSoundBank 类使用 AssetReferenceT 指向 SoundBank 和媒体文件。
- 在构建工程时，将把 WwiseAddressableSoundBank 的 Current Platfrom Assets 字段设为目标构建平台。
|
注意： WwiseAddressableSoundBank 中 SoundBank 和流播放媒体的引用为软引用。这些文件将使用 Addressables 加载且必须打包到 Addressables 分组中。 |
|
注意： 若意外删除 WwiseAddressableSoundBank，则须删除并重新生成与之关联的 SoundBank，以便另行新建并正确设置引用。 |
Init Bank Holder
在针对 Init SoundBank 创建 WwiseAddressableSoundBank 时，将向场景中的 “WwiseGlobal” GameObject 添加 InitBankHolder 组件。 此组件只是简单地存储 WwiseAddressableSoundBank 以便 AddressableBankManager 轻松找到它。
Addressable Bank Manager
在使用 Wwise Addressables 时，由 AkAddressableBankManager 负责内存中 SoundBank 的加载和卸载。此类会存储对正在和已经加载的 AddressableSoundBank 的引用，并确保始终最先加载 Init SoundBank。 若在完成加载 SoundBank 前触发了 AkEvent，则此类将存储所触发调用的参数，并在加载 SoundBank 后再次触发相应的 Event。
在加载 SoundBank 时，将通过 Addressables 加载与当前平台对应的 SoundBank 素材。一旦完成加载便会锁定 SoundBank 数据，并使用 AkSoundEngine.LoadBankMemoryCopy() 将内存副本加载到声音引擎中。
在 Editor 中进入游戏模式时，将使用 AssetDatabase 而非 Addressables 来同步加载 SounBank。也就是说，只能在构建好的游戏中测试异步加载。
WwiseBankReference
WwiseBankReference 类用在 Ak.Wwise.Bank 组件的自定义检视器中。 WwiseBankReference 包含对 WwiseAddressableSoundBank 的硬引用。 在通过 AkAssetUtilities.AddressableBankUpdated 委托创建 WwiseAddressableSoundBank Asset 时，会更新此引用。 若在 WwiseAddressableSoundBank 之后创建 WwiseBankReference ，则将在 SoundBanks 文件夹中搜索与 SoundBank 名称匹配的 WwiseAddressableSoundBank 素材。 序列化的 WwiseBankReference 存储在 Assets\Wwise\ScriptableObjects\SoundBank 下。
 |
备注： | 游戏对象直接引用的素材会随该游戏对象一并打包。 AkBank 组件包含对 WwiseBankReference 的硬引用，WwiseBankReference 则包含对对应 WwiseAddressableSoundBank 的硬引用。 若将带有 AkBank 组件的游戏对象放在 Addressables 分组中，则将随之一并打包 WwiseBankReference 和 WwiseAddressableSoundBank（无须显式添加到分组中）。 |
流播放媒体
流播放媒体（.wem 文件）同样由 WwiseBankImporter 脚本处理。 WwiseAddressableSoundBank 包含一系列对 SoundBank 关联平台专用流播放媒体素材的引用。 在加载 SoundBank 时会通过 Addressables 加载媒体素材，并将其复制到 the Application.persistentDataPath 文件夹中。 若文件夹中已存在同名文件，则对两者的哈希值进行比对。若两个文件不同，则使用 AssetBundle 中的文件加以覆盖。