|
Wwise Unity Integration Documentation
|
Wwise Picker 窗口将用同样的结构来显示您的 Wwise 工程中可用的对象（如 Events 和 Switches）。 Wwise Picker 视图中显示的工程与 Wwise Settings 窗口 (Edit > Project Settings > Wwise Editor) 中输入的工程相同。 通常，会在 Unity 中安装 Wwise 插件时指定该工程。
自 2021.1 版本起，Wwise Picker 包含两种模式：File System 和 Wwise Authoring。您可以使用 Picker 窗口左上角的菜单更改所述模式。
在 File System 模式下，会在保存 Wwise 工程时更新 Wwise Picker 视图中的可用对象。 若未显示所创建的对象，有可能是没有保存工程。 通过单击 Refresh Project，您可以强制刷新 Wwise Picker 视图。 注意，这也刷新了所有与 Wwise 相关的数据，包括在生成 SoundBank 时创建的 XML 元数据文件中的数据。
 |
备注： | 请不要将 AkWwiseProjectData.asset添加到版本控制系统中！ 它只是 Wwise 工程数据的临时缓存文件，目的在于避免 Wwise Picker 反复解析 Work Unit 文件。假如将其添加到版本控制系统中，可能会 出现问题。 |
|
备注： | 在 Wwise Settings 对话框中，必须指定 Wwise Windows Installation Path（或者 Mac 上的 Wwise Application ）。当在 Unity 中点击 Generate SoundBanks 时，Unity 需要用到 Wwise 的路径。 |
在 Wwise Authoring 模式下，Picker 使用 WAAPI 与 Wwise 中打开的工程进行通信。除 File System 模式下可用的功能外，该模式还提供以下功能：
- 在 Wwise 设计工具中实施修改时立即更新可用对象。
- 在 Picker 内播放声音 Event。
- 在 Unity 和 Wwise 之间同步所作选择。
- 在 Unity 内重命名和删除 Wwise 对象。
 |
注意： 为确保此模式能够正常运行，须在 Wwise 设计工具中打开 Wwise 工程，并正确配置 WAAPI 设置。 有关如何针对工程设置 WAAPI 的详细信息，请参阅 WAAPI 实用工具 页面。 |
功能
以下章节所述功能在 File System 和 Wwise Authoring 模式下均可使用。
使用 Picker 在您的场景中添加音频
若要将 Wwise Picker 中的任何对象添加到您的场景中，要将对象拖拽到现有的 Game Object 上 或 Inspector 窗口中。 有关各个组件的详细信息，请分别参阅组件的文档：
- 拖放一个 Event 将创建一个 AkAmbient 。
- 拖放一个 SoundBank 将创建一个 AkBank 。
- 拖放一个 Switch Value 将创建一个 AkSwitch 。
- 拖放一个 State Value 将创建一个 AkState 。
- 拖放一条 Aux Bus 将创建一个 AkEnvironment 。
搜索和浏览
使用 Wwise Picker 顶部附近的筛选器框来搜索特定的项。 只要写下您要找的东西的名字，然后 Picker 会自动过滤掉那些与您的搜索不匹配的条目。
您可以通过单击 + 和 - 按钮或双击项目名称来展开和关闭项目。 此外，还可使用键盘上的方向键来选择和展开条目。
如果您要寻找的对象有一个关闭了的父级，那么可能需要展开一些项。
生成 SoundBank
单击 Generate SoundBanks，为所有平台和语言生成全部的 SoundBank。 生成的 SoundBank 将出现在 Wwise Picker 的 SoundBanks 文件夹下，如同是从 Wwise 中生成的一样。 此外，Unity 状态栏还会根据具体情况显示以下消息：
-
WwiseUnity: SoundBanks generation successful（如无错误或警告）； -
WwiseUnity: SoundBanks generation has warning(s)（如有警告）； -
WwiseUnity: SoundBanks generation error（如有错误）。 点击消息，将焦点移动到Console选项卡，该选项卡显示来自 SoundBank 生成过程的信息。
在场景中查找引用
在 Picker 中右键单击 Wwise 对象时，可选择相应选项以在场景中查找引用。 这样会将自定义搜索添加到 Hierarchy 窗口中，并单独列出包含 Wwise 对象引用的 GameObject。 除此之外，也可通过选中条目并按下 Shift + R 来实现此操作。
自动填充
Auto Populate 选项只在 File System 模式下显示。若启用，则一旦在 Wwise 工程文件中检测到更改（一般会在保存工程时触发此操作），Picker 便会马上更新其内容。 若禁用，则须单击 Refresh Project 按钮来更新 Picker 内容。
在 Wwise Picker 中选择对象
在右键单击引用 Wwise 对象的 Wwise 组件时，现在 Picker 中会显示用于选择对象的菜单选项。这样可以在 Picker 窗口中高亮显示被引用的对象。
WAAPI 功能
在 Wwise Authoring 模式下，Picker 窗口中会即时反映对 Wwise 对象所作的修改。 若在 Wwise Project Explorer 中复制、重命名、删除或移动对象，则 Picker 窗口的内容将同步发生变化。 在 Picker 窗口中右键单击条目时，还可选用很多其他功能：
同步选择
Autosync selection 选项允许设定是否在 Unity 和 Wwise 设计工具之间同步所作选择。 这样便于在程序之间快速过渡，因为最后选中的条目是一样的。
Event 播放
您可以在 WAAPI Picker 中右键单击并试听 Event。 在启动后，还可使用同一选项来停止当前正在播放的 Event。
快捷方式：空格键或快速双击。
若忘记当前都在播放哪些 Event，可在 Picker 中右键单击任意条目，然后选择 Stop All。
重命名 Wwise 对象
您可以在 Picker 窗口内从快捷菜单选择相应选项来重命名 Wwise 对象。
快捷方式：F2 或慢速双击。
|
备注： | 无法重命名 Work Unit 或 Physical Folder。 |
打开包含该内容的文件夹
快捷菜单中的 Open Containing Folder 选项允许在文件资源管理器中打开 Wwise 对象的 Work Unit 所在的文件夹。
快捷方式：Ctrl + O
打开 SoundBank 文件夹
若所选条目为 SoundBank，则会显示用于打开 SoundBank 文件夹的附加选项。这样可打开文件资源管理器并转到与 Wwise 设计工具中当前激活平台对应的 Generated SoundBanks 文件夹。
|
备注： | 若尚未生成 SoundBank，则将打开操作系统的根目录。 |
刷新工程
在 Wwise Authoring 模式下，若单击 Refresh 按钮，则将清空 Picker 窗口，并使用 WAAPI 重新获取工程内容。
连接状态
Wwise Picker 窗口的右上角会显示连接状态以及因 WAAPI 请求失败而产生的错误消息。
有关如何针对工程设置 WAAPI 的详细信息，请参阅 WAAPI 实用工具 页面。 若启用了 WAAPI 但 Unity 工程无法成功打开 WebSocket 连接，则 Wwise Picker 窗口中将显示相应的错误消息。
连接错误消息：
- Connection refused
- 原因为没有打开工程。
- 原因为在 Unity 或 Wwise WAAPI 设置中指定了错误的端口/IP地址。
- 原因为在 Wwise 设计工具的 User Preferences 中禁用了 WAAPI。
- The wrong project is open in Wwise
- 确保打开了正确的工程。
- No project is open in Wwise yet
- 确保已打开工程。
其他错误消息：
- Cannot execute call because Wwise has an exclusive lock
- 原因为在 Wwise 设计工具中打开了模式或设置窗口。
在每次连接失败后，Unity Integration 都会在 2^N 秒后尝试重新连接。其中 N 为尝试连接失败的次数。此等待时间最多不会超过 32 秒。