|
Wwise SDK 2023.1.8
|
SoundBank 생성. SoundBank 생성은 프로젝트에 저장된 설정에 따라 실행됩니다. User SoundBanks Settings are normally ignored when SoundBank generation is launched from the command line. However, when using the Source Control for generated SoundBanks, the User Project Settings are loaded for the Source Control settings. Also, some of these settings can be overridden from the command line.
WwiseConsole generate-soundbank "C:\MyProject\MyProject.wproj" --platform "Windows" "Linux" --language "English(US)"
영어(미국) 언어를 사용하여 Windows와 Linux 플랫폼에 대해 MyProject.wproj의 모든 SoundBank를 생성합니다.
PROJECT
해당 프로젝트 파일(.wproj)의 경로.
--abort-on-load-issues
프로젝트 로드 이슈가 감지되면 작업을 중단합니다. 로그된 모든 프로젝트 로드 문제가 화면에 출력됩니다.
--audio-source-from-original
탭으로 구분된 가져오기를 할 때, 불러오는 파일과 동일한 이름의 오디오 음원 파일이 이미 프로젝트 있는 경우가 있습니다. 이럴 때에는 해당 옵션을 추가해 기존에 있던 오디오 음원 파일을 사용하도록 하고 탭으로 구분된 파일의 내용으로 대체하지 않습니다.
--bank SOUNDBANK
--bank SOUNDBANK1 SOUNDBANK2 ...
--bank FILE
생성할 SoundBank를 지정합니다. 이 작업 후 반드시 SoundBank 이름을 생성해줘야 합니다. 복수의 SoundBank를 지정할 수 있습니다. 아무 SoundBank도 지정되지 않으면 모든 SoundBank가 생성됩니다. 또는 '.txt' 확장자를 포함한 전체 경로를 텍스트 파일로 지정하여 SoundBank 이름의 목록이 담긴 텍스트 파일을 지정할 수도 있습니다.
--cache PATH
Overrides the project's cache directory path and instead uses the (relative) path specified in the command.
--clear-audio-file-cache
Deletes the content of the Wwise audio file cache directory prior to converting source files and generating SoundBanks, which ensures that all source files are reconverted. –platform 인자와 상관 없이 모든 플랫폼에 대해 전체 캐시가 삭제되니 주의하세요.
--continue-on-error
오류가 발생했을 때 작업을 계속하려면 이 옵션을 사용합니다.
--custom-global-closing-cmd CMD
Wwise에 정의된 전역적 종료 단계를 오버라이드합니다. 이 옵션은 반드시 새로운 명령줄(공백이 있을 경우 인용 부호 사용)이 뒤따라야 합니다. 명령줄에 빈 문자열("")을 정의하면 아무 전역적 종료 단계도 실행되지 않는다는 뜻입니다.
--custom-global-opening-cmd CMD
Wwise에 정의된 전역적 시작 단계를 오버라이드합니다. 이 옵션은 반드시 새로운 명령줄(공백이 있을 경우 인용 부호 사용)이 뒤따라야 합니다. 명령줄에 빈 문자열("")을 정의하면 아무 전역적 시작 단계도 실행되지 않는다는 뜻입니다.
--custom-post-gen-cmd PLATFORM CMD
--custom-post-gen-cmd PLATFORM1 CMD1 --custom-post-gen-cmd PLATFORM2 CMD2 ...
Wwise의 해당 플랫폼에 대해 정의된 사용자 지정 생성 직후 단계(post-generation)를 오버라이드합니다. 이 옵션 뒤에는 플랫폼 식별자(위 상세 목록 참고)가 와야 하며, 그 후 새로운 명령줄(공백이 있을 경우 인용 부호 사용)이 뒤따라야 합니다. 다른 플랫폼의 사용자 지정 생성 직후 단계 명령을 오버라이드하려면 –custom-post-gen-cmd 옵션을 반복하고 원하는 다른 플랫폼의 식별자와 해당 명령줄을 새로 입력합니다. 명령줄에 빈 문자열("")을 정의하면 아무런 생성 직후 단계도 실행되지 않는다는 뜻입니다.
--custom-pre-gen-cmd PLATFORM CMD
--custom-pre-gen-cmd PLATFORM1 CMD1 --custom-pre-gen-cmd PLATFORM2 CMD2 ...
Wwise의 해당 플랫폼에 대해 정의된 사용자 지정 생성 직전 단계(pre-generation)를 오버라이드합니다. 이 옵션 뒤에는 플랫폼 식별자(위 상세 목록 참고)가 와야 하며, 그 후 새로운 명령줄(공백이 있을 경우 인용 부호 사용)이 뒤따라야 합니다. 다른 플랫폼의 사용자 지정 생성 직전 단계 명령을 오버라이드하려면 –custom-pre-gen-cmd 옵션을 반복하고 원하는 다른 플랫폼의 식별자와 해당 명령줄을 새로 입력합니다. 명령줄에 빈 문자열("")을 정의하면 아무런 생성 직전 단계도 실행되지 않는다는 뜻입니다.
--header-file
이 옵션이 프로젝트 설정에서 지정돼있지 않더라도 Wwise_IDs.h 헤더 파일을 생성합니다.
--header-file-path
(DEPRECATED) Use root-output-path instead. 프로젝트 설정에 지정된 헤더 파일 경로를 오버라이드합니다. 이 옵션은 헤더 파일(Wwise_IDs.h)이 작성될 곳을 나타내는 경로(절대 또는 상대)가 반드시 뒤따라야 합니다. 헤더 파일의 생성이 필요할 경우에만 유효합니다.
--import-definition-file FILE
--import-definition-file FILE1 FILE2 ...
--import-definition-file FILE1 --import-definition-file FILE2 ...
SoundBank 정의 파일을 가져옵니다. 이 옵션은 반드시 불러올 뱅크 정의 파일의 전체 경로가 뒤따라야 합니다. 복수의 파일을 지정할 수 있습니다. –save 옵션이 지정돼있지 않으면 불러온 정의 파일의 결과물인 프로젝트의 변경 사항이 유지되지 않습니다.
--import-language LANGUAGE
탭으로 구분된 불러오기 작업을 통해 보이스를 불러올 수 있습니다. 이 옵션은 불러오는 보이스의 언어를 정의하는 데 사용합니다. 이 옵션 후 반드시 –language 옵션으로 언어 식별자 중 하나를 정의해줘야 합니다. 이 작업에서는 오디오 파일만 추가할 수 있다는 점에 유의하세요. 볼륨 조정과 같이 다른 작업을 하려는 시도는 무시됩니다.
--language LANGUAGE
--language LANGUAGE1 --language LANGUAGE2 ...
생성되는 SoundBank를 위한 언어를 지정합니다. 이 옵션 후에는 반드시 프로젝트에서 정의한 언어 식별자가 뒤따라야 합니다. 각 지정된 언어의 앞에는 이 옵션을 접두어로 붙여야 합니다.
--license LICENSE
사용할 라이선스를 설정합니다. 해당 라이선스는 프로젝트에 저장되지 않습니다.
--no-decode
Avoids generating DECODED files in the .cache directory, which saves CPU and disk space for your Wwise project. 또한 SoundBank 생성 시간을 줄이는 역할도 합니다. 주의: DECODED 파일을 생성하지 않을 경우, Wwise Authoring에서 이 사운드를 재생할 때 재생이 업데이트되지 않거나 아예 아무런 재생이 일어나지 않을 수 있습니다. 이 옵션 실행 후 파일 캐시 삭제를 권장합니다.
--no-source-control
Skip the Source Control operations, even it is was enabled in the SoundBank Project Settings.
--no-wwise-dat
Disables writing to hidden 'wwise.dat' files when converting audio files. This is useful when calling from a build tool that already handles file dependencies, as it allows multiple instances of Wwise to convert to the same directory simultaneously, without conflicting. Note that this option does not prevent the reading of existing hidden 'wwise.dat' files.
--output PLATFORM PATH
--output PLATFORM1 PATH1 --output PLATFORM2 PATH2 ...
--output PATH
Allows you to follow this option with a platform and an output path to override the output path of this platform for external source conversion. 이 옵션을 다른 플랫폼에 대해서도 반복합니다. If only a directory is specified, sources for all platforms are generated in that directory.
--platform PLATFORM
--platform PLATFORM1 PLATFORM2 ...
--platform PLATFORM1 --platform PLATFORM2 ...
생성되는 SoundBank를 위한 플랫폼을 지정합니다. 이 옵션 후에는 반드시 플랫폼 식별자가 있어야 합니다.
--quiet
오류를 일으키지 않은 모든 콘솔 텍스트 출력을 비활성화합니다.
--readable-soundbanks
이 옵션이 프로젝트 설정에서 지정돼있지 않더라도, 읽을 수 있는 SoundBank(.rbnk)를 생성합니다.
--root-output-path
Overrides the root output path specified in the SoundBank settings. This option must be followed by the path (absolute or relative) in which the project level, platform agnostic files will be written. Examples of such files are Wwise_IDs.h and ProjectInfo.(xml|json).
--save
SoundBank를 생성하기 전에 프로젝트를 저장합니다. 탭으로 구분된 불러오기 파일이 있을 경우, 불러온 콘텐츠도 함께 저장됩니다. 필요한 경우, 프로젝트 저장이 암묵적으로 먼저 마이그레이션됩니다.
--skip-languages
프로젝트에 현지화된 SoundBank를 생성하지 않습니다.
--soundbank-path PLATFORM PATH
--soundbank-path PLATFORM1 PATH1 --soundbank-path PLATFORM2 PATH2 ...
이 플랫폼에 대해 지정된 SoundBank 경로를 오버라이드합니다. 이 옵션 뒤에는 플랫폼 식별자(위 상세 목록 참고)와 새로운 경로(절대 또는 상대, 공백이 있을 경우 인용 부호 사용)가 뒤따라야 합니다. 다른 플랫폼의 경로를 오버라이드하려면 –soundbank-path 옵션을 반복하고 다른 플랫폼의 지정자와 새로운 경로를 입력합니다.
--source-by-platform PLATFORM FILE
--source-by-platform PLATFORM1 FILE1 --source-by-platform PLATFORM2 FILE2 ...
Specifies the WSOURCES files to use by platform for external source conversion. 특정 플랫폼이 지정된 경우, 이 플랫폼의 프로젝트 설정에서 WSOURCES 파일을 오버라이드합니다. 특별히 지정된 내용이 없는 플랫폼의 경우, 프로젝트 설정을 사용합니다. Specify the platform first, then the WSOURCES files to use for this platform. 각 플랫폼과 WSOURCES 파일에 대해 해당 작업을 반복합니다.
--source-file FILE
--source-file FILE1 FILE2 ...
Specifies the WSOURCES files to use for external source conversion. 이 WSOURCES 파일은 모든 플랫폼에 사용됩니다.
--tab-delimited-import-file FILE
--tab-delimited-import-file FILE1 FILE2 ...
--tab-delimited-import-file FILE1 --tab-delimited-import-file FILE2 ...
불러오게 될 탭으로 구분된 파일. 이 옵션 후에는 불러올 파일을 여러 개 지정할 수 있습니다.
--tab-delimited-operation createNew
--tab-delimited-operation useExisting
--tab-delimited-operation replaceExisting
생성된 오브젝트 각각에 대해 오브젝트를 불러올 때의 생성 방식을 결정합니다. "createNew": 새로운 오브젝트를 생성합니다. 여기에 원하는 이름을 별도로 부여하세요. 그렇지 않으면 새로운 고유 이름을 사용합니다. "useExisting": 기존 오브젝트가 있으면 해당 지정 속성을 업데이트해 사용합니다. 그렇지 않으면 새로운 새로운 오브젝트를 생성합니다. 이는 기본값입니다. "replaceExisting": 새로운 오브젝트를 생성합니다. 기존 오브젝트가 동일한 이름을 갖고 있을 경우, 기존 것이 삭제됩니다.
사용 가능한 값:
--use-stable-guid
Give the SoundBank a stable GUID across multiple builds if you don't want to save the project.
--use-user-overrides
Use user overrides for Project Settings and SoundBank Settings.
--verbose
추가 콘솔 문자 출력을 활성화합니다.
SoundBank 생성 처리의 종료 코드. Although your SoundBanks might generate properly with warnings, it is strongly recommended that you consider these warnings as errors. 예를 들어, 음원 파일이 누락되었을 경우 WwiseConsole.exe가 오류 코드를 반환합니다. Although a missing source file does not prevent your SoundBanks from being generated, the resulting SoundBanks might potentially be incomplete. Wwise의 Project Settings > Logs에 가면, SoundBank 생성 도중 발생하는 메시지 대부분의 심각도(severity)를 변경할 수 있습니다. 메시지의 심각도를 변경하면 반환 코드에 영향을 끼칩니다.
WwiseConsole.exe exit 코드 0은 성공을 뜻하고, 1은 최소 한 개의 오류(경고)가 발생했다는 뜻이며, 2는 경고만 발생했다는 뜻입니다.
Wwise Console에 대한 더 자세한 정보는 명령줄 사용하기 를 참고하세요.
프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.
Wwise를 시작해 보세요