Wwise Help

-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。

	备注
	默认值 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 也未引用时才会被添加到文件包中。

-verbosity <level>

指定要在工具的标准输出和错误流中显示多少信息。

Level 可为 0（仅错误）、1（错误和警告）或 2（错误、警告和信息）。

	备注
	消息显示操作可能会减慢大型工程的打包过程。若发现工具运行缓慢，可使用此参数来降低详细级别 (verbosity level) 以提升速度。

此参数为可选参数。在默认情况下，输出所有类型的消息（Level 为 2）。