목차

Wwise SDK 2019.2.0
Preparing to use the Wwise Authoring API

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:

  • Wwise에서, Project > User Preferences를 선택합니다. (기본 단축키: Shift + U)
  • Wwise Authoring API 그룹 상자에서 Enable Wwise Authoring API를 선택합니다.
  • OK를 클릭하세요.

This means you can now use WAAPI.

Network Security

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.

참고: 브라우저를 통해 WAAPI로 연결할 경우, IP 주소와 웹 서버 오리진 둘 다 허용되는 연결에 대해서 추가돼있어야 합니다. Preventing Cross-Site Scripting 을 참고하세요.

Blocking access to WAAPI ports

WAAPI는 WAMP와 HTTP에 대한 두 개의 포트 접근을 제공합니다. (기본값: 8080과 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.

Restricting access to WAAPI to specific IP addresses

기본 설정으로 WAAPI는 로컬 호스트에서 오는 연결만 허용하게 돼있습니다 (127.0.0.1 또는 ::1).

Accessing WAAPI from a remote computer will therefore fail, unless you add its IP address in the User Preferences. 특정 IP 주소를 WAAPI에 연결할 수 있도록 허용하는 방법은 다음과 같습니다.

  • Wwise 메인 메뉴에서 Project > User Preferences를 클릭합니다.
  • Allow connections from 영역에 원하는 IP 주소를 추가합니다. 예시:
    • 203.0.113.255, IPv4 주소 사용. 또는,
    • 2001:db8::, IPv6 주소 사용.
  • OK 를 클릭합니다.
경고: *를 입력해 어떤 IP 주소든 모두 허용할 수도 있습니다. 그러나 안전하지 않은 방법이므로 권장하지 않습니다.

Preventing Cross-Site Scripting

WAAPI는 사이트 간 스크립팅 방지를 위한 보안 기능을 제공합니다. 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. 만약 이런 경우 방화벽만으로는 충분하지 않습니다.

이러한 WAAPI 보안 기능은 사용자의 브라우저 보안 설정을 기반으로 하고 있습니다. 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.

즉 사용자 환경 설정에서 호스트를 추가하기 않는 이상, 다른 호스트로부터 로드한 웹사이트에서 WAAPI를 사용하는 것은 불가능합니다. WAAPI에 대한 유효한 서버 오리진으로 호스트를 추가하는 방법은 다음과 같습니다.

  • Wwise 메인 메뉴에서 Project > User Preferences를 클릭합니다.
  • 원하는 호스트 URI를 Allow browser connections from origins 영역에 추가합니다. 예시:
  • OK 를 클릭합니다.
경고: *를 입력해 어떤 오리진의 웹사이트든 모두 허용할 수도 있습니다. 그러나 안전하지 않은 방법이므로 권장하지 않습니다.

명령줄에서 "-Waapi" 명령을 사용하는 방법에 대한 자세한 정보는 Using the Command Line 를 참고하세요.

참고: 둘 이상의 클라이언트 사용하기

WAAPI는 여러 동시 연결 사용을 지원합니다. WAAPI로 활성화된 연결의 현재 최대 개수는 WAMP에 대해서 20개, 그리고 그와 별도로 HTTP POST에 대해서 20개입니다.

Using WAAPI on Mac

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.

Next Steps

이제 WAAPI 예제 중 하나를 참고해 WAAPI를 사용해볼 수 있습니다. 자신이 원하는 언어와 프로토콜에서 WAAPI를 실행하는 방법에 대해 자세히 알아보세요.

참고