音频频谱
- Android
更新时间不可用
disableAudioSpectrumMonitor
禁用音频频谱监测。
public abstract int disableAudioSpectrumMonitor();调用 enableAudioSpectrumMonitor 后，如需关闭音频频谱监测，可以调用该方法。
注： 你可以在加入频道前或加入频道后调用此方法。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
enableAudioSpectrumMonitor
开启音频频谱监测功能。
public abstract int enableAudioSpectrumMonitor(int intervalInMS);你可以注册音频频谱观察器并调用该方法以获取本地或远端用户的音频频谱数据。
适用场景
你可以在加入频道前或加入频道后调用此方法。
相关回调
onLocalAudioSpectrum 和 onRemoteAudioSpectrum 回调。
参数
| 参数名 | 描述 |
|---|---|
intervalInMS | SDK 触发 onLocalAudioSpectrum 和 onRemoteAudioSpectrum 回调的时间间隔，单位为毫秒。该参数不能小于 10，否则调用该方法会失败。（默认值为 100） |
返回值
-
0：方法调用成功。
-
< 0：方法调用失败。详见错误码了解详情和解决建议。
- -2：参数无效。
所属接口类
registerAudioSpectrumObserver
注册音频频谱观察器。
public abstract int registerAudioSpectrumObserver(IAudioSpectrumObserver observer);成功注册音频频谱观察器并调用 enableAudioSpectrumMonitor 启用音频频谱监测后，SDK 会根据你设置的时间间隔，触发你在 IAudioSpectrumObserver 中实现的回调。
注： 你可以在加入频道前或加入频道后调用此方法。
参数
| 参数名 | 描述 |
|---|---|
observer | 音频频谱观察器。详见 IAudioSpectrumObserver。 |
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
unRegisterAudioSpectrumObserver
取消注册音频频谱观察器。
public abstract int unRegisterAudioSpectrumObserver(IAudioSpectrumObserver observer);调用 registerAudioSpectrumObserver 后，如果你希望关闭音频频谱监测，可以调用此方法。
注： 你可以在加入频道前或加入后调用此方法。
参数
| 参数名 | 描述 |
|---|---|
observer | 音频频谱观察器，详见 IAudioSpectrumObserver。 |
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
onLocalAudioSpectrum
本地音频频谱数据回调。
@CalledByNative boolean onLocalAudioSpectrum(AudioSpectrumInfo data);在成功调用 registerAudioSpectrumObserver 实现 onLocalAudioSpectrum 回调，并调用 enableAudioSpectrumMonitor 启用音频频谱监测后，SDK 会按照你设置的时间间隔，在编码前触发该回调报告本地用户的音频频谱数据。
触发时机
该回调在启用音频频谱监测并设置时间间隔后，由 SDK 按照设置的时间间隔在编码前触发。
参数
| 参数名 | 描述 |
|---|---|
data | 本地用户的音频频谱数据。详见 AudioSpectrumInfo。 |
返回值
是否接收到频谱数据：
- true：已接收到频谱数据。
- false：未接收到频谱数据。
所属接口类
onRemoteAudioSpectrum
远端音频频谱数据回调。
boolean onRemoteAudioSpectrum(UserAudioSpectrumInfo[] userAudioSpectrumInfos, int spectrumNumber);成功调用 registerAudioSpectrumObserver 并调用 enableAudioSpectrumMonitor 启用音频频谱监测后，SDK 会按照你设置的时间间隔触发该回调。
触发时机
该回调在成功调用 registerAudioSpectrumObserver 并启用音频频谱监测后，根据设置的时间间隔被触发。
参数
| 参数名 | 描述 |
|---|---|
userAudioSpectrumInfos | 远端用户的音频频谱信息。数组长度为 SDK 监测到的远端用户数量。如果该数组为 |
spectrumNumber |
返回值
- true：接收到频谱数据。
- false：未接收到频谱数据。