SoundBank 생성 전/후 실행할 단계 정의하기

작업 과정에 따라 SoundBank를 생성하기 직전/직후에 특정 단계나 작업을 실행할 수 있습니다. 예를 들어 SoundBank를 생성 전에 특정 SoundBank 파일을 소스 컨트롤 시스템에서 체크아웃하거나 SoundBank 생성 직후 스트리밍 파일을 폴더에 복사하도록 만들 수 있습니다.

Wwise에서는 명령줄(commanad line)을 통해 이러한 유형의 업무를 정의합니다. Wwise에서는 특별한 명령줄 편집기를 제공하여 사용자가 원하는 만큼의 명령줄을 쉽게 제작하도록 해줍니다. 이 편집기는 명령줄로 사용할 수 있는 Wwise 전용 및 Windows 환경 변수의 목록을 담고 있어 제작 과정을 더 간편하게 만들어 줍니다.

맞춤 명령줄을 제작할 때 사용할 수 있는 Wwise의 변수는 다음과 같습니다.

명령줄 변수

설명

$(AllowExceedMaximum)

지정한 최대 크기를 초과하더라도 SoundBank를 생성할지 여부를 정합니다.

이 변수는 Allow SoundBanks to exceed maximum size 옵션을 선택할 경우에 true로 설정됩니다.

$(ContentFileFormat)

생성된 SoundBank 콘텐츠 파일의 파일 유형을 지정합니다. 다음은 가능한 값의 목록입니다.

ANSI
Unicode

$(GenerateContentFile)

각 SoundBank의 내용물 목록을 만들지 여부를 지정합니다. 내용물로 들어 있는 파일에는 Event, Bus, State, Switch 뿐만 아니라 스트리밍 오디오와 메모리 안의 오디오 파일의 전체 목록이 들어 있습니다.

이 변수는 Generate SoundBank content files 옵션을 선택할 경우에 true로 설정됩니다.

$(GenerateHeaderFile)

Event, State, Switch, Game Parameter를 ID로 매핑하는 헤더 파일을 생성할지의 여부를 지정합니다.

이 변수는 Generate header file 옵션이 활성화되었을 경우에 true로 설정됩니다.

$(GenerateMaxAttenuationInfo)

Event의 최대 감쇠(attenuation) 정보를 생성할지 여부를 지정합니다.

이 변수는 Metadata Options: Max attenuation 옵션이 활성화되었을 경우에 true로 설정됩니다.

$(GenerateEstimatedDuration)

Event의 최대/최소 예상 길이와 길이 유형 정보를 생성할지 여부를 지정합니다.

이 변수는 Metadata Options: Estimated Duration 옵션이 활성화되었을 경우에만 true로 설정됩니다.

$(HeaderFileFullFilePath)

헤더 파일의 전체 경로인 $(HeaderFilePath)\Wwise_IDs.h를 말합니다.

$(HeaderFilePath)

헤더 파일을 저장할 경로나 위치를 말합니다.

이 경로는 Header file 텍스트 상자에서 가져옵니다.

$(InfoFilePath)

현재 선택된 플랫폼 Info 파일의 전체 파일 이름을 말합니다.

$(IsRunningFromCmdLine)

Wwise가 -generatesoundbanks 플래그를 가진 명령줄을 사용하여 실행될지를 지정합니다.

$(LanguageList)

명령줄로 전송되는 언어의 목록 또는 SoundBank Manager에서 선택한 언어를 말합니다.

	참고
	목록은 스페이스로 구분됩니다.

$(Platform)

현재 플랫폼의 이름을 말합니다.

$(SoundBankList)

명령줄로 전송되는 SoundBank의 목록 또는 SoundBank Manager에서 선택한 SoundBank를 말합니다.

	참고
	목록은 스페이스로 구분됩니다. 하나의 단일 인자(argument)로 목록을 묶어 넣으려면 큰 따옴표를 사용하세요.

$(SoundBankPath)

현재 플랫폼의 SoundBanks가 저장된 경로나 위치를 말합니다.

$(UseSoundBankNames)

SoundBank 이름 (참)이나 ID (거짓)을 사용하여 생성된 SoundBank (BNK) 파일의 이름을 지정하고 또 다른 뱅크에서 한 뱅크를 참조할지를 결정합니다.

이 변수는 Use SoundBank names 옵션이 활성화되었을 경우에 참으로 설정됩니다.

