|
Wwise SDK 2021.1.14
|
在音频源的给定区域以二进制字符串数组形式获取最小/最大峰值对（每个声道对应一个字符串）。字符串为 base-64 编码的 16 位有符号整数数组（交错存取最小值和最大值）。若 getCrossChannelPeaks 为 true，则仅有一个二进制字符串（代表所有声道的全局峰值）。
| 名称 | 类型 | 说明 |
|---|---|---|
| object * | any of: | Audio Source 对象的 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。 | |
| timeFrom * | number | 需要获取峰值的音频源区域的开始时间（秒）。此数值须小于 timeTo。范围：[0,*] |
| timeTo * | number | 需要获取峰值的音频源区域的结束时间（秒）。此数值须大于 timeFrom。范围：[0,*] |
| 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） 章节。