menu
版本
2017.1.9.6501
2024.1.5.8803
2023.1.13.8732
2022.1.19.8584
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.5.8803
2023.1.13.8732
2022.1.19.8584
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 Authoring API 提供了综合查询系统,可用于获取 Wwise 工程最关键方面的信息。更具体地说,它用于获取工程中任何对象的信息。
该查询系统内置于 ak.wwise.core.object.get 功能里。请参阅它的参考文档了解更多详情。
查询的结构包括两个部分:
此外,查询可以用选项指定:
from 语句为查询开始提供了几个起点:
\Actor-Mixer
Hierarchy\Default Work Unit\MySound。transform 语句提供了几个转换功能,可以用于转换已选择的对象。第一个转换是应用于 from 语句所选择的对象的。另一个 transformation 应用于之前转换的结果。
可以按次序添加多个转换。
return 语句会在所有转换结尾执行一次。如果没有指定转换,会直接从from 语句执行。 return 语句会指定返回 Wwise 对象的何种要素。可以返回任意数量的要素。
当带有‘@’前缀时,返回表达式可包含属性和引用。比如,它可能包含‘@Volume’或‘@OutputBus’。当有‘@@’前缀时,返回会使用"Override"("不沿用"属性)的来源,它由层级中‘Override Parent’(不沿用父级)的具体数值决定。
如果返回表达式中的一个条目不兼容或不在返回对象中,则结果将不含该条目。
请参照 to 工程代码 了解初始化。
返回一列对象的 ID、名称和音量:
var query = { from: { id: [ '{A076AA65-B71A-45BB-8841-5A20C52CE727}', '{2028C899-8300-4667-ADD0-ED10467BD91E}', '{24979032-B170-43E3-A2E4-469E0193E2C3}' ] } }; var options = { return: ['id', 'name', '@Volume'] }; session.call('ak.wwise.core.object.get', [], query, options).then( function (res) { // 打印名称和音量 var objects = res.kwargs.return; for(let i = 0; i < objects.length;++i ){ console.log(`${objects[i].name}: ${objects[i]['@Volume']}`); } }, function (error) { console.log(`error: ${error}`); } );
返回 Actor-Mixer Hierarchy 中以‘My’开头所有对象的 ID 和名称,并使用以下的正则表达式返回:
var query = { from:{path:['\\Actor-Mixer Hierarchy']}, transform:[ {select:['descendants']}, {where:['name:matches','^My']} ] }; var options = { return: ['id', 'name'] }; session.call('ak.wwise.core.object.get', [], query, options).then( function (res) { // 打印名称 var objects = res.kwargs.return; for(let i = 0; i < objects.length;++i ){ console.log(`${objects[i].name}`); } }, function (error) { console.log(`error: ${error}`); } );