Wwise SDK 2023.1.8
|
The Wwise Authoring API is normally enabled by default. We recommend you take a look at its preferences before you start. You will find important security settings, and you will be able to confirm that Wwise Authoring API is enabled:
To enable Wwise Authoring API:
This means you can now use WAAPI.
Since WAAPI allows you to control Wwise remotely, it must be used in a secure environment in order to prevent other people from gaining control of your computer. If it is not configured correctly, it could present a security risk.
Note: If you are connecting to WAAPI through a browser, both the IP address and origin of the web server must be added for the connection to be allowed. Refer to Preventing Cross-Site Scripting. |
WAAPI provides access to two ports for WAMP and HTTP (by default: 8080 and 8090). For greater security, we recommend you block remote computers from accessing those ports, by using a Firewall. If you wish to allow remote computers to access WAAPI, we recommend adding them in a white list, instead of allowing any remote connection.
By default, WAAPI will only accept connections coming from localhost (127.0.0.1 or ::1).
Accessing WAAPI from a remote computer will therefore fail, unless you add its IP address in the User Preferences. To allow an IP address to connect to WAAPI:
Caution: You can add * to allow connections from any IP address. But, this is insecure and, therefore, unrecommended. |
WAAPI provides a security layer against cross-site scripting. Otherwise, when you visit a webpage that contains JavaScript code, for example, that code could theoretically gain access to Wwise by connecting from the loaded webpage. In that scenario, the firewall is not enough.
This WAAPI security layer relies on your browser security settings. By default, WAAPI will only accept connections from local software or, in the case of browsers, only when opening HTML files on the local file system.
Using WAAPI in a webpage loaded from another host will fail, unless you add the host in the User Preferences. To add a host as a valid origin for WAAPI:
Caution: You can add * to allow connections from webpages of any origin. But, this is insecure and, therefore, unrecommended. |
See Using the Command Line for information on using "-Waapi" commands from the command line.
Note: Using Multiple Clients WAAPI supports usage from multiple connections at once. The current maximum number of active connections to WAAPI is 20 for WAMP, with another 20 for HTTP POST. |
WAAPI uses Windows-style paths to access files, with the root folder "/" represented by drive Z and the home folder drive Y. For example, in order to load project "/Volumes/path/to/MyProject.wproj", you must use path "Z:\Volumes\path\to\MyProject.wproj".
In case of doubt, you can refer to the project path as displayed in the recent projects in Wwise.
You can now try out WAAPI according to one of the WAAPI Samples, which show you how to get WAAPI running for your preferred language and protocol.
Questions? Problems? Need more info? Contact us, and we can help!
Visit our Support pageRegister your project and we'll help you get started with no strings attached!
Get started with Wwise