WebRTC：浏览器中的实时通信

当调用 RTCPeerConnection.constructor() 时，用户代理 必须 执行以下步骤：

1. 如果以下步骤中的任何步骤由于此处未指定的原因而失败，抛出一个 UnknownError，并将 message 属性设置为适当的描述。

2. 令 connection 为新创建的 RTCPeerConnection 对象。

3. 令 connection 拥有一个 [[DocumentOrigin]] 内部槽，初始化为 相关设置对象 的 origin。

4. 令 configuration 为该方法的第一个参数。

5. 如果 configuration 中的 certificates 值不为空，为每个证书 certificate 执行以下步骤：

   1. 如果 certificate.expires 的值小于当前时间， 抛出一个 InvalidAccessError。

   2. 如果 certificate.[[Origin]] 与 connection.[[DocumentOrigin]] 不同源， 抛出一个 InvalidAccessError。

   3. 存储 certificate。

6. 否则，生成一个或多个新的 RTCCertificate 实例，使用该 RTCPeerConnection 实例并存储它们。这可以异步地发生，并且在后续步骤中 certificates 的值保持 undefined。正如 [RFC8826] 的 4.3.2.3 节中所述，WebRTC 使用自签名证书而不是公钥基础设施 (PKI) 证书，因此过期检查是为了确保密钥不会被无限期使用，并且不需要额外的证书检查。

7. 初始化 connection 的 ICE 代理。

8. 令 connection 拥有一个 [[Configuration]] 内部槽，初始化为 null。 设置由 configuration 指定的配置。

9. 令 connection 拥有一个 [[IsClosed]] 内部槽，初始化为 false。

10. 令 connection 拥有一个 [[NegotiationNeeded]] 内部槽，初始化为 false。

11. 令 connection 拥有一个 [[SctpTransport]] 内部槽，初始化为 null。

12. 令 connection 拥有一个 [[DataChannels]] 内部槽，初始化为一个空的 有序集合。

13. 令 connection 拥有一个 [[Operations]] 内部槽，表示一个 操作链，初始化为一个空列表。

14. 令 connection 拥有一个 [[UpdateNegotiationNeededFlagOnEmptyChain]] 内部槽，初始化为 false。

15. 令 connection 拥有一个 [[LastCreatedOffer]] 内部槽，初始化为 ""。

16. 令 connection 拥有一个 [[LastCreatedAnswer]] 内部槽，初始化为 ""。

17. 令 connection 拥有一个 [[EarlyCandidates]] 内部槽，初始化为一个空列表。

18. 令 connection 拥有一个 [[SignalingState]] 内部槽，初始化为 "stable"。

19. 令 connection 拥有一个 [[IceConnectionState]] 内部槽，初始化为 "new"。

20. 令 connection 拥有一个 [[IceGatheringState]] 内部槽，初始化为 "new"。

21. 令 connection 拥有一个 [[ConnectionState]] 内部槽，初始化为 "new"。

22. 令 connection 拥有一个 [[PendingLocalDescription]] 内部槽，初始化为 null。

23. 令 connection 拥有一个 [[CurrentLocalDescription]] 内部槽，初始化为 null。

24. 令 connection 拥有一个 [[PendingRemoteDescription]] 内部槽，初始化为 null。

25. 令 connection 拥有一个 [[CurrentRemoteDescription]] 内部槽，初始化为 null。

26. 令 connection 拥有一个 [[LocalIceCredentialsToReplace]] 内部槽，初始化为一个空集合。

27. 返回 connection。

RTCPeerConnection 对象具有一个 操作链，[[Operations]]，它确保链中的异步操作只能一个接一个地执行。如果在前一个调用返回的 Promise 尚未 解决 时进行后续调用，它们会被添加到链中，等到所有前面的调用完成并它们的 Promise 已 解决 后再执行。

要将操作 链接 到 RTCPeerConnection 对象的 操作链 时，请执行以下步骤：

1. 设 connection 为 RTCPeerConnection 对象。

2. 如果 connection 的 [[IsClosed]] 为 true，则返回一个 被拒绝的 Promise，携带一个新创建的 InvalidStateError。

3. 设 operation 为要链接的操作。

4. 设 p 为一个新的 Promise。

5. 将 operation 添加到 [[Operations]]。

6. 如果 [[Operations]] 的长度正好为 1，则执行 operation。

7. 在 operation 返回的 Promise 完成或 被拒绝后，执行以下步骤：

   1. 如果 connection 的 [[IsClosed]] 为 true，则中止这些步骤。

   2. 如果 operation 返回的 Promise 完成并有一个值，则用该值 完成 p。

   3. 如果 operation 返回的 Promise 被拒绝并有一个值，则用该值 拒绝 p。

   4. 在 p 完成或 被拒绝时，执行以下步骤：

      1. 如果 connection 的 [[IsClosed]] 为 true，则中止这些步骤。

      2. 移除 [[Operations]] 的第一个元素。

      3. 如果 [[Operations]] 非空，则执行 [[Operations]] 的第一个元素表示的操作，并中止这些步骤。

      4. 如果 connection 的 [[UpdateNegotiationNeededFlagOnEmptyChain]] 为 false，则中止这些步骤。

      5. 将 connection 的 [[UpdateNegotiationNeededFlagOnEmptyChain]] 设置为 false。

      6. 更新需要协商的标志。

