|
Wwise SDK 2021.1.14
|
在本教程中，建议使用 Integration Demo 工程。在通过 Audiokinetic Launcher 安装 SDK 和 Visual Studio 平台后，可在 SDK 示例中找到该工程。不过，您也可以使用自己的工程或 Wwise 示例中的其他工程（如 Wwise Audio Lab 或《Wwise Adventure Game》）。
在很多地方都可以使用 WAQL。对于本教程，我们来以 List View 为例加以阐述。
简单的筛选查询
在 List View 的搜索字段中键入以下查询：
$ where volume < 0
第一个字符为 $，用于告知 Wwise 要写入 WAQL 查询。Wwise 可藉此区分标准文本和 WAQL 查询。$ 之后的内容用于定义查询本身。
在本例中，使用 where 关键字开始查询。在使用 where 关键字开始时，WAQL 会自动获取工程的所有对象，并使用 where 之后定义的条件语句来加以筛选。作为筛选器，where 关键字只输出匹配的对象。
简写如下：
$ where CONDITION
CONDITION 是一个布尔表达式，其会返回 true 或 false。在上面的例子中，表示要将音量与数字值进行比较。若音量小于零，则查询返回 true。在此，将针对工程的所有对象验证该条件。在完成查询后，会列出所有音量小于零的对象。
补充练习：
- 尝试不同的运算符：<=、>、>=、=
- 将 volume 替换为 pitch 或 lowpass
- 尝试使用 and 和 or（加或不加括号）来定义更为复杂的表达式
 |
技巧: 若要了解 WAQL 属性名称，请参阅 Wwise 对象参考 章节。 |
字符串条件
目前只使用了数字值条件。下面来试下字符串条件：
$ where name = "hello"
字符串条件会将两个字符串的内容进行比较。在使用等号运算符执行比较时，不区分大小写。若文本相同（不区分大小写），则认为条件成立。您可以使用该表达式来查找特定的内容。
除此之外，也可只比较字符串的部分内容：
$ where name : "hello"
此查询中使用了冒号而非等号作为比较运算符。冒号用于定义单词搜索运算符。若在所查看的元素内找到指定的单词，则返回 true。在此示例中，若在名称中找到 hello，则返回 true。
补充练习：
- 更改所要搜索的文本
- 尝试在搜索文本中使用星号通配符（比如 *lo）
- 将 name 替换为 notes 或 outputbus
联用对象属性
Wwise 对象具有两种类型的属性：
- 返回数值的属性：
- Volume、Pitch、Lowpass 等：通常与 Wwise 中的滑杆关联，用于存储数字值。这些属性因对象类型而异。比如，Sound 和 Random Container 便拥有不同的属性。
- Name、Note、ID、Path：Wwise 对象系统的核心元素，其通常存储字符串值。所有 Wwise 对象都拥有这些属性。
- 返回另一 Wwise 对象的属性（又称引用）：
- OutputBus、Target、UserAuxSend0、Effect0：这些属性指向另一对象，并因对象类型而异。比如，Event 和 Sound 便拥有不同的属性。
- Parent：指向父对象 (parent)。
您可以使用点号运算符将两项属性结合在一起。例如：
$ where parent.name = "Music"
或者
$ where parent.volume < 0
甚至，还可将多个属性结合在一起：
$ where outputbus.parent.name = "Master Audio Bus"
 |
备注: 在将属性结合在一起时，确保把要返回值的属性放在最后一个点号之后。至于要返回另一对象的属性，则可放在序列中的任何位置。 |
补充练习：
- 尝试对 outputbus 的 volume 进行筛选
- 尝试对 Effect0 的 pluginname 进行筛选
使用不同的源
目前，我们都是筛选整个工程中的对象。不过有时需要缩小搜索范围，将目标限定为一组特定的对象。
键入以下查询：
$ from type sound
此查询会列出工程中的所有 Sound 对象。from 关键字用于定义从哪里开始查询。这样可以有效地缩小搜索范围。藉此，WAQL 可将迭代限定为指定的源。
甚至，还可指定多种对象类型：
$ from type randomsequencecontainer, switchcontainer, blendcontainer
同时，还可使用 where 关键字为前述查询写入筛选器：
$ where type = "randomsequencecontainer" or type = "switchcontainer" or type = "blendcontainer"
不过，执行筛选时必须查询所有工程对象，包括 Event、Bus、Sound 等等。这样的话执行速度会比较慢。
补充练习：
- 尝试使用其他对象类型（参见 Wwise 对象参考 章节）。
结合使用 from 和 where
键入以下查询：
$ from type sound where volume < 0
此查询会获取工程中的所有 Sound 对象，并在筛选之后只列出音量小于零的声音。
其中 from 关键字仅可用在 WAQL 查询的开头，where 关键字则要添加到 from 的后面。
补充练习：
- 尝试在 from 部分使用其他对象类型
- 尝试在 where 部分使用其他条件
- 尝试联用多个 where 语句
从特定对象查询
WAQL 可进一步限定查询源。
在 List View 中键入以下查询：
$ from object "\Actor-Mixer Hierarchy"
此查询会使用对象路径来返回单个对象。
为了使语句更加紧凑，WAQL 还支持省略 from object 部分。因此，可直接键入：
$ "\Actor-Mixer Hierarchy"
此查询会返回指定的对象。
当然，也可列出多个对象：
$ "\Master-Mixer Hierarchy", "\Actor-Mixer Hierarchy"
补充练习：
- 在按住 SHIFT 的同时右键单击 Project Explorer 中的某个对象。在快捷菜单中选择 Copy Path(s) to clipboard。将其设为 WAQL 查询的源。
- 在按住 SHIFT 的同时右键单击 Project Explorer 中的多个对象。在快捷菜单中选择 Copy WAQL query to clipboard。将查询粘贴到 List View 中。
- 在按住 SHIFT 的同时右键单击 Project Explorer 中的某个对象。在快捷菜单中选择 Copy GUID(s) to clipboard。将 GUID 粘贴到 List View 中，并在前后添加双引号：$ "{1514A4D8-1DA6-412A-A17E-75CA0C2149F3}"。
- 对于 Bus 和 Event，尝试使用类型和名称：$ "Bus:Master Audio Bus"。
选择对象
前面尝试了从不同的源执行 WAQL 查询，接下来我们看看如何选择对象。通过选择对象，可从初始对象序列获取其他对象。
在 List View 中键入以下查询：
$ "\Actor-Mixer Hierarchy\Default Work Unit" select children
此查询会获取 Default Work Unit，并返回其所有的直接子对象 (children)。
下面来尝试获取更多对象：
$ "\Actor-Mixer Hierarchy\Default Work Unit" select descendants
此查询会在结果中获取 Default Work Unit 的所有下级对象 (descendant)。这些下级对象包括所有以递归方式获取的子对象。
补充练习：
- 尝试选择父对象
- 尝试选择多个元素（元素之间使用逗号分隔）
- 尝试将 select 语句添加到第一部分中的 where 查询
- 尝试在 select 查询的末尾添加 where 语句
- 尝试选择 outputbus
通过 Event 播放声音
前面学习了 WAQL 的基本概念，下面我们来尝试构建具体的示例。在本例中，我们将尝试枚举 Event 引用的所有声音。
首先，枚举工程中的所有 Event：
$ from type event
然后，从 Event 对象获取 Event 动作（直接子对象）：
$ from type event select children
然后，获取各个动作的目标（引用命名目标）：
$ from type event select children select target
然后，获取目标本身（使用 this 关键字）及其下级对象：
$ from type event select children select target select this, descendants
最后，通过筛选类型来仅保留 Sound 对象：
$ from type event select children select target select this, descendants where type = "sound"
补充练习：
- 将查询源由工程中的所有 Event 改为特定的 Event。
- 尝试仅筛选 Play 动作（滤掉其他类型，比如 Stop）。有关动作属性的信息，请参阅 Action 章节。
通过 Event 播放声音 – 反向操作
下面我们来从 Sound 对象开始查询，并列出所有可播放该对象的 Event：
$ from type sound
然后，获取所有声音本身及其上级对象 (ancestor)。之所以在意上级对象，是因为其同样可被 Event 引用。比如，父级 Random Container 便可作为 Event 的目标。
$ from type sound select this, ancestors
然后，获取所有引用目前所获元素的对象：
$ from type sound select this, ancestors select referencesTo
这样基本上相当于查找所有引用（类似于 Reference 视图），不过需要筛选并仅保留 Event 动作，因为其他对象（如 SoundBank 或 SoundCaster 会话）也有可能包含对它们的引用：
$ from type sound select this, ancestors select referencesTo where type = "action"
最后，获取各个动作的父对象（即 Event）：
$ from type sound select this, ancestors select referencesTo where type = "action" select parent
补充练习：
- 将查询源由工程中的所有声音改为特定的声音。
- 将查询源由工程中的所有声音改为特定 Work Unit 下的所有对象。
- 尝试仅保留 Play 动作（滤掉其他动作类型，比如 Stop）。
总结
下面我们来总结一下本教程中所学的内容。
关于 WAQL 查询的构成：
- 查询会返回一系列 Wwise 对象。
- 查询可拆分成多个部分（由 from、where 和 select 语句定义）。
- 查询的每个部分为下一部分馈送结果。
- 必须指定从哪里开始查询。查询源由 from 语句定义。
- 在省略 from 语句时，将把工程中的所有对象作为查询源。
- where 语句允许从馈送序列（即前一部分）中滤掉某些对象，而仅保留那些符合条件的对象。
- select 语句允许从馈送序列（即前一部分）中获取新的对象。
- where 和 select 语句可添加到任何序列。
关于 Wwise 对象：
- Wwise 对象拥有属性，其可用在 where 或 select 语句中。
- 属性既可以是数字值、布尔值、字符串，也可以是对工程中其他对象的引用。
- 有些属性适用于所有对象类型（称为核心属性）。
- 有些属性仅适用于一种或多种对象类型。
- 属性可与点号运算符结合使用。
下一步？您可以使用 WAQL 执行很多其他操作：
- 如需继续了解 WAQL，请参阅 术语表 和 重要的关键字和概念 章节。
- 如需了解都可使用 WAQL 查询哪些内容，请参阅 Wwise Authoring Query Language (WAQL) 参考 章节。
- 如需了解 Wwise 对象及其属性，请参阅 Wwise 对象参考 章节。
- 如需了解如何在 WAAPI 中使用 WAQL，请参阅 ak.wwise.core.object.get 章节。