Version

menu_open
Wwise SDK 2018.1.11
ak.wwise.core.object.setProperty


Sets a property value of an object for a specific platform. Refer to Wwise Objects Reference for more information on the properties available on each object type.

Supported by

Graphical User Interface, Command-Line Interface.

Arguments

Name Type Description
object *   The ID (GUID), name, or path of the object to set value.
property * string The name of the property. For more information, refer to the property list of Wwise Objects listed in Wwise Objects Reference .
platform string The ID (GUID) of the platform.
value *   The value of the object.

(Required *)

Arguments Details


object

description : The ID (GUID), name, or path of the object to set value.
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 : ^\

property

type : string
description : The name of the property. For more information, refer to the property list of Wwise Objects listed in Wwise Objects Reference .
pattern : ^[:a-zA-Z0-9 _]+$

platform

description : The ID (GUID) of the platform.
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}\}$

value

description : The value of the object.
Possibilities, one of the following :

1) type : null

2) type : string

3) type : number

4) type : boolean


Examples :

Setting the value of a specified property

Sets the "Volume" property of the object defined by "object" to "Value".

Arguments:

{
"object": "{A076AA65-B71A-45BB-8841-5A20C52CE727}",
"property": "Volume",
"platform": "{66666666-7777-8888-9999-AAAAAAAAAAAA}",
"value": 5.7
}

Result:

{}


Detailed JSON Schema


Arguments :

{
"type": "object",
"properties": {
"object": {
"description": "The ID (GUID), name, or path of the object to set value.",
"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": "^\\\\"
}
]
},
"property": {
"type": "string",
"description": "The name of the property.",
"pattern": "^[:a-zA-Z0-9 _]+$"
},
"platform": {
"description": "The ID (GUID) of the platform.",
"type": "string",
"pattern": *Must be a valid GUID*
},
"value": {
"description": "The value of the object.",
"anyOf": [
{
"type": "null"
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"object",
"property",
"value"
],
"additionalProperties": false
}


Options :

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


Response :

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

Document version : 1


Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

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

Register your project and we'll help you get started with no strings attached!

Get started with Wwise