版本
menu

Wwise Unity Integration Documentation
Wwise Browser

The Wwise Browser window shows the available objects (such as Events and Switches) from your Wwise project, using the same structure. The project displayed in the Wwise Browser view is based on the Generated SoundBanks and your Wwwise Project. 通常,会在 Unity 中安装 Wwise 插件时指定该工程。

Wwise Browser Columns

The Wwise Browser is separated into two columns, which are described in the following sections.

The Name column recreates the hierarchy of the project as it exists in the SoundBanks and displays the name of the Wwise Items. It prioritises the name found in the Generated SoundBanks over the name in Wwise if the names are different.

Status Column

The Status Column compares the Wwise Project to the Generated SoundBanks and provides information about the differences between the two. For this column to work properly, the Wwise Browser must be connected to WAAPI.

  • New in Wwise: The Wwise Project has the information but the SoundBanks do not. Generating the SoundBanks creates the item in the SoundBanks and changes this column to SoundBank Up to Date.
  • Deleted in Wwise: The SoundBanks have the item information but Wwise does not. Generating the SoundBanks removes the item from the Wwise Browser or, if a UAsset of the item exists, changes the column to Not in Wwise or SoundBank.
  • Renamed in Wwise: The Wwise Project and the SoundBanks have the same item but with different names. Generating the SoundBanks renames the item inside the SoundBanks to match the name in Wwise.
  • SoundBank needs Update: The item in Wwise and the SoundBanks do not have the same ID.
  • Moved in Wwise: The item exists in both Wwise and the SoundBank, but in a different location in each. Generating the SoundBanks moves the item to the same location it is in Wwise and changes this column to SoundBank Up to Date. Items with this label are shown where they are according to the SoundBanks in the Wwise Browser.
  • SoundBank Up to Date: The name and ID of the item are the same in the Wwise Project and in the SoundBanks.

Adding Audio to your Scenes with the Browser

To add any object from the Wwise Browser to your scene, drag the object onto an existing Game Object or into the Inspector window. 有关各个组件的详细信息,请分别参阅组件的文档:

  • 拖放一个 Event 将创建一个 AkAmbient
  • 拖放一个 SoundBank 将创建一个 AkBank
  • 拖放一个 Switch Value 将创建一个 AkSwitch
  • 拖放一个 State Value 将创建一个 AkState
  • 拖放一条 Aux Bus 将创建一个 AkEnvironment

搜索和浏览

To find a specific item, type the name in the filter box near the top of the Wwise Browser. The items in the list are filtered to match the text.

You can filter Wwise objects to reduce the number of objects displayed in the Browser. There are two categories of filtering: SoundBank Status and Types. The SoundBank Status filters on the “Status” column and Types filters on the Wwise item type. When you select a filter, all Wwise objects that do not satisfy the condition are filtered out of the Wwise Browser.

您可以通过单击 + 和 - 按钮或双击项目名称来展开和关闭项目。 此外,还可使用键盘上的方向键来选择和展开条目。

如果您要寻找的对象有一个关闭了的父级,那么可能需要展开一些项。

生成 SoundBank

单击 Generate SoundBanks,为所有平台和语言生成全部的 SoundBank。 The generated SoundBanks will appear under the Wwise Browser's SoundBanks folder, the same as if they were generated from within Wwise. 此外,Unity 状态栏还会根据具体情况显示以下消息:

  • WwiseUnity: SoundBanks generation successful(如无错误或警告);
  • WwiseUnity: SoundBanks generation has warning(s) (如有警告);
  • WwiseUnity: SoundBanks generation error(如有错误)。 点击消息,将焦点移动到 Console 选项卡,该选项卡显示来自 SoundBank 生成过程的信息。

Finding References in Scenes

You can use the Wwise Browser to find all GameObjects that contain references to a specified Wwise object.

To find references to a Wwise object in a scene:

Do one of the following: Right-click the object and select the option to find references. Select the object and press Shift+R

A custom search appears in the Hierarchy window, which lists GameObjects that contain a reference to the Wwise object.

WAAPI 功能

When connected to the Wwise Authoring, modifications to the Wwise project are immediately reflected in the Browser window. If you copy, rename, delete, or move an object in the Wwise Project Explorer, the contents of the Browser window will be updated. There are also many additional features available when right clicking items in the Browser window:

同步选择

The Autosync selection option under the Wwise Integration in the Project Settings lets you decide whether you want your selection to be synchronized across Unity and Wwise authoring. 这样便于在程序之间快速过渡,因为最后选中的条目是一样的。

Event 播放

To audition an event, right-click it in the Wwise Browser and click Play/Stop.

If multiple events are playing, you can right-click any item in the Browser and select Stop All.

打开包含该内容的文件夹

The Open Containing Folder option in the shortcut menu opens the folder that contains the Wwise object's Work Unit in the file explorer.

刷新工程

In Wwise Authoring mode, clicking the Refresh button will clear the browser window refetch the project contents using WAAPI.

连接状态

Connection status and any error messages resulting from unsuccessful WAAPI request will be displayed in the upper-right corner of the Wwise Browser Window.

有关如何针对工程设置 WAAPI 的详细信息,请参阅 WAAPI 实用工具 页面。 If WAAPI is enabled but the Unity project is not able to successfully open the websocket connnection, a specific error message will be displayed in the Wwise Browser window.

连接错误消息:

  • 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 秒。


此页面对您是否有帮助?

需要技术支持?

仍有疑问?或者问题?需要更多信息?欢迎联系我们,我们可以提供帮助!

查看我们的“技术支持”页面

介绍一下自己的项目。我们会竭力为您提供帮助。

来注册自己的项目,我们帮您快速入门,不带任何附加条件!

开始 Wwise 之旅