|
Wwise Unity Integration Documentation
|
Wwise Picker(와이즈 피커) 창은 Wwise 프로젝트에서 사용 가능한 오브젝트 (예: Event와 Switch)를 Wwise와 동일한 구조로 보여줍니다. Wwise Picker에 표시되는 프로젝트는 Wwise Settings 창 (menu Edit > Project Settings > Wwise Editor)에 입력된 프로젝트와 동일합니다. 보통 이 프로젝트는 Wwise 플러그인이 Unity 안에 설치되었을 때에 지정됩니다.
2021.1 버전부터 Wwise Picker는 File System과 Wwise Authoring이라는 두 가지 모드를 가집니다. 이 모드는 피커 창의 상단 좌측 모서리에 있는 메뉴를 사용하여 변경할 수 있습니다.
File System 모드에서는 Wwise 프로젝트가 저장될 때 Wwise Picker 뷰에 있는 사용 가능한 오브젝트가 업데이트됩니다. 생성한 오브젝트가 보이지 않을 경우, 프로젝트가 저장되지 않았을 가능성이 높습니다. Refresh Project를 클릭하면 Wwise Picker 뷰를 새로 고칠 수 있습니다. 이때 SoundBank를 생성할 때 생기는 XML 메타데이터 파일에 있는 데이터를 포함한 Wwise에 관련된 모든 데이터도 새로 고침 됩니다.
 | 참고: | AkWwiseProjectData.asset은 버전 컨트롤에 넣지 마세요! 이 파일은 Wwise Picker가 계속해서 Work Unit 파일을 파싱하지 않도록 하는 Wwise 프로젝트 데이터의 임시 캐시 파일입니다. 이 파일을 버전 컨트롤에 추가할 경우 문제가 일어날 수 있습니다. |
| 참고: | Wwise Settings 대화창에서 Wwise Windows Installation Path(와이즈 윈도우 설치 경로) (혹은 Mac의 경우 Wwise Application(와이즈 애플리케이션))를 반드시 지정해야 합니다. Unity에서 Generate SoundBanks를 클릭할 때 Unity가 Wwise 경로를 사용해야 합니다. |
Wwise Authoring 모드에서 피커는 WAAPI를 사용하여 Wwise에서 열린 프로젝트와 통신합니다. File System 모드에서 제공되는 기능과 더불어, 이 모드는 다음의 기능을 제공합니다:
- Wwise Authoring에서 오브젝트가 변경될 경우 사용 가능한 오브젝트를 즉시 업데이트함
- Picker 안에서 사운드 Event 재생
- Unity와 Wwise 간에 동기화된 선택
- Unity 안에서 Wwise 오브젝트 이름 변경 및 삭제.
 | 주의: 이 모드가 올바르게 작동하려면 Wwise 프로젝트가 Wwise Authoring 안에서 반드시 열려있어야 하며 WAAPI 설정이 올바르게 설정되어 있어야 합니다. 프로젝트의 WAAPI 설정하기에 대한 더 많은 정보는 WAAPI 유틸리티 페이지를 참조해 주세요. |
