音视频设备管理

编辑文档更新于 2025-01-16 07:59:52

功能描述

Web SDK 提供 API 用于音视频设备管理，例如在通话过程中动态切换音视频采集设备、处理音视频采集设备热插拔逻辑等

切换音视频设备

在创建本地音视频轨道时，可以通过指定 cameraId 和 microphoneId 来指定音视频设备。

let camera = refBottom.getCurrentCamera()
let mic = refBottom.getCurrentMic()

let options = {
  video: !!camera,
  audio: !!mic
  cameraId: camera.deviceId
  microphoneId: mic.deviceId
}
let publishStream;
publishStream = BRTC.createStream(options);

此外，百家云 Web SDK 还支持通过 publishStream.switchDevice 在创建本地音视频流对象之后动态切换音视频采集设备。

// 切换麦克风设备
this.sourcePublishStream.switchDevice('audio', device.deviceId).then(() => {
    //切换成功的处理逻辑
})
// 切换摄像头设备
this.sourcePublishStream.switchDevice('video', device.deviceId).then(() => {
    //切换成功的处理逻辑
})
// 切换扬声器
this.remoteStream.setAudioOutput(device.deviceId)

错误处理

在调用 switchDevice 替换音视频的输入源时，因为输入参数等因素 SDK 可能抛出如下错误：

INVALID_OPERATION: 非法操作，message 中的错误信息如下：
- 输入的deviceId，与当前的 audioTrack 不匹配，不是来自于麦克风设备
- 输入的deviceId，与当前的 videoTrack 不匹配，不是来自于摄像头设备
- stream 流未初始化、或者已被销毁
INVALID_PARAMETER: deviceId 类型错误。