버전
menu_open
Wwise SDK 2023.1.8
Wwise 저작 API 사용 전 준비 사항

Wwise 저작 API (Wwise Authoring API)는 보통 기본으로 활성화돼있습니다. Wwise 저작 API를 시작하기 전에 환경 설정을 확인해볼 것을 권장합니다. 중요한 보안 설정과 함께 Wwise 저작 API가 활성화돼있는지 확인할 수 있습니다.

Wwise 저작 API를 활성화하기 위해서는 다음과 같이 실행합니다.

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

이제 WAAPI를 사용할 수 있게 되었습니다.

네트워크 보안

WAAPI를 이용하면 Wwise를 원격으로 제어할 수 있게 되기 때문에 다른 사용자가 자신의 컴퓨터를 제어하지 못하도록 안전한 환경에서 사용해야 합니다. 올바르게 설정되지 않으면 보안 위험성이 따릅니다.

참고: 브라우저를 통해 WAAPI로 연결할 경우, IP 주소와 웹 서버 오리진 둘 다 허용되는 연결에 대해서 추가돼있어야 합니다. 사이트 간 스크립팅 방지 을 참고하세요.

WAAPI 포트 접근 차단

WAAPI는 WAMP와 HTTP에 대한 두 개의 포트 접근을 제공합니다. (기본값: 8080과 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는 사이트 간 스크립팅 방지를 위한 보안 기능을 제공합니다. 그 외의 경우, 예를 들어 자바스크립트 코드가 있는 웹페이지를 방문할 경우, 로딩된 웹페이지에 접속하여 이 코드가 Wwise 접근 권한을 얻는 것이 이론적으로 가능합니다. 만약 이런 경우 방화벽만으로는 충분하지 않습니다.

이러한 WAAPI 보안 기능은 사용자의 브라우저 보안 설정을 기반으로 하고 있습니다. 기본 설정으로 WAAPI는 로컬 소프트웨어에서 오는 연결이나, 브라우저의 경우 로컬 파일 시스템의 HTML 파일을 열 때만 연결을 허용하게 돼있습니다.

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

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

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

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

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

Mac에서 WAAPI 사용하기

WAAPI는 파일에 접근할 때 Z 드라이브로 표시되는 루트 폴더 "/"와 홈 폴더 Y 드라이브를 이용하는 Windows 형식의 경로를 사용합니다. 예를 들어, '/Volumes/path/to/MyProject.wproj'라는 프로젝트를 열려면 "Z:\Volumes\path\to\MyProject.wproj" 라는 경로를 사용해야 합니다.

확실하지 않은 경우, Wwise에서 최근 프로젝트에 나와있는 프로젝트 경로를 참고하면 됩니다.

다음 단계

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

참고

이 페이지가 도움이 되었나요?

지원이 필요하신가요?

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요