기능
다음 섹션에서 설명된 기능은 File System과 Wwise Authoring 모드에서 모두 사용할 수 있습니다.
Picker로 오디오를 씬으로 추가하기
Wwise Picker에서 씬으로 오브젝트를 추가하려면 게임 오브젝트나 인스펙터 창으로 게임 오브젝트를 드래그하세요. 컴포넌트의 더 자세한 내용은 각 컴포넌트의 설명서를 참조하세요.
- Event를 드래그하면 AkAmbient 가 생성됩니다.
- SoundBank를 드래그하면 AkBank 가 생성됩니다.
- Switch Value를 드래그하면 AkSwitch 가 생성됩니다.
- State Value를 드래그하면 AkState 가 생깁니다.
- Aux Bus 를 드래그하면 AkEnvironment 가 생깁니다.
검색 및 이동
Wwise Picker의 윗쪽에 있는 필터 박스를 사용해서 특정 아이템을 찾으세요. 찾고자 하는 아이템의 이름을 입력하면 Picker가 자동으로 검색어에 대응하지 않는 아이템을 걸러냅니다.
+와 - 버튼을 클릭하거나 아이템의 이름을 더블 클릭하면 아이템을 펼치거나 닫을 수 있습니다. 또한 키보드의 화살표 키를 사용해서 아이템을 선택하고 펼칠 수 있습니다.
찾고자 하는 아이템의 상위 계층이 닫혀 있는 경우 몇몇 아이템을 펼쳐야 할 수 있습니다.
Generating SoundBanks
Generate SoundBanks를 클릭하면 모든 플랫폼과 언어용 SoundBank가 생성됩니다. 생성된 SoundBank는 Wwise Picker의 SoundBanks 폴더 아래 Wwise 안에서 생성된 것과 동일하게 표시됩니다. 그리고 Unity 상태 막대가 다음 중 한 메시지를 표시하게 됩니다:
WwiseUnity: SoundBanks generation successful: 오류나 경고 메시지가 없을 경우WwiseUnity: SoundBanks generation has warning(s): 경고 메시지가 있을 경우WwiseUnity: SoundBanks generation error: 오류 메시지가 있을 경우 메시지를 클릭하면 SoundBank 생성 과정 정보를 보여주는Console탭으로 포커스가 옮겨집니다.
Finding References in Scene
픽커에서 Wwise 오브젝트를 우클릭하면 씬에서 해당 오브젝트로의 참조를 찾는 옵션을 선택할 수 있습니다. 이 옵션을 선택하면 Hierarchy 창이 해당 Wwise 오브젝트로의 참조를 담은 GameObject만 표시하게 됩니다. 또한 아이템을 선택하고 Shift + R을 눌러서 같은 작업을 실행할 수 있습니다.
Auto Populate
이 옵션은 File System 모드에서만 나타납니다. 이 옵션이 활성화되면 Wwise 프로젝트 파일에서 변경이 감지될 때마다 (보통 프로젝트를 저장하면 감지됨) 피커가 내용을 업데이트하게 됩니다. 이 옵션을 비활성화하면 Refresh Project 버튼을 눌러서 피커 내용을 업데이트해야 합니다.
Select in Wwise Picker
이제 Wwise Object 오브젝트를 참조하는 Wwise 컴포넌트를 우클릭하면 피커에서 해당 오브젝트를 선택할 수 있는 메뉴 옵션이 제공됩니다. 이 옵션을 사용하면 피커 윈도에서 참조된 오브젝트가 강조 표시됩니다.
WAAPI 기능
Wwise Authoring 모드를 사용할 경우 Wwise 프로젝트에서의 변경 내용이 피커 창에 즉시 반영됩니다. Wwise Project Explorer에서 오브젝트를 복사, 이름 변경, 삭제, 이동할 경우 Picker 창의 내용이 항상 대응하게 됩니다. 또한 피커 창에서 아이템을 우클릭하면 제공되는 수많은 추가 기능을 확인할 수 있습니다:
동기화된 선택
Autosync selection 옵션을 사용하면 Unity와 Wwise 저작 간에 선택 사항을 동기화할지의 여부를 결정할 수 있습니다. 이 옵션은 마지막으로 선택한 아이템을 같게 해서 두 프로그램 간을 쉽게 전환할 수 있게 해줍니다.
Event 재생
WAAPi Picker에서 이벤트를 우클릭해서 들어보기를 선택할 수 있습니다. 또한 동일한 옵션을 사용해서 재생이 시작되어 진행 중인 Event를 중단할 수도 있습니다.
빠른 실행: Space bar 혹은 빠른 더블 클릭.
어떤 이벤트를 재생 중인지 잊어버릴 경우, 피커에서 아무 아이템이나 우클릭해서 Stop All을 선택할 수 있습니다.
Renaming Wwise Objects
바로가기 메뉴에서 이 옵션을 선택하면 피커 창 안에서 Wwise 오브젝트의 이름을 변경할 수 있습니다.
빠른 실행: F2나 느린 더블 클릭.
| 참고: | Work Unit이나 Physical Folder의 이름은 변경할 수 없습니다. |
Open Containing Folder
바로가기 메뉴의 Open Containing Folder 옵션은 Wwise 오브젝트의 Work Unit이 담긴 폴더를 파일 탐색기에서 열어줍니다.
빠른 실행: Ctrl + O
Open SoundBank Folder
선택한 아이템이 SoundBank일 경우, SoundBank 폴더를 열 수 있는 추가 옵션이 제공됩니다. 이 옵션은 Wwise Authoring에서 현재 활성화된 플랫폼의 Generated SoundBanks 폴더를 파일 탐색기에서 열어줍니다.
| 참고: | SoundBank를 아직 생성하지 않았을 경우 아마도 OS의 최상위 계층 폴더가 열릴 것입니다. |
프로젝트 새로 고치기
Wwise Authoring 모드에서 Refresh 버튼을 클릭하면 피커 창을 비우고 WAAPI를 사용하여 프로젝트의 내용을 다시 페치하게 됩니다.
연결 상태
연결 상태와 실패한 WAAPI 요청에 의한 오류 메시지는 Wwise Picker Window의 상단 우측 모서리에 표시됩니다.
프로젝트에 WAAPI 설정하기에 대한 더 많은 정보는 WAAPI 유틸리티 페이지를 참고해 주세요. WAAPI가 활성화되었지만 Unity 프로젝트가 웹소켓 연결을 성공적으로 열지 못할 경우, Wwise Picker 창에서 특정 오류 메시지가 표시됩니다.
연결 오류 메시지:
- Connection refused
- 프로젝트가 열려 있지 않은 경우
- Unity나 Wwise WAAPI 설정에서 잘못된 포트/IP 주소가 지정된 경우
- Wwise Authoring User 사용자 환경에서 WAAPI가 비활성화되었을 경우
- The wrong project is open in Wwise
- 올바른 프로젝트가 열려 있는지 확인하세요
- No project is open in Wwise yet
- 프로젝트가 열려있는지 확인하세요
기타 오류 메시지:
- Cannot execute call because Wwise has an exclusive lock
- Wwise Authoring에서 모달이나 설정 창이 열려있을 경우.
연결에 실패할 때마다 Unity 통합이 2^N초 후에 재연결을 시도합니다 (N은 실패한 연결 시도 횟수를 말함). 이 대기 시간은 32초를 초과하지 않습니다.
이 페이지가 도움이 되었나요?
작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.
프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.
Wwise를 시작해 보세요