目录
Wwise SDK 2018.1.11
|
使用 Wwise Authoring API(WAAPI)
Wwise Authoring API 是用于与 Wwise 设计工具通信的。API 中可用的功能让客户端能 执行一些任务,包括:
- Wwise 工程修改,如:
- 获取对象和它们的信息
- 设置对象的信息
- 创建新对象
- 常见操作,如:
- 导入音频文件
- 生成 SoundBanks
- 转码音频文件
- 播放 Wwise 对象
- 用户界面的访问和控制,如:
- 打开视图
- 访问当前选中内容并对它们进行改动
- 察看对象
- SoundEngine 方面的用途,如:
- 创建游戏对象并设置位置
- 发送事件
- 设置 Game Parameter(游戏参数)值、Switches(切换开关)和 States(状态)
使用
Wwise Authoring API 可以和以下项目集成:
- 游戏引擎
- 对话管理管线
- 用于声音设计、编辑、对话录音或音乐制作的 DAW
The Wwise Authoring API 可以用于:
- 任务自动化,如导入音频文件或创建 Wwise 对象
- 在移动设备上远程控制 Wwise
- 实现自定义 Wwise 界面
协议
Wwise Authoring API 可通过两个不同的协议访问:
- WAMP:WAMP 旨在连接分布式应用中的应用组件。WAMP 使用 WebSocket 作为其默认传输方式,允许有序、可靠、双向、信息为导向的通信。 WAMP 允许客户端使用 JSON 参数来调用函数并获取结构性 JSON 结果。WAMP 也允许客户端订阅通知。
- HTTP POST:HTTP 是分布式应用的一种应用协议。HTTP 是在互联网上传输内容的最常用手段。 POST 让调用者能发送一个文档主体,对于 Wwise Authoring API来说,这个文档就像 JSON 一样,对应函数参数。HTTP 的响应就是 JSON 结果。
这两个协议可以在各种语言下使用,如 C++、C#、JavaScript、Python,以及其他支持 HTTP 或 WebSocket 的语言。
![]() |
Note: WAMP 是一种开放式的标准 WebSocket 子协议,它可以提供统一的应用程序路由。WAMP 支持大部分常用编程语言。如需进一步了解 WAMP,请转到 https://wamp-proto.org。 |
![]() |
Note: WAMP 能提供最佳的性能和体验,因为它会为整个会话重复使用同样的 WebSocket 连接,并且能提供双向通信。 |
总的来说,协议支持以下特性:
API 特性 | WAMP | HTTP POST |
远程程序调用 用来在 Wwise Authoring 上远程调用功能 |
支持 | 支持 |
发布 & 订阅 当 Wwise 设计工具中出现变更时用来接收通知。 |
支持 | 不<span>支持 |
最佳性能 | 是 | 否 |
阅读更多关于特定话题的内容:
- 初始化 Wwise Authoring API
- WAAPI 示例
- 查询 Wwise 工程
- 订阅 Wwise Authoring API 中的话题
- 导入音频文件和创建架构
- 在 Wwise 插件中使用 Wwise Authoring API
参阅 Wwise Authoring API 参考文档中的以下话题: