版本
使用命令行生成文件包时,须用特定参数来定义文件包的特征。下表列出了可以用在命令行中的参数。
注意 | |
---|---|
2009.2 及更早版本的 File Packager 参数与当前版本兼容。 |
参数 |
Description |
|||
---|---|---|---|---|
-generate |
启动文件包生成过程,可与 File Packager 工程路径或 -info 参数一起使用。示例如下:
|
|||
-info <filename> |
指定 SoundBanksInfo.xml 文件的位置。 使用若干个以下参数: -output -put_ |
|||
-output <filename> |
生成一个包含 SoundBank 和流文件的文件包,<filename> 指定文件包名称及其保存位置。 在没有 <projectpath> 时可以指定此参数。完整路径或仅含文件包名称均可,但都要求包含文件包扩展名。 此参数可与 -output_stm 或 -output_bnk 一起使用来生成多个文件包,各自包含不同文件。 虽然工程中也定义了此信息,但如果命令行显式定义了 -output 参数,其优先级将高于工程中的相应信息。 |
|||
-output_stm <filename> |
生成一个仅包含流文件的文件包,<filename> 指定文件包名称及其保存位置。 在没有 <projectpath> 时可以指定此参数。完整路径或仅含文件包名称均可,但都要求包含文件包扩展名。 此参数可与-output_stm 或 -output_bnk 一起使用来生成多个文件包,各自包含不同文件。 |
|||
-output_bnk <filename> |
生成一个仅包含 SoundBank 文件的文件包,<filename> 指定文件包名称及其保存位置。 在没有 <projectpath> 时可以指定此参数。完整路径或仅含文件包名称均可,但都要求包含文件包扩展名。 此参数可与-output_stm 或 -output_bnk 一起使用来生成多个文件包,各自包含不同文件。 |
|||
-output_loose <directory> -output_loose |
生成若干个仅包含零散媒体的文件包。零散文件是被 SoundBank 中的事件或结构所引用,但不包含在工程 SoundBank 中的文件。<directory>可选,用来指定文件包的保存位置,未指定 <directory> 时将使用默认目录,即 SoundBanksInfo.xml 文件目录。 在没有 <projectpath> 时可以指定此参数,目录可以是相对路径或绝对路径。 此参数可与-output、-output_stm 或 -output_bnk 一起使用来生成多个文件包,各自包含不同文件。 |
|||
-blocksize <number> |
文件包内数据对齐的字节数,其大小将取决于平台 I/O 设备的要求。 每个平台的默认值是 1。
有关 Block Size 和各平台 I/O 设备限制的详细信息,请参阅 SDK文档 的 Streaming > Low-Level I/O(流播放 > 底层 I/O)部分。 |
|||
-hideprogressui <boolean> |
指定在 Wwise 内生成文件包时是否显示 Generating Packages 对话框。 如果设置为 True,则进度对话框将不会显示。默认情况下,此参数为 False。 |
|||
<projectpath> |
指定 File Packager 工程路径,直接指向 WFPPROJ 文件。与 -generate 参数一起使用时,将采用此参数指定的 File Packager 工程来生成文件包,而忽略其它参数。 此参数为可选参数。 |
|||
-soundbanks_dir <directory> |
覆盖 SoundBanksInfo.xml 文件(位于 SoundBanksInfo/RootPaths/SourceFilesRoot)中指定的GeneratedSoundBanks 目录信息。 默认路径为:'projectpath\GeneratedSoundBanks\platform\'。 此参数为可选参数。 |
|||
-cache_dir <directory> |
覆盖 SoundBanksInfo.xml 文件(位于 SoundBanksInfo/RootPaths/SourceFilesRoot)中指定的 Wwise 保存已转码结果文件的目录信息。 默认路径为:'projectpath\.cache\platform\'。 此参数为可选参数。 |
|||
-languages “<language1> <languageN>“ |
指定要打包的语言列表。
此参数为可选参数。默认情况下会打包所有语言。 仅在未指定 File Packager 工程时才会使用此参数。 |
|||
-banks “<soundbank1> <soundbankN>“ |
指定要打包的 SoundBank 列表,名称不包含 BNK 扩展名。
此参数为可选参数。默认情况下会打包所有SoundBank。 指定了 File Packager 工程时仍可以使用此参数,将自动创建含有特定 SoundBank 的文件包。 |
|||
-includedFilesInBanks “<soundbank1> <soundbankN>“ |
指定 SoundBank 列表,其中的媒体应作为零散文件添加到文件包中。仅当使用 PrepareEvent API ,且加载的 SoundBank 也需要此媒体时,才应使用此选项。名称不包含 bnk 扩展名。
此参数为可选参数。默认情况下,SoundBank 中的媒体文件不会作为零散文件添加到文件包中。 |
|||
-excludedFilesInBanks “<soundbank1> <soundbankN>“ |
指定 SoundBank 列表,其中引用但不包含的媒体应作为零散文件添加到文件包中。当使用 PrepareEvent API ,且加载的 SoundBank 也需要此媒体时,可以使用此选项。名称不包含 BNK 扩展名。
此参数为可选参数。默认情况下,对于 SoundBank 引用但未包含的媒体文件,仅在其它 SoundBank 也未引用时才会被添加到文件包中。 |