AudioAnalyzer 从通过 Wire 连接到它的音频流中提取测量值。它提供一个 输入 引脚,但不产生任何输出流。请注意,为了节省资源,所有音频处理在服务器上都是禁用的;在服务器脚本中使用时,AudioAnalyzer 的属性和方法将返回空或零结果。
概要
属性
在最后的音频缓冲区中观察到的最大音量。
在最后的音频缓冲区中观察到的均方根平均音量。
启用使用 GetSpectrum。
方法
返回连接到指定引脚的 Wires 数组。
返回最后音频缓冲区的频率谱。
活动
当另一个实例通过 Wire 连接到或从 AudioAnalyzer 断开时触发。
属性
RmsLevel
在最后的音频缓冲区中观察到的均方根平均音量。此属性通常比 PeakLevel 更稳定,但可能无法捕捉瞬时音量波动。此属性的变化频率高于帧率,并且不会触发更改事件。在服务器上,此属性始终为 0。
SpectrumEnabled
启用使用 GetSpectrum()。如果为 false,则 GetSpectrum() 返回空数组,但 AudioAnalyzer 的 CPU 开销大幅减少。这意味着如果您只分析音频流的 音量,可以禁用此属性以提高性能。
WindowSize
方法
GetSpectrum
返回最后音频缓冲区的频率谱,作为数字数组。数组中的元素是均方根音量水平,均匀间隔从 0 赫兹到 24,000 赫兹。如果分析器的任何输入来自 AudioDeviceInput,或者从服务器脚本中使用此方法,则返回空数组。
返回
活动
WiringChanged
事件在 Wire 连接或断开后触发,该 Wire 现在或之前已连接到 AudioAnalyzer 的引脚和某个其他可连接实例。