Wwise SDK 2023.1.6
|
一般情况下都会默认启用 Wwise Authoring API。不过,最好在开始使用前查看下相应偏好设置。藉此检查重要的安全设置,并确认是否启用了 Wwise Authoring API:
启用 Wwise Authoring API:
接下来就可以开始使用 WAAPI 了。
因为 WAAPI 允许您远程控制 Wwise,所以它必须在安全的环境中使用,这样才能防止其他人获取您电脑的控制权。假如没有正确配置,可能会出现安全风险。
![]() | 备注: 假如通过浏览器连接 WAAPI,必须同时添加 Web 服务器的 IP 地址和源端口,才允许连接到主机。 请参阅 防止跨地域脚本 。 |
WAAPI 提供了 WAMP 和 HTTP 的两个端口(默认:8080 and 8090)。为了进一步提升安全性,建议通过使用防火墙来阻止远程计算机访问这些端口。假如想要允许远程计算机访问 WAAPI,建议将其逐一添加到白名单中,而不要直接允许所有远程连接。
在默认情况下,WAAPI 仅允许来自本地主机 (127.0.0.1 或 ::1) 的连接。
除非在 User Preferences 中添加远程计算机的 IP 地址,否则会无法通过其访问 WAAPI。允许特定 IP 地址连接 WAAPI:
![]() | 注意: 您可以通过添加 * 来允许来自任意 IP 地址的连接。但是这样做并不安全,因此我们不建议这样做。 |
WAAPI 针对跨地域脚本提供了安全层。如果没有安全层,则当您访问含有 JavaScript 代码的网页时,该代码理论上可通过从加载的网页上连接来获取 Wwise 的控制权。在这一情境下,防火墙是不够的。
这个 WAAPI 安全层依赖于您的浏览器安全设置。默认情况下,WAAPI 只接受两种连接:要么是本地软件的连接,要么是在浏览器中打开本地文件系统上的 HTML 文件时的连接。
在别的主机(host)加载的网页中使用 WAAPI 会导致失败,除非您将该主机添加到了 User Preferences 中。将一个主机添加为 WAAPI 有效来源的方法是:
![]() | 注意: 您可以添加 * 来允许来自任意来源网页的连接。但是这样做并不安全,因此我们不建议这样做。 |
请参阅 使用命令行 了解通过命令行使用“-Waapi”命令的更多信息。
![]() | 备注: 使用多客户端 WAAPI 支持同时多个连接的使用。目前 WAAPI 接受的最大连接数是 20 个采用 WAMP 的连接,再加上 20 个采用 HTTP POST 的连接。 |
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。