startAudioCapture abstract method

Future<int?> startAudioCapture()

开启内部音频采集,默认为关闭状态

内部采集是指使用 RTC SDK 内置的音频采集机制进行音频采集。 调用该方法开启采集后,本地用户会收到 RTCVideoEventHandler.onAudioDeviceStateChanged 的回调。 可见用户进房后调用该方法,房间中的其他用户会收到 RTCVideoEventHandler.onUserStartAudioCapture 回调。

返回值:

  • 0:调用成功;
  • <0:调用失败,具体原因参看 ReturnStatus

注意:

  • 若未取得当前设备的麦克风权限,调用该方法后会触发 RTCVideoEventHandler.onAudioDeviceStateChanged 回调,对应的错误码为 MediaDeviceError.deviceNoPermission
  • 调用 RTCVideo.stopAudioCapture 可以关闭音频采集设备,否则,SDK 只会在销毁引擎的时候自动关闭设备。
  • 由于不同硬件设备初始化响应时间不同,频繁调用本方法和 RTCVideo.stopAudioCapture 可能出现短暂无声问题,建议使用 RTCRoom.publishStream/RTCRoom.unpublishStream 实现临时闭麦和重新开麦。
  • 无论是否发布音频数据,你都可以调用该方法开启音频采集,并且调用后方可发布音频。

Implementation

Future<int?> startAudioCapture();