版本
menu

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

创建 'type' 类型的对象作为 'parent' 的子对象。See 导入音频文件和创建架构 for more information about creating objects. Also see ak.wwise.core.audio.import to import audio files to Wwise. To create Effect or Source plug-ins, use ak.wwise.core.object.set, and see Wwise 对象参考 for the classId.

参数

名称 类型 说明
parent * any of: 新对象的父对象的 ID (GUID)、名称或路径。
string 由类型或 Short ID 限定的对象名称,格式为 type:name 或 Global:shortId。仅支持采用全局唯一名称或 Short Id 的对象类型。例如:Event:Play_Sound_01, Global:245489792
string 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。
string Wwise 对象的工程路径,包含类别和 Work Unit。For example: \Containers\Default Work Unit\New Sound SFX.
list string 要在其中插入对象的列表的名称。若设置了此参数,则将对象直接而非作为子对象插入到父对象拥有的列表中。
onNameConflict string 在 "parent" 已经包含同名子对象时所要执行的操作。默认值为 "fail"。See 理解名称冲突模式 for more information. 可能的值:
  • rename
  • replace
  • fail
  • merge
platform any of: 通过此命令设置属性时所用平台的 ID (GUID) 或唯一名称。若不指定平台,则统一设置所有链接的平台的值。
string 对象的名称。
string 以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。
autoAddToSourceControl boolean Determines if Wwise automatically performs an Add source control operation for affected work units. 默认设为 true。
type * string 新对象的类型。See Wwise 对象参考 for possible object types.
name * string 新对象的名称。
id string For internal use only! The ID (GUID) to assign to the newly created Object.
An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
notes string 新对象的备注或注释。
children array 此数组中包含所要创建的子对象。
children [...] object 所要创建的子对象。
children[...].type * string 新对象的类型。See Wwise 对象参考 for possible object types or Wwise Nodes Reference for possible node types
children[...].name * string 新对象的名称。
children[...].id string For internal use only! The ID (GUID) to assign to the newly created Object.
An object GUID of the form: {aabbcc00-1122-3344-5566-77889900aabb}.
children[...].notes string 新对象的备注或注释。
children[...].children 此数组中包含所要创建的子对象(以递归方式获取)。
children[...].regex(^@[:_a-zA-Z0-9]+$) any of: 设置 @propertyName 属性的值。See Wwise 对象参考 for property names.
The value of a property.
null 空值。没有对对象的引用。
string 字符串值。
number 数字值。
boolean 布尔值。
regex(^@[:_a-zA-Z0-9]+$) any of: 设置 @propertyName 属性的值。See Wwise 对象参考 for property names.
The value of a property.
null 空值。没有对对象的引用。
string 字符串值。
number 数字值。
boolean 布尔值。

(必填 *)

参数架构

结果

名称 类型 说明
id string 新建对象的 ID (GUID)。
以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。
name string 新建对象的名称。
children array 所创建对象的子对象。
children [...] object 创建的对象。
children[...].id string 新建对象的 ID (GUID)。
以下形式的对象 GUID:{aabbcc00-1122-3344-5566-77889900aabb}。
children[...].name string 新建对象的名称。
children[...].children array 所创建对象的子对象。
children[...].children [...] 创建的对象。

结果架构

另请参阅

示例

有关 Wwise Authoring API 的详细信息,请参阅 使用 Wwise Authoring API(WAAPI) 章节。


此页面对您是否有帮助?

需要技术支持?

仍有疑问?或者问题?需要更多信息?欢迎联系我们,我们可以提供帮助!

查看我们的“技术支持”页面

介绍一下自己的项目。我们会竭力为您提供帮助。

来注册自己的项目,我们帮您快速入门,不带任何附加条件!

开始 Wwise 之旅