# 音频频谱 (/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## disableAudioSpectrumMonitor [#disableaudiospectrummonitor] 关闭音频频谱监测。 ```dart Future disableAudioSpectrumMonitor(); ``` 调用 [enableAudioSpectrumMonitor](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#api_irtcengine_enableaudiospectrummonitor) 后,如果你想关闭音频频谱监测,请调用该方法。 :::note 注: 该方法在加入频道前后均可调用。 ::: ### 返回值 [#返回值] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## enableAudioSpectrumMonitor [#enableaudiospectrummonitor] 开启音频频谱监测。 ```dart Future enableAudioSpectrumMonitor({int intervalInMS = 100}); ``` 如果你想获取本地或远端用户的音频频谱数据,请注册音频频谱观测器并开启音频频谱监测。 :::note 注: 该方法在加入频道前后均可调用。 ::: ### 参数 [#参数] SDK 触发 [onLocalAudioSpectrum](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#callback_iaudiospectrumobserver_onlocalaudiospectrum) 和 [onRemoteAudioSpectrum](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#callback_iaudiospectrumobserver_onremoteaudiospectrum) 回调的时间间隔(毫秒)。 默认值为 100 毫秒。取值不得少于 10 毫秒,否则该方法会调用失败。 ### 返回值 [#返回值-1] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## registerAudioSpectrumObserver [#registeraudiospectrumobserver] 注册音频频谱观测器。 ```dart void registerAudioSpectrumObserver(AudioSpectrumObserver observer); ``` 成功注册音频频谱观测器并调用 [enableAudioSpectrumMonitor](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#api_irtcengine_enableaudiospectrummonitor) 开启音频频谱监测后,SDK 会按照你设置的时间间隔报告你在 [AudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_iaudiospectrumobserver) 类中实现的回调。 :::note 注: 该方法在加入频道前后均可调用。 ::: ### 参数 [#参数-1] 音频频谱观测器。详见 [AudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_iaudiospectrumobserver)。 ### 返回值 [#返回值-2] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## unregisterAudioSpectrumObserver [#unregisteraudiospectrumobserver] 取消注册音频频谱观测器。 ```dart void unregisterAudioSpectrumObserver(AudioSpectrumObserver observer); ``` 调用 [registerAudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#api_irtcengine_registeraudiospectrumobserver) 后,如果你想取消注册音频频谱观测器,请调用该方法。 :::note 注: 该方法在加入频道前后均可调用。 ::: ### 返回值 [#返回值-3] 方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine) ## onLocalAudioSpectrum [#onlocalaudiospectrum] 获取本地音频频谱。 ```dart final void Function(AudioSpectrumData data)? onLocalAudioSpectrum; ``` 成功调用 [registerAudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#api_irtcengine_registeraudiospectrumobserver) 实现 [AudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_iaudiospectrumobserver) 中的 [onLocalAudioSpectrum](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#callback_iaudiospectrumobserver_onlocalaudiospectrum) 回调并调用 [enableAudioSpectrumMonitor](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#api_irtcengine_enableaudiospectrummonitor) 开启音频频谱监测后,SDK 会按照你设置的时间间隔触发该回调,报告编码前的本地音频数据的频谱。 ### 参数 [#参数-2] 本地用户的音频频谱数据。详见 [AudioSpectrumData](/zh-CN/api-reference/rtc/flutter/class-audiospectrumdata)。 ### 所属接口类 [#所属接口类-4] - [AudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_iaudiospectrumobserver) ## onRemoteAudioSpectrum [#onremoteaudiospectrum] 获取远端音频频谱。 ```dart final void Function( List spectrums, int spectrumNumber)? onRemoteAudioSpectrum; ``` 成功调用 [registerAudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#api_irtcengine_registeraudiospectrumobserver) 实现 [AudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_iaudiospectrumobserver) 中的 [onRemoteAudioSpectrum](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#callback_iaudiospectrumobserver_onremoteaudiospectrum) 回调并调用 [enableAudioSpectrumMonitor](/zh-CN/api-reference/rtc/flutter/audio/audio-spectrum#api_irtcengine_enableaudiospectrummonitor) 开启音频频谱监测后,SDK 会按照你设置的时间间隔触发该回调,报告接收到的远端音频数据的频谱。 ### 参数 [#参数-3] 远端用户的音频频谱信息,详见 [UserAudioSpectrumInfo](/zh-CN/api-reference/rtc/flutter/class-useraudiospectruminfo)。 数组数量等于 SDK 监测到的远端用户数量,数组为空表示没有监测到远端用户的音频频谱。 远端用户的数量。 ### 所属接口类 [#所属接口类-5] - [AudioSpectrumObserver](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_iaudiospectrumobserver)