|
Wwise SDK 2023.1.8
|
Allows for batch processing of the following operations: Object creation in a child hierarchy, Object creation in a list, Setting name, notes, properties and references. Refer to Importing Audio Files and Creating Structures for more information about creating objects. Also refer to ak.wwise.core.audio.import to import audio files to Wwise.
| Name | Type | Description |
|---|---|---|
| objects * | array | An array of objects on which to set values and create child or list objects. |
| objects [...] | object | The object specification, values to set, objects to create, and overriding options applicable to this object. |
| objects[...].object * | any of: | The ID (GUID), name, or path of the existing object on which to set the name, notes, properties or references and under which to create children or create objects in a list. |
| 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. | |
| objects[...].platform | any of: | The ID (GUID) or unique name of the platform used when setting properties and references via this operation. Not specifying a platform sets the value for all linked platforms. |
| string | The name of the object. | |
| string | An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. | |
| objects[...].onNameConflict | string | The action to take if "object" already has a child with the same name. Default value is "fail". Refer to Understanding the name conflict modes for more information. Possible values:
|
| objects[...].listMode | string | The action to take if "object" already has objects in a specified list. Default value is "append". Refer to Understanding lists and list modes for more information. Possible values:
|
| objects[...].name | string | The new name of "object". |
| objects[...].notes | string | The new notes or comments of "object". |
| objects[...].children | array | An array of child objects to be created. |
| objects[...].children [...] | object | Child objects to be created. Child object to be created. |
| objects[...].children[...].platform | any of: | The ID (GUID) or unique name of the platform used when setting properties and references via this operation. Not specifying a platform sets the value for all linked platforms. |
| string | The name of the object. | |
| string | An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. | |
| objects[...].children[...].type * | string | The type of the new object. Refer to Wwise Objects Reference for possible object types or Wwise Nodes Reference for possible node types. |
| objects[...].children[...].name * | string | The name of the new object. |
| objects[...].children[...].notes | string | The notes or comments of the new object. |
| objects[...].children[...].classId | integer | The ID (class ID) of the plug-in. Only specify for Effect or Source plug-ins. Refer to Wwise Objects Reference for possible ClassId values. Unsigned Integer 32-bit. Range: [0,4294967295] |
| objects[...].children[...].language | string | The ID (GUID) or name of the language. Only use this argument when creating Sound Voice objects. |
| objects[...].children[...].children | An array of child objects to be created (Recursive). | |
| objects[...].children[...].import | object | Import command argument. |
| objects[...].children[...].import.autoAddToSourceControl | boolean | Determines if Wwise automatically performs an Add source control operation for affected work units. Defaults to true. |
| objects[...].children[...].import.files * | array | Array of import files. |
| objects[...].children[...].import.files [...] | object | Parameters of one audio file |
| objects[...].children[...].import.files[...].audioFile | string | Path to media file to import. This path must be accessible from Wwise. For using WAAPI on Mac, please refer to Using WAAPI on Mac . |
| objects[...].children[...].import.files[...].audioFileBase64 | string | Base64 encoded WAV audio file data to import with its target file path relative to the Originals folder, separated by a vertical bar. E.g. 'MySound.wav|UklGRu...'. |
| objects[...].children[...].import.files[...].originalsSubFolder | string | Specifies the 'originals' sub-folder in which to place the imported audio file. This folder is relative to the 'originals' folder in which the file would normally be imported. Example: if importing an SFX, then the audio file is imported to the folder Originals\SFX\originalsPath. |
| objects[...].children[...].import.files[...].language | string | Imports the language for the audio file import (taken from the project's defined languages, found in the WPROJ file LanguageList). |
| objects[...].children[...].import.files[...].objectType | string | Specifies the type of object to create when importing an audio file. This type can also be specified directly in the objectPath. Refer to Wwise Objects Reference for the available types. |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$) | any of: | |
| Objects to create in list @listName. Refer to Wwise Objects Reference for the possible list names for each Wwise object. | ||
| null | A null value. No reference to an object. | |
| string | A string value. | |
| array | An array of object references. Several values provided for the option. | |
| number | A numerical value. | |
| boolean | A boolean value. | |
| Object to create and assign to a reference. Refer to Wwise Objects Reference for the possible object types. | ||
| array | Array of Ref Objects. Several values provided for the option. | |
| object | The definition of an "in-place" Curve object. | |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$) [...] | string | A value for the option. |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$) [...] | string | A value for the option. |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$).type * | string | The type of the new object. Refer to Wwise Objects Reference for possible object types. |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$).points * | array | Used when creating a Curve. An array of points defining a curve. |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$).points [...] | object | A point in the curve. |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$).points[...].x * | number | X coordinate of curve point. |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$).points[...].y * | number | Y coordinate of curve point. |
| objects[...].children[...].regex(^@[:_a-zA-Z0-9]+$).points[...].shape * | string | Shape of the curve segment between this point and the next. Possible values:
|
| objects[...].import | object | Import command argument. |
| objects[...].import.autoAddToSourceControl | boolean | Determines if Wwise automatically performs an Add source control operation for affected work units. Defaults to true. |
| objects[...].import.files * | array | Array of import files. |
| objects[...].import.files [...] | object | Parameters of one audio file |
| objects[...].import.files[...].audioFile | string | Path to media file to import. This path must be accessible from Wwise. For using WAAPI on Mac, please refer to Using WAAPI on Mac . |
| objects[...].import.files[...].audioFileBase64 | string | Base64 encoded WAV audio file data to import with its target file path relative to the Originals folder, separated by a vertical bar. E.g. 'MySound.wav|UklGRu...'. |
| objects[...].import.files[...].originalsSubFolder | string | Specifies the 'originals' sub-folder in which to place the imported audio file. This folder is relative to the 'originals' folder in which the file would normally be imported. Example: if importing an SFX, then the audio file is imported to the folder Originals\SFX\originalsPath. |
| objects[...].import.files[...].language | string | Imports the language for the audio file import (taken from the project's defined languages, found in the WPROJ file LanguageList). |
| objects[...].import.files[...].objectType | string | Specifies the type of object to create when importing an audio file. This type can also be specified directly in the objectPath. Refer to Wwise Objects Reference for the available types. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$) | any of: | |
| array | Objects to create in list @listName. Refer to Wwise Objects Reference for the possible list names for each Wwise object. An array of child objects to be created. | |
| null | A null value. No reference to an object. | |
| string | A string value. | |
| array | Several values provided for the option. | |
| number | A numerical value. | |
| boolean | A boolean value. | |
| object | The definition of an "in-place" Curve object. | |
| object | Child object to be created. | |
| array | Array of Ref Objects. Several values provided for the option. | |
| objects[...].regex(^@[:_a-zA-Z0-9]+$) [...] | object | Child objects to be created. Child object to be created. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].platform | any of: | The ID (GUID) or unique name of the platform used when setting properties and references via this operation. Not specifying a platform sets the value for all linked platforms. |
| string | The name of the object. | |
| string | An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. | |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].type * | string | The type of the new object. Refer to Wwise Objects Reference for possible object types or Wwise Nodes Reference for possible node types. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].name * | string | The name of the new object. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].notes | string | The notes or comments of the new object. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].classId | integer | The ID (class ID) of the plug-in. Only specify for Effect or Source plug-ins. Refer to Wwise Objects Reference for possible ClassId values. Unsigned Integer 32-bit. Range: [0,4294967295] |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].language | string | The ID (GUID) or name of the language. Only use this argument when creating Sound Voice objects. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].children | An array of child objects to be created (Recursive). | |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import | object | Import command argument. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import.autoAddToSourceControl | boolean | Determines if Wwise automatically performs an Add source control operation for affected work units. Defaults to true. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import.files * | array | Array of import files. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import.files [...] | object | Parameters of one audio file |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import.files[...].audioFile | string | Path to media file to import. This path must be accessible from Wwise. For using WAAPI on Mac, please refer to Using WAAPI on Mac . |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import.files[...].audioFileBase64 | string | Base64 encoded WAV audio file data to import with its target file path relative to the Originals folder, separated by a vertical bar. E.g. 'MySound.wav|UklGRu...'. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import.files[...].originalsSubFolder | string | Specifies the 'originals' sub-folder in which to place the imported audio file. This folder is relative to the 'originals' folder in which the file would normally be imported. Example: if importing an SFX, then the audio file is imported to the folder Originals\SFX\originalsPath. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import.files[...].language | string | Imports the language for the audio file import (taken from the project's defined languages, found in the WPROJ file LanguageList). |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].import.files[...].objectType | string | Specifies the type of object to create when importing an audio file. This type can also be specified directly in the objectPath. Refer to Wwise Objects Reference for the available types. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$) | any of: | |
| Objects to create in list @listName. Refer to Wwise Objects Reference for the possible list names for each Wwise object. | ||
| null | A null value. No reference to an object. | |
| string | A string value. | |
| array | An array of object references. Several values provided for the option. | |
| number | A numerical value. | |
| boolean | A boolean value. | |
| Object to create and assign to a reference. Refer to Wwise Objects Reference for the possible object types. | ||
| array | Array of Ref Objects. Several values provided for the option. | |
| object | The definition of an "in-place" Curve object. | |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$) [...] | string | A value for the option. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$) [...] | string | A value for the option. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$).type * | string | The type of the new object. Refer to Wwise Objects Reference for possible object types. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$).points * | array | Used when creating a Curve. An array of points defining a curve. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$).points [...] | object | A point in the curve. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$).points[...].x * | number | X coordinate of curve point. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$).points[...].y * | number | Y coordinate of curve point. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$)[...].regex(^@[:_a-zA-Z0-9]+$).points[...].shape * | string | Shape of the curve segment between this point and the next. Possible values:
|
| objects[...].regex(^@[:_a-zA-Z0-9]+$) [...] | string | A value for the option. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).type * | string | The type of the new object. Refer to Wwise Objects Reference for possible object types. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).points * | array | Used when creating a Curve. An array of points defining a curve. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).points [...] | object | A point in the curve. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).points[...].x * | number | X coordinate of curve point. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).points[...].y * | number | Y coordinate of curve point. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).points[...].shape * | string | Shape of the curve segment between this point and the next. Possible values:
|
| objects[...].regex(^@[:_a-zA-Z0-9]+$).platform | any of: | The ID (GUID) or unique name of the platform used when setting properties and references via this operation. Not specifying a platform sets the value for all linked platforms. |
| string | The name of the object. | |
| string | An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. | |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).type * | string | The type of the new object. Refer to Wwise Objects Reference for possible object types or Wwise Nodes Reference for possible node types. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).name * | string | The name of the new object. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).notes | string | The notes or comments of the new object. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).classId | integer | The ID (class ID) of the plug-in. Only specify for Effect or Source plug-ins. Refer to Wwise Objects Reference for possible ClassId values. Unsigned Integer 32-bit. Range: [0,4294967295] |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).language | string | The ID (GUID) or name of the language. Only use this argument when creating Sound Voice objects. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).children | array | An array of child objects to be created (Recursive). An array of child objects to be created. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).children [...] | Child objects to be created. | |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import | object | Import command argument. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import.autoAddToSourceControl | boolean | Determines if Wwise automatically performs an Add source control operation for affected work units. Defaults to true. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import.files * | array | Array of import files. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import.files [...] | object | Parameters of one audio file |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import.files[...].audioFile | string | Path to media file to import. This path must be accessible from Wwise. For using WAAPI on Mac, please refer to Using WAAPI on Mac . |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import.files[...].audioFileBase64 | string | Base64 encoded WAV audio file data to import with its target file path relative to the Originals folder, separated by a vertical bar. E.g. 'MySound.wav|UklGRu...'. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import.files[...].originalsSubFolder | string | Specifies the 'originals' sub-folder in which to place the imported audio file. This folder is relative to the 'originals' folder in which the file would normally be imported. Example: if importing an SFX, then the audio file is imported to the folder Originals\SFX\originalsPath. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import.files[...].language | string | Imports the language for the audio file import (taken from the project's defined languages, found in the WPROJ file LanguageList). |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).import.files[...].objectType | string | Specifies the type of object to create when importing an audio file. This type can also be specified directly in the objectPath. Refer to Wwise Objects Reference for the available types. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$) | any of: | |
| array | Objects to create in list @listName. Refer to Wwise Objects Reference for the possible list names for each Wwise object. An array of child objects to be created. | |
| null | A null value. No reference to an object. | |
| string | A string value. | |
| array | An array of object references. Several values provided for the option. | |
| number | A numerical value. | |
| boolean | A boolean value. | |
| Object to create and assign to a reference. Refer to Wwise Objects Reference for the possible object types. | ||
| array | Array of Ref Objects. Several values provided for the option. | |
| object | The definition of an "in-place" Curve object. | |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$) [...] | Child objects to be created. | |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$) [...] | string | A value for the option. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$) [...] | string | A value for the option. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$).type * | string | The type of the new object. Refer to Wwise Objects Reference for possible object types. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$).points * | array | Used when creating a Curve. An array of points defining a curve. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$).points [...] | object | A point in the curve. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$).points[...].x * | number | X coordinate of curve point. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$).points[...].y * | number | Y coordinate of curve point. |
| objects[...].regex(^@[:_a-zA-Z0-9]+$).regex(^@[:_a-zA-Z0-9]+$).points[...].shape * | string | Shape of the curve segment between this point and the next. Possible values:
|
| objects[...].regex(^@[:_a-zA-Z0-9]+$) [...] | string | A value for the option. |
| platform | any of: | Unless overriden by an individual "object", the ID (GUID) or unique name of the platform used when setting properties and references via this operation. Not specifying a platform sets the value for all linked platforms. |
| string | The name of the object. | |
| string | An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. | |
| onNameConflict | string | Unless overriden by an individual "object", the action to take if "object" already has a child with the same name. Default value is "fail". Refer to Understanding the name conflict modes for more information. Possible values:
|
| listMode | string | Unless overriden by an individual "object", the action to take if "object" already has objects in a specified list. Default value is "append". Refer to Understanding lists and list modes for more information. Possible values:
|
| autoAddToSourceControl | boolean | Determines if Wwise automatically performs an Add source control operation for affected work units. Defaults to true. |
(Required *)
| Name | Type | Description |
|---|---|---|
| return | array | Specifies what is being returned for every object. Refer to Wwise Objects Reference for more information on the properties and references 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:
| |
| 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 | any of: | The ID (GUID) or name of the platform. This is an optional argument. When not specified, the current platform is used. |
| string | The name of the platform. | |
| string | The id of the platform. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. | |
| language | any of: | The ID (GUID) or name of the language. |
| string | The name of the language. | |
| string | The id of the language. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| Name | Type | Description |
|---|---|---|
| objects | array | Array of {object, created objects} associations for each parent object. |
| objects [...] | object | Objects created as children of, or in lists of, "object". |
| objects[...].id | string | The ID (GUID) of the parent. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].name | string | The name of the parent. |
| objects[...].children | array | The child objects created. |
| objects[...].children [...] | object | A created object. A Wwise object. Use the return options to specify which property is required. |
| objects[...].children[...].id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].name | string | The name of the object. |
| objects[...].children[...].notes | string | The notes of the object. |
| objects[...].children[...].type | string | The type of the object. Refer to Wwise Objects Reference for more information on the types available. |
| objects[...].children[...].pluginName | string | The name of the plug-in for Source, Effect, Mixer, Device and Metadata plug-in. |
| objects[...].children[...].path | string | The path of the object from the project root. Ex: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1' |
| objects[...].children[...].parent | object | The parent of the object in the hierarchy. |
| objects[...].children[...].parent.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].parent.name | string | The name of the object. |
| objects[...].children[...].owner | object | The owner of the object. This applies to objects being locally owned by other objects, such as custom effects, custom attenuations, etc. |
| objects[...].children[...].owner.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].owner.name | string | The name of the object. |
| objects[...].children[...].isPlayable | boolean | True if the object can be played in Transport. |
| objects[...].children[...].shortId | integer | The Short ID of the object. |
| objects[...].children[...].classId | integer | The class ID of the object. Unsigned Integer 32-bit. Range: [0,4294967295] |
| objects[...].children[...].category | string | The category of the object. Ex: 'Actor-Mixer Hierarchy' |
| objects[...].children[...].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 . |
| objects[...].children[...].workunit | object | The parent Work Unit containing the object. The 'id' and the 'name' is returned. |
| objects[...].children[...].workunit.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].workunit.name | string | The name of the object. |
| objects[...].children[...].childrenCount | number | The number of children for the object. Note, this is deprecated. The same result can be obtained with children.count(). |
| objects[...].children[...].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. |
| objects[...].children[...].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. |
| objects[...].children[...].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. |
| objects[...].children[...].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. |
| objects[...].children[...].musicTransitionRoot | object | (DEPRECATED) The music transition root containing all other music transitions recursively. Note, this is deprecated. The TransitionRoot reference should be used instead. |
| objects[...].children[...].musicTransitionRoot.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].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. |
| objects[...].children[...].musicPlaylistRoot.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].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 . |
| objects[...].children[...].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 . |
| objects[...].children[...].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 . |
| objects[...].children[...].activeSource | object | The active source of the sound object. |
| objects[...].children[...].activeSource.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].activeSource.name | string | The name of the object. |
| objects[...].children[...].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 . |
| objects[...].children[...].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 . |
| objects[...].children[...].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 . |
| objects[...].children[...].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. |
| objects[...].children[...].playbackDuration.playbackDurationMin | number | The minimum possible time playback can take. |
| objects[...].children[...].playbackDuration.playbackDurationMax | number | The maximum possible time playback can take. |
| objects[...].children[...].playbackDuration.playbackDurationType | string | The type of duration. |
| objects[...].children[...].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. |
| objects[...].children[...].duration.min | number | The minimum possible time playback can take. |
| objects[...].children[...].duration.max | number | The maximum possible time playback can take. |
| objects[...].children[...].duration.type | string | The type of duration. |
| objects[...].children[...].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. |
| objects[...].children[...].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}. |
| objects[...].children[...].maxDurationSource.trimmedDuration | number | The duration in seconds of the longest trimmed source. |
| objects[...].children[...].audioSourceTrimValues | object | Range of time for which the audio source is trimmed. |
| objects[...].children[...].audioSourceTrimValues.trimBegin | number | The time value in seconds of the start trim. |
| objects[...].children[...].audioSourceTrimValues.trimEnd | number | The time value in seconds of the end trim. |
| objects[...].children[...].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. |
| objects[...].children[...].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}. |
| objects[...].children[...].maxRadiusAttenuation.radius | number | The radius of the attenuation object. |
| objects[...].children[...].audioSourceLanguage | object | Language associated to the audio source. This only applies to Audio Source objects directly. |
| objects[...].children[...].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}. |
| objects[...].children[...].audioSourceLanguage.name | string | The name of the Language object to which the Audio Source object is associated. |
| objects[...].children[...].workunitIsDefault | boolean | True if the work unit is the default. |
| objects[...].children[...].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:
|
| objects[...].children[...].workunitIsDirty | boolean | True if a Work Unit or a Project (wproj file) is dirty, meaning it was modified but not saved. |
| objects[...].children[...].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). |
| objects[...].children[...].switchContainerChildContext.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].isExplicitMute | boolean | Whether or not the object has been muted explicitly. Explicitly muting an object implicitly mutes the descendant objects. |
| objects[...].children[...].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. |
| objects[...].children[...].isImplicitMute | boolean | Whether or not the object has been muted implicitly. Explicitly muting an object implicitly mutes the descendant objects. |
| objects[...].children[...].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. |
| objects[...].children[...].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. |
| objects[...].children[...].points | array | This only applies to Curve objects. An array of points defining a curve. |
| objects[...].children[...].points [...] | object | A point in the curve. |
| objects[...].children[...].points[...].x * | number | X coordinate of curve point. |
| objects[...].children[...].points[...].y * | number | Y coordinate of curve point. |
| objects[...].children[...].points[...].shape * | string | Shape of the curve segment between this point and the next. Possible values:
|
| objects[...].children[...].stateProperties | array | An array of state properties to set. |
| objects[...].children[...].stateProperties [...] | string | The name of the property to set. |
| objects[...].children[...].stateGroups | array | The State Group objects associated with this object. |
| objects[...].children[...].stateGroups [...] | object | A State Group object. |
| objects[...].children[...].stateGroups[...].id | string | The ID (GUID) of the State Group object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].children[...].stateGroups[...].name | string | The name of the State Group object. |
| objects[...].children[...].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. | |
| objects[...].children[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | string | A string value. |
| objects[...].children[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | number | A numeric value. |
| objects[...].children[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | boolean | A boolean value. |
| objects[...].children[...].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}. |
| objects[...].children[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$).name | string | The name of the object. |
| objects[...].children[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | object | An object reference value. |
| objects[...].children[...].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}. |
| objects[...].children[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$)[...].name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$) | one of: | The objects created and inserted in the specified list. |
| array | The objects to be created. | |
| object | A Wwise object. Use the return options to specify which property is required. | |
| objects[...].regex(^@[_:a-zA-Z0-9]+$) [...] | object | A created object. A Wwise object. Use the return options to specify which property is required. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].notes | string | The notes of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].type | string | The type of the object. Refer to Wwise Objects Reference for more information on the types available. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].pluginName | string | The name of the plug-in for Source, Effect, Mixer, Device and Metadata plug-in. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].path | string | The path of the object from the project root. Ex: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1' |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].parent | object | The parent of the object in the hierarchy. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].parent.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].parent.name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].owner | object | The owner of the object. This applies to objects being locally owned by other objects, such as custom effects, custom attenuations, etc. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].owner.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].owner.name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].isPlayable | boolean | True if the object can be played in Transport. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].shortId | integer | The Short ID of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].classId | integer | The class ID of the object. Unsigned Integer 32-bit. Range: [0,4294967295] |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].category | string | The category of the object. Ex: 'Actor-Mixer Hierarchy' |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].workunit | object | The parent Work Unit containing the object. The 'id' and the 'name' is returned. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].workunit.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].workunit.name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].childrenCount | number | The number of children for the object. Note, this is deprecated. The same result can be obtained with children.count(). |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].musicTransitionRoot | object | (DEPRECATED) The music transition root containing all other music transitions recursively. Note, this is deprecated. The TransitionRoot reference should be used instead. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].musicTransitionRoot.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].musicPlaylistRoot.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].activeSource | object | The active source of the sound object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].activeSource.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].activeSource.name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].playbackDuration.playbackDurationMin | number | The minimum possible time playback can take. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].playbackDuration.playbackDurationMax | number | The maximum possible time playback can take. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].playbackDuration.playbackDurationType | string | The type of duration. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].duration.min | number | The minimum possible time playback can take. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].duration.max | number | The maximum possible time playback can take. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].duration.type | string | The type of duration. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].maxDurationSource.trimmedDuration | number | The duration in seconds of the longest trimmed source. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].audioSourceTrimValues | object | Range of time for which the audio source is trimmed. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].audioSourceTrimValues.trimBegin | number | The time value in seconds of the start trim. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].audioSourceTrimValues.trimEnd | number | The time value in seconds of the end trim. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].maxRadiusAttenuation.radius | number | The radius of the attenuation object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].audioSourceLanguage | object | Language associated to the audio source. This only applies to Audio Source objects directly. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].audioSourceLanguage.name | string | The name of the Language object to which the Audio Source object is associated. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].workunitIsDefault | boolean | True if the work unit is the default. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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:
|
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].workunitIsDirty | boolean | True if a Work Unit or a Project (wproj file) is dirty, meaning it was modified but not saved. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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). |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].switchContainerChildContext.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].isExplicitMute | boolean | Whether or not the object has been muted explicitly. Explicitly muting an object implicitly mutes the descendant objects. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].isImplicitMute | boolean | Whether or not the object has been muted implicitly. Explicitly muting an object implicitly mutes the descendant objects. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].points | array | This only applies to Curve objects. An array of points defining a curve. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].points [...] | object | A point in the curve. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].points[...].x * | number | X coordinate of curve point. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].points[...].y * | number | Y coordinate of curve point. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].points[...].shape * | string | Shape of the curve segment between this point and the next. Possible values:
|
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].stateProperties | array | An array of state properties to set. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].stateProperties [...] | string | The name of the property to set. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].stateGroups | array | The State Group objects associated with this object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].stateGroups [...] | object | A State Group object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].stateGroups[...].id | string | The ID (GUID) of the State Group object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].stateGroups[...].name | string | The name of the State Group object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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. | |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | string | A string value. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | number | A numeric value. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | boolean | A boolean value. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$).name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | object | An object reference value. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$)[...].regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$)[...].name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).notes | string | The notes of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).type | string | The type of the object. Refer to Wwise Objects Reference for more information on the types available. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).pluginName | string | The name of the plug-in for Source, Effect, Mixer, Device and Metadata plug-in. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).path | string | The path of the object from the project root. Ex: '\Actor-Mixer Hierarchy\Default Work Unit\Sound1' |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).parent | object | The parent of the object in the hierarchy. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).parent.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).parent.name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).owner | object | The owner of the object. This applies to objects being locally owned by other objects, such as custom effects, custom attenuations, etc. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).owner.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).owner.name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).isPlayable | boolean | True if the object can be played in Transport. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).shortId | integer | The Short ID of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).classId | integer | The class ID of the object. Unsigned Integer 32-bit. Range: [0,4294967295] |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).category | string | The category of the object. Ex: 'Actor-Mixer Hierarchy' |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).workunit | object | The parent Work Unit containing the object. The 'id' and the 'name' is returned. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).workunit.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).workunit.name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).childrenCount | number | The number of children for the object. Note, this is deprecated. The same result can be obtained with children.count(). |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).musicTransitionRoot | object | (DEPRECATED) The music transition root containing all other music transitions recursively. Note, this is deprecated. The TransitionRoot reference should be used instead. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).musicTransitionRoot.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).musicPlaylistRoot.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).activeSource | object | The active source of the sound object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).activeSource.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).activeSource.name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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 . |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).playbackDuration.playbackDurationMin | number | The minimum possible time playback can take. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).playbackDuration.playbackDurationMax | number | The maximum possible time playback can take. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).playbackDuration.playbackDurationType | string | The type of duration. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).duration.min | number | The minimum possible time playback can take. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).duration.max | number | The maximum possible time playback can take. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).duration.type | string | The type of duration. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).maxDurationSource.trimmedDuration | number | The duration in seconds of the longest trimmed source. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).audioSourceTrimValues | object | Range of time for which the audio source is trimmed. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).audioSourceTrimValues.trimBegin | number | The time value in seconds of the start trim. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).audioSourceTrimValues.trimEnd | number | The time value in seconds of the end trim. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).maxRadiusAttenuation.radius | number | The radius of the attenuation object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).audioSourceLanguage | object | Language associated to the audio source. This only applies to Audio Source objects directly. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).audioSourceLanguage.name | string | The name of the Language object to which the Audio Source object is associated. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).workunitIsDefault | boolean | True if the work unit is the default. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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:
|
| objects[...].regex(^@[_:a-zA-Z0-9]+$).workunitIsDirty | boolean | True if a Work Unit or a Project (wproj file) is dirty, meaning it was modified but not saved. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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). |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).switchContainerChildContext.id | string | The ID (GUID) of the object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).isExplicitMute | boolean | Whether or not the object has been muted explicitly. Explicitly muting an object implicitly mutes the descendant objects. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).isImplicitMute | boolean | Whether or not the object has been muted implicitly. Explicitly muting an object implicitly mutes the descendant objects. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).points | array | This only applies to Curve objects. An array of points defining a curve. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).points [...] | object | A point in the curve. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).points[...].x * | number | X coordinate of curve point. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).points[...].y * | number | Y coordinate of curve point. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).points[...].shape * | string | Shape of the curve segment between this point and the next. Possible values:
|
| objects[...].regex(^@[_:a-zA-Z0-9]+$).stateProperties | array | An array of state properties to set. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).stateProperties [...] | string | The name of the property to set. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).stateGroups | array | The State Group objects associated with this object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).stateGroups [...] | object | A State Group object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).stateGroups[...].id | string | The ID (GUID) of the State Group object. An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).stateGroups[...].name | string | The name of the State Group object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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. | |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | string | A string value. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | number | A numeric value. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | boolean | A boolean value. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$).name | string | The name of the object. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$) [...] | object | An object reference value. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).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}. |
| objects[...].regex(^@[_:a-zA-Z0-9]+$).regex(^((@?@?[a-zA-Z0-9:_\(\),]+)|[a-zA-Z\(\),]+\(.+\))(\.@?@?[a-zA-Z0-9:_\(\),]+|[a-zA-Z\(\),]+\(.+\))*$)[...].name | string | The name of the object. |
Refer to Using the Wwise Authoring API (WAAPI) for more information about Wwise Authoring API.
Questions? Problems? Need more info? Contact us, and we can help!
Visit our Support pageRegister your project and we'll help you get started with no strings attached!
Get started with Wwise