Table of Contents

Wwise SDK 2018.1.11
ak.wwise.core.object.create


Creates an object of type 'type', as a child of 'parent'. 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.

Supported by

Graphical User Interface, Command-Line Interface.

Arguments

Name Type Description
parent *   The ID (GUID), name, or path of the parent of the new object.
type * string The type of the new object. Refer to Wwise Objects Reference for possible object types.
name * string The name of the new object.
onNameConflict string The action to take if "parent" already has a child with the same name. Default value is "fail". Refer to Understanding the name conflict modes for more information.
Possible values : "rename", "replace", "fail", "merge"
platform string The ID (GUID) of the platform used when setting properties via this command. Not specifying a platform sets the value for all linked platforms.
notes string  
autoAddToSourceControl boolean Determines if Wwise will automatically perform an Add or Checkout operation on the imported files with the source control. Defaults to false.
children array A list of child objects to be created.

(Required *)

Arguments Details


parent

description : The ID (GUID), name, or path of the parent of the new object.
Possibilities, one of the following :

1) type : string
pattern : ^(StateGroup|SwitchGroup|SoundBank|GameParameter|Event|Effect|AudioDevice|Trigger|Attenuation|DialogueEvent|Bus|AuxBus|Conversion|ModulatorLfo|ModulatorEnvelope|ModulatorTime|Platform|Language|AcousticTexture):[a-zA-Z_]+[a-zA-Z0-9_]*$
description : The name of the object qualified by its type in the form of type:name. Only object types that have globally-unique names are supported.

2) type : string
pattern : ^\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}$

3) type : string
pattern : ^\

type

type : string
description : The type of the new object. Refer to Wwise Objects Reference for possible object types.

name

type : string
description : The name of the new object.

onNameConflict

type : string
description : The action to take if "parent" already has a child with the same name. Default value is "fail". Refer to Understanding the name conflict modes for more information.
Possible values : "rename", "replace", "fail", "merge"

platform

description : The ID (GUID) of the platform used when setting properties via this command. Not specifying a platform sets the value for all linked platforms.
type : string
pattern : ^\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}$

notes

type : string

autoAddToSourceControl

type : boolean
description : Determines if Wwise will automatically perform an Add or Checkout operation on the imported files with the source control. Defaults to false.

children

type : array
description : A list of child objects to be created.

argsSchema / children / ...

items

type : object

Name Type Description
type * string The type of the new object. Refer to Wwise Objects Reference for possible object types.
name * string The name of the new object.
notes string  
children    

(Required *)

argsSchema / children / items / ...

patternProperties


^@[:_a-zA-Z0-9]+$

description : Sets the value of property @propertyName. Refer to Wwise Objects Reference for property names.
Possibilities, one of the following :

1) type : null

2) type : string

3) type : number

4) type : boolean


Result

Name Type Description
id string The ID (GUID) of the newly created Object.
name string The name of the newly created Object.
children array  

Result Details


id

description : The ID (GUID) of the newly created Object.
type : string
pattern : ^\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}$

name

type : string
description : The name of the newly created Object.

children

type : array
Possible types : or object

resultSchema / children / ...

id

type : string
pattern : ^\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}$

resultSchema / children / ...

name

type : string

resultSchema / children / ...

children

Reference : : See Arguments "children"


Examples :

Create a Sound object.

Create a new Sound object called 'Boom' under the specified parent.

Arguments:

{
"parent": "{7A12D08F-B0D9-4403-9EFA-2E6338C197C1}",
"type": "Sound",
"name": "Boom"
}

Result:

{
"id": "{66666666-7777-8888-9999-AAAAAAAAAAAA}",
"name": "Boom"
}

Create a virtual folder.

Create a new virtual folder called 'Guns' under the default work unit. If a folder with the same name already exists, it will automatically find a unique name.

Arguments:

{
"parent": "\\Actor-Mixer Hierarchy\\Default Work Unit",
"type": "Folder",
"name": "Guns",
"onNameConflict": "rename"
}

Result:

{
"id": "{66666666-7777-8888-9999-AAAAAAAAAAAA}",
"name": "Guns"
}

Create a Play Event on a Sound

Create an event called 'Play_SFX' under the virtual folder 'WAAPI', with Play action on the SFX sound object.

Arguments:

{
"parent": "\\Events\\Default Work Unit",
"type": "Folder",
"name": "WAAPI",
"onNameConflict": "merge",
"children": [
{
"type": "Event",
"name": "Play_SFX",
"children": [
{
"name": "",
"type": "Action",
"@ActionType": 1,
"@Target": "\\Actor-Mixer Hierarchy\\Default Work Unit\\SFX"
}
]
}
]
}

Result:

{
"id": "{6114659F-9274-4031-B90E-F369568532E0}",
"name": "WAAPI",
"children": [
{
"id": "{F546017D-201A-49BD-8D4E-0A28F5DBB28D}",
"name": "Play_SFX",
"children": [
{
"id": "{400D0354-0FDB-48B4-B341-9DFA0B76078D}",
"name": ""
}
]
}
]
}

Create a Random Container with 2 sound objects.

Create a Random Container called 'Boom' under the specified parent, with two Sound objects 'A' and 'B'.

Arguments:

{
"parent": "{7A12D08F-B0D9-4403-9EFA-2E6338C197C1}",
"type": "RandomSequenceContainer",
"name": "Boom",
"@RandomOrSequence": 1,
"children": [
{
"type": "Sound",
"name": "A"
},
{
"type": "Sound",
"name": "B"
}
]
}

Result:

{
"id": "{66666666-7777-8888-9999-AAAAAAAAAAAA}",
"name": "Boom",
"children": [
{
"id": "{46813545-2168-3547-8328-681AB678D6F5}",
"name": "A"
},
{
"id": "{68465134-2548-2377-3541-321354318ASD}",
"name": "B"
}
]
}


Detailed JSON Schema


Arguments :

{
"type": "object",
"properties": {
"parent": {
"description": "The ID (GUID), name, or path of the parent of the new object.",
"anyOf": [
{
"type": "string",
"pattern": "^(StateGroup|SwitchGroup|SoundBank|GameParameter|Event|Effect|AudioDevice|Trigger|Attenuation|DialogueEvent|Bus|AuxBus|Conversion|ModulatorLfo|ModulatorEnvelope|ModulatorTime|Platform|Language|AcousticTexture):[a-zA-Z_]+[a-zA-Z0-9_]*$",
"description": "The name of the object qualified by its type in the form of type:name. Only object types that have globally-unique names are supported."
},
{
"type": "string",
"pattern": *Must be a valid GUID*
},
{
"type": "string",
"pattern": "^\\\\"
}
]
},
"type": {
"type": "string",
"description": "The type of the new object."
},
"name": {
"type": "string",
"description": "The name of the new object."
},
"onNameConflict": {
"type": "string",
"description": "The action to take if \"parent\" already has a child with the same name. Default value is \"fail\".",
"enum": [
"rename",
"replace",
"fail",
"merge"
]
},
"platform": {
"description": "The ID (GUID) of the platform used when setting properties via this command. Not specifying a platform sets the value for all linked platforms.",
"type": "string",
"pattern": *Must be a valid GUID*
},
"notes": {
"type": "string"
},
"autoAddToSourceControl": {
"type": "boolean",
"description": "Determines if Wwise will automatically perform an Add or Checkout operation on the imported files with the source control. Defaults to false."
},
"children": {
"type": "array",
"description": "A list of child objects to be created.",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "The type of the new object."
},
"name": {
"type": "string",
"description": "The name of the new object."
},
"notes": {
"type": "string"
},
"children": {
"$ref": "#/properties/children"
}
},
"patternProperties": {
"^@[:_a-zA-Z0-9]+$": {
"description": "Sets the value of property \\@propertyName.",
"anyOf": [
{
"type": "null"
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"type",
"name"
],
"additionalProperties": false
}
}
},
"patternProperties": {
"^@[:_a-zA-Z0-9]+$": {
"description": "Sets the value of property \\@propertyName.",
"anyOf": [
{
"type": "null"
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"type",
"name",
"parent"
],
"additionalProperties": false
}


Options :

{
"type": "object",
"properties": {},
"additionalProperties": false
}


Response :

{
"type": "object",
"properties": {
"id": {
"description": "The ID (GUID) of the newly created Object.",
"type": "string",
"pattern": *Must be a valid GUID*
},
"name": {
"type": "string",
"description": "The name of the newly created Object."
},
"children": {
"type": "array",
"items": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": *Must be a valid GUID*
},
"name": {
"type": "string"
},
"children": {
"$ref": "#/properties/children"
}
}
}
]
}
}
}

Document version : 1