Options

Name	Type	Description
object *	any of:	The ID (GUID), name, or path of the object to watch.
	string	The name of the object qualified by its type or Short ID in the form of type:name or Global:shortId. Only object types that have globally-unique names or Short Ids are supported. Ex: Event:Play_Sound_01, Global:245489792
	string	An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
	string	A project path to a Wwise object, including the category and the work-unit. For example: \Actor-Mixer Hierarchy\Default Work Unit\New Sound SFX.
property *	string	The property of the watched object to watch. A property name. Refer to Wwise Objects Reference for information about the Wwise objects and their properties.
return	array	Data to be returned for every change on "property" of "object". Refer to Wwise Objects Reference for more information on the properties available. The array of return expressions defines which elements of the Wwise object is returned. This can include built-in accessors, such as the name or id, or object properties, such as the Volume or the Pitch.
return [...]	any of:	A return expression.
	string	Specifies one or many of the built-in accessors for Wwise objects. Possible values: 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	Specifies one or many dot-separated accessors that form a query and yields a value or an object reference. Specifying a single @ returns the value of the property for the associated object. Specifying a double @ returns the value of the property for the source of override. Refer to Wwise Objects Reference .
platform	string	The ID (GUID) of the platform. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.

(Required *)

Options Schema

Publish

Name	Type	Description
object *	object	The watched object. A Wwise object. Use the return options to specify which property is required.
object.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.name	string	The name of the object.
object.notes	string	The notes of the object.
object.type	string	The type of the object. Refer to Wwise Objects Reference for more information on the types available.
object.pluginName	string	The name of the plug-in for Source, Effect, Mixer, Device and Metadata plug-in.
object.path	string	The path of the object from the project root. Ex: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1'
object.parent	object	The parent of the object in the hierarchy.
object.parent.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.parent.name	string	The name of the object.
object.owner	object	The owner of the object. This applies to objects being locally owned by other objects, such as custom effects, custom attenuations, etc.
object.owner.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.owner.name	string	The name of the object.
object.isPlayable	boolean	True if the object can be played in Transport.
object.shortId	integer	The Short ID of the object.
object.classId	integer	The class ID of the object. Unsigned Integer 32-bit. Range: [0,4294967295]
object.category	string	The category of the object. Ex: 'Actor-Mixer Hierarchy'
object.filePath	string	The path to the file containing the object. The path can be a Work Unit file or a project file. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
object.workunit	object	The parent Work Unit containing the object. The 'id' and the 'name' is returned.
object.workunit.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.workunit.name	string	The name of the object.
object.childrenCount	number	The number of children for the object. Note, this is deprecated. The same result can be obtained with children.count().
object.totalSize	integer	The amount of space (in bytes) this object and all of its children take up in a SoundBank. This does not include the objectSize. Note that SoundBanks need to be generated for this value to be accurate.
object.mediaSize	integer	The total converted size (in bytes) of the media files of this object and all of its children. Note that SoundBanks need to be generated for this value to be accurate.
object.objectSize	integer	The amount of space (in bytes) the meta-data of the object takes up in a SoundBank. This does not include media files. Note that SoundBanks need to be generated for this value to be accurate.
object.structureSize	integer	The amount of space (in bytes) the meta-data of the object and all of its children take up in a SoundBank. This does not include media files. Note that SoundBanks need to be generated for this value to be accurate.
object.musicTransitionRoot	object	(DEPRECATED) The music transition root containing all other music transitions recursively. Note, this is deprecated. The TransitionRoot reference should be used instead.
object.musicTransitionRoot.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.musicPlaylistRoot	object	(DEPRECATED) The music playlist root containing all other music playlist items recursively. This applies to Music Playlist Containers only. Note, this is deprecated. The PlaylistRoot reference should be used instead.
object.musicPlaylistRoot.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.originalWavFilePath	string	(DEPRECATED) Absolute path to the original wav file. Only valid for Sound and Audio Source objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
object.originalFilePath	string	Absolute path to the original file. Only valid for Sound and Audio Source objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
object.originalRelativeFilePath	string	Relative (from project's Originals Folder) path to the original file. Only valid for Sound and Audio Source objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
object.activeSource	object	The active source of the sound object.
object.activeSource.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.activeSource.name	string	The name of the object.
object.convertedWemFilePath	string	(DEPRECATED) Absolute path to the converted wem file. Specify the platform in the options. Only valid for Sound and Audio Source objects. To use WAAPI on Mac, please refer to Using WAAPI on Mac .
object.convertedFilePath	string	Absolute path to the converted file. Specify the platform in the options. Only valid for Sound and Audio Source objects. To use WAAPI on Mac, please refer to Using WAAPI on Mac .
object.soundbankBnkFilePath	string	Absolute path to the generated SoundBank file associated with the SoundBank object. Only valid for SoundBank objects. To use WAAPI on Mac, please refer to Using WAAPI on Mac .
object.playbackDuration	object	The duration root that contains the min and max durations and duration type. Note, this is deprecated. The duration should be used instead. This applies to all objects that can contain Audio Source objects, either directly as a source or indirectly through descendants.
object.playbackDuration.playbackDurationMin	number	The minimum possible time playback can take.
object.playbackDuration.playbackDurationMax	number	The maximum possible time playback can take.
object.playbackDuration.playbackDurationType	string	The type of duration.
object.duration	object	The duration root that contains the min and max durations and duration type. This applies to all objects that can contain Audio Source objects, either directly as a source or indirectly through descendants.
object.duration.min	number	The minimum possible time playback can take.
object.duration.max	number	The maximum possible time playback can take.
object.duration.type	string	The type of duration.
object.maxDurationSource	object	Audio source with the longest duration. This applies to all objects that can contain Audio Source objects, either directly as a source or indirectly through descendants.
object.maxDurationSource.id	string	The ID (GUID) of the audio source object with the longest duration. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.maxDurationSource.trimmedDuration	number	The duration in seconds of the longest trimmed source.
object.audioSourceTrimValues	object	Range of time for which the audio source is trimmed.
object.audioSourceTrimValues.trimBegin	number	The time value in seconds of the start trim.
object.audioSourceTrimValues.trimEnd	number	The time value in seconds of the end trim.
object.maxRadiusAttenuation	object	Attenuation with the largest radius. This applies to all objects that can contain Audio Source objects, either directly as a source or indirectly through descendants.
object.maxRadiusAttenuation.id	string	The ID (GUID) of the attenuation object with the largest radius. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.maxRadiusAttenuation.radius	number	The radius of the attenuation object.
object.audioSourceLanguage	object	Language associated to the audio source. This only applies to Audio Source objects directly.
object.audioSourceLanguage.id	string	The ID (GUID) of the Language object to which the Audio Source object is associated. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.audioSourceLanguage.name	string	The name of the Language object to which the Audio Source object is associated.
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.
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.
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.
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.
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.
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.
object.originalChannelMask	number	The mask associated with the channel's configuration. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
object.originalSampleRate	number	The sample rate for the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
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.
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.
object.originalDataSize	number	The data size for bytes the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
object.originalSampleCount	number	The number of samples in the audio file. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
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.
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.
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.
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.
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.
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.
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.
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.
object.convertedChannelMask	number	The mask associated with the channel's configuration. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
object.convertedSampleRate	number	The sample rate for the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
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.
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.
object.convertedDataSize	number	The data size for bytes the audio source. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
object.convertedSampleCount	number	The number of samples in the audio file. This accessor works for Sounds, Audio File Source, Plugin-Media and Music Clips.
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.
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.
object.workunitIsDefault	boolean	True if the work unit is the default.
object.workunitType	string	The type of the Work Unit. Please note that, like Work Units, physical folders have the type "WorkUnit". Physical folders have the workunitType "folder". Possible values: folder rootFile nestedFile
object.workunitIsDirty	boolean	True if a Work Unit or a Project (wproj file) is dirty, meaning it was modified but not saved.
object.switchContainerChildContext	object	The context object associated with the child of a Switch Container. This object holds the properties associated with the child that are context-dependent for the Switch Container (for example: the properties of the '1st only' checkbox).
object.switchContainerChildContext.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.isExplicitMute	boolean	Whether or not the object has been muted explicitly. Explicitly muting an object implicitly mutes the descendant objects.
object.isExplicitSolo	boolean	Whether or not the object has been soloed explicitly. Soloing an object silences all the other objects in the project except this one.
object.isImplicitMute	boolean	Whether or not the object has been muted implicitly. Explicitly muting an object implicitly mutes the descendant objects.
object.isImplicitSolo	boolean	Whether or not the object has been soloed implicitly. Soloing an object silences all the other objects in the project except this one.
object.isIncluded	boolean	Whether or not the object is Included. Specify the platform in the options. This takes into consideration the Inclusion status of the object's ancestors.
object.points	array	This only applies to Curve objects. An array of points defining a curve.
object.points [...]	object	A point in the curve.
object.points[...].x *	number	X coordinate of curve point.
object.points[...].y *	number	Y coordinate of curve point.
object.points[...].shape *	string	Shape of the curve segment between this point and the next. Possible values: Constant Linear Log3 Log2 Log1 InvertedSCurve SCurve Exp1 Exp2 Exp3
object.stateProperties	array	An array of state properties to set.
object.stateProperties [...]	string	The name of the property to set.
object.stateGroups	array	The State Group objects associated with this object.
object.stateGroups [...]	object	A State Group object.
object.stateGroups[...].id	string	The ID (GUID) of the State Group object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.stateGroups[...].name	string	The name of the State Group object.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)*$)	any of:	Specifies dot-separated accessors that form a query and yields a property value or an object reference. A single @ specifies the value of the property for the associated object. A double @ specifies the value of the property for the source of override. Refer to Wwise Objects Reference for more information on the properties and references for all types available.
	string	A string value.
	array	An array of string values.
	number	A numeric value.
	array	An array of numeric values.
	boolean	A boolean value.
	array	An array of boolean values.
	object	An object reference value.
	array	An object list reference value.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)$) [...]*	string	A string value.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)$) [...]*	number	A numeric value.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)$) [...]*	boolean	A boolean value.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)*$).id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)*$).name	string	The name of the object.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)$) [...]*	object	An object reference value.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)*$)[...].id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
object.regex(^((@?@?[a-zA-Z0-9:_,]+)\|[a-zA-Z,]+$.+$)(\.@?@?[a-zA-Z0-9:_,]+\|[a-zA-Z,]+$.+$)*$)[...].name	string	The name of the object.
property *	string	The watched property of the watched object. A property name. Refer to Wwise Objects Reference for information about the Wwise objects and their properties.
old *	any of:	The previous value. The value of a property.
	null	A null value. No reference to an object.
	string	A string value.
	number	A numerical value.
	boolean	A boolean value.
new *	any of:	The new value. The value of a property.
	null	A null value. No reference to an object.
	string	A string value.
	number	A numerical value.
	boolean	A boolean value.
platform *	string	The ID (GUID) of the platform for which the change occurred. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.

(Required *)

Publish Schema

Wwise SDK

ak.wwise.core.object.propertyChanged

Options

Publish

See Also

Was this page helpful?

Need Support?

Tell us about your project. We're here to help.