Wwise Unreal 플러그인은 SoundBank를 생성하고 명령줄을 통해 소스 컨트롤로 SoundBank를 제출할 수 있게 해주는 Commandlet을 제공합니다. 다음은 Commandlet 사용법입니다:Wwise
<UE4Editor-cmd.exe> <path_to_uproject> -run=GenerateSoundBanks [-platforms=listOfPlatforms] [-languages=listOfLanguages] [-wwiseConsolePath=pathToWwiseConsole] [-rebuild][-migrate]
|
참고: |
Unreal Engine 5를 사용할 경우 Editor 실행 파일의 이름은 UnrealEditor-cmd.exe 입니다. |
매개 변수는 다음과 같습니다.
-
platforms: (선택 사항) Wwise에서 지정된대로 생성될 SoundBank가 생성될 플랫폼을 쉼표(,)로 구분하여 열거합니다. 지정되지 않은 경우 모든 플랫폼의 SoundBank가 생성됩니다.
-
languages: (선택 사항) Wwise에서 지정된대로 생성될 SoundBank가 생성될 언어를 쉼표(,)로 구분하여 열거합니다. 지정되지 않은 경우 모든 언어가 생성됩니다.
-
banks: (선택 사항) 생성할 SoundBank의 목록이며, 쉼표로 구분되어 있습니다. 뱅크의 이름은 프로젝트에 있는 UAkAudioBank 에셋과 반드시 상응해야 합니다. 지정되지 않을 경우 프로젝트에 있는 모든 SoundBank가 생성됩니다.
-
wwiseConsolePath: (선택 사항) SoundBank를 생성하는 데에 사용되는 Wwise 명령줄의 전체 경로입니다. 지정되지 않은 경우 Wwise 설정에서 찾은 경로를 사용합니다.
-
rebuild: (선택 사항) 모든 Wwise Sound Data의 깔끔한 리빌드(rebuild)를 강제 실행합니다.
-
migrate: (선택 사항) 프로젝트의 첫 번째 마이그레이션을 실행합니다.
-
fixupRedirectors: (선택 사항) 마이그레이션이 완료되었을 때 에셋 이동으로 인한 리디렉터를 수정합니다.
-
autosubmit: (선택 사항) 생성된 Wwise 에셋을 소스 컨트롤에 자동으로 제출합니다.
-
clnum: (선택 사항) 자동 커밋 메시지의 끝에 추가할 변경 목록 번호입니다.
-
forceAssetSync: (선택 사항) Wwise와 에셋 동기화를 강제 실행합니다. 새 에셋을 추가하고 삭제된 에셋을 제거합니다.
-
help: (선택 사항) 이 도움 메시지를 출력합니다. 이 매개 변수는 Commandlet을 즉시 종료합니다.
사용 예시: Wwise
C:\UE_4.23\Engine\Binaries\Win64\UE4Editor-Cmd.exe C:\MyProjects\Demo\WwiseDemoGame.uproject -run=GenerateSoundBanks -platforms=Windows,Mac
|
참고: |
Development Editor가 빌드되지 않거나 사용할 수 없는 문제가 생길 경우 SKIP_PLUGIN_ACTIVATION 환경 변수를 true 로 설정해서 플러그인 활성화를 건너뛸 수 있습니다. |
초기 마이그레이션에서 Commandlet 사용하기
Commandlet에는 빌드 장치에서 오프라인으로 Event-Based Packaging 작업 과정으로 프로젝트를 마이그레이션하는 특수 옵션이 있습니다. 이 옵션은 시간이 꽤 걸리기 때문에 대규모 프로젝트에 사용하는 것이 좋습니다. Commandlet이 새로운 에셋을 생성하며 사운드 데이터를 다시 빌드하고 소스 컨트롤로 제출합니다. Wwise Console 애플리케이션의 경로를 사용하실 것을 적극 권장합니다.
사용 예시:
Wwise
C:\UE_4.23\Engine\Binaries\Win64\UE4Editor-Cmd.exe C:\MyProjects\Demo\WwiseDemoGame.uproject -run=GenerateSoundBanks -wwiseConsolePath=C:\Wwise\Authoring\x64\Release\Bin\WwiseConsole.exe -migrate
제출(commit) 메시지 설정하기
Commandlet은 소스 컨트롤이 활성화되어 있을 경우 프로젝트의 변경 사항을 제출합니다. 제출 메시지는 Wwise Integration Settings에서 Commandlet Commit Message 입력란을 통해 맞춤화할 수 있습니다.