|
Wwise SDK 2023.1.3
|
一般情况下都会默认启用 Wwise Authoring API。不过，最好在开始使用前查看下相应偏好设置。藉此检查重要的安全设置，并确认是否启用了 Wwise Authoring API：
启用 Wwise Authoring API：
- 在 Wwise 中，选择 Project > User Preferences。（默认快捷键：Shift + U）
- 在 Wwise Authoring API 组框中，选择 Enable（启用） Wwise Authoring API。
- 单击 OK。
接下来就可以开始使用 WAAPI 了。
网络安全
因为 WAAPI 允许您远程控制 Wwise，所以它必须在安全的环境中使用，这样才能防止其他人获取您电脑的控制权。假如没有正确配置，可能会出现安全风险。
 | 备注: 假如通过浏览器连接 WAAPI，必须同时添加 Web 服务器的 IP 地址和源端口，才允许连接到主机。 请参阅 防止跨地域脚本 。 |
阻止访问 WAAPI 端口
WAAPI 提供了 WAMP 和 HTTP 的两个端口（默认：8080 and 8090）。为了进一步提升安全性，建议通过使用防火墙来阻止远程计算机访问这些端口。假如想要允许远程计算机访问 WAAPI，建议将其逐一添加到白名单中，而不要直接允许所有远程连接。
仅允许特定 IP 地址访问 WAAPI
在默认情况下，WAAPI 仅允许来自本地主机 (127.0.0.1 或 ::1) 的连接。
除非在 User Preferences 中添加远程计算机的 IP 地址，否则会无法通过其访问 WAAPI。允许特定 IP 地址连接 WAAPI：
- 从 Wwise 主菜单点击 Project > User Preferences。
- 在 Allow connections from（允许来自以下位置的连接）字段中添加 IP 地址。例如：
- 203.0.113.255（使用 IPv4 地址）
- 2001:db8::（使用 IPv6 地址）
- 单击 OK 。
 | 注意: 您可以通过添加 * 来允许来自任意 IP 地址的连接。但是这样做并不安全，因此我们不建议这样做。 |
防止跨地域脚本
WAAPI 针对跨地域脚本提供了安全层。如果没有安全层，则当您访问含有 JavaScript 代码的网页时，该代码理论上可通过从加载的网页上连接来获取 Wwise 的控制权。在这一情境下，防火墙是不够的。
这个 WAAPI 安全层依赖于您的浏览器安全设置。默认情况下，WAAPI 只接受两种连接：要么是本地软件的连接，要么是在浏览器中打开本地文件系统上的 HTML 文件时的连接。
在别的主机（host）加载的网页中使用 WAAPI 会导致失败，除非您将该主机添加到了 User Preferences 中。将一个主机添加为 WAAPI 有效来源的方法是：
- 从 Wwise 主菜单点击 Project > User Preferences。
- 将您的主机 URI 添加到 Allow browser connections from origins 字段。例如：
- http://www.myhost.com，使用端口 80；或
- http://www.myhost.com:1234，不使用默认的 80，而是 1234。
- 单击 OK 。
| 注意: 您可以添加 * 来允许来自任意来源网页的连接。但是这样做并不安全，因此我们不建议这样做。 |
请参阅 使用命令行 了解通过命令行使用“-Waapi”命令的更多信息。
| 备注: 使用多客户端 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。