Wwise SDK 2021.1.14
|
在生成单个 SoundBank 后发送。可在 SoundBank 生成期间发送多次,针对生成的每个 SoundBank 以及平台。如需了解如何生成 SoundBank,请参阅 ak.wwise.core.soundbank.generate 或 ak.wwise.ui.commands.execute 来查看 SoundBank 生成命令。如需查看命令列表,请参阅 Wwise 设计工具命令标识符 章节。
名称 | 类型 | 说明 |
---|---|---|
infoFile | boolean | 在响应中嵌入 JSON SoundBank 信息文件。 |
bankData | boolean | 在响应中嵌入 base64 SoundBank 数据。 |
pluginInfo | boolean | 在响应中嵌入 JSON PluginInfo 文件。 |
return | array | 要为所生成 SoundBank 返回的数据。有关可用属性的详细信息,请参阅 Wwise 对象参考 章节。 此数组中包含一系列 return 表达式,用于定义所要返回的 Wwise 对象元素。这可能包括内置访问器(如名称或 ID)或对象属性(如 Volume 或 Pitch)。 |
return [...] | any of: | return 表达式。 |
string | 为 Wwise 对象指定一个或多个内置访问器。可能的值:
|
|
string | 指定一个或多个点号分隔的访问器,来构建查询并生成数值或对象引用。若指定一个 @,则返回关联对象的属性值。若指定两个 @,则返回 override 对应源的属性值。参阅 Wwise 对象参考 章节。 |
名称 | 类型 | 说明 |
---|---|---|
soundbank | object | 生成的 SoundBank。使用 return 选项获取特定细节。 Wwise 对象。使用 return 选项来指定所需的属性。 |
soundbank.id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.name | string | 对象的名称。 |
soundbank.notes | string | 对象的备注。 |
soundbank.type | string | 对象的类型。有关可用类型的详细信息,请参阅 Wwise 对象参考 章节。 |
soundbank.pluginName | string | Source、Effect、Mixer、Device 和 Metadata 插件的插件名称。 |
soundbank.path | string | 工程根目录下的对象路径。例如:'\Actor-Mixer Hierarchy\Default Work Unit\Sound1' |
soundbank.parent | object | 层级结构下的对象的父对象。 |
soundbank.parent.id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.parent.name | string | 对象的名称。 |
soundbank.owner | object | 对象的所有者。此项适用于其他对象在本地拥有的对象(如自定义效果器、自定义衰减等)。 |
soundbank.owner.id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.owner.name | string | 对象的名称。 |
soundbank.isPlayable | boolean | 若对象可在 Transport 中播放,则返回 true。 |
soundbank.shortId | integer | 对象的 Short ID。 |
soundbank.classId | integer | 对象的 Class ID。 32 位无符号整数。范围:[0,4294967295] |
soundbank.category | string | 对象的类别。例如:'Actor-Mixer Hierarchy' |
soundbank.filePath | string | 对象所在文件的路径。该路径可为 Work Unit 文件或工程文件。如需了解如何在 Mac 上使用 WAAPI,请参阅 在 Mac 上使用 WAAPI 章节。 |
soundbank.workunit | object | 对象所在的父级 Work Unit。返回 'id' 和 'name'。 |
soundbank.workunit.id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.workunit.name | string | 对象的名称。 |
soundbank.childrenCount | number | 对象的子对象数量。 |
soundbank.totalSize | integer | 此对象及其所有子对象在 SoundBank 中占用的空间大小(字节)。此项不包括 objectSize。注意,需生成 SoundBank 方可确保此数值的准确性。 |
soundbank.mediaSize | integer | 此对象及其所有子对象的媒体文件的 Converted Size 总和(字节)。注意,需生成 SoundBank 方可确保此数值的准确性。 |
soundbank.objectSize | integer | 对象的元数据在 SoundBank 中占用的空间大小(字节)。此项不包括媒体文件。注意,需生成 SoundBank 方可确保此数值的准确性。 |
soundbank.structureSize | integer | 对象及其所有子对象的元数据在 SoundBank 中占用的空间大小(字节)。此项不包括媒体文件。注意,需生成 SoundBank 方可确保此数值的准确性。 |
soundbank.musicTransitionRoot | object | 包含其他所有以递归方式获取的 Music Transition 的 Music Transition 根对象。 |
soundbank.musicTransitionRoot.id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.musicPlaylistRoot | object | 包含其他所有以递归方式获取的 Music Playlist 条目的 Music Playlist 根对象。此项仅适用于 Music Playlist Container。 |
soundbank.musicPlaylistRoot.id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.originalWavFilePath | string | 原始 wav 文件的绝对路径。仅适用于 Sound 和 Audio Source 对象。如需了解如何在 Mac 上使用 WAAPI,请参阅 在 Mac 上使用 WAAPI 章节。 |
soundbank.convertedWemFilePath | string | 转码后 wem 文件的绝对路径。指定选项中的平台。仅适用于 Sound 和 Audio Source 对象。如需了解如何在 Mac 上使用 WAAPI,请参阅 在 Mac 上使用 WAAPI 章节。 |
soundbank.soundbankBnkFilePath | string | 所生成的 SoundBank 文件的绝对路径,该文件与 SoundBank 对象关联。仅适用于 SoundBank 对象。如需了解如何在 Mac 上使用 WAAPI,请参阅 在 Mac 上使用 WAAPI 章节。 |
soundbank.playbackDuration | object | 包含最小/最大时长和时长类型的 Duration 根对象。此项适用于可包含 Audio Source 对象的所有对象(以源的形式直接实现,或通过下级对象间接实现)。 |
soundbank.playbackDuration.playbackDurationMin | number | 播放操作可能花费的最小时长。 |
soundbank.playbackDuration.playbackDurationMax | number | 播放操作可能花费的最大时长。 |
soundbank.playbackDuration.playbackDurationType | string | 时长的类型。 |
soundbank.maxDurationSource | object | 时长最长的音频源。此项适用于可包含 Audio Source 对象的所有对象(以源的形式直接实现,或通过下级对象间接实现)。 |
soundbank.maxDurationSource.id | string | 时长最长的 Audio Source 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.maxDurationSource.trimmedDuration | number | 修剪的最长音频源的时长(秒)。 |
soundbank.audioSourceTrimValues | object | 修剪的音频源的时间范围。 |
soundbank.audioSourceTrimValues.trimBegin | number | Trim Start 的时间值(秒)。 |
soundbank.audioSourceTrimValues.trimEnd | number | Trim End 的时间值(秒)。 |
soundbank.maxRadiusAttenuation | object | 半径最长的衰减。此项适用于可包含 Audio Source 对象的所有对象(以源的形式直接实现,或通过下级对象间接实现)。 |
soundbank.maxRadiusAttenuation.id | string | 半径最长的 Attenuation 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.maxRadiusAttenuation.radius | number | Attenuation 对象的半径。 |
soundbank.audioSourceLanguage | object | 与音频源关联的语言。此项仅直接适用于 Audio Source 对象。 |
soundbank.audioSourceLanguage.id | string | 与 Audio Source 对象关联的 Language 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.audioSourceLanguage.name | string | 与 Audio Source 对象关联的 Language 对象的名称。 |
soundbank.workunitIsDefault | boolean | 若为 Default Work Unit,则返回 true。 |
soundbank.workunitType | string | Work Unit 的类型。请注意,物理文件夹与 Work Unit 一样,类型都是 WorkUnit。物理文件夹的 workunitType 为 "folder"。可能的值:
|
soundbank.workunitIsDirty | boolean | 若 Work Unit 或工程(wproj 文件)处于未同步状态(即修改了而没保存),则返回 true。 |
soundbank.switchContainerChildContext | object | 与 Switch Container 的子对象关联的上下文对象。此对象具有与子对象关联的属性(对 Switch Container 来说,与上下文相关)。比如,'1st only' 复选框的属性。 |
soundbank.switchContainerChildContext.id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$) | any of: | 指定点号分隔的访问器,来构建查询并生成属性值或对象引用。若指定一个 @,则返回关联对象的属性值。若指定两个 @,则返回 override 对应源的属性值。如需详细了解所有可用类型的属性和引用,请参阅 Wwise 对象参考 章节。 |
string | 字符串值。 | |
number | 数字值。 | |
boolean | 布尔值。 | |
object | 对象引用值。 | |
array | 对象列表引用值。 | |
soundbank.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$).id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$).name | string | 对象的名称。 |
soundbank.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$) [...] | object | 对象引用值。 |
soundbank.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$)[...].id | string | 对象的 ID (GUID)。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
soundbank.regex(^((@?@?[a-zA-Z0-9:_]+)|[a-zA-Z]+\(.+\))(.@?@?[a-zA-Z0-9:_]+|[a-zA-Z]+\(.+\))*$)[...].name | string | 对象的名称。 |
platform | object | 针对该平台生成了 SoundBank。 |
language | object | 针对该语言生成了 SoundBank。仅在针对特定语言生成 SoundBank 时显示。 |
error | string | 错误消息(如出现错误)。仅在出现错误时显示。 |
bankData | object | 此 SoundBank 数据对象包含 base64 编码的实际数据及数据大小。 |
bankData.data | string | base64 编码的 SoundBank 数据。 |
bankData.size | integer | 编码后 SoundBank 数据的大小。 |
bankInfo | array | SoundBank 的所有信息。 |
bankInfo [...] | object | SoundBank 信息。 |
bankInfo[...].Id | string | 生成的 SoundBank 的 Short ID(以字符串形式编码)。 |
bankInfo[...].GUID | string | 生成的 SoundBank 的 GUID。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
bankInfo[...].ObjectPath | string | 工程中的对象路径。 |
bankInfo[...].Language | string | 此 SoundBank 中所用语言的名称。 |
bankInfo[...].ShortName | string | SoundBank 的名称。 |
bankInfo[...].Path | string | SoundBank 的文件名。 |
bankInfo[...].IncludedEvents | array | 此 SoundBank 中包含的所有 Event 及其信息。 |
bankInfo[...].IncludedEvents [...] | object | Event 信息。 |
bankInfo[...].IncludedEvents[...].Id | string | Event 的 Short ID。 |
bankInfo[...].IncludedEvents[...].Name | string | Event 的名称。 |
bankInfo[...].IncludedEvents[...].GUID | string | Event 的 GUID。 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。 |
bankInfo[...].IncludedEvents[...].MaxAttenuation | string | Event 的最大衰减(浮点值)。 |
bankInfo[...].IncludedEvents[...].DurationType | string | 时长的类型。可能的值:OneShot、Unknown、Infinite、Mixed。 |
bankInfo[...].IncludedEvents[...].DurationMin | string | 时长的最小值(浮点值)。 |
bankInfo[...].IncludedEvents[...].DurationMax | string | 时长的最大值(浮点值)。 |
bankInfo[...].IncludedEvents[...].ReferencedStreamedFiles | array | 该数组中包含此 SoundBank 或 Event 所用的全部流播放文件。 |
bankInfo[...].IncludedEvents[...].ReferencedStreamedFiles [...] | object | Referenced Streamed File 条目。 Media File 引用。 |
bankInfo[...].IncludedEvents[...].ReferencedStreamedFiles[...].Id | string | 媒体的 Short ID。 |
bankInfo[...].IncludedEvents[...].ReferencedStreamedFiles[...].Language | string | 此媒体所用的语言名称。 |
bankInfo[...].IncludedEvents[...].ReferencedStreamedFiles[...].ShortName | string | 原始文件的文件名。 |
bankInfo[...].IncludedEvents[...].ReferencedStreamedFiles[...].Path | string | 转码后的媒体相对于缓存文件夹的路径。 |
bankInfo[...].IncludedEvents[...].ReferencedStreamedFiles[...].PrefetchSize | string | Prefetch Size 的字节大小。 |
bankInfo[...].IncludedEvents[...].ReferencedStreamedFiles[...].UseDeviceMemory | string | 媒体是否需要设备内存。可能的值:
|
bankInfo[...].IncludedEvents[...].ExcludedMemoryFiles | array | 此数组中包含 SoundBank 或 Event 内弃用的媒体。若针对流播放文件使用 Prefetch,则将在此处列出 Prefetch Size。 |
bankInfo[...].IncludedEvents[...].ExcludedMemoryFiles [...] | object | Excluded Streamed File 条目。 Media File 引用。 |
bankInfo[...].IncludedEvents[...].ExcludedMemoryFiles[...].Id | string | 媒体的 Short ID。 |
bankInfo[...].IncludedEvents[...].ExcludedMemoryFiles[...].Language | string | 此媒体所用的语言名称。 |
bankInfo[...].IncludedEvents[...].ExcludedMemoryFiles[...].ShortName | string | 原始文件的文件名。 |
bankInfo[...].IncludedEvents[...].ExcludedMemoryFiles[...].Path | string | 转码后的媒体相对于缓存文件夹的路径。 |
bankInfo[...].IncludedEvents[...].ExcludedMemoryFiles[...].PrefetchSize | string | Prefetch Size 的字节大小。 |
bankInfo[...].IncludedEvents[...].ExcludedMemoryFiles[...].UseDeviceMemory | string | 媒体是否需要设备内存。可能的值:
|
PluginInfo | object | PluginInfo 文件信息。 |
PluginInfo.Project | string | Wwise 工程的名称。 |
PluginInfo.Platform | string | 平台的名称。 |
PluginInfo.BasePlatform | string | 当前平台所基于的基础平台。 |
PluginInfo.Plugins | array | 此数组中包含一系列插件。 |
PluginInfo.Plugins [...] | object | 插件信息。 |
PluginInfo.Plugins[...].Name | string | 插件的 Display Name。 |
PluginInfo.Plugins[...].ID | string | 插件的 Short ID。 |
PluginInfo.Plugins[...].DLL | string | 插件 DLL 的名称。 |
有关 Wwise Authoring API 的详细信息,请参阅 使用 Wwise Authoring API(WAAPI) 章节。