音频频谱

disableAudioSpectrumMonitor

禁用音频频谱监测。

Java

public abstract int disableAudioSpectrumMonitor();

调用 enableAudioSpectrumMonitor 后，如需关闭音频频谱监测，可以调用该方法。

信息

你可以在加入频道前或加入频道后调用此方法。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• RtcEngine

enableAudioSpectrumMonitor

开启音频频谱监测功能。

Java

public abstract int enableAudioSpectrumMonitor(int intervalInMS);

你可以注册音频频谱观察器并调用该方法以获取本地或远端用户的音频频谱数据。

适用场景

你可以在加入频道前或加入频道后调用此方法。

相关回调

onLocalAudioSpectrum 和 onRemoteAudioSpectrum 回调。

参数

intervalInMS

SDK 触发 onLocalAudioSpectrum 和 onRemoteAudioSpectrum 回调的时间间隔，单位为毫秒。该参数不能小于 10，否则调用该方法会失败。（默认值为 100）

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。
  • -2：参数无效。

所属接口类

• RtcEngine

registerAudioSpectrumObserver

注册音频频谱观察器。

Java

public abstract int registerAudioSpectrumObserver(IAudioSpectrumObserver observer);

成功注册音频频谱观察器并调用 enableAudioSpectrumMonitor 启用音频频谱监测后，SDK 会根据你设置的时间间隔，触发你在 IAudioSpectrumObserver 中实现的回调。

信息

你可以在加入频道前或加入频道后调用此方法。

参数

observer

音频频谱观察器。详见 IAudioSpectrumObserver。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• RtcEngine

unRegisterAudioSpectrumObserver

取消注册音频频谱观察器。

Java

public abstract int unRegisterAudioSpectrumObserver(IAudioSpectrumObserver observer);

调用 registerAudioSpectrumObserver 后，如果你希望关闭音频频谱监测，可以调用此方法。

信息

你可以在加入频道前或加入后调用此方法。

参数

observer

音频频谱观察器，详见 IAudioSpectrumObserver。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• RtcEngine

onLocalAudioSpectrum

本地音频频谱数据回调。

Java

@CalledByNative boolean onLocalAudioSpectrum(AudioSpectrumInfo data);

在成功调用 registerAudioSpectrumObserver 实现 onLocalAudioSpectrum 回调，并调用 enableAudioSpectrumMonitor 启用音频频谱监测后，SDK 会按照你设置的时间间隔，在编码前触发该回调报告本地用户的音频频谱数据。

触发时机

该回调在启用音频频谱监测并设置时间间隔后，由 SDK 按照设置的时间间隔在编码前触发。

参数

data

本地用户的音频频谱数据。详见 AudioSpectrumInfo。

返回值

是否接收到频谱数据：

• true：已接收到频谱数据。
• false：未接收到频谱数据。

所属接口类

• IAudioSpectrumObserver

onRemoteAudioSpectrum

远端音频频谱数据回调。

Java

boolean onRemoteAudioSpectrum(UserAudioSpectrumInfo[] userAudioSpectrumInfos, int spectrumNumber);

成功调用 registerAudioSpectrumObserver 并调用 enableAudioSpectrumMonitor 启用音频频谱监测后，SDK 会按照你设置的时间间隔触发该回调。

触发时机

该回调在成功调用 registerAudioSpectrumObserver 并启用音频频谱监测后，根据设置的时间间隔被触发。

参数

userAudioSpectrumInfos

远端用户的音频频谱信息。数组长度为 SDK 监测到的远端用户数量。如果该数组为 null，表示未检测到远端用户的音频频谱。详见 UserAudioSpectrumInfo。

spectrumNumber

远端用户的数量。

返回值

• true：接收到频谱数据。
• false：未接收到频谱数据。

所属接口类

• IAudioSpectrumObserver