版本
|
Wwise SDK 2021.1.14
|
针对每个声道在音频源的整个修剪区域以二进制字符串数组形式获取最小/最大峰值对（每个声道对应一个字符串）。字符串为 base-64 编码的 16 位有符号整数数组（交错存取最小值和最大值）。若 getCrossChannelPeaks 为 true，则仅有一个二进制字符串（代表所有声道的全局峰值）。
| 名称 | 类型 | 说明 |
|---|---|---|
| object * | any of: | 音频源的 ID (GUID)、名称或路径。 |
| string | 由类型限定的对象名称，格式为 type:name。仅支持采用全局唯一名称的对象类型。例如：Event:Play_Sound_01 | |
| string | 以下形式的对象 GUID：{aabbcc00-1122-3344-5566-77889900aabb}。 | |
| string | Wwise 对象的工程路径，包含类别和 Work Unit。例如：\Actor-Mixer Hierarchy\Default Work Unit\New Sound SFX。 | |
| numPeaks * | integer | 所需的峰值数量（最小值为 1）. 范围：[1,4294967295] |
| getCrossChannelPeaks | boolean | 若为 true，则统一计算各个声道的峰值，而非单独计算每个声道的峰值。 |
(必填 *)
| 名称 | 类型 | 说明 |
|---|---|---|
| peaksBinaryStrings | array | 此数组中包含一系列二进制字符串。 |
| peaksBinaryStrings [...] | string | 二进制字符串，代表某个声道的最小/最大峰值数据。若 getCrossChannelPeaks 为 true，则此数组中仅有一个二进制字符串（代表所有声道的最小/最大峰值）。 |
| numChannels | number | 峰值数据对应的声道数量（即 peaksBinaryStrings 中的字符串数量）。若 getCrossChannelPeaks 为 true，则该值为 1。 |
| maxAbsValue | number | 峰值的最大可能值。此项可用于将数组中的各个峰值除以此数值来对其进行归一化（介于 -1 ~ 1 之间）。 |
| peaksArrayLength | number | 返回的最小/最大声道数量数组中的峰值数量。若 peaksArrayLength 小于 numPeaks 输入参数，则表示可用的采样数少于请求的 numPeaks。在这种情况下，数组包含请求的时间区间内的所有采样值。 |
| peaksDataSize | number | 最小/最大峰值数组中的数据的大小。此项可与 peaksArrayLength 结合用于将 peaksBinaryStrings 解码为 16 位整数数组。 |
有关 Wwise Authoring API 的详细信息，请参阅 使用 Wwise Authoring API（WAAPI） 章节。