$(WwiseExeDriveLetter)

Wwise 실행 파일(Wwise.exe)이 위치한 작업 환경의 드라이브 문자(drive letter, 구동 장치 표시 문자)를 말합니다.

$(WwiseExePath)

Wwise 실행 파일(Wwise.exe)의 경로나 위치를 말합니다.

$(WwiseExeProcessID)

Wwise 실행 파일(Wwise.exe)의 숫자 Process Identifier를 말합니다.

$(WwiseProjectDriveLetter)

Wwise 프로젝트가 위치한 작업 환경의 드라이브 문자를 말합니다.

$(WwiseProjectName)

현재 프로젝트의 이름을 표시합니다.

$(WwiseProjectPath)

Wwise 프로젝트의 경로나 위치를 말합니다.

$(WaapiWampPort)

WAAPI가 WAMP 프로토콜에 사용하는 포트를 말합니다.

$(WaapiHttpPort)

WAAPI가 HTTP 프로토콜에 사용하는 포트를 말합니다.

	참고
	또한 $(WWISESDK)와 같은 모든 환경 변수 역시 사용 가능합니다.

Wwise에서는 작업의 유연성을 높이기 위해 다음 유형의 단계에 여러 가지 명령줄을 정의할 수 있습니다.

Global opening step - 모든 플랫폼에 적용되며 다른 단계를 실행하기 전에 먼저 실행되는 명령줄입니다.
Platform-specific pre-generation step - 특정 플랫폼에 적용되며 다른 단계를 실행하기 전에 먼저 실행되는 명령줄입니다.
Platform-specific post-generation step - 특정 플랫폼에 적용되며 SoundBank를 생성한 후에 실행되는 명령줄입니다.
Global closing step - 모든 플랫폼에 적용되며 SoundBank를 생성한 후에 실행되는 명령줄입니다.

기본적으로 모든 프로젝트에는 스트리밍용 파일을 SoundBank 폴더로 복사하는 각 플랫폼별 생성 후 단계(post-generation step) 명령줄(command line)이 들어 있습니다. 하지만 다른 명령줄을 실행해서 모든 유형의 업무를 자동화할 수 있습니다. 또한 Wwise는 File Packager를 통해 SoundBank의 모든 데이터와 미디어를 담은 패키지를 생성하는 또 다른 Factory 명령줄을 제공합니다. File Packager에 대한 더 많은 정보는 36장. 파일 패키지 관리하기(을)를 참조하세요. 기본 명령줄 불러오기에 대한 더 많은 정보는 “기본/맞춤 명령줄 불러오기”(을)를 참조하세요.

또한 이러한 명령줄을 파일(WCMDLINE)에 저장하여 동일한 프로젝트 또는 다른 프로젝트에서 사용하거나 다른 사용자와 공유할 수 있습니다. 명령줄 저장하기에 대한 더 자세한 정보는 “맞춤 명령줄을 파일로 저장하기”(을)를 참조하세요.

SoundBank 생성 후에 실행할 업무를 정의하는 방법:

다음 중 하나를 실행하여 Project Settings 대화 상자를 엽니다.
- Project 메뉴에서 Project Settings를 선택합니다.
- Shift+K를 누릅니다.
SoundBanks 탭으로 갑니다.
전역적 Pre-Generation Step을 만들려면 브라우즈 버튼 […]을 클릭하여 Global Opening Step Editor를 엽니다.

Pre-Generation Step Editor가 열립니다.
Description 텍스트 상자에서 실행할 단계나 업무를 명확하게 묘사하는 이름을 입력합니다.

Commands 텍스트 상자를 클릭하여 명령줄을 만들기 시작합니다.

	참고
	Commands 텍스트 상자는 대부분의 다른 텍스트 편집기와 비슷하게 작동하기 때문에 Enter 키를 눌러서 텍스트에 새로운 줄을 추가하고, 선택 후 Delete를 눌러서 텍스트를 삭제하는 등의 작업을 실행할 수 있습니다.

명령줄에 큰 규모의 내장 변수나 환경 변수를 삽입하는 방법:

Macros 그룹 상자에서 다음 옵션 중 한 가지를 선택합니다.
- Built-in Macros - Wwise 명령줄에서 사용할 수 있는 Wwise 고유 변수의 목록을 보여줍니다.
- Environment Variables - Wwise 명령줄에서 사용할 수 있는 Window 고유 환경 변수의 목록을 보여줍니다.
명령줄에 변수를 추가하려면 다음 중 하나를 골라 따라하세요.
- 목록에서 변수를 더블 클릭합니다.
- 목록에서 변수를 선택한 다음 Insert를 클릭합니다.
계속해서 필요한 만큼 명령줄에 변수를 추가합니다.
두 번째 전체 범위 생성 전 단계를 실행하려면 첫 번째 줄의 끝에서 Enter를 눌러서 새로운 명령줄을 만들기 시작합니다.

OK를 클릭하여 명령줄을 저장하고 Pre-Generation Step Editor를 닫습니다.

	참고
	명령줄을 파일에 저장하려면 편집기에서 Save As 버튼을 클릭합니다. 맞춤 명령줄 저장하기에 대한 더 자세한 정보는 “맞춤 명령줄을 파일로 저장하기”(을)를 참조하세요.

플랫폼에 특정한 생성 전 단계를 만드려면 각 플랫폼에 3~8 단계를 반복하면 됩니다.

	참고
	Load 버튼을 클릭하면 기본 명령줄이나 이전에 저장한 맞춤 명령줄을 편집기로 불러올 수 있습니다. 기본/맞춤 명령줄 불러오기에 대한 더 많은 정보는 “기본/맞춤 명령줄 불러오기”(을)를 참조하세요.

SoundBank 생성 후에 실행할 작업을 정의하는 방법:

다음 중 하나를 실행하여 Project Settings 대화 상자를 엽니다.
- Project 메뉴에서 Project Settings를 선택합니다.
- Shift+K를 누릅니다.
SoundBanks 탭으로 갑니다.
Post-Generation Step 그룹 상자에서 Copy Streamed Files 명령줄이 기본으로 추가된 것을 볼 수 있습니다. 이 명령줄을 변경하거나 새로 추가하려면 탐색 버튼 [...]을 클릭합니다.

Post-Generation Step Editor가 열립니다.
Description 텍스트 상자에서 실행할 단계나 업무를 명확히 묘사하는 이름을 입력합니다.

Commands 텍스트 상자에서 현재 명령줄의 끝을 클릭한 후 Enter를 누릅니다. 새로운 명령줄 만들기를 시작합니다.

	참고
	Commands 텍스트 상자는 대부분의 다른 텍스트 편집기와 비슷하게 작동하기 때문에 Enter 키를 눌러서 텍스트에 새로운 줄을 추가하고, 선택 후 Delete를 눌러서 텍스트를 삭제하는 등의 작업을 실행할 수 있습니다.

명령줄에 큰 규모의 내장 변수나 환경 변수를 삽입하는 방법:

Macros 그룹 상자에서 다음 옵션 중 한 가지를 선택합니다.
- Built-in Macros - Wwise 명령줄에서 사용할 수 있는 Wwise 고유 변수의 목록을 보여줍니다.
- Environment Variables - Wwise 명령줄에서 사용할 수 있는 Window 고유 환경 변수의 목록을 보여줍니다.
명령줄에 변수를 추가하려면 다음 중 하나를 골라 따라하세요.
- 목록에서 변수를 더블 클릭합니다.
- 목록에서 변수를 선택한 다음 Insert를 클릭합니다.
계속해서 필요한 만큼 명령줄에 변수를 추가합니다.
추가적인 생성 전 단계를 실행하려면 첫 번째 줄의 끝으로 가서 Enter를 누른 후 새로운 명령줄을 만들 수 있습니다.

OK를 클릭하여 명령줄을 저장하고 Post-Generation Step Editor를 닫습니다.

	참고
	명령줄을 파일에 저장하려면 편집기에서 Save As 버튼을 클릭합니다. 맞춤 명령줄 저장하기에 대한 더 자세한 정보는 “맞춤 명령줄을 파일로 저장하기”(을)를 참조하세요.

3~8 단계를 반복하여 전역적(global) 종료 단계와 각 추가 플랫폼에 실행할 단계를 정의합니다.

	참고
	Load 버튼을 클릭하면 기본 명령줄이나 이전에 저장한 맞춤 명령줄을 편집기로 불러올 수 있습니다. 기본/맞춤 명령줄 불러오기에 대한 더 많은 정보는 “기본/맞춤 명령줄 불러오기”(을)를 참조하세요.

관련 주제

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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요

Wwise Help