Wwise SDK 2024.1.5

Retrieves the Meter data for all registered busses, aux busses and devices. Only the master audio bus is registered by default. Use ak.wwise.core.profiler.registerMeter for other busses, before retrieval of the meter data.

Arguments

名称	类型	说明
time *	one of:	Time in milliseconds to query for Performance Monitor data, or a Time Cursor from which to acquire the time. User Time Cursor 可由用户操控，Capture Time Cursor 代表当前捕获的最新时间。
	integer	范围：[0,*]
	string	识别其中一种全局性能分析器光标。可能的值： user capture

(必填 *)

参数架构

Options

名称	类型	说明
return	array	指定要为每个对象返回什么内容。有关可用属性和引用的详细信息，请参阅 Wwise 对象参考章节。此数组中包含一系列 return 表达式，用于定义所要返回的 Wwise 对象元素。这可能包括内置访问器（如名称或 ID）或对象属性（如 Volume 或 Pitch）。
return [...]	any of:	return 表达式。
	string	为 Wwise 对象指定一个或多个内置访问器。可能的值： id name notes type pluginName shortId classId category filePath workunit parent owner path isPlayable childrenCount totalSize mediaSize objectSize structureSize sound:convertedWemFilePath sound:originalWavFilePath soundbank:bnkFilePath music:transitionRoot music:playlistRoot audioSource:playbackDuration audioSource:maxDurationSource audioSource:trimValues audioSource:maxRadiusAttenuation audioSource:language workunit:isDefault workunit:type workunit:isDirty switchContainerChild:context convertedWemFilePath originalFilePath originalRelativeFilePath convertedFilePath originalWavFilePath soundbankBnkFilePath musicTransitionRoot musicPlaylistRoot playbackDuration duration maxDurationSource audioSourceTrimValues maxRadiusAttenuation audioSourceLanguage workunitIsDefault workunitType workunitIsDirty switchContainerChildContext isExplicitMute isExplicitSolo isImplicitMute isImplicitSolo isIncluded points stateProperties stateGroups blendTracks
	string	指定一个或多个点号分隔的访问器，来构建查询并生成数值或对象引用。若指定一个 @，则返回关联对象的属性值。若指定两个 @，则返回 override 对应源的属性值。参阅 Wwise 对象参考章节。
platform	any of:	平台的 ID (GUID) 或名称。此项为可选参数。若不作任何指定，则使用当前平台。
	string	平台的名称。
	string	平台的 ID。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
language	any of:	语言的 ID (GUID) 或名称。
	string	语言的名称。
	string	语言的 ID。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。

选项架构

Result

