Options

Name	Type	Description
return	array	Data to be returned for the Switch Container and the assignment (pair of objects). The array of return expressions defines which elements of the Wwise object will be returned. This can include built-in accessors, such as the name or id, or object properties, such as the Volume or 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 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
	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 .

Options Schema

Publish

Name	Type	Description
stateOrSwitch *	object	The State or Switch to which the child object was assigned. A Wwise object. Use the return options to specify which property is required.
stateOrSwitch.soundbank:bnkFilePath	string	Absolute path to the generated SoundBank file associated with the SoundBank object. Only valid for SoundBank objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
stateOrSwitch.objectSize	integer	The amount of space (in bytes) the meta-data of the object will take up in a SoundBank. This does not include media files. Note that SoundBanks need to be generated for this value to be accurate.
stateOrSwitch.audioSource:maxDurationSource	object	Audio source with longest duration. This applies to all objects that can contain Audio Source objects, either directly as a source or indirectly through descendants.
stateOrSwitch.audioSource:maxDurationSource.id	string	The ID (GUID) of the audio source object with longest duration. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
stateOrSwitch.audioSource:maxDurationSource.trimmedDuration	number	The duration in seconds of the longest trimmed source.
stateOrSwitch.music:transitionRoot	object	The music transition root containing all other music transitions recursively.
stateOrSwitch.music:transitionRoot.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
stateOrSwitch.workunit:type	string	The type of the Work Unit. Please note that, like Work Units, physical folders have the type "WorkUnit". Physical folders will have the workunit:type "folder". Possible values: folder rootFile nestedFile
stateOrSwitch.owner	object	The owner of the object. This applies to objects being locally owned by other objects, such as custom effects, custom attenuations, etc.
stateOrSwitch.owner.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
stateOrSwitch.owner.name	string	The name of the object.
stateOrSwitch.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.
stateOrSwitch.sound:originalWavFilePath	string	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 .
stateOrSwitch.structureSize	integer	The amount of space (in bytes) the meta-data of the object and all of its children will take up in a SoundBank. This does not include media files. Note that SoundBanks need to be generated for this value to be accurate.
stateOrSwitch.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
stateOrSwitch.category	string	The category of the object. Ex: 'Actor-Mixer Hierarchy'
stateOrSwitch.switchContainerChild:context	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: property for the 1st only checkbox).
stateOrSwitch.switchContainerChild:context.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
stateOrSwitch.totalSize	integer	The amount of space (in bytes) this object and all of its children will take up in a SoundBank. This does not include the objectSize. Note that SoundBanks need to be generated for this value to be accurate.
stateOrSwitch.type	string	The type of the object. Refer to Wwise Objects Reference for more information on the types available.
stateOrSwitch.workunit:isDefault	boolean	True if the work unit is the default.
stateOrSwitch.isPlayable	boolean	True if the object can be played in Transport.
stateOrSwitch.audioSource:trimValues	object	Range of time for which the audio source is trimmed.
stateOrSwitch.audioSource:trimValues.trimBegin	number	The time value in seconds of the start trim.
stateOrSwitch.audioSource:trimValues.trimEnd	number	The time value in seconds of the end trim.
stateOrSwitch.audioSource: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.
stateOrSwitch.audioSource:maxRadiusAttenuation.radius	number	The radius of the attenuation object.
stateOrSwitch.audioSource: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}.
stateOrSwitch.parent	object	The parent of the object in the hierarchy.
stateOrSwitch.parent.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
stateOrSwitch.parent.name	string	The name of the object.
stateOrSwitch.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 .
stateOrSwitch.workunit:isDirty	boolean	True if a Work Unit or a Project (wproj file) is dirty, meaning it is modified but not saved.
stateOrSwitch.workunit	object	The parent Work Unit containing the object. The 'id' and the 'name' will be returned.
stateOrSwitch.workunit.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
stateOrSwitch.workunit.name	string	The name of the object.
stateOrSwitch.shortId	integer	The short ID of the object.
stateOrSwitch.sound:convertedWemFilePath	string	Absolute path to the converted wem file. Specify the platform in the options. Only valid for Sound and Audio Source objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
stateOrSwitch.audioSource:playbackDuration	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.
stateOrSwitch.audioSource:playbackDuration.playbackDurationMin	number	The minimum possible time playback can take.
stateOrSwitch.audioSource:playbackDuration.playbackDurationMax	number	The maximum possible time playback can take.
stateOrSwitch.audioSource:playbackDuration.playbackDurationType	string	The type of duration.
stateOrSwitch.path	string	The path of the object from the project root. Ex: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1'
stateOrSwitch.music:playlistRoot	object	The music playlist root containing all other music playlist items recursively. This applies to Music Playlist Containers only.
stateOrSwitch.music:playlistRoot.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
stateOrSwitch.classId	integer	The class ID of the object. Unsigned Integer 32-bit. Range: [0,4294967295]
stateOrSwitch.name	string	The name of the object.
stateOrSwitch.audioSource:language	object	Language associated to the audio source. This only applies to Audio Source objects directly.
stateOrSwitch.audioSource:language.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}.
stateOrSwitch.audioSource:language.name	string	The name of the Language object to which the Audio Source object is associated.
stateOrSwitch.notes	string	The notes of the object.
stateOrSwitch.childrenCount	number	The number of children for the object.
stateOrSwitch.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 using 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.
	number	A numeric value.
	boolean	A boolean value.
	object	An object reference value.