8. 返回 p。

RTCPeerConnection 对象具有一个聚合的 [[ConnectionState]]。每当 RTCDtlsTransport 的状态发生变化时，用户代理 必须 排队执行以下步骤的任务：

1. 设 connection 为与状态发生变化的 RTCDtlsTransport 对象相关联的 RTCPeerConnection 对象。

2. Proposed Correction 35:在 pc.close() 上不触发 connectionstatechange (PR #2876)

   显示当前和未来 显示当前 显示未来

   如果 connection 的 [[IsClosed]] 为 true，则中止这些步骤。

3. 设 newState 为根据 RTCPeerConnectionState 枚举得出的新状态值。

4. 如果 connection 的 [[ConnectionState]] 等于 newState，则中止这些步骤。

5. 将 connection 的 [[ConnectionState]] 设置为 newState。

6. 触发一个名为 connectionstatechange 的事件，目标是 connection。

要在 RTCPeerConnection 对象 connection 上设置本地会话描述 description，请通过 设置会话描述 description，并使用附加值 false。

要在 RTCPeerConnection 对象 connection 上设置远程会话描述 description，请通过 设置会话描述 description，并使用附加值 true。

要在 RTCPeerConnection 对象 connection 上设置会话描述 description，给定布尔值 remote，请执行以下步骤：

1. 令 p 为一个新的 promise。

2. 如果 description.type 是 "rollback"，且 connection.[[SignalingState]] 为 "stable"，"have-local-pranswer"，或 "have-remote-pranswer"，则 拒绝 p 并生成一个新的 InvalidStateError，然后终止这些步骤。

3. 令 jsepSetOfTransceivers 为 connection 的 转接器集合 的浅拷贝。

4. 并行，按照 [RFC9429] (第5.5节 和 第5.6节) 中的描述，开始应用 description 的过程，具有以下额外的限制：

   1. 使用 jsepSetOfTransceivers 作为关于存在哪些“RtpTransceivers”的真实性来源，并将它们的 [[JsepMid]] 内部槽作为它们的“mid 属性”。

   2. 候选更正 5：禁止对管理上禁止的候选进行 ICE 收集和连接性检查 (PR #2708)

      显示当前和未来 显示当前显示未来

      如果 remote 为 false，并且这触发了 [RFC9429] (第 5.9 节) 中的 ICE 候选收集过程，则 ICE 代理 不得 收集那些会被 管理上禁止 的候选。

   3. 候选更正 5：禁止对管理上禁止的候选进行 ICE 收集和连接性检查 (PR #2708)

      显示当前和未来 显示当前显示未来

      如果 remote 为 true，并且这触发了 [RFC9429] (第 5.10 节) 中的 ICE 连接性检查，则 ICE 代理 不得 尝试连接那些被 管理上禁止 的候选。

   4. 如果 remote 为 true，则验证背靠背的提议，仿佛在其间应用了答案，通过运行后续提议的检查，仿佛它处于稳定状态。

   5. 候选更正 37：不要因 RID 不匹配而导致 sRD(offer) 失败，只需用单播回答。 (PR #2794)
      显示当前和未来 显示当前显示未来

   6. 如果应用 description 导致修改了传输器 transceiver，并且 transceiver.[[Sender]].[[SendEncodings]] 非空且不等于处理 description 所得到的编码，则应用 description 的过程会失败。本规范不允许远程发起的 RID 重协商。

       

   7. 如果应用 description 的过程因任何原因失败，则用户代理 必须 排队执行以下步骤的任务：

      1. 如果 connection.[[IsClosed]] 为 true，则中止这些步骤。

      2. 如果 description.type 对于当前的 connection.[[SignalingState]] 是无效的，如在 [RFC9429] (第 5.5 节 和 第 5.6 节) 中描述的那样，则 拒绝 p， 生成一个新的 创建的 InvalidStateError 并中止这些步骤。

      3. 如果 description 的内容不是有效的 SDP 语法，则 拒绝 p，并以 RTCError (其 errorDetail 设置为 "sdp-syntax-error"，且 sdpLineNumber 属性设置为 SDP 中检测到语法错误的行号) 并中止这些步骤。

      4. 如果 remote 为 true，且 connection 的 RTCRtcpMuxPolicy 是 require，且描述不使用 RTCP mux，则 拒绝 p 并以新创建的 异常 InvalidAccessError 中止这些步骤。

      5. 如果描述试图重新协商 RID，如上述描述，则 拒绝 p，并以新创建的 异常 InvalidAccessError 中止这些步骤。

      6. 如果 description 的内容无效，则 拒绝 p 并以新创建的 异常 InvalidAccessError 中止这些步骤。

      7. 对于所有其他错误，拒绝 p 并以新创建的 异常 OperationError。

   8. 如果 description 成功应用，用户代理 必须 排队执行以下步骤的任务：

      1. 如果 connection.[[IsClosed]] 为 true，则中止这些步骤。

      2. 如果 remote 为 true 且 description 的类型为 "offer"， 并且在应用 description 的过程中，connection 的任何 addTrack() 方法成功，则中止这些步骤并重新开始该过程， 将额外的传输器纳入过程。

      3. 如果 connection 关联的 RTCRtpSender 的 setParameters 方法的任何 promise 尚未 解决， 则中止这些步骤并重新开始过程。

      4. 如果 description 的类型为 "offer"， 并且 connection 的 [[SignalingState]] 为 "stable"， 则对 connection 的 传输器集合 中的每个 transceiver 运行以下步骤：

         1. 将 transceiver.[[Sender]].[[LastStableStateSenderTransport]] 设置为 transceiver.[[Sender]].[[SenderTransport]]。

         2. Candidate Correction 13:回滚恢复 sRD(simulcastOffer) 被覆盖的无 rid 编码。 (PR #2797)

            显示当前和未来版本 显示当前版本显示未来版本

            如果 transceiver.[[Sender]].[[SendEncodings]].length 为 1，且唯一的编码不包含rid成员，则将 transceiver.[[Sender]].[[LastStableRidlessSendEncodings]] 设置为 transceiver.[[Sender]].[[SendEncodings]]； 否则，将 transceiver.[[Sender]].[[LastStableRidlessSendEncodings]] 设置为 null。

         3. 将 transceiver.[[Receiver]].[[LastStableStateReceiverTransport]] 设置为 transceiver.[[Receiver]].[[ReceiverTransport]]。

         4. 将 transceiver.[[Receiver]].[[LastStableStateAssociatedRemoteMediaStreams]] 设置为 transceiver.[[Receiver]].[[AssociatedRemoteMediaStreams]]。

         5. 将 transceiver.[[Receiver]].[[LastStableStateReceiveCodecs]] 设置为 transceiver.[[Receiver]].[[ReceiveCodecs]]。

      5. 如果 remote 是 false，则执行以下步骤之一：

         1. 如果 description 的类型是 "offer"，则将 connection.[[PendingLocalDescription]] 设置为一个新的 RTCSessionDescription 对象，该对象是从 description 构造的，将 connection.[[SignalingState]] 设置为 "have-local-offer"， 并且 释放早期候选者。

         2. 如果 description 的类型是 "answer"， 则这完成了一个 提供者的应答协商。将 connection.[[CurrentLocalDescription]] 设置为一个新的 RTCSessionDescription 对象，该对象是从 description 构造的，并将 connection.[[CurrentRemoteDescription]] 设置为 connection.[[PendingRemoteDescription]]。 将 connection.[[PendingRemoteDescription]] 和 connection.[[PendingLocalDescription]] 设置为 null。将 connection.[[LastCreatedOffer]] 和 connection.[[LastCreatedAnswer]] 设置为 ""，将 connection.[[SignalingState]] 设置为 "stable"， 并且 释放早期候选者。 最后，如果 connection.[[LocalIceCredentialsToReplace]] 中没有任何ICE凭证在 description 中，则将 connection.[[LocalIceCredentialsToReplace]] 设置为空集。

         3. 如果 description 的类型是 "pranswer"， 则将 connection.[[PendingLocalDescription]] 设置为一个新的 RTCSessionDescription 对象，该对象是从 description 构造的，将 connection.[[SignalingState]] 设置为 "have-local-pranswer"， 并且 释放早期候选者。

      6. 否则（如果 remote 为 true），执行以下步骤之一：

         1. 如果 description 的类型是 "offer"， 将 connection.[[PendingRemoteDescription]] 属性设置为一个新的 RTCSessionDescription 对象，该对象是从 description 构造的， 并将 connection.[[SignalingState]] 设置为 "have-remote-offer"。

         2. 如果 description 的类型是 "answer"， 则这完成了一个提案-应答的协商。将 connection.[[CurrentRemoteDescription]] 设置为一个新的 RTCSessionDescription 对象，该对象是从 description 构造的，并将 connection.[[CurrentLocalDescription]] 设置为 connection.[[PendingLocalDescription]]。 将 connection.[[PendingRemoteDescription]] 和 connection.[[PendingLocalDescription]] 设置为 null。将 connection.[[LastCreatedOffer]] 和 connection.[[LastCreatedAnswer]] 设置为 ""，将 connection.[[SignalingState]] 设置为 "stable"。 最后，如果 connection.[[LocalIceCredentialsToReplace]] 中没有任何ICE凭证在新设置的 connection.[[CurrentLocalDescription]] 中，则将 connection.[[LocalIceCredentialsToReplace]] 设置为空集。

         3. 如果 description 的类型是 "pranswer"， 则将 connection.[[PendingRemoteDescription]] 设置为一个新的 RTCSessionDescription 对象，该对象是从 description 构造的，并将 connection.[[SignalingState]] 设置为 "have-remote-pranswer"。

      7. 如果 description 的类型是 "answer"，并且 它启动了现有 SCTP 关联的关闭，如 [RFC8841] 的第 10.3 和 10.4 节所定义，将 connection.[[SctpTransport]] 的值设为 null。

      8. 让 trackEventInits、 muteTracks、addList、 removeList 和 errorList 成为空列表。

      9. 如果 description 的类型是 "answer" 或 "pranswer"， 那么执行以下步骤：

         1. 如果 description 启动了新的 SCTP 关联的建立，如在 [RFC8841]， 第 10.3 节和第 10.4 节中所定义，创建一个 RTCSctpTransport， 初始状态为 "connecting" 并将结果分配给 [[SctpTransport]] 槽位。 否则，如果 SCTP 关联已经建立，但 max-message-size SDP 属性被更新，更新 connection.[[SctpTransport]] 的数据最大消息大小。

         2. 如果 description 协商了 SCTP 传输的 DTLS 角色，那么对于每个 RTCDataChannel， channel，具有 null 的 id， 执行以下步骤：

            1. 为 channel 分配一个根据 [RFC8832] 生成的新 ID。 如果无法生成可用的 ID，将 channel.[[ReadyState]] 设置为 "closed"， 并将 channel 添加到 errorList。

      10. 如果 description 的类型不是 "rollback"， 那么执行以下步骤：

          1. 如果 remote 是 false，那么 对 description 中的每个 媒体描述 执行以下步骤：

             候选修正 26：修剪 createAnswer() 的编码和 sLD(answer) 中的 SendEncodings。 (PR #2801)

             显示当前和未来 显示当前显示未来

             1. 如果 媒体描述 尚未与 RTCRtpTransceiver 对象 关联， 那么执行以下步骤：

                1. 让 transceiver 为用于创建 媒体描述 的 RTCRtpTransceiver。

                2. 将 transceiver.[[Mid]] 设置为 transceiver.[[JsepMid]]。

                3. 如果 transceiver.[[Stopped]] 为 true，则中止这些子步骤。

                4. 如果 媒体描述 被指示为使用现有的 媒体 媒体 传输 根据 [RFC8843]， 让 transport 为表示该传输的 RTP/RTCP 组件的 RTCDtlsTransport 对象。

                5. 否则，让 transport 为具有新的基础 RTCIceTransport 的新创建 RTCDtlsTransport 对象。

                6. 将 transceiver.[[Sender]].[[SenderTransport]] 设置为 transport。

                7. 将 transceiver.[[Receiver]].[[ReceiverTransport]] 设置为 transport。

             2. 设 transceiver 为与 RTCRtpTransceiver 关联的 媒体描述。

             3. 如果 transceiver.[[Stopped]] 为 true，则中止这些子步骤。

             4. 让 direction 为表示来自 媒体 媒体描述 的方向的 RTCRtpTransceiverDirection 值。

             5. 如果 direction 是 "sendrecv" 或 "recvonly"， 则将 transceiver.[[Receptive]] 设置为 true，否则设置为 false。

             6. 将 transceiver.[[Receiver]].[[ReceiveCodecs]] 设置为 description 为接收协商的编码以及用户代理当前准备接收的编码。

                注意

                如果 direction 是 "sendonly" 或 "inactive"， 接收器不会准备接收任何内容，列表将为空。

             7. 如果 description 的类型是 "answer" 或 "pranswer"， 那么执行以下步骤：

                1. 如果 transceiver.[[Sender]].[[SendEncodings]] .length 大于 1，则执行以下步骤：

                   1. 如果 description 缺少所有先前协商的层， 则从 transceiver.[[Sender]].[[SendEncodings]] 中移除所有字典，除了第一个，并跳过下一步。

                   2. 如果 description 缺少任何先前协商的层， 则从 transceiver.[[Sender]].[[SendEncodings]] 中移除对应于缺失层的字典。

                2. 将 transceiver.[[Sender]].[[SendCodecs]] 设置为 description 为发送协商的编码以及用户代理当前能够发送的编码， 并将 transceiver.[[Sender]].[[LastReturnedParameters]] 设置为 null。

                3. 如果 direction 是 "sendonly" 或 "inactive"， 并且 transceiver.[[FiredDirection]] 是 "sendrecv" 或 "recvonly"， 那么执行以下步骤：

                   1. 设置关联的远程流 以给定的 transceiver.[[Receiver]]、 一个空列表、另一个空列表和 removeList。

                   2. 处理远程轨道的移除 以给定的 transceiver 和 muteTracks。

                4. 将 transceiver.[[CurrentDirection]] 和 transceiver.[[FiredDirection]] 设置为 direction。

          2. 否则，如果 remote 为 true，则对 description 中的每个 媒体描述 执行以下步骤：

             候选修正 12：移除 encoding.active 与 simulcast ~rid 之间的交互 (PR #2754)

             候选修正 14：使 RTCTransceiver.direction 在提议和回答中反映本地偏好 (PR #2759)

             候选修正 22：允许通过客户端回答修剪远程提议的 rid 编码 (PR #2758)

             候选修正 37：不要因为 rid 不匹配而使 sRD(offer) 失败，而是仅以单播方式回答。 (PR #2794)

             候选修正 25：移除 proposedSendEncodings 中的重复 rid。 (PR #2800)

             候选修正 27：忽略以逗号分隔的 rid 替代项。 (PR #2813)

             显示当前和未来 显示当前 显示未来

             1. 如果 description 的类型是 "offer" 并且 的 媒体描述 包含接收 simulcast 的请求，使用 simulcast 属性中指定的 rid 值的顺序为每个 simulcast 层创建一个 RTCRtpEncodingParameters 字典，按照相应的 rid valuevalue (如果存在以逗号分隔的替代项，则仅使用第一个值) 填充 rid 成员， 并让 sendEncodingsproposedSendEncodings 为 列表列表 包含创建的字典。 否则，让 sendEncodingsproposedSendEncodings 为 一个一个 空列表。

             2. 对于 proposedSendEncodings 中的每个编码 encoding，按相反顺序， 如果 encoding 的 rid 与 proposedSendEncodings 中的另一个编码匹配，则从 proposedSendEncodings 中移除 encoding。

             3. 让 supportedEncodings 为实现可以支持的最大编码数。如果 sendEncodingsproposedSendEncodings 的长度大于 supportedEncodings，则截断 sendEncodingsproposedSendEncodings，使其长度为 supportedEncodings。
             4. 如果 sendEncodingsproposedSendEncodings 非空， 设置 设置 每个编码的 scaleResolutionDownBy 为 2^(长度 of sendEncodingsproposedSendEncodings - 编码索引 - 1)。

             5. 如 [RFC8829RFC9429] (第 5.10 节。) 所描述的， 尝试找到一个现有的 RTCRtpTransceiver 对象， transceiver，以表示 媒体描述。

             6. 如果找到合适的 transceiver（transceiver 已设置）, 且 sendEncodingsproposedSendEncodings 非空，则将 transceiver.[[Sender]].[[SendEncodings]] 设置为 sendEncodings，并将 transceiver.[[Sender]].[[LastReturnedParameters]] 设置为 null。执行以下步骤：

                1. 如果 transceiver.[[Sender]].[[SendEncodings]] 的长度为 1，且唯一的编码不包含 rid 成员，则将 transceiver.[[Sender]].[[SendEncodings]] 设置为 proposedSendEncodings，并将 transceiver.[[Sender]].[[LastReturnedParameters]] 设置为 null。

             7. 如果没有找到合适的转发器（transceiver 未设置），请执行以下步骤：

                1. 创建一个 RTCRtpSender， sender，从 媒体媒体描述 使用 sendEncodingsproposedSendEncodings。

                2. 创建一个 RTCRtpReceiver， receiver，从 媒体媒体描述。

                3. 创建一个 RTCRtpTransceiver，使用 sender、receiver 和 RTCRtpTransceiverDirection 的值为 "recvonly"， 并将 transceiver 设为结果。

                4. 将 transceiver 添加到 connection 的 转发器集合 中中。

             8. 如果 description 的类型为 "answer" 或 "pranswer"， 并且 transceiver.[[Sender]].[[SendEncodings]].length 大于 1，则执行以下步骤：

                1. 如果 description 表明不支持或不需要同时播送，或者 description 缺少所有先前协商的层， 则移除 transceiver.[[Sender]].[[SendEncodings]] 中的所有字典，除了第一个，并中止这些子步骤。

                2. 如果 description 拒绝缺少 任何 提供的先前协商的 层，则则 从 transceiver.[[Sender]].[[SendEncodings]] 中移除与缺失层对应的字典。

                3. 根据 [RFC8853] 的指示，更新每个同时播送层的暂停状态，通过将 active 成员设置为对应字典中 transceiver.[[Sender]].[[SendEncodings]] 的 true（未暂停）或 false（已暂停）。

             9. 将 transceiver.[[Mid]] 设置为 transceiver.[[JsepMid]]。

             10. 让 direction 成为一个 RTCRtpTransceiverDirection 值，表示来自 媒体媒体描述 的方向，但将发送和接收方向反转，以表示此对等体的视角。如果 媒体描述 被拒绝，则将 direction 设置为 "inactive"。

             11. 如果 direction 为 "sendrecv" 或 "recvonly"，让 msids 成为媒体描述指示的与 transceiver.[[Receiver]].[[ReceiverTrack]] 关联的 MSID 列表。否则，让 msids 为一个空列表。

                 注意

                 如果 媒体描述 被拒绝，则 msids 将在此处为一个空列表。

             12. 处理远程轨道，与 transceiver、direction、msids、addList、removeList 和 trackEventInits 一起进行。

             13. 将 transceiver.[[Receiver]].[[ReceiveCodecs]] 设置为 description 协商的接收编解码器，以及用户代理当前准备接收的编解码器。

             14. 如果 description 的类型为 "answer" 或 "pranswer"， 那么执行以下步骤：

                 1. 将 transceiver.[[Sender]].[[SendCodecs]] 设置为 description 协商的发送编解码器，以及用户代理当前能够发送的编解码器。

                 2. 将 transceiver.[[CurrentDirection]] 和 transceiver.[[Direction]]s 设置为 direction。

                 3. 让 transport 成为表示 RTCDtlsTransport对象的 RTP/RTCP 组件的 媒体媒体传输，用于 transceiver 的 关联的 媒体描述，根据 [RFC8843]。

                 4. 将 transceiver.[[Sender]].[[SenderTransport]] 设置为 transport。

                 5. 将 transceiver.[[Receiver]].[[ReceiverTransport]] 设置为 transport。

                 6. 根据 [RFC8445] 的规则，设置 transport 的 [[IceRole]]。

                    注意

                    此处适用的 [RFC8445] 规则为：

                    • 如果 [[IceRole]] 不是 unknown，则不修改 [[IceRole]]。
                    • 如果 description 是本地提议，则将其设置为 controlling。
                    • 如果 description 是远程提议，并包含 a=ice-lite，则将 [[IceRole]] 设置为 controlling。
                    • 如果 description 是远程提议，并且不包含 a=ice-lite，则将 [[IceRole]] 设置为 controlled。

                    这确保在处理第一个提议后，[[IceRole]] 始终具有值。

             15. 如果 媒体描述 被拒绝，并且 transceiver.[[Stopped]] 为 false，则 停止 该该RTCRtpTransceiver transceiver。

      11. 否则（如果 description 的类型是 "rollback）执行以下步骤：

          1. 让 pendingDescription 为 connection.[[PendingLocalDescription]] 或 connection.[[PendingRemoteDescription]]，取决于哪一个不为 null。

          2. 对于 connection 的 转接器集合 中的每个 transceiver，执行以下步骤：

             1. 如果 transceiver 在设置 pendingDescription 之前没有与任何媒体描述 关联，则将其解除关联，并将 transceiver.[[JsepMid]] 和 transceiver.[[Mid]] 设置为 null。

             2. 将 transceiver.[[Sender]].[[SenderTransport]] 设置为 transceiver.[[Sender]].[[LastStableStateSenderTransport]]。

             3. 候选修正 13： 回滚恢复因 sRD（simulcastOffer）而被取消的 ridless 编码。 (PR #2797)

                显示当前和未来 显示当前 显示未来

                如果 transceiver.[[Sender]].[[LastStableRidlessSendEncodings]] 不是 null，并且 transceiver.[[Sender]].[[SendEncodings]] 中的任何编码包含一个 rid 成员，则将 transceiver.[[Sender]].[[SendEncodings]] 设置为 transceiver.[[Sender]].[[LastStableRidlessSendEncodings]]。

             4. 将 transceiver.[[Receiver]].[[ReceiverTransport]] 设置为 transceiver.[[Receiver]].[[LastStableStateReceiverTransport]]。

             5. 将 transceiver.[[Receiver]].[[ReceiveCodecs]] 设置为 transceiver.[[Receiver]].[[LastStableStateReceiveCodecs]]。

             6. 如果 connection.[[SignalingState]] 是 "have-remote-offer"，则运行以下子步骤：

                1. 让 msids 成为 transceiver.[[Receiver]].[[LastStableStateAssociatedRemoteMediaStreams]] 中所有 id 的 MediaStream 对象的列表，或者如果没有，则为空列表。

                2. 使用 transceiver、transceiver.[[CurrentDirection]]、msids、addList、removeList 和 trackEventInits 处理远程轨道。

             7. 如果 transceiver 是在设置 pendingDescription 时创建的，并且从未通过 addTrack() 附加任何轨道，则 停止 RTCRtpTransceiver transceiver，并将其从 connection 的 转发器集合 中移除。

          3. 将 connection.[[PendingLocalDescription]] 和 connection.[[PendingRemoteDescription]] 设置为 null，并将 connection.[[SignalingState]] 设置为 "stable"。

      12. 如果 description 的类型是 "answer"，则执行以下步骤：

          1. 对于 connection 的 传输器集合 中的每个 transceiver，执行以下步骤：

             1. 如果 transceiver 是 stopped，并且与一个 m= 部分 相关联，且关联的 m= 部分在 connection.[[CurrentLocalDescription]] 或 connection.[[CurrentRemoteDescription]] 中被拒绝，则从 connection 的 传输器集合 中移除 transceiver。

      13. 如果 connection.[[SignalingState]] 现在是 "stable"， 则执行以下步骤：

          1. 对于在之前步骤中从 传输器集合 中移除的任何 transceiver， 如果它的任何传输 (transceiver.[[Sender]].[[SenderTransport]] 或 transceiver.[[Receiver]].[[ReceiverTransport]]) 仍然没有关闭且不再被非停止的传输器引用，则关闭 RTCDtlsTransport 和它们关联的 RTCIceTransport。 这将导致这些对象在排队任务中触发事件。

          2. Candidate Addition 49:向 RTCRtpEncodingParameters 添加编解码器 (PR #2985)

             显示当前和未来 显示当前显示 未来

             对于 connection 的 传输器集合 中的每个 transceiver：

             1. 让 codecs 为 transceiver.[[Sender]].[[SendCodecs]]。

             2. 如果 codecs 不是空列表：

                1. 对于 transceiver.[[Sender]].[[SendEncodings]] 中的每个 encoding， 如果 encoding.codec 没有 匹配 codecs 中的任何条目， 移除 encoding[codec]。

          3. 清除 negotiation-needed 标志 并 更新 negotiation-needed 标志。

      14. 如果 connection.[[SignalingState]] 在上方更改了，触发一个名为 signalingstatechange 的事件于 connection。

      15. 对于 errorList 中的每个 channel， 触发一个名为 error 的事件，使用 RTCErrorEvent 接口，将 errorDetail 属性设置为 "data-channel-failure" 于 channel。

      16. 对于 muteTracks 中的每个 track， 设置 track 的静音状态为 true。

      17. 对于 removeList 中的每个 stream 和 track 对， 移除 stream 中的 track。

      18. 对于 addList 中的每个 stream 和 track 对， 添加 track 到 stream。

      19. 对于 trackEventInits 中的每个 entry， 触发一个名为 track 的事件，使用 RTCTrackEvent 接口，将其 receiver 属性初始化为 entry.receiver， track 属性初始化为 entry.track， streams 属性初始化为 entry.streams， 以及 transceiver 属性初始化为 entry.transceiver 于 connection 对象上。

      20. 以 undefined 解析 p。

5. 返回 p。

要 设置配置，使用 configuration，请执行以下步骤：

1. 令 configuration 为要处理的 RTCConfiguration 字典。

2. 令 connection 为目标 RTCPeerConnection 对象。

3. 令 oldConfig 为 connection.[[Configuration]]。

4. 如果 configuration.certificatesoldConfig 不是 null，执行以下步骤:，如果有任何步骤失败，则 抛出 InvalidModificationError 异常：

   1. 如果 configuration.certificates 的长度与 connectionoldConfig.[[Configuration]].certificates 的长度不同，则失败。

   2. 令 index 初始化为 0。

   3. 令 size 初始化为 configuration.certificates 的长度。

   4. 当 index 小于 size 时，执行以下步骤：:将 configuration.

      certificates 中的每一个元素执行以下步骤：

      1. 如果 configuration.certificates 中 index 位置的 ECMAScript 对象与 connectionoldConfig 中 [[Configuration]].certificates 中 index 位置的 ECMAScript 对象不同，则失败。

      2. 将 index 增加 1。

   5. 如果 configuration.bundlePolicy 的值与 oldConfig.bundlePolicy 不同，则失败。

   6. 如果 configuration.rtcpMuxPolicy 的值与 oldConfig.rtcpMuxPolicy 不同，则失败。

   7. 如果 configuration.iceCandidatePoolSize 的值与 oldConfig.iceCandidatePoolSize 不同，且已经调用了 setLocalDescription，则失败。

5. 如果 configuration.bundlePolicy 的值 被设置并且与 connection 的捆绑策略不同，则 抛出 一个 InvalidModificationError。

6. 如果 configuration.rtcpMuxPolicy 的值 被设置并且与 connection 的 rtcpMux 策略不同，则 抛出 一个 InvalidModificationError。

7. 如果 configuration.iceCandidatePoolSize 的值 被设置并且与 connection 之前设置的 iceCandidatePoolSize 不同， 并且 setLocalDescription 已经被调用，则 抛出 一个 InvalidModificationError。

8. 让 iceServers 为 configuration.iceServers。

9. 将 iceServers 截断到最大支持元素的数量。

10. 对于 iceServers 中的每个 server， 执行以下步骤：

    1. 让 urls 为 server.urls。

    2. 如果 urls 是一个字符串，则将 urls 设置为仅包含该字符串的列表。

    3. 如果 urls 为空，则 抛出 一个 "SyntaxError" DOMException。

    4. 对于 urls 中的每个 url，执行 验证 ICE 服务器 URL 算法。

11. 将 ICE Agent 的 ICE 传输设置 设置为 configuration.iceTransportPolicy。 如[RFC8829RFC9429] (第 4.1.18 节)中定义，如果新的 ICE ICE 传输设置更改了 现有设置，则在下一个收集阶段之前不会采取任何行动。如果脚本希望立即发生这种情况，它应该进行 ICE 重启。

12. 将 ICE Agent 的预取 ICE 候选池大小 设置为[RFC8829RFC9429] (第 3.5.4 节 和 第 4.1.1 节)的值 configuration.iceCandidatePoolSize。 如果新的ICE 候选池大小更改了现有设置，则这可能导致立即收集新的池候选者，或丢弃现有的池候选者，如[RFC8829RFC9429] (第 4.1.18 节)。

13. 让 validatedServers 为空列表。

14. 如果 configuration.iceServers 已定义，则对每个元素执行以下步骤：

    1. 让 server 为当前列表元素。

    2. 让 urls 为 server.urls。

    3. 如果 urls 是一个字符串，则将 urls 设置为仅包含该字符串的列表。

    4. 如果 urls 为空，则 抛出 一个 SyntaxError。

    5. 对于 urls 中的每个 url，执行 [=验证 ICE 服务器 URL=] 算法。

    6. 将 server 添加到 validatedServers。

15. 将 ICE Agent 的 ICE 服务器列表 设置为 validatedServers设置为 iceServers。

    如[RFC8829RFC9429] (第 4.1.18 节)中定义，如果新服务器列表替换了ICE Agent 的现有 ICE 服务器列表ICE 服务器列表，将不会采取任何行动，直到下一个收集阶段。如果脚本希望立即发生这种情况，它应该进行 ICE 重启。然而，如果 ICE ICE 候选池 的大小非零，则任何 现有 现有 的候选者将被丢弃，并将从新服务器收集新的候选者。

16. 将 configuration 存储在 [[Configuration]] 内部槽中。

要 验证 ICE 服务器 URL url，执行以下步骤：

1. 使用 [RFC3986] 中定义的通用 URI 语法解析 url，并获取 scheme name。如果根据 [RFC3986] 中定义的语法解析失败，抛出 一个 SyntaxError。 如果 scheme name 未被浏览器实现，抛出 一个 NotSupportedError。 如果 scheme name 是 turn 或 turns，并且使用 [RFC7065] 中定义的语法解析 url 失败，抛出 一个 SyntaxError。 如果 scheme name 是 stun 或 stuns，并且使用 [RFC7064] 中定义的语法解析 url 失败，抛出 一个 SyntaxError。

2. 让 parsedURL 为 解析 url 的结果。

3. 如果以下任何条件适用，则 抛出 一个 "SyntaxError" DOMException：

   • parsedURL 解析失败
   • parsedURL 的 scheme 既不是 "stun"， "stuns"，"turn"，也不是 "turns"
   • parsedURL 没有 不透明路径
   • parsedURL 的 fragment 不是空值
   • parsedURL 的 scheme 是 "stun" 或 "stuns"，并且 parsedURL 的 query 不是空值

4. 如果 parsedURL 的 scheme 未被用户代理实现，则 抛出 一个 NotSupportedError。

5. 让 hostAndPortURL 为结果 解析 字符串 "https://" 和 parsedURL 的 path 的拼接结果。

6. 如果 hostAndPortURL 解析失败，则 抛出 一个 "SyntaxError" DOMException。

   注意

   对于 "stun" 和 "stuns" 方案，这验证 [RFC7064] 第 3.1 节。
   对于 "turn" 和 "turns" 方案，这一步骤及以下步骤验证 [RFC7065] 第 3.1 节。

7. TODO: 验证 ?transport=udp|tcp (见 PR #2996)

8. 如果 scheme nameparsedURL 的 scheme 是 turn"turn" 或 turns或 "turns"，并且 server.username 或 server.credential 被省略不存在，则 抛出 一个 InvalidAccessError。

9. 如果 scheme name 是 turn 或 turns，并且 server.credentialType 是 "password"， 并且 server.credential 不是 DOMString，则 抛出 一个 InvalidAccessError。

本节描述了一组旧版扩展，可用于影响如何创建提议，此外还有添加到RTCPeerConnection中的媒体。建议开发者改为使用RTCRtpTransceiver API。

当调用createOffer时， 如果指定了本节中的任何旧版选项，则执行以下步骤，而不是常规的createOffer步骤：

1. 让 options 为方法的第一个参数。

2. 让 connection 为当前的RTCPeerConnection 对象。

3. 对于 offerToReceive<Kind> 中的每个成员，在options中具有类型kind，执行以下步骤：

   1. 如果字典成员的值为 false，

      1. 对于每个未停止的"sendrecv" 传输器，其类型为kind，设置transceiver.[[Direction]]为 "sendonly"。

      2. 对于每个未停止的"recvonly" 传输器，其类型为kind，设置transceiver.[[Direction]]为 "inactive"。

      如果有下一个选项，则继续处理下一个选项。

   2. 如果connection有任何未停止的"sendrecv" 或"recvonly" 传输器，其类型为kind，如果有下一个选项，则继续处理下一个选项。

   3. 让transceiver为调用connection.addTransceiver(kind)的结果， 但此操作不得 更新协商所需标志。

   4. 如果transceiver因上一个操作抛出错误而未设置，则中止这些步骤。

   5. 设置transceiver.[[Direction]]为 "recvonly"。

4. 按照createOffer指定的步骤创建提议。

WebIDLpartial dictionary RTCOfferOptions {
                  boolean offerToReceiveAudio;
                  boolean offerToReceiveVideo;
                };

candidate-attribute 语法用于解析 candidate 成员 的candidateInitDict中的值，属于RTCIceCandidate() 构造函数。

candidate-attribute 的主要语法在 [RFC5245] 第15.1节中定义。此外，浏览器必须支持 [RFC6544] 第4.5节中定义的ICE TCP语法扩展。

浏览器可以支持在其他RFC中定义的candidate-attribute的其他语法扩展。

RTCIceProtocol 表示 ICE候选项的协议。

WebIDLenum RTCIceProtocol {
                      "udp",
                      "tcp"
                    };

RTCIceTcpCandidateType 表示 ICE TCP候选项的类型，如[RFC6544]中所定义的。

WebIDLenum RTCIceTcpCandidateType {
                      "active",
                      "passive",
                      "so"
                    };

RTCIceCandidateType 表示 ICE候选项的类型，如[RFC5245] 第15.1节所定义。

WebIDLenum RTCIceCandidateType {
                      "host",
                      "srflx",
                      "prflx",
                      "relay"
                    };