버전

menu_open
알림: 고객님의 주요 출시 버전( 2023.1.8.8601 )에 해당하는 최신 설명서로 이동했습니다. 특정 버전의 설명서를 보시려면 Audiokinetic 런처에서 오프라인 설명서를 다운로드하고 Wwise Authoring의 Offline Documentation을 확인하세요.

명령줄에서 File Packager 전달인자 사용하기

명령줄에서 패키지 파일을 생성할 때에는 반드시 특정 전달인자를 사용하여 패키지의 특성을 정의해야 합니다. 다음 표는 명령줄에서 사용할 수 있는 인자의 목록을 보여줍니다.

전달인자

설명

-generate

파일 패키지 생성 작업을 실행합니다. 이 인자는 File Packater 경로 또는 -info 인자와 함께 사용될 수 있습니다. 다음은 몇 가지 예시입니다.

  • File Packager 프로젝트를 사용하여 생성하기:

    -generate <project_path>

  • SoundbanksInfo.xml 파일을 사용하여 단일 패키지 생성하기:

    -generate -info <soundbank_info_filename> -output <package_name>

  • SoundbanksInfo.xml 파일을 사용하여 스트림 패키지와 뱅크 패키지 생성하기:

    -generate -info <soundbank_info_filename> -output_stm <package_name> -output_bnk <package_name>

-info <filename>

SoundBanksInfo.xml 파일의 위치를 지정합니다.

다음 중 한 개 이상의 옵션을 함께 사용할 수 있습니다.

-output

-put_

-output <filename>

SoundBank 파일과 스트리밍용 미디어 파일을 모두 포함하는 하나의 파일 패키지를 생성합니다. <filename>은 생성된 파일 패키지의 이름과 이 파일 패키지가 저장될 위치를 지정합니다.

이 인자는 <projectpath>가 지정되지 않았을 때에 지정할 수 있습니다. 전체 파일 경로를 써도 되고 패키지 이름만을 써도 됩니다. 두 옵션 모두 파일 패키지 확장자를 포함해야 합니다.

이 인자는 -output_stm 또는 -output_bnk와 함께 사용되어 각각 다른 파일 집합을 담고 있는 한 개 이상의 패키지를 생성합니다.

이 값은 프로젝트 내에서 정의되지만, -output 인자가 명시적으로 정의되었을 경우 프로젝트에서 지정한 값보다 우선권을 가집니다.

-output_stm <filename>

스트리밍용 미디어 파일만을 포함하는 파일 패키지를 한 개 생성합니다. <filename>은 생성된 파일 패키지의 이름과 이 파일 패키지가 저장될 위치를 지정합니다.

이 인자는 <projectpath>가 지정되지 않았을 때에 지정할 수 있습니다. 전체 파일 경로를 써도 되고 패키지 이름만을 써도 됩니다. 두 옵션 모두 파일 패키지 확장자를 포함해야 합니다.

이 인자는 -output 또는 -output_bnk와 함께 사용되어 각기 다른 파일 집합을 담고 있는 한 개 이상의 패키지를 생성합니다.

-output_bnk <filename>

SoundBank 파일만을 포함하는 단일 파일 패키지를 생성합니다. <filename>은 생성된 파일 패키지의 이름과 이 파일 패키지가 저장될 위치를 지정합니다.

이 인자는 <projectpath>가 지정되지 않았을 때에 지정할 수 있습니다. 전체 파일 경로를 써도 되고 패키지 이름만을 써도 됩니다. 두 옵션 모두 파일 패키지 확장자를 포함해야 합니다.

이 인자는 -output 또는 -output_bnk와 함께 사용되어 각기 다른 파일 집합을 담고 있는 한 개 이상의 패키지를 생성합니다.

-output_loose <directory>

-output_loose

루스 미디어(loose media) 파일만을 포함하는 한 개 이상의 파일 패키지를 생성합니다. 이 파일은 한 개 이상의 SoundBank 안에 든 Event와 구조가 참조하고 있지만 프로젝트의 어떤 SoundBank에도 미디어가 포함되어 있지 않는 것입니다. <directory>는 선택적으로 사용할 수 있으며 생성된 파일 패키지가 저장될 위치를 지정합니다. <directory>가 지정되지 않았을 경우 기본 폴더인 SoundBanksInfo.xml 폴더가 사용됩니다.

이 인자는 <projectpath>가 지정되지 않았을 때에 지정할 수 있습니다. 상대 경로 또는 절대 경로 모두 사용가능합니다.

이 인자는 -output, -output_stm, -output_bnk와 함께 사용되어 각각 다른 파일 집합을 담고 있는 한 개 이상의 패키지 파일을 생성합니다.

-blocksize <number>

