版本

menu_open
Wwise SDK 2024.1.0
ak.wwise.core.object.create

创建 'type' 类型的对象作为 'parent' 的子对象。如需详细了解如何创建对象,请参阅 导入音频文件和创建架构 章节。如需了解如何将音频文件导入到 Wwise 中,请参阅 ak.wwise.core.audio.import 章节。To create Effect or Source plug-ins, use ak.wwise.core.object.set, and refer to 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。例如:\Actor-Mixer Hierarchy\Default Work Unit\New Sound SFX。
list string 要在其中插入对象的列表的名称。若设置了此参数,则将对象直接而非作为子对象插入到父对象拥有的列表中。
onNameConflict string 在 "parent" 已经包含同名子对象时所要执行的操作。默认值为 "fail"。请参阅 理解名称冲突模式 了解更多信息。可能的值:
  • 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 新对象的类型。有关可用对象类型的信息,请参阅 Wwise 对象参考 章节。
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 新对象的类型。Refer to 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 属性的值。有关属性名称的信息,请参阅 Wwise 对象参考 章节。
属性的值。
null 空值。没有对对象的引用。
string 字符串值。
number 数字值。
boolean 布尔值。
regex(^@[:_a-zA-Z0-9]+$) any of: 设置 @propertyName 属性的值。有关属性名称的信息,请参阅 Wwise 对象参考 章节。
属性的值。
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 之旅