名称	类型	说明
meters *	array	Array of registered meters.
meters [...]	object	The meter information.
meters[...].object *	object	The metered object. A Wwise object. 使用 return 选项来指定所需的属性。
meters[...].object.id	string	对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.name	string	对象的名称。
meters[...].object.notes	string	对象的备注。
meters[...].object.type	string	对象的类型。有关可用类型的详细信息，请参阅 Wwise 对象参考章节。
meters[...].object.pluginName	string	Source、Effect、Mixer、Device 和 Metadata 插件的插件名称。
meters[...].object.path	string	工程根目录下的对象路径。例如：'\Actor-Mixer Hierarchy\Default Work Unit\Sound1'
meters[...].object.parent	object	层级结构下的对象的父对象。
meters[...].object.parent.id	string	对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.parent.name	string	对象的名称。
meters[...].object.owner	object	对象的所有者。此项适用于其他对象在本地拥有的对象（如自定义效果器、自定义衰减等）。
meters[...].object.owner.id	string	对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.owner.name	string	对象的名称。
meters[...].object.isPlayable	boolean	若对象可在 Transport 中播放，则返回 true。
meters[...].object.shortId	integer	对象的 Short ID。
meters[...].object.classId	integer	对象的 Class ID。 32 位无符号整数。范围：[0,4294967295]
meters[...].object.category	string	对象的类别。例如：'Actor-Mixer Hierarchy'
meters[...].object.filePath	string	对象所在文件的路径。该路径可为 Work Unit 文件或工程文件。如需了解如何在 Mac 上使用 WAAPI，请参阅在 Mac 上使用 WAAPI 章节。
meters[...].object.workunit	object	对象所在的父级 Work Unit。返回 'id' 和 'name'。
meters[...].object.workunit.id	string	对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.workunit.name	string	对象的名称。
meters[...].object.childrenCount	number	对象的子对象数量。注意，此项已弃用。The same result can be obtained with children.count().
meters[...].object.totalSize	integer	此对象及其所有子对象在 SoundBank 中占用的空间大小（字节）。此项不包括 objectSize。注意，需生成 SoundBank 方可确保此数值的准确性。
meters[...].object.mediaSize	integer	此对象及其所有子对象的媒体文件的 Converted Size 总和（字节）。注意，需生成 SoundBank 方可确保此数值的准确性。
meters[...].object.objectSize	integer	对象的元数据在 SoundBank 中占用的空间大小（字节）。此项不包括媒体文件。注意，需生成 SoundBank 方可确保此数值的准确性。
meters[...].object.structureSize	integer	对象及其所有子对象的元数据在 SoundBank 中占用的空间大小（字节）。此项不包括媒体文件。注意，需生成 SoundBank 方可确保此数值的准确性。
meters[...].object.musicTransitionRoot	object	(DEPRECATED) The music transition root containing all other music transitions recursively. 注意，此项已弃用。The TransitionRoot reference should be used instead.
meters[...].object.musicTransitionRoot.id	string	对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.musicPlaylistRoot	object	(DEPRECATED) The music playlist root containing all other music playlist items recursively. 此项仅适用于 Music Playlist Container。注意，此项已弃用。The PlaylistRoot reference should be used instead.
meters[...].object.musicPlaylistRoot.id	string	对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.originalWavFilePath	string	（已弃用）原始 wav 文件的绝对路径。仅适用于 Sound 和 Audio Source 对象。如需了解如何在 Mac 上使用 WAAPI，请参阅在 Mac 上使用 WAAPI 章节。
meters[...].object.originalFilePath	string	原始文件的绝对路径。仅适用于 Sound 和 Audio Source 对象。如需了解如何在 Mac 上使用 WAAPI，请参阅在 Mac 上使用 WAAPI 章节。
meters[...].object.originalRelativeFilePath	string	Relative (from project's Originals Folder) path to the original file. 仅适用于 Sound 和 Audio Source 对象。如需了解如何在 Mac 上使用 WAAPI，请参阅在 Mac 上使用 WAAPI 章节。
meters[...].object.activeSource	object	声音对象的活跃音频源。
meters[...].object.activeSource.id	string	对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.activeSource.name	string	对象的名称。
meters[...].object.convertedWemFilePath	string	（已弃用）转码后 wem 文件的绝对路径。指定选项中的平台。仅适用于 Sound 和 Audio Source 对象。如需了解如何在 Mac 上使用 WAAPI，请参阅在 Mac 上使用 WAAPI 章节。
meters[...].object.convertedFilePath	string	转码后文件的绝对路径。指定选项中的平台。仅适用于 Sound 和 Audio Source 对象。如需了解如何在 Mac 上使用 WAAPI，请参阅在 Mac 上使用 WAAPI 章节。
meters[...].object.soundbankBnkFilePath	string	所生成的 SoundBank 文件的绝对路径，该文件与 SoundBank 对象关联。仅适用于 SoundBank 对象。如需了解如何在 Mac 上使用 WAAPI，请参阅在 Mac 上使用 WAAPI 章节。
meters[...].object.playbackDuration	object	包含最小/最大时长和时长类型的 Duration 根对象。注意，此项已弃用。应当改用时长。此项适用于可包含 Audio Source 对象的所有对象（以源的形式直接实现，或通过下级对象间接实现）。
meters[...].object.playbackDuration.playbackDurationMin	number	播放操作可能花费的最小时长。
meters[...].object.playbackDuration.playbackDurationMax	number	播放操作可能花费的最大时长。
meters[...].object.playbackDuration.playbackDurationType	string	时长的类型。
meters[...].object.duration	object	包含最小/最大时长和时长类型的 Duration 根对象。此项适用于可包含 Audio Source 对象的所有对象（以源的形式直接实现，或通过下级对象间接实现）。
meters[...].object.duration.min	number	播放操作可能花费的最小时长。
meters[...].object.duration.max	number	播放操作可能花费的最大时长。
meters[...].object.duration.type	string	时长的类型。
meters[...].object.maxDurationSource	object	时长最长的音频源。此项适用于可包含 Audio Source 对象的所有对象（以源的形式直接实现，或通过下级对象间接实现）。
meters[...].object.maxDurationSource.id	string	时长最长的 Audio Source 对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.maxDurationSource.trimmedDuration	number	修剪的最长音频源的时长（秒）。
meters[...].object.audioSourceTrimValues	object	修剪的音频源的时间范围。
meters[...].object.audioSourceTrimValues.trimBegin	number	Trim Start 的时间值（秒）。
meters[...].object.audioSourceTrimValues.trimEnd	number	Trim End 的时间值（秒）。
meters[...].object.maxRadiusAttenuation	object	半径最长的衰减。此项适用于可包含 Audio Source 对象的所有对象（以源的形式直接实现，或通过下级对象间接实现）。
meters[...].object.maxRadiusAttenuation.id	string	半径最长的 Attenuation 对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.maxRadiusAttenuation.radius	number	Attenuation 对象的半径。
meters[...].object.audioSourceLanguage	object	与音频源关联的语言。此项仅直接适用于 Audio Source 对象。
meters[...].object.audioSourceLanguage.id	string	与 Audio Source 对象关联的 Language 对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.audioSourceLanguage.name	string	与 Audio Source 对象关联的 Language 对象的名称。
meters[...].object.originalTotalChannelCount	number	The total number of channels present in the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalNormalChannelCount	number	The number of channel in the normal plane of the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalHeightChannelCount	number	The number of channel in the height plane of the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalLFEChannelCount	number	The number of low frequency channel in the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalAnonymousChannelCount	number	The number of anonymous channel in the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalChannelConfig	string	The configuration of the channels in the audio source (Ex : 7.1.4). For anonymous channels, returns Anonymous. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalChannelMask	number	The mask associated with the channel's configuration. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalSampleRate	number	The sample rate for the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalBitDepth	number	The sample rate for the audio source. Either 16 or 24. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalFileSize	number	The file size in bytes for the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalDataSize	number	The data size for bytes the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalSampleCount	number	The number of samples in the audio file. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalDuration	number	The file duration. Differs from generic Duration field because the original file does not include Trim Begind/End. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.originalCodec	string	The audio file's codec. For original files, it will always be PCM. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedTotalChannelCount	number	The total number of channels present in the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedNormalChannelCount	number	The number of channel in the normal plane of the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedHeightChannelCount	number	The number of channel in the height plane of the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedLFEChannelCount	number	The number of low frequency channel in the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedAnonymousChannelCount	number	The number of anonymous channel in the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedChannelConfig	string	The configuration of the channels in the audio source (Ex : 7.1.4). For anonymous channels, returns Anonymous. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedChannelMask	number	The mask associated with the channel's configuration. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedSampleRate	number	The sample rate for the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedBitDepth	number	The sample rate for the audio source. Either 16 or 24. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedFileSize	number	The file size in bytes for the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedDataSize	number	The data size for bytes the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedSampleCount	number	The number of samples in the audio file. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedDuration	number	The file duration. Differs from generic Duration field because the original file does not include Trim Begind/End. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.convertedCodec	string	The audio file's codec. For original files, it will always be PCM. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
meters[...].object.workunitIsDefault	boolean	若为 Default Work Unit，则返回 true。
meters[...].object.workunitType	string	Work Unit 的类型。请注意，物理文件夹与 Work Unit 一样，类型都是 WorkUnit。物理文件夹的 workunitType 为 "folder"。可能的值： folder rootFile nestedFile
meters[...].object.workunitIsDirty	boolean	若 Work Unit 或工程（wproj 文件）处于未同步状态（即修改了而没保存），则返回 true。
meters[...].object.switchContainerChildContext	object	与 Switch Container 的子对象关联的上下文对象。此对象具有与子对象关联的属性（对 Switch Container 来说，与上下文相关）。比如，'1st only' 复选框的属性。
meters[...].object.switchContainerChildContext.id	string	对象的 ID (GUID)。以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。
meters[...].object.isExplicitMute	boolean	对象是否已被显式设为 Mute 状态。若对象显式被设为 Mute 状态，则将子级对象隐式设为 Mute 状态。
meters[...].object.isExplicitSolo	boolean	对象是否已被显式设为 Solo 状态。若对象被设为 Solo 状态，则将工程中除此之外的所有其他对象静音。
meters[...].object.isImplicitMute	boolean	对象是否已被隐式设为 Mute 状态。若对象显式被设为 Mute 状态，则将子级对象隐式设为 Mute 状态。
meters[...].object.isImplicitSolo	boolean	对象是否已被隐式设为 Solo 状态。若对象被设为 Solo 状态，则将工程中除此之外的所有其他对象静音。
meters[...].object.isIncluded	boolean	Whether or not the object is Included. 指定选项中的平台。This takes into consideration the Inclusion status of the object's ancestors.
meters[...].object.points	array	此项仅适用于 Curve 对象。此数组中包含定义曲线的控制点。
meters[...].object.points [...]	object	曲线上的控制点。
meters[...].object.points[...].x *	number	曲线控制点的 X 坐标。
meters[...].object.points[...].y *	number	曲线控制点的 Y 坐标。
meters[...].object.points[...].shape *	string	这一控制点和下一控制点之间曲线线段的形状。可能的值： Constant Linear Log3 Log2 Log1 InvertedSCurve SCurve Exp1 Exp2 Exp3
meters[...].object.stateProperties	array	An array of state properties to set.
meters[...].object.stateProperties [...]	string	The name of the property to set.
meters[...].object.stateGroups	array	The State Group objects associated with this object.
meters[...].object.stateGroups [...]	object	A State Group object.
meters[...].object.stateGroups[...].id	string	The ID (GUID) of the State Group object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
meters[...].object.stateGroups[...].name	string	The name of the State Group object.
meters[...].object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)*$)	any of:	指定点号分隔的访问器，来构建查询并生成属性值或对象引用。若指定一个 @，则返回关联对象的属性值。若指定两个 @，则返回 override 对应源的属性值。如需详细了解所有可用类型的属性和引用，请参阅 Wwise 对象参考章节。
	string	字符串值。
	array	An array of string values.
	number	数字值。
	array	An array of numeric values.
	boolean	布尔值。
	array	An array of boolean values.
	object	对象引用值。
	array	对象列表引用值。