stateOrSwitch.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}.
stateOrSwitch.regex(^((@?@?[a-zA-Z0-9:_]+)\|[a-zA-Z]+(.+))(.@?@?[a-zA-Z0-9:_]+\|[a-zA-Z]+(.+))*$).name	string	The name of the object.
switchContainer *	object	The Switch Container on which the assignment was added. A Wwise object. Use the return options to specify which property is required.
switchContainer.soundbank:bnkFilePath	string	Absolute path to the generated SoundBank file associated with the SoundBank object. Only valid for SoundBank objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
switchContainer.objectSize	integer	The amount of space (in bytes) the meta-data of the object will take up in a SoundBank. This does not include media files. Note that SoundBanks need to be generated for this value to be accurate.
switchContainer.audioSource:maxDurationSource	object	Audio source with longest duration. This applies to all objects that can contain Audio Source objects, either directly as a source or indirectly through descendants.
switchContainer.audioSource:maxDurationSource.id	string	The ID (GUID) of the audio source object with longest duration. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
switchContainer.audioSource:maxDurationSource.trimmedDuration	number	The duration in seconds of the longest trimmed source.
switchContainer.music:transitionRoot	object	The music transition root containing all other music transitions recursively.
switchContainer.music:transitionRoot.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
switchContainer.workunit:type	string	The type of the Work Unit. Please note that, like Work Units, physical folders have the type "WorkUnit". Physical folders will have the workunit:type "folder". Possible values: folder rootFile nestedFile
switchContainer.owner	object	The owner of the object. This applies to objects being locally owned by other objects, such as custom effects, custom attenuations, etc.
switchContainer.owner.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
switchContainer.owner.name	string	The name of the object.
switchContainer.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.
switchContainer.sound:originalWavFilePath	string	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 .
switchContainer.structureSize	integer	The amount of space (in bytes) the meta-data of the object and all of its children will take up in a SoundBank. This does not include media files. Note that SoundBanks need to be generated for this value to be accurate.
switchContainer.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
switchContainer.category	string	The category of the object. Ex: 'Actor-Mixer Hierarchy'
switchContainer.switchContainerChild:context	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: property for the 1st only checkbox).
switchContainer.switchContainerChild:context.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
switchContainer.totalSize	integer	The amount of space (in bytes) this object and all of its children will take up in a SoundBank. This does not include the objectSize. Note that SoundBanks need to be generated for this value to be accurate.
switchContainer.type	string	The type of the object. Refer to Wwise Objects Reference for more information on the types available.
switchContainer.workunit:isDefault	boolean	True if the work unit is the default.
switchContainer.isPlayable	boolean	True if the object can be played in Transport.
switchContainer.audioSource:trimValues	object	Range of time for which the audio source is trimmed.
switchContainer.audioSource:trimValues.trimBegin	number	The time value in seconds of the start trim.
switchContainer.audioSource:trimValues.trimEnd	number	The time value in seconds of the end trim.
switchContainer.audioSource: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.
switchContainer.audioSource:maxRadiusAttenuation.radius	number	The radius of the attenuation object.
switchContainer.audioSource: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}.
switchContainer.parent	object	The parent of the object in the hierarchy.
switchContainer.parent.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
switchContainer.parent.name	string	The name of the object.
switchContainer.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 .
switchContainer.workunit:isDirty	boolean	True if a Work Unit or a Project (wproj file) is dirty, meaning it is modified but not saved.
switchContainer.workunit	object	The parent Work Unit containing the object. The 'id' and the 'name' will be returned.
switchContainer.workunit.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
switchContainer.workunit.name	string	The name of the object.
switchContainer.shortId	integer	The short ID of the object.
switchContainer.sound:convertedWemFilePath	string	Absolute path to the converted wem file. Specify the platform in the options. Only valid for Sound and Audio Source objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
switchContainer.audioSource:playbackDuration	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.
switchContainer.audioSource:playbackDuration.playbackDurationMin	number	The minimum possible time playback can take.
switchContainer.audioSource:playbackDuration.playbackDurationMax	number	The maximum possible time playback can take.
switchContainer.audioSource:playbackDuration.playbackDurationType	string	The type of duration.
switchContainer.path	string	The path of the object from the project root. Ex: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1'
switchContainer.music:playlistRoot	object	The music playlist root containing all other music playlist items recursively. This applies to Music Playlist Containers only.
switchContainer.music:playlistRoot.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
switchContainer.classId	integer	The class ID of the object. Unsigned Integer 32-bit. Range: [0,4294967295]
switchContainer.name	string	The name of the object.
switchContainer.audioSource:language	object	Language associated to the audio source. This only applies to Audio Source objects directly.
switchContainer.audioSource:language.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}.
switchContainer.audioSource:language.name	string	The name of the Language object to which the Audio Source object is associated.
switchContainer.notes	string	The notes of the object.
switchContainer.childrenCount	number	The number of children for the object.
switchContainer.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 using 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.
	number	A numeric value.
	boolean	A boolean value.
	object	An object reference value.
