媒体采集与流

MediaStream

参见 MediaStream 构造函数算法

无参数。

MediaStream

参见 MediaStream 构造函数算法

MediaStream

参见 MediaStream 构造函数算法

id 类型为 DOMString， 只读

id 属性必须返回对象创建时初始化的值。

创建 MediaStream 时， 用户代理必须生成一个标识符字符串，并必须将对象的 id 属性初始化为该字符串，除非对象是作为特殊算法的一部分创建，该算法指定了流 id 的初始化方式。推荐做法是使用 UUID [rfc4122]，其规范形式为36位字符。为避免指纹识别，实现应当在生成UUID时使用RFC 4122的4.4或4.5节中的格式。

指定流 id 初始化方式的算法示例如，将传入网络组件与 MediaStream 对象关联的算法。[WEBRTC]

active 类型为 boolean，只读

active 属性必须在此 MediaStream 为 活动时返回 true，否则返回 false。

onaddtrack 类型为 EventHandler

该事件处理器的事件类型为 addtrack。

onremovetrack 类型为 EventHandler

该事件处理器的事件类型为 removetrack。

getAudioTracks()

返回表示此流中音频轨道的 MediaStreamTrack 对象序列。

getAudioTracks 方法必须返回一个序列，表示此流的 轨道集合中所有 MediaStreamTrack 对象的快照，其 [[Kind]] 等于 "audio"。由 轨道集合转换为序列的过程由 用户代理定义，且多次调用时序列顺序不需保持稳定。

getVideoTracks()

返回表示此流中视频轨道的 MediaStreamTrack 对象序列。

getVideoTracks 方法必须返回一个序列，表示此流的 轨道集合中所有 MediaStreamTrack 对象的快照，其 [[Kind]] 等于 "video"。由 轨道集合转换为序列的过程由 用户代理定义，且多次调用时序列顺序不需保持稳定。

getTracks()

返回表示此流中所有轨道的 MediaStreamTrack 对象序列。

getTracks 方法必须返回此流的 轨道集合中所有 MediaStreamTrack 对象的快照，无论 [[Kind]] 类型。由 轨道集合转换为序列的过程由用户代理定义，且多次调用时序列顺序不需保持稳定。

getTrackById()

getTrackById 方法必须返回此流 轨道集合中 MediaStreamTrack 对象，其 [[Id]] 等于 trackId，不存在则返回 null。

addTrack()

将给定的 MediaStreamTrack 添加到此 MediaStream。

调用 addTrack 方法时，用户代理必须执行如下步骤：

1. 令 track 为方法参数，stream 为调用该方法的 MediaStream 对象。

2. 如果 track 已在 stream 的 轨道集合中，则终止这些步骤。

3. 添加 track 到 stream 的 轨道集合。

removeTrack()

从此 MediaStream 移除给定的 MediaStreamTrack 对象。

调用 removeTrack 方法时，用户代理必须执行如下步骤：

1. 令 track 为方法参数，stream 为调用该方法的 MediaStream 对象。

2. 如果 track 不在 stream 的 轨道集合中，则终止这些步骤。

3. 移除 track 从 stream 的 轨道集合。

clone()

克隆给定的 MediaStream 及其所有轨道。

调用 clone() 方法时，用户代理必须执行如下步骤：

1. 令 streamClone 为新构造的 MediaStream 对象。

2. 初始化 streamClone.MediaStream.id 为新生成的值。

3. 克隆每个轨道到此 MediaStream 对象，并将结果添加到 streamClone 的 轨道集合中。

4. 返回 streamClone。

期望触发 addtrack 或 removetrack 事件的用户代理代码应通过其他对象引用保持目标 MediaStream 对象存活。垃圾回收 MediaStream 对象时无需考虑 addtrack 或 removetrack 事件监听器的存在。

constructor()

构造一个新的 MediaStreamTrackEvent。

track 类型为 MediaStreamTrack，只读

track 属性表示与事件关联的 MediaStreamTrack 对象。

track 类型为 MediaStreamTrack，必需

mediaDevices 类型为 MediaDevices，只读

返回 this 的 相关全局对象的 关联 MediaDevices。

ondevicechange 类型为 EventHandler

该事件处理器的事件类型为 devicechange。

enumerateDevices

收集 用户代理 可用的媒体输入和输出设备信息。

该方法返回一个 promise。promise 将在 成功时携带一个 MediaDeviceInfo 对象序列， 表示 用户代理 可用的媒体输入和输出设备（枚举成功时）。

该序列中表示输入设备的元素将为 InputDeviceInfo 类型，继承自 MediaDeviceInfo。

摄像头和麦克风源 应当 可枚举。增加其他源类型的规范会给出该源类型是否可枚举的建议。

当调用 enumerateDevices() 方法时，用户代理必须执行以下步骤：

1. 令 p 为一个新 promise。

2. 令 proceed 为 设备枚举可进行 的结果，参数为 this。

3. 令 mediaDevices 为 this。

4. 并行执行以下步骤：

   1. 当 proceed 为 false 时， 用户代理 必须等待，直到队列任务将 proceed 设置为 设备枚举可进行 的结果（参数为 mediaDevices），使 proceed 变为 true。

   2. 令 resultList 为 创建设备信息对象列表 的结果，参数为 mediaDevices 和 mediaDevices.[[storedDeviceList]]。

   3. resolve p，值为 resultList。

5. 返回 p。

要执行 创建设备信息对象列表，给定 mediaDevices 和 deviceList， 执行以下步骤：

1. 令 resultList 为一个空列表。

2. 令 microphoneList、cameraList 和 otherDeviceList 为空列表。

3. 令 document 为 mediaDevices 的 相关全局对象 的 关联 Document。

4. 对 deviceList 中每个已发现的设备 device，执行如下子步骤：

   1. 如果 device 不是麦克风，或 document 不允许使用 "microphone" 功能， 跳过本设备，继续下一个设备（如有）。

   2. 令 deviceInfo 为 创建设备信息对象 的结果（表示 device，参数为 mediaDevices）。

   3. 如果 device 是系统默认麦克风， 则将 deviceInfo 前置到 microphoneList。 否则，将 deviceInfo 添加到 microphoneList。

5. 对 deviceList 中每个已发现的设备 device，执行如下子步骤：

   1. 如果 device 不是摄像头，或 document 不允许使用 "camera" 功能， 跳过本设备，继续下一个设备（如有）。

   2. 令 deviceInfo 为 创建设备信息对象 的结果（表示 device，参数为 mediaDevices）。

   3. 如果 device 是系统默认摄像头， 则将 deviceInfo 前置到 cameraList。 否则，将 deviceInfo 添加到 cameraList。

6. 如果 麦克风信息可暴露 在 mediaDevices 上为 false， 则将 microphoneList 截断为仅保留第一个。

7. 如果 摄像头信息可暴露 在 mediaDevices 上为 false， 则将 cameraList 截断为仅保留第一个。

8. 对 deviceList 中每个已发现的设备 device，执行如下子步骤：

   1. 如果 device 是麦克风或摄像头，跳过本设备，继续下一个设备（如有）。

   2. 执行 除摄像头和麦克风外的设备暴露决策算法， 参数为 device、microphoneList、cameraList 和 mediaDevices。 若结果为 false，跳过本设备，继续下一个设备（如有）。

   3. 令 deviceInfo 为 创建设备信息对象 的结果（表示 device，参数为 mediaDevices）。

   4. 如果 device 是系统默认音频输出， 则将 deviceInfo 前置到 otherDeviceList。 否则，将 deviceInfo 添加到 otherDeviceList。

9. 按顺序将 microphoneList 中的所有设备追加到 resultList。

10. 按顺序将 cameraList 中的所有设备追加到 resultList。

11. 按顺序将 otherDeviceList 中的所有设备追加到 resultList。

12. 返回 resultList。

由于该方法会跨会话和来源返回可用媒体采集设备的持久信息， 它增加了 用户代理 暴露的指纹信息面。

只要 相关全局对象 的 关联 Document 未进行采集，则该方法只会暴露两位信息：是否有摄像头和是否有麦克风。 用户代理 可通过假装系统有摄像头和麦克风来进行缓解， 直到 相关全局对象 的 关联 Document 调用 getUserMedia() 并传入合理约束。

当 相关全局对象 的 关联 Document 开始采集后，会通过所有媒体采集设备列表（包括分组和设备标签）向跨域共享更多持久信息，进一步增加指纹信息面。

用户代理 可通过清理设备标签来限制暴露。例如移除标签中的用户名，但保留设备制造商或型号信息。 重要的是，清理后的标签仍要让用户能识别对应设备。

deviceId 类型为 DOMString，只读

所表示设备的标识符。设备 必须通过其标识符和 kind 唯一标识。

为确保存储的标识符可被识别，标识符 必须在 Document 的 同源 顶级可遍历对象中保持一致。 在 子可导航对象中， 标识符是否跨文档一致，必须遵循 用户代理的存储分区规则 （如 localStorage）， 以避免影响跨站相关性防护措施。如果标识符可以唯一识别用户，则必须在其他来源的文档中不可猜测，以防止跨来源相关性。只要标识符与用户无关且可通过其他方式（如 User-Agent 字符串）猜测，则可在不同来源间复用。

如果任何本地设备已绑定到本来源页面的活动 MediaStreamTrack， 或本来源已获得访问本地设备的 存储权限， 则该标识符必须被持久保存，除非下述特殊情况。唯一且稳定的标识符允许应用跨多次访问保存、识别设备可用性并直接请求特定源。

但只要没有本地设备被绑定到本来源页面的活动 MediaStreamTrack，且本来源没有获得本地设备的 存储权限，则用户代理 可以 在本来源最后一个浏览会话关闭后清除该标识符。如果用户代理选择不清除， 则必须允许用户可见地检查并删除该标识符，如同 cookie。

由于 deviceId 可能跨会话持久化， 且为减少其作为指纹机制的潜力，deviceId 应当如 cookie [COOKIES] 一样对待， 即用户代理 不得为被禁止使用 cookie 的站点持久化设备标识符， 且用户代理 必须在清除其他持久化存储时，旋转每个来源的设备标识符。

kind 类型为 MediaDeviceKind，只读

所表示设备的类型。

label 类型为 DOMString，只读

描述该设备的标签（例如“外部USB摄像头”）。该标签用于让终端用户区分设备。应用不能假定标签包含任何特定信息，比如设备类型或型号。 如果设备没有标签，则此属性必须返回空字符串。

groupId 类型为 DOMString，只读

所表示设备的分组标识符。如果两个设备属于同一物理设备，则具有相同的分组标识。例如，代表同一耳机的扬声器和麦克风的音频输入输出设备 groupId 相同。

分组标识符必须为每个document唯一生成。

toJSON

调用时，执行 [WEBIDL] 的 默认 toJSON 步骤。

getCapabilities

返回一个 MediaTrackCapabilities 对象， 描述该设备主音频或视频轨道的能力（根据其 kind 值），在没有用户提供约束的情况下。 这些能力必须与调用 getCapabilities() 于 MediaStream 返回的第一个同类 MediaStreamTrack 的结果一致， 其中 getUserMedia({deviceId: id})，id为本对象的 deviceId属性值。

如果尚未获得任何本地设备的访问权限，并且本 InputDeviceInfo 已针对唯一识别信息进行过滤（详见 enumerateDevices() 结果说明），则该方法返回一个空字典。

constructor()

将 this.devices 初始化为 由 eventInitDict.devices 创建的冻结数组。

devices 类型为 FrozenArray<MediaDeviceInfo>， 只读

devices 属性返回当前可用设备列表的 MediaDeviceInfo 对象数组。

userInsertedDevices 类型为 FrozenArray<MediaDeviceInfo>， 只读

userInsertedDevices 属性返回仅包含用户最近新插入或激活并随本事件首次暴露的 MediaDeviceInfo 对象的数组。 否则返回空列表。

用户代理 可以包含在调用 getUserMedia() 前用户插入或激活的设备，只要本事件首次暴露它们且用户未在 getUserMedia() 中选取设备。

这些 MediaDeviceInfo 对象（如有）必须也存在于 devices 中。

注意

用户在通话过程中（或通话前后立即）插入设备是希望立即使用该设备的强烈信号。

鼓励应用根据该属性来区分此信号与设备信息暴露变化带来的设备差异。

注意

如果该属性缺失，说明该用户代理尚未升级实现本规范版本。

devices 类型为 sequence<MediaDeviceInfo>， 默认值为 []

devices 成员是一个 MediaDeviceInfo 对象数组，表示可用设备。

getSupportedConstraints

返回一个字典，其成员是用户代理已知的可约束属性。受支持的属性必须被列出，用户代理不得在返回的字典中出现不支持的属性。返回值表示用户代理实际实现的内容，并且在一次浏览会话期间不会变化。

getUserMedia

弹窗请求用户允许使用其摄像头或其他视频、音频输入。

constraints 参数是 MediaStreamConstraints 类型的字典。

该方法返回一个 promise。promise 在 成功时会返回合适的 MediaStream 对象，如果用户接受有效轨道（如下描述）。

如果找不到有效轨道或用户拒绝授权，promise会 拒绝，具体情况如下。

当调用 getUserMedia() 方法时，用户代理 必须执行以下步骤：

1. 令 constraints 为方法的第一个参数。

2. 令 requestedMediaTypes 为 constraints 中值为字典或 true 的媒体类型集合。

3. 如果 requestedMediaTypes 为空，则返回一个 拒绝的 promise，异常类型为 TypeError。 WebIDL 虽然参数是 optional，但调用必须传参才能成功。

4. 令 document 为 相关全局对象的 关联 Document。

5. 如果 document 不是 完全激活，则返回一个 拒绝的 promise，异常类型为 DOMException， name 属性为 "InvalidStateError"。

6. 如果 requestedMediaTypes 包含 "audio"，且 document 不允许使用 "microphone" 权限名的功能， 跳到 权限失败 步骤。

7. 如果 requestedMediaTypes 包含 "video"，且 document 不允许使用 "camera" 权限名的功能， 跳到 权限失败 步骤。

8. 令 mediaDevices 为 this。

9. 令 isInView 为 is in view 算法的结果。

10. 令 p 为一个新的 promise。

11. 并行执行以下步骤：

    1. 当 isInView 为 false 时， 用户代理 必须等待，直到队列任务将 isInView 设为 is in view 算法结果为 true。

    2. 令 finalSet 为一个（初始为空的）集合。

    3. 对 requestedMediaTypes 中的每种媒体类型 kind，执行：

       1. 对每种 kind 类型的每个可能源设备的每种可能配置，构造一个 候选项，作为最终 MediaStreamTrack 的占位符，包含源设备及其设置字典。

          称该候选集合为 candidateSet。

          如果 candidateSet 为空，跳到 未找到失败 步骤。

       2. 如果 constraints 的 kind 项值为 true，则 CS 为空约束集；否则用 constraints 的 kind 项值。
       3. 移除 CS 中未为该类型 MediaStreamTrack 定义的约束属性。即在 "video" 内的音频约束和 "audio" 内的视频约束会被忽略，而不会导致 OverconstrainedError。

       4. 如果 CS 中有某个 必需约束，其名字不在 设备选择允许的必需约束列表里， 则 拒绝 p，异常类型为 TypeError，终止这些步骤。

       5. 对 candidateSet 中每个候选项，使用 SelectSettings 算法及 CS。若结果为 undefined，移除该候选项。这样可排除不满足约束的设备。

          如果 candidateSet 为空，令 failedConstraint 为所有设置字典中 fitness distance 为无穷大的任何 必需约束，如没有则为 ""，跳到 约束失败 步骤。

          此错误可透露底层设备无法提供哪些能力，用户尚未授权就能用于指纹识别。

       6. 读取所有 candidateSet 中未绑定到当前 Document 活动 MediaStreamTrack 的设备的权限状态。移除权限状态为 "denied" 的候选项。

          如果 candidateSet 为空，说明该类型设备都处于 "denied" 状态，跳到 权限失败 步骤。

       7. 可选地（如基于用户偏好、安全原因或平台限制），跳到 权限失败 步骤。

       8. 将 candidateSet 中所有候选项加入 finalSet。

    4. 令 stream 为一个新的空 MediaStream 对象。

    5. 对 requestedMediaTypes 中每种媒体类型 kind，并行执行以下子步骤：

       注意

       用户代理鼓励将不同类型媒体的并发请求合并为一个用户权限弹窗。

       1. 请求权限使用 PermissionDescriptor， name 设置为 kind 关联的权限名（如 "camera" 对应 "video"， "microphone"对应 "audio"）， 同时考虑所有绑定到当前 Document 活动并具有 同权限的 MediaStreamTrack， 权限状态为 "granted"，最终获得一组媒体。 同权限指获取权限时要求和当前请求相同级别（如非隔离）的 MediaStreamTrack。

          请求用户权限时，用户代理 必须披露权限是仅授予所选设备还是同类所有设备。

          注意

          如果用户未响应，算法会在此步骤停滞。

       2. 如果请求结果为 "denied"，跳到 权限失败 步骤。

    6. 令 hasSystemFocus 为 false。

    7. 当 hasSystemFocus 为 false 时， 用户代理 必须等待，直到队列任务根据 has system focus 算法将 hasSystemFocus 设为 true。

    8. 设置设备信息暴露，参数为 mediaDevices、requestedMediaTypes和true。

    9. 对 requestedMediaTypes 中每种媒体类型 kind，执行：

       1. 令 finalCandidate 为所提供媒体，该媒体 必须是 finalSet 中精确的一个 kind 类型候选项。具体选择由 用户代理决定，可询问用户。

          用户代理 应当根据 SelectSettings 算法计算的 fitness distance 作为选择依据，也可用其他内部信息（如用户偏好）。

          用户代理鼓励默认选择用户的主用或系统默认设备（如果可能）。用户代理 可以允许用户使用任何媒体源，包括录制媒体文件。

       2. 请求结果为 "granted"。 如果硬件错误（如系统/程序/网页锁定）导致无法访问，则移除 finalSet 中对应候选项。 若 finalSet 中无该类型候选项，则 拒绝 p，异常类型为 DOMException， name 属性值为 "NotReadableError"，终止这些步骤。否则，更新 finalSet 后重试。

          若设备访问因其他原因失败，则移除对应候选项。若 finalSet 无该类型候选项，则 拒绝 p，异常类型为 DOMException， name 属性值为 "AbortError"，终止这些步骤。否则，更新 finalSet 后重试。

       3. 令 grantedDevice 为 finalCandidate 的源设备。

       4. 用 grantedDevice 的 deviceId deviceId， 将 mediaDevices.[[devicesLiveMap]][deviceId] 设为 true（如尚未为 true）， 且 mediaDevices.[[devicesAccessibleMap]][deviceId] 也设为 true（如尚未为 true）。

       5. 令 track 为 创建 MediaStreamTrack 的结果，参数为 grantedDevice 和 mediaDevices。 MediaStreamTrack 的源 不得改变。

       6. 将 track 加入 stream 的轨道集合。

    10. 对 stream 中所有轨道，运行 ApplyConstraints 算法，并传入适当约束。若返回非 undefined，令 failedConstraint 为该结果，跳到 约束失败 步骤。

    11. 对 stream 中每个 track， 将轨道源与 MediaDevices 绑定，参数为 track.[[Source]] 和 mediaDevices。

    12. resolve p，值为 stream，终止这些步骤。

    13. 未找到失败：

        1. 如果 允许 getUserMedia 特定失败， 参数为 requestedMediaTypes，结果为 false，跳到 权限失败 步骤。

        2. 拒绝 p，异常类型为 DOMException， name 属性值为 "NotFoundError"。

    14. 约束失败：

        1. 如果 允许 getUserMedia 特定失败， 参数为 requestedMediaTypes，结果为 false，跳到 权限失败 步骤。

        2. 令 message 为 undefined 或信息性人类可读消息， constraint 为 failedConstraint（若 设备信息可暴露为 true），否则为 ""。

        3. 拒绝 p，异常类型为 OverconstrainedError，通过 OverconstrainedError(constraint, message) 构造。

    15. 权限失败：拒绝 p，异常类型为 DOMException， name 属性值为 "NotAllowedError"。

12. 返回 p。

video 类型为 (boolean 或 MediaTrackConstraints)， 默认值为 false

如果为 true，则请求返回的 MediaStream 包含一个视频轨道。 如果提供了 Constraints 结构，则进一步指定视频轨道的类型和设置。如果为 false，则 MediaStream 不得包含视频轨道。

audio 类型为 (boolean 或 MediaTrackConstraints)， 默认值为 false

如果为 true，则请求返回的 MediaStream 包含一个音频轨道。 如果提供了 Constraints 结构， 则进一步指定音频轨道的类型和设置。如果为 false，则 MediaStream 不得包含音频轨道。

getCapabilities

getCapabilities() 方法返回对象所支持的可约束属性名称的字典。当被调用时，用户代理 必须返回 [[Capabilities]] 内部槽的值。

注意

底层硬件可能无法完全映射到所定义的可约束属性的范围。当出现这种情况时，条目 应当定义如何将硬件的设置转换并缩放到属性定义的值。例如，假设一个假设的 fluxCapacitance 属性范围是 -10（最小）到 10（最大），但常见硬件设备只支持 "off"、"medium" 和 "full" 三个值。 可约束属性定义可能会指定，对于这种硬件，用户代理 应该将范围值 -10 映射到 "off"，10 映射到 "full"，0 映射到 "medium"。也可能指明，如果 ConstraintSet 设置为严格值 3，用户代理 应尝试将硬件设置为 "medium"，而 getSettings() 应返回 fluxCapacitance 为 0，因为这是与 "medium" 对应的值。

getConstraints

getConstraints() 方法 返回最近一次成功调用 ApplyConstraints 算法 时的 Constraints 参数，并保持指定顺序。注意，返回的一些高级 ConstraintSets 可能当前未满足。要检查哪些 ConstraintSets 当前有效， 应用应使用 getSettings。 用户代理 可返回效果完全相同的约束集，而不是精确的约束。当被调用时， 用户代理 必须返回 [[Constraints]] 内部槽的值。

getSettings

getSettings() 方法 返回对象所有可约束属性的当前设置，无论是平台默认值还是通过 ApplyConstraints 算法 设置。注意，设置是符合约束的目标值， 因此有时可能与测量性能不同。当被调用时，用户代理 必须返回 [[Settings]] 内部槽的值。

applyConstraints

当 applyConstraints 模板方法 被调用时， 用户代理 必须执行以下步骤：

1. 令 object 为调用此方法的对象。

2. 令 newConstraints 为此方法的参数。

3. 令 p 为一个新的 promise。

4. 并行运行以下步骤，如果此方法多次调用则保持调用顺序：

   1. 令 failedConstraint 为运行 ApplyConstraints 算法， 参数为 newConstraints 的结果。

   2. 令 successfulSettings 为上述步骤算法执行后 object 的当前设置。

   3. 队列一个任务，运行以下步骤：

      1. 如果 failedConstraint 不为 undefined，令 message 为 undefined 或有信息的人类可读消息，reject p，并以 OverconstrainedError 新建对象调用 OverconstrainedError(failedConstraint, message)，然后终止这些步骤。此时原有约束保留。

      2. 将 object 的 [[Constraints]] 内部槽设置为 newConstraints 或一个与 newConstraints 在所有情况下效果相同的 Constraints 字典。

      3. 将 object 的 [[Settings]] 内部槽设置为 successfulSettings。

      4. resolve p，值为 undefined。

5. 返回 p。

ApplyConstraints 算法 说明如下。以下是算法中用到的预备定义：

我们用术语 settings dictionary 表示可能应用为对象设置值的集合。

对于字符串值约束，下文定义 “==” 为真，当序列中的某一值与被比较的值完全相同。

我们定义 fitness distance， 即一个 settings dictionary 与约束集 CS 之间的距离， 对每个成员（由 constraintName 和 constraintValue 组成）在 CS 中 存在 时，其值如下：

1. 如果 constraintName 不被 用户代理 支持，则距离为 0。

2. 如果约束 必需 （constraintValue 包含一个或多个 'min'、'max' 或 'exact' 成员， 或本身为裸值且裸值视为 'exact'），且 settings dictionary 的 constraintName 成员值不满足约束或不存在，则距离为正无穷。

3. 如果约束不适用于该类型对象，则距离为 0（即此约束不影响距离）。

4. 如果 constraintValue 是布尔型，但可约束属性不是，则距离取决于 settings dictionary 的 constraintName 是否 存在，公式如下：

   (constraintValue == exists) ? 0 : 1

5. 如果 settings dictionary 的 constraintName 成员 不存在，距离为 1。

6. 如果没有指定理想值（constraintValue 没有 'ideal' 成员，或裸值视为 'ideal' 时不是裸值），距离为 0。
7. 对所有正数约束（如 height、width、frameRate、aspectRatio、sampleRate 和 sampleSize），距离公式为

   (actual == ideal) ? 0 : |actual - ideal| / max(|actual|, |ideal|)

8. 对所有字符串、枚举和布尔约束（如 deviceId、groupId、facingMode、resizeMode、echoCancellation），距离公式为

   (actual == ideal) ? 0 : 1

更多定义：

• 我们将 ConstraintSet 的每个元素（除了特殊项 'advanced'）称为“约束”，因为它用于将给定属性的可接受设置，从 ConstrainablePattern 对象的对应 Capability 中给出的完整列表或范围，限制为符合其指定范围或列表的值。
• 我们将对象 O 的“有效 Capability”C，称为 C 的可能真子集（即 getCapabilities 返回的值），该子集会考虑环境限制和/或其他约束施加的限制。例如，假设有一个约束集限制了 aspectRatio、height 和 width 属性，对任意两个属性赋值都会限制第三个属性的有效 Capability。有效 Capability 集可能依赖于平台。例如，在资源受限设备上，可能无法将属性 P1 和 P2 都设置为 'high'，而在另一台受限较少的设备上则可能可以。
• 一个 settings dictionary，即对象 O 的可约束属性值集合，如果与约束集 CS 的 fitness distance 小于无穷，则视为满足 CS。
• 一组 ConstraintSets CS1...CSn（n >= 1），如果能找到对象 O 的 settings dictionary 同时满足 CS1...CSn，则视为可被 O 满足。
• 将一组 ConstraintSets CS1...CSn 应用于对象 O，就是选择一组能满足 CS1...CSn 的值，并将它们作为 O 属性的设置进行赋值。

我们定义 SelectSettings 算法如下：

1. 每个 约束 为其属性指定一个或多个值（或一个值的范围）。某属性 可以 在 'advanced' ConstraintSets 列表中多次出现。如果约束的值为一个空列表，则 必须 视为未指定该约束（即，空约束 == 无约束）。

   注意，未知属性会被 WebIDL 丢弃，这意味着未知/不支持的必需约束会被悄悄忽略。为避免意外，建议应用作者先使用 getSupportedConstraints() 方法，如下方示例所示。

2. 令 object 为本算法应用的 ConstrainablePattern 对象。令 copy 为 object 的不受约束副本（即 copy 应如同所有 ConstraintSet 都被移除的 object）。

3. 对 copy 的所有可能的 settings dictionary，计算其 fitness distance，将属性的裸值视为理想值。令 candidates 为所有 fitness distance 有限的 settings dictionary 集合。

4. 如果 candidates 为空，则返回 undefined 作为 SelectSettings 算法的结果。

5. 按指定顺序迭代 newConstraints 内的 'advanced' ConstraintSets。对每个 ConstraintSet：

   1. 计算每个 candidates settings dictionary 与该 ConstraintSet 的 fitness distance，将属性的裸值视为精确值。

   2. 如果某些 candidates settings dictionary 的距离有限，则保留这些 settings dictionary，丢弃其他的。

      如果所有 candidates 的距离均为无穷，则忽略此 ConstraintSet。

6. 从 candidates 中选择一个 settings dictionary，作为 SelectSettings 算法的结果。用户代理 必须 使用距离最小的 settings dictionary（见第 3 步计算）。如果有多个最小距离，用户代理 根据系统默认属性值和 用户代理 默认属性值选择一个。

对于所选设备有系统默认值的属性，如果与上述算法兼容，则 应当 使用系统默认值。通常如 sampleRate 或 sampleSize。其他属性如 echoCancellation 或 resizeMode 通常没有系统默认值。用户代理 为这些属性定义自己的默认值。实现者需注意选择合适的默认值，因为它们常常影响媒体内容的生成。

注意

建议参考已有实现以选择有意义的默认值。注意，默认值可能因系统不同而异，例如桌面与移动设备。撰写本文时，用户代理实现通常采用如下默认值，这些值便于 RTCPeerConnection 作为 sink 使用：

1. width 设为 640。

2. height 设为 480。

3. frameRate 设为 30。

4. echoCancellation 设为 true。

要对 object 应用 ApplyConstraints algorithm，给定参数 newConstraints，用户代理 必须 执行以下步骤：

1. 令 successfulSettings 为以 newConstraints 为约束集运行 SelectSettings 算法的结果。

2. 如果 successfulSettings 为 undefined，令 failedConstraint 为在执行 SelectSettings 算法时所有 settings dictionary 的距离为无穷的任一 必需约束，若没有则为 ""，然后返回 failedConstraint 并终止这些步骤。

3. 一次性移除 object 的现有约束，应用 newConstraints，并将 successfulSettings 作为当前设置。
4. 返回 undefined。

注意

如果 UA 释放了设备，比如轨道被 静音，应用设置不代表更改设备配置。此时，UA 会在重新获取设备时配置设备以匹配轨道设置，比如轨道被 取消静音时。

注意

任何与上述算法结果一致的实现都是允许的。例如，实现可以只跟踪约束下设置的最大最小值，而不是所有可能值。

注意

在选择 settings dictionary 时，UA 可以使用任何可用信息。例如，是否作为 getUserMedia 设备选择的一部分进行选择、摄像头的能耗是否因 settings dictionary 不同而变化，或者使用某个 settings dictionary 会导致设备驱动使用重采样等。

用户代理 可以 在任何时候为对象的可约束属性选择新设置。此时 必须 按上述算法尝试满足所有当前约束，令 successfulSettings 为所得新设置，并队列一个任务执行以下步骤：

1. 令 object 为一个或多个可约束属性的新设置已被更改的 ConstrainablePattern 对象。

2. 将 object 的 [[Settings]] 内部槽设置为 successfulSettings。

max 类型为 double

该属性的最大有效值。

min 类型为 double

该属性的最小值。

exact 类型为 double

该属性的精确要求值。

ideal 类型为 double

该属性的理想（目标）值。

max 类型为 unsigned long

该属性的最大有效值。

min 类型为 unsigned long

该属性的最小值。

exact 类型为 unsigned long

该属性的精确要求值。

ideal 类型为 unsigned long

该属性的理想（目标）值。

exact 类型为 boolean

该属性的精确要求值。

ideal 类型为 boolean

该属性的理想（目标）值。

exact 类型为 (DOMString 或 sequence<DOMString>)

该属性的精确要求值。

ideal 类型为 (DOMString 或 sequence<DOMString>)

该属性的理想（目标）值。

exact 类型为 (boolean 或 DOMString)

该属性的精确要求值。

ideal 类型为 (boolean 或 DOMString)

该属性的理想（目标）值。