meters[...].object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)$) [...]*	string	字符串值。
meters[...].object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)$) [...]*	number	数字值。
meters[...].object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)$) [...]*	boolean	布尔值。
meters[...].object.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}。
meters[...].object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)*$).name	string	对象的名称。
meters[...].object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)$) [...]*	object	对象引用值。
meters[...].object.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}。
meters[...].object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)*$)[...].name	string	对象的名称。
meters[...].source *	string	The type of meter data. 可能的值： Bus DeviceMainMix DevicePassthrough DeviceSystemAudioObjects
meters[...].configurationName *	string	The name of the channel configuration.
meters[...].configurationMask *	integer	The bit field of the channel configuration.
meters[...].configurationType *	string	The type of the configuration for the meter. 可能的值： Anonymous Standard Ambisonic Objects
meters[...].channels *	array	An array of channels for this object, in the same order as the Meter in Wwise.
meters[...].channels [...]	object	The channel value with corresponding name.
meters[...].channels[...].name *	string	The name of the channel.
meters[...].channels[...].value *	number	The channel value in decibels.

(必填 *)

结果架构

另请参阅

示例

Retrieving the meter values after registering a bus for meter

有关 Wwise Authoring API 的详细信息，请参阅使用 Wwise Authoring API（WAAPI）章节。

此页面对您是否有帮助？

需要技术支持？

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

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

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

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

开始 Wwise 之旅

Arguments
Options
Result
另请参阅
示例

Wwise SDK

ak.wwise.core.profiler.getMeters