目录

Wwise SDK 2018.1.11
初始化 Wwise Authoring API

根据您选择的协议和语言不同,运行 Wwise Authoring API(WAAPI)时也会不同。 但是无论如何,您需要先运行 Wwise 并启用 Wwise Authoring API 才能使用它:

  • 在 Wwise 中,选择 Project > User Preferences。(默认快捷键:Shift + U)
  • Wwise Authoring API 组框中,选择 Enable(启用) Wwise Authoring API
  • 单击 OK

这就意味着您现在可以写些 WAAPI 代码了。但是,首先,请您先确保检查了 Network Security(网络安全)!

网络安全

因为 WAAPI 允许您远程控制 Wwise,所以它必须在安全的环境中使用,这样才能防止其他人获取您电脑的控制权。

Note: 假如通过浏览器连接 WAAPI,必须同时添加 Web 服务器的 IP 地址和源端口,才允许连接到主机。 请参阅 防止跨地域脚本

阻止访问 WAAPI 端口

WAAPI 提供了 WAMP 和 HTTP 的两个端口(默认:8080 and 8090)。这些端口需要在您的防火墙中来阻止,无论是直接在您自己的机器上还是在您公司的防火墙设置中(如果您想在 LAN 上使用 WAAPI)。

仅允许特定 IP 地址访问 WAAPI

在默认情况下,WAAPI 仅允许来自本地主机 (127.0.0.1) 的连接。

因此,要想从其他主机连接 WAAPI,必须在 User Preferences(用户首选项)中添加相应的 IP 地址。允许特定 IP 地址连接 WAAPI:

  • 从 Wwise 主菜单点击 Project > User Preferences
  • Allow connections from(允许来自以下位置的连接)字段中添加 IP 地址。例如:
    • 203.0.113.255
  • 单击 OK。
Caution: 您可以通过添加 * 来允许来自任意 IP 地址的连接。但是这样做并不安全,因此我们不建议这样做。

防止跨地域脚本

WAAPI 针对跨地域脚本提供了安全层。如果没有安全层,则当您访问含有 JavaScript 代码的网页时,该代码理论上可通过从加载的网页上连接来获取 Wwise 的控制权。在这一情境下,防火墙是不够的。

这个 WAAPI 安全层依赖于您的浏览器安全设置。默认情况下,WAAPI 只接受两种连接:要么是本地软件的连接,要么是在浏览器中打开本地文件系统上的 HTML 文件时的连接。

在别的主机(host)加载的网页中使用 WAAPI 会导致失败,除非您将该主机添加到了 User Preferences 中。将一个主机添加为 WAAPI 有效来源的方法是:

  • 从 Wwise 主菜单点击 Project > User Preferences
  • 将您的主机 URI 添加到 Allow browser connections from origins 字段。例如:
  • 单击 OK。
Caution: 您可以添加 * 来允许来自任意来源网页的连接。但是这样做并不安全,因此我们不建议这样做。

请参阅 使用命令行 了解通过命令行使用“-Waapi”命令的更多信息。

Note: 使用多客户端

WAAPI 支持同时多个连接的使用。目前 WAAPI 接受的最大连接数是 20 个采用 WAMP 的连接,再加上 20 个采用 HTTP POST 的连接。

在 Mac 上使用 WAAPI

WAAPI 采用 Windows 样式的路径访问文件。在 Windows 上,根文件夹使用 \ 符号(以驱动器 Z 为例);在 Mac 上,主文件夹使用 / 符号(以驱动器 Y 为例)。比如,若要在 Mac 上加载工程 Y:/Volumes/path/to/MyProject.wproj,必须使用路径 Z:\Volumes\path\to\MyProject.wproj。

如有疑问,请在 Wwise 中的 Recent Projects(最近打开的工程)下查看显示的工程路径。

下一步

您现在可以根据 WAAPI 示例 来试试 WAAPI,这些示例给您展现了如何用您偏好的语言和协议使用 WAAPI。

参见