Wwise 帮助

SoundBank Settings

SoundBank 设置。允许 SoundBank 超出大小上限

决定是否允许生成超出大小上限的 SoundBank。

Use SoundBank names

决定在进行以下任务时，使用 SoundBank 名称还是 ID：

命名生成的 SoundBank 文件（例如“Init.bnk”或“1355168291.bnk”）

当一个 SoundBank 引用了另一个 SoundBank 中的媒体时，识别目标文件。

根据游戏中使用的低级 I/O 实现，该选项可能会影响如何调用 AK::SoundBank::LoadBank()。有关详细信息，请参阅 Wwise SDK 文档中的 使用 SoundBank 名称 。路径为“声音引擎集成纵览 > 将 Wwise 元素集成到游戏中 > 集成 SoundBank > 集成详情 – SoundBank > 一般信息”。

Default value: true

Generate header file

创建包含名称与 ID 映射关系的头文件。头文件用于映射 Event、State、Switch 和 Game Parameter。

该文件将保存在头文件路径中，其命名为“Wwise_IDs.h”。

如果程序员倾向于在代码中使用 ID，则必须生成头文件。

Default value: false

Generate Bank Content TXT Files

创建文件，其中列出各个 SoundBank 内容。内容文件包括有关 Event、总线、状态和切换开关的信息，以及流播放文件和内存媒体文件的完整列表。

您可以通过关联列表指定 SoundBank 内容文件的文本文件类型。

Generate Metadata File

生成元数据文件。为每个指定类型（XML 或 JSON）创建一个文件 (SoundbanksInfo.xml/SoundbanksInfo.json)，并在其中列出所有生成的 SoundBank 的信息。此文件包含 SoundBank 名称、路径、语言、所含 Event 和文件（AMB、WAV 和 WEM）以及为 Metadata Options 指定的各项详细信息。此选项还会创建一个 PluginInfo 文件（XML 或 JSON），并在其中列出工程中所用全部插件的信息。

	在生成 SoundBank 时可能会收到 Invalid info file 错误
	对于流播放文件，Wwise 默认使用 SoundbanksInfo.xml 来完成 SoundBank 生成后步骤。假如无法找到该文件，系统会发出错误消息。因此，请一定要启用 Generate Metadata File 选项。同时，还要启用 Generate XML Metadata 选项。

Generate Per Bank Metadata File

为每个音频包生成元数据文件。为每个指定类型（XML 或 JSON）和单独生成的 SoundBank 创建文件，并在其中列出相关信息。这些文件包含 SoundBank 名称、路径、语言、所含 Event 和文件（AMB、WAV 和 WEM）以及为 Metadata Options 选项指定的各项详细信息。

Generate XML Metadata

生成 XML 元数据。无论启用了哪个 Generate Metadata File 选项，都可在此指定创建 XML 版本。若未启用任何 Generate Metadata File 选项，则将禁用此选项。

正如 Generate Metadata File 选项部分所述，Wwise 需要使用 SoundbanksInfo.xml 文件来处理流播放文件。因此，请务必启用此选项。

Generate JSON Metadata

生成 JSON 元数据。无论启用了哪个 Generate Metadata File 选项，都可在此指定创建 JSON 版本。若未启用任何 Generate Metadata File 选项，则将禁用此选项。

Metadata Options

Include GUID

包含 GUID。添加 Event 和 SoundBank 的全局唯一标识符。

Max attenuation

最大衰减。决定是否在每个 Event 的元数据文件中包含最大衰减信息（详见 Attenuation Editor 中的 Max distance 属性）。对于非 Play 动作，此值将为 0。

Default value: false

尝试确定音频包中每个事件的预期时长。对于各个事件，将包含 DurationType、MinDuration 和 MaxDuration 属性

将尝试计算 SoundBank 中每个 Event 的预期时长。对于各个事件，soundbanksinfo.xml 文件中将包含 DurationType、MinDuration 和 MaxDurations 属性。DurationType 可以是以下值：“OneShot”、“Infinite”、“Mixed”或“Unknown”。“OneShot”表示非循环声音；“Infinite”表示循环声音；“Mixed”表示声音可能无限循环（可能基于随机因素或切换开关）；“Unknown”表示 Wwise 无法确定时长。MinDuration 和 MaxDuration 属性表示事件的最短和最长时长。请注意，这些范围仅为估算值，根据运行时条件不同，可能并不完全准确。

Default value: false

Header file path:

保存 SoundBank 头文件的路径或位置。

根据您使用的是工程位置还是当前用户的自定义位置，该路径或位置可能不同。

浏览。打开 Windows 资源管理器或 Mac Finder，以便更改 SoundBank 头文件的默认保存位置。

SoundBank Paths（SoundBank 路径）

点击列标题区 Configure Columns...（配置列...）快捷方式（右键点击）选项。p

此时将会打开 Configure Columns 对话框。指定要显示的列及其顺序。

Platform

影响音频包生成路径或位置的平台名称，如 Windows、Xbox One、Mac、iOS、Switch 和 PlayStation 4。

SoundBank Folder

保存 SoundBank 的路径或特定文件夹。

根据您使用的是工程位置还是当前用户的自定义位置，该路径或位置可能不同。

(浏览)

打开 Browse For Folder 对话框，可在其中指定各个平台的 SoundBank 将保存至哪些新文件夹。

Pre-Generation Step（预生成步骤）

点击列标题区 Configure Columns...（配置列...）快捷方式（右键点击）选项。p

此时将会打开 Configure Columns 对话框。指定要显示的列及其顺序。

Platform

平台。执行自定义步骤的平台名称，如 Windows、Mac、iOS 和 PlayStation 4。

Global opening step（全局初始步骤）是独立于各平台的步骤，将在其它任何步骤之前执行。

描述

描述命令行的信息。

点击描述后按下 F2，即可在表中直接编辑描述。

Command Line

一种 shell 命令行，允许在 SoundBank 生成后执行自定义步骤。将流播放文件复制到 SoundBank 保存位置的默认命令行。

点击命令，然后按下 F2 即可直接在表中编辑命令行。如果有多个命令行，则必须打开 Post-Generation Step Editor 才能编辑其它的命令行。

(浏览)

打开 Browse For Folder 对话框，可在其中指定各个平台的 SoundBank 将保存至哪些新文件夹。

Post-Generation Step（生成后步骤）

点击列标题区 Configure Columns...（配置列...）快捷方式（右键点击）选项。p

此时将会打开 Configure Columns 对话框。指定要显示的列及其顺序。

Platform

平台。执行自定义步骤的平台名称，如 Windows、Mac、iOS 和 PlayStation 4。

Global opening step（全局初始步骤）是独立于各平台的步骤，将在其它任何步骤之前执行。

描述

描述命令行的信息。

点击描述后按下 F2，即可在表中直接编辑描述。

Command Line

一种 shell 命令行，允许在 SoundBank 生成后执行自定义步骤。将流播放文件复制到 SoundBank 保存位置的默认命令行。

点击命令，然后按下 F2 即可直接在表中编辑命令行。如果有多个命令行，则必须打开 Post-Generation Step Editor 才能编辑其它的命令行。

(浏览)

打开 Browse For Folder 对话框，可在其中指定各个平台的 SoundBank 将保存至哪些新文件夹。

保存工程设置并关闭对话框。

关闭 Project Settings 对话框，不保存这些设置。