switchContainer.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}.
switchContainer.regex(^((@?@?[a-zA-Z0-9:_]+)\|[a-zA-Z]+(.+))(.@?@?[a-zA-Z0-9:_]+\|[a-zA-Z]+(.+))*$).name	string	The name of the object.
child *	object	The child object that was assigned. A Wwise object. Use the return options to specify which property is required.
child.soundbank:bnkFilePath	string	Absolute path to the generated SoundBank file associated with the SoundBank object. Only valid for SoundBank objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
child.objectSize	integer	The amount of space (in bytes) the meta-data of the object will take up in a SoundBank. This does not include media files. Note that SoundBanks need to be generated for this value to be accurate.
child.audioSource:maxDurationSource	object	Audio source with longest duration. This applies to all objects that can contain Audio Source objects, either directly as a source or indirectly through descendants.
child.audioSource:maxDurationSource.id	string	The ID (GUID) of the audio source object with longest duration. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
child.audioSource:maxDurationSource.trimmedDuration	number	The duration in seconds of the longest trimmed source.
child.music:transitionRoot	object	The music transition root containing all other music transitions recursively.
child.music:transitionRoot.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
child.workunit:type	string	The type of the Work Unit. Please note that, like Work Units, physical folders have the type "WorkUnit". Physical folders will have the workunit:type "folder". Possible values: folder rootFile nestedFile
child.owner	object	The owner of the object. This applies to objects being locally owned by other objects, such as custom effects, custom attenuations, etc.
child.owner.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
child.owner.name	string	The name of the object.
child.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.
child.sound:originalWavFilePath	string	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 .
child.structureSize	integer	The amount of space (in bytes) the meta-data of the object and all of its children will take up in a SoundBank. This does not include media files. Note that SoundBanks need to be generated for this value to be accurate.
child.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
child.category	string	The category of the object. Ex: 'Actor-Mixer Hierarchy'
child.switchContainerChild:context	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: property for the 1st only checkbox).
child.switchContainerChild:context.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
child.totalSize	integer	The amount of space (in bytes) this object and all of its children will take up in a SoundBank. This does not include the objectSize. Note that SoundBanks need to be generated for this value to be accurate.
child.type	string	The type of the object. Refer to Wwise Objects Reference for more information on the types available.
child.workunit:isDefault	boolean	True if the work unit is the default.
child.isPlayable	boolean	True if the object can be played in Transport.
child.audioSource:trimValues	object	Range of time for which the audio source is trimmed.
child.audioSource:trimValues.trimBegin	number	The time value in seconds of the start trim.
child.audioSource:trimValues.trimEnd	number	The time value in seconds of the end trim.
child.audioSource: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.
child.audioSource:maxRadiusAttenuation.radius	number	The radius of the attenuation object.
child.audioSource: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}.
child.parent	object	The parent of the object in the hierarchy.
child.parent.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
child.parent.name	string	The name of the object.
child.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 .
child.workunit:isDirty	boolean	True if a Work Unit or a Project (wproj file) is dirty, meaning it is modified but not saved.
child.workunit	object	The parent Work Unit containing the object. The 'id' and the 'name' will be returned.
child.workunit.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
child.workunit.name	string	The name of the object.
child.shortId	integer	The short ID of the object.
child.sound:convertedWemFilePath	string	Absolute path to the converted wem file. Specify the platform in the options. Only valid for Sound and Audio Source objects. For using WAAPI on Mac, please refer to Using WAAPI on Mac .
child.audioSource:playbackDuration	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.
child.audioSource:playbackDuration.playbackDurationMin	number	The minimum possible time playback can take.
child.audioSource:playbackDuration.playbackDurationMax	number	The maximum possible time playback can take.
child.audioSource:playbackDuration.playbackDurationType	string	The type of duration.
child.path	string	The path of the object from the project root. Ex: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1'
child.music:playlistRoot	object	The music playlist root containing all other music playlist items recursively. This applies to Music Playlist Containers only.
child.music:playlistRoot.id	string	The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
child.classId	integer	The class ID of the object. Unsigned Integer 32-bit. Range: [0,4294967295]
child.name	string	The name of the object.
child.audioSource:language	object	Language associated to the audio source. This only applies to Audio Source objects directly.
child.audioSource:language.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}.
child.audioSource:language.name	string	The name of the Language object to which the Audio Source object is associated.
child.notes	string	The notes of the object.
child.childrenCount	number	The number of children for the object.
child.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 using 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.
	number	A numeric value.
	boolean	A boolean value.
	object	An object reference value.
child.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}.
child.regex(^((@?@?[a-zA-Z0-9:_]+)\|[a-zA-Z]+(.+))(.@?@?[a-zA-Z0-9:_]+\|[a-zA-Z]+(.+))*$).name	string	The name of the object.

(Required *)

Publish Schema

Wwise SDK 2019.1.11

ak.wwise.core.switchContainer.assignmentAdded

Options

Publish

See Also

Was this page helpful?

Need Support?

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