menu
版本
2019.1.11.7296
2024.1.4.8780
2023.1.12.8706
2022.1.18.8567
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
2024.1.4.8780
2023.1.12.8706
2022.1.18.8567
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
Wwise SDK 2019.1.11
|
Wwise Authoring API 提供了综合查询系统,可用于获取 Wwise 工程最关键方面的信息。更具体地说,它用于获取工程中任何对象的信息。
该查询系统内置于 ak.wwise.core.object.get 功能里。请参阅它的参考文档了解更多详情。
查询的结构包括两个部分:
此外,查询可以用选项指定:
from 语句为查询开始提供了几个起点:
transform 语句提供了几个转换功能,可以用于转换已选择的对象。第一个转换是应用于 from 语句所选择的对象的。另一个 transformation 应用于之前转换的结果。
可以按次序添加多个转换。
return 语句会在所有转换结尾执行一次。如果没有指定转换,会直接从 from 语句执行。 return 语句会指定返回 Wwise 对象的何种要素。可以返回任意数量的要素。
当带有‘@’前缀时,返回表达式可包含属性和引用。比如,它可能包含‘@Volume’或‘@OutputBus’。当有‘@@’前缀时,返回会使用"Override"("不沿用"属性)的来源,它由层级中‘Override Parent’(不沿用父级)的具体数值决定。
在表达式解析为有效引用时,可进一步查询被引用对象的属性。比如,若 Sound 对象的 '@UserAuxSend0' 引用了现有 Auxiliary Bus,则可通过附加点号 ('.') 并后缀属性描述符来查询此 Auxiliary Bus 的属性。因此,如需查询被引用 Auxiliary Bus 的 Attenuation,直接使用 '@UserAuxSend0.@Attenuation' 即可。使用 '@@' 前缀来获取 Override 来源的规则在此同样适用。
有些对象包含带有特定功能(如随机化)的属性。为了检索与这些功能相关的值,可通过类似函数的访问器来查询与属性绑定的特殊对象。比如,随机化器功能由绑定到对象特定属性的 Modifier 对象描述。此对象可作为 'randomizer("PropertyName")' 来查询,其中 PropertyName 为属性(如 'Volume')的名称。 在访问器提供有效引用时,可按照前文所述方式进一步查询返回的对象。比如,可按照以下方式获取 Volume 随机化器的 'Max' 属性:'randomizer("Volume").@Max'。
可用的访问器包括:
如果返回表达式中的一个条目不兼容或不在返回对象中,则结果将不含该条目。
ak.wwise.core.object.get 函数及其他函数允许使用选项对象来定义:
有些访问器会区分选项。比如,在检索属性或引用值时,可通过指定平台来获取取消链接的值。若未指定平台,则使用当前平台。 另外,还可通过指定语言来检索针对语言的信息,如 Sound SFX(音效)对象的音频源数据。 若未指定语言,则使用当前语言。
请参照 to 工程代码 了解初始化。
如需查看更多示例,请参阅 ak.wwise.core.object.get 。
返回一列对象的 ID、名称和音量:
返回 Actor-Mixer Hierarchy 中以‘My’开头所有对象的 ID 和名称,并使用以下的正则表达式返回: