关于 WebRTC API navigator.mediaDevices.getUserMedia 返回类型的讨论-CFANZ编程社区

关于 WebRTC API navigator.mediaDevices.getUserMedia 返回类型的讨论

MediaDevices.enumerateDevices()

MediaDevices 方法 enumerateDevices() 请求可用媒体输入和输出设备的列表，例如麦克风、相机、耳机等。返回的 Promise 使用描述设备的 MediaDeviceInfo 数组解析。

对特定设备的访问由 Permissions API 控制。返回的设备列表将省略任何未授予相应权限的设备，包括：麦克风、摄像头、扬声器选择（用于输出设备）等。

一个 Promise，当 Promise 完成时接收 MediaDeviceInfo 对象数组。数组中的每个对象都描述了一个可用的媒体输入和输出设备（只有被授予权限的设备类型是“可用的”）。顺序很重要 - 默认捕获设备将首先列出。

如果枚举失败，则 Promise 被拒绝。

下面的代码是一个例子，枚举当前运行环境里所有摄像头设备的 id：

if (!navigator.mediaDevices || !navigator.mediaDevices.enumerateDevices) {
  console.log("enumerateDevices() not supported.");
  return;
}

// List cameras and microphones.

navigator.mediaDevices.enumerateDevices()
.then(function(devices) {
  devices.forEach(function(device) {
    console.log(device.kind + ": " + device.label +
                " id = " + device.deviceId);
  });
})
.catch(function(err) {
  console.log(err.name + ": " + err.message);
});