版本

menu_open

在命令行中使用 File Packager 参数

使用命令行生成文件包时,须用特定参数来定义文件包的特征。下表列出了可以用在命令行中的参数。

[注意] 注意

2009.2 及更早版本的 File Packager 参数与当前版本兼容。

参数

Description

-generate

启动文件包生成过程,可与 File Packager 工程路径或 -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_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。

[注意] 注意

默认值 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>“

指定要打包的语言列表。

[注意] 注意

列表由空格进行分隔,并用双引号括起整个参数中的列表。

在语言列表中,可以使用关键字“SFX”以将其打包。

此参数为可选参数。默认情况下会打包所有语言。

仅在未指定 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 也未引用时才会被添加到文件包中。


此页面对您是否有帮助?

需要技术支持?

仍有疑问?或者问题?需要更多信息?欢迎联系我们,我们可以提供帮助!

查看我们的“技术支持”页面

介绍一下自己的项目。我们会竭力为您提供帮助。

来注册自己的项目,我们帮您快速入门,不带任何附加条件!

开始 Wwise 之旅