패키지 안의 데이터가 이 바이트(byte) 수에 맞춰 조정됩니다. 지정할 숫자는 각 플랫폼 I/O 후크의 요구 사항에 따라 다릅니다.

지정하지 않을 경우 값이 1로 사용되어 조정이 없습니다.

-hideprogressui <boolean>

패키지가 Wwise 내에서 생성될 때 Generating Packages 대화 상자가 표시될지를 정합니다.

true로 설정하면 진행 과정 대화 상자가 표시되지 않습니다. 기본적으로 이 인자는 false로 설정되어 있습니다.

<projectpath>

WFPPROJ 파일을 직접 가리키는 File Packager 프로젝트 경로를 지정합니다. -generate 인자와 함께 사용할 경우 다른 인자들은 무시되며 패키지를 생성할 때 File Packager 프로젝트가 사용됩니다.

이 인자는 선택적으로 사용할 수 있습니다.

-soundbanks_dir <directory>

<directory>가 지정되지 않았을 경우 기본 폴더인 SoundBanksInfo.xml 폴더가 사용됩니다.

이 인자는 보통 'projectpath\GeneratedSoundBanks\platform\' 형식으로 작성됩니다.

이 인자는 선택적으로 사용할 수 있습니다.

-cache_dir <directory>

SoundBanksInfo.xml 파일에서 Wwise가 생성된 SoundBank를 저장한 폴더를 지정하는 정보 ( SoundBanksInfo/RootPaths/SourceFilesRoot에 위치)를 덮어씁니다.

이 인자는 보통 'projectpath\.cache\platform\' 형식으로 작성됩니다.

이 인자는 선택적으로 사용할 수 있습니다.

-languages “<language1> <languageN>“

패키징할 언어를 지정합니다.

[참고]참고

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

SFX도 패키징하려면 언어 목록에 'SFX' 키워드를 사용하세요.

이 인자는 선택적으로 사용할 수 있습니다. 기본적으로는 모든 언어가 패키징됩니다.

이 인자는 File Packager가 지정되지 않았을 때에만 사용됩니다.

-banks “<soundbank1> <soundbankN>“

패키징할 SoundBank를 지정합니다. 이름에는 BNK 확장자가 포함되지 않습니다.

[참고]참고

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

이 인자는 선택적으로 사용할 수 있습니다. 기본적으로는 모든 SoundBank가 패키징됩니다

이 인자는 File Packager 프로젝트가 지정되었을 때에도 사용할 수 있습니다. 이 인자는 지정된 SoundBank를 참조하는 패키지를 자동으로 생성합니다.

-includedFilesInBanks “<soundbank1> <soundbankN>“

뱅크에 포함된 미디어 파일이 루스 파일로 패키지에 추가되어야 하는 SoundBank의 목록을 지정합니다. 이 옵션은 루스 미디어가 PrepareEvent API와 함께 사용되어야 하거나 메모리에 올라간 뱅크에서 필요로 할 때에만 사용됩니다. 이름에는 BNK 확장자가 포함되지 않습니다.

[참고]참고

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

이 인자는 선택적으로 사용할 수 있습니다. 기본적으로 SoundBank 내 미디어 파일은 패키지에 루스 파일로 추가되지 않습니다.

-excludedFilesInBanks “<soundbank1> <soundbankN>“

뱅크에 포함되진 않았지만 참조는 되고 있는 미디어 파일이 루스 파일로 패키지에 추가되어야 하는 SoundBank의 목록을 지정합니다. 이 옵션은 루즈 미디어가 PrepareEvent API와 함께 사용되어야 하거나 메모리에 로딩된 다른 SoundBank에서 이 미디어를 필요로 할 때에만 사용됩니다. 이름에는 BNK 확장자가 포함되지 않습니다.

[참고]참고

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

이 인자는 선택적으로 사용할 수 있습니다. SoundBank에 포함되어 있지 않지만 참조는 되고 있는 미디어 파일은 기본적으로 다른 SoundBank에서 이 파일이 참조하고 있지 않을 때에만 파일 패키지에 추가됩니다.

-verbosity <level>

도구의 표준 출력과 오류 스트림에서 정보를 얼마나 출력할 것인지를 지정합니다.

0 (오류만), 1 (오류와 경고), 2 (오류, 경고, 정보 메시지) 중에서 레벨을 선택할 수 있습니다.

[참고]참고

대규모 프로젝트의 경우 메시지를 출력하면 패키징 과정이 느려질 수 있습니다. 도구 실행이 느리다면 이 전달 인자를 사용해서 상세 출력 레벨을 낮춰서 속도를 높일 수 있습니다.

이 인자는 선택적으로 사용할 수 있습니다. 기본적으로 모든 메시지 종류가 출력됩니다 (레벨 2).


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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요