menu
版本
2024.1.4.8780
2024.1.4.8780
2023.1.12.8706
2022.1.18.8567
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
2024.1.4.8780
2023.1.12.8706
2022.1.18.8567
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
Wwise Unity Integration Documentation
|
Wwise Picker 窗口将用同样的结构来显示您的 Wwise 工程中可用的对象(如 Events 和 Switches)。 Wwise Picker 视图中显示的工程与 Wwise Settings 窗口 (Edit > Project Settings > Wwise Integration) 中输入的工程相同。 通常,会在 Unity 中安装 Wwise 插件时指定该工程。
自 2021.1 版本起,Wwise Picker 包含两种模式:File System 和 Wwise Authoring。您可以使用 Picker 窗口左上角的菜单更改所述模式。
在 File System 模式下,会在保存 Wwise 工程时更新 Wwise Picker 视图中的可用对象。 若未显示所创建的对象,有可能是没有保存工程。 通过单击 Refresh Project,您可以强制刷新 Wwise
Picker 视图。 注意,这也刷新了所有与 Wwise 相关的数据,包括在生成 SoundBank 时创建的 XML 元数据文件中的数据。
info | 备注: | 请不要将 AkWwiseProjectData.asset添加到版本控制系统中! 它只是 Wwise 工程数据的临时缓存文件,目的在于避免 Wwise Picker 反复解析 Work Unit 文件。假如将其添加到版本控制系统中,可能会 出现问题。 |
info | 备注: | 在 Wwise Settings 对话框中,必须指定 Wwise Windows Installation Path(或者 Mac 上的 Wwise Application )。当在 Unity 中点击 Generate SoundBanks 时,Unity 需要用到 Wwise 的路径。 |
在 Wwise Authoring 模式下,Picker 使用 WAAPI 与 Wwise 中打开的工程进行通信。除 File System 模式下可用的功能外,该模式还提供以下功能:
warning | 注意: 为确保此模式能够正常运行,须在 Wwise 设计工具中打开 Wwise 工程,并正确配置 WAAPI 设置。 有关如何针对工程设置 WAAPI 的详细信息,请参阅 WAAPI 实用工具 页面。 |
以下章节所述功能在 File System 和 Wwise Authoring 模式下均可使用。
若要将 Wwise Picker 中的任何对象添加到您的场景中,要将对象拖拽到现有的 Game Object 上 或 Inspector 窗口中。 有关各个组件的详细信息,请分别参阅组件的文档:
使用 Wwise Picker 顶部附近的筛选器框来搜索特定的项。 只要写下您要找的东西的名字,然后 Picker 会自动过滤掉那些与您的搜索不匹配的条目。
您可以通过单击 + 和 - 按钮或双击项目名称来展开和关闭项目。 此外,还可使用键盘上的方向键来选择和展开条目。
如果您要寻找的对象有一个关闭了的父级,那么可能需要展开一些项。
单击 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 对象的 Wwise 组件时,现在 Picker 中会显示用于选择对象的菜单选项。这样可以在 Picker 窗口中高亮显示被引用的对象。
在 Wwise Authoring 模式下,Picker 窗口中会即时反映对 Wwise 对象所作的修改。 若在 Wwise Project Explorer 中复制、重命名、删除或移动对象,则 Picker 窗口的内容将同步发生变化。 在 Picker 窗口中右键单击条目时,还可选用很多其他功能:
Autosync selection 选项允许设定是否在 Unity 和 Wwise 设计工具之间同步所作选择。 这样便于在程序之间快速过渡,因为最后选中的条目是一样的。
您可以在 WAAPI Picker 中右键单击并试听 Event。 在启动后,还可使用同一选项来停止当前正在播放的 Event。
快捷方式:空格键或快速双击。
若忘记当前都在播放哪些 Event,可在 Picker 中右键单击任意条目,然后选择 Stop All。
您可以在 Picker 窗口内从快捷菜单选择相应选项来重命名 Wwise 对象。
快捷方式:F2 或慢速双击。
info | 备注: | 无法重命名 Work Unit 或 Physical Folder。 |
快捷菜单中的 Open Containing Folder 选项允许在文件资源管理器中打开 Wwise 对象的 Work Unit 所在的文件夹。
快捷方式:Ctrl + O
若所选条目为 SoundBank,则会显示用于打开 SoundBank 文件夹的附加选项。这样可打开文件资源管理器并转到与 Wwise 设计工具中当前激活平台对应的 Generated SoundBanks 文件夹。
info | 备注: | 若尚未生成 SoundBank,则将打开操作系统的根目录。 |
在 Wwise Authoring 模式下,若单击 Refresh 按钮,则将清空 Picker 窗口,并使用 WAAPI 重新获取工程内容。
Wwise Picker 窗口的右上角会显示连接状态以及因 WAAPI 请求失败而产生的错误消息。
有关如何针对工程设置 WAAPI 的详细信息,请参阅 WAAPI 实用工具 页面。 若启用了 WAAPI 但 Unity 工程无法成功打开 WebSocket 连接,则 Wwise Picker 窗口中将显示相应的错误消息。
连接错误消息:
其他错误消息:
在每次连接失败后,Unity Integration 都会在 2^N 秒后尝试重新连接。其中 N 为尝试连接失败的次数。此等待时间最多不会超过 32 秒。