音视频设备管理 (Web SDK 4.x)

功能描述

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

切换音视频设备

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

此外，Agora Web SDK 还支持通过 CameraVideoTrack.setDevice 和 MicrophoneAudioTrack.setDevice 在创建轨道之后动态切换音视频采集设备。

示例代码中的 videoTrack 是指通过 AgoraRTC.createCameraVideoTrack 创建的本地视频轨道对象。

// 切换摄像头。
videoTrack.setDevice("<NEW_DEVICE_ID>").then(() => {
  console.log("set device success");
}).catch(e => {
  console.log("set device error", e);
});

支持在发布后调用，在部分移动设备上该方法可能不生效。

音视频采集设备热插拔

Agora Web SDK 提供 AgoraRTC.onMicrophoneChanged 和 AgoraRTC.onCameraChanged 方法来监听并获取音视频设备的插拔状态。如果你想要在新设备插入的时候强制使用新设备，你需要监听 AgoraRTC.onMicrophoneChanged 或 AgoraRTC.onCameraChanged，并在对应的回调函数里调用 MicrophoneAudioTrack.setDevice 或 CameraVideoTrack.setDevice 来切换音视频采集设备。

AgoraRTC.onMicrophoneChanged = async (changedDevice) => {
  // 插入设备时，切换到新插入的设备。
  if (changedDevice.state === "ACTIVE") {
    microphoneTrack.setDevice(changedDevice.device.deviceId);
  // 拔出设备为当前设备时，切换到一个已有的设备。
  } else if (changedDevice.device.label === microphoneTrack.getTrackLabel()) {
    const oldMicrophones = await AgoraRTC.getMicrophones();
    oldMicrophones[0] && microphoneTrack.setDevice(oldMicrophones[0].deviceId);
  }
}

AgoraRTC.onCameraChanged = async (changedDevice) => {
  // 插入设备时，切换到新插入的设备。
  if (changedDevice.state === "ACTIVE") {
    cameraTrack.setDevice(changedDevice.device.deviceId);
    // 拔出设备为当前设备时，切换到一个已有的设备。
  } else if (changedDevice.device.label === cameraTrack.getTrackLabel()) {
    const oldCameras = await AgoraRTC.getCameras();
    oldCameras[0] && cameraTrack.setDevice(oldCameras[0].deviceId);
  }
}