RFC 8829 - JavaScript Session Establishment Protocol (JSEP)

• 状态: Proposed Standard
• 发布日期: January 2021
• Stream: IETF
• 被废弃: RFC9429
• 勘误: 无勘误

---

Abstract (摘要)

本文档描述了允许 JavaScript 应用程序通过 W3C RTCPeerConnection API 中指定的接口控制多媒体会话的信令平面的机制, 并讨论了这与现有信令协议的关系。

Status of This Memo (本备忘录的状态)

这是一份互联网标准跟踪文档。

本文档是互联网工程任务组 (IETF) 的产品。它代表了 IETF 社区的共识。它已经接受了公开审查, 并已获得互联网工程指导小组 (IESG) 的批准发布。有关互联网标准的更多信息可在 RFC 7841 的第 2 节中找到。

有关本文档当前状态, 任何勘误表以及如何提供反馈的信息可从 https://www.rfc-editor.org/info/rfc8829 获取。

Copyright Notice (版权声明)

Copyright (c) 2021 IETF Trust 和被确认为文档作者的人员。保留所有权利。

本文档受 BCP 78 和 IETF Trust 关于 IETF 文档的法律规定 (https://trustee.ietf.org/license-info) 的约束, 该规定在本文档发布之日有效。请仔细审阅这些文档, 因为它们描述了您对本文档的权利和限制。从本文档中提取的代码组件必须包括简化 BSD 许可证文本, 如 Trust Legal Provisions 第 4.e 节所述, 并且按照简化 BSD 许可证中的描述提供, 不提供任何保证。

Contents

• 1. Introduction (简介)
  • 1.1 General Design of JSEP (JSEP的总体设计)
  • 1.2 Other Approaches Considered (考虑的其他方法)
  • 1.3 Contradiction regarding bundle-only "m=" sections (关于bundle-only "m="部分的矛盾)
• 2. Terminology (术语)
• 3. Semantics and Syntax (语义和语法)
  • 3.1 Signaling Model (信令模型)
  • 3.2 Session Descriptions and State Machine (会话描述和状态机)
  • 3.3 Session Description Format (会话描述格式)
  • 3.4 Session Description Control (会话描述控制)
    • 3.4.1 RtpTransceivers
    • 3.4.2 RtpSenders
    • 3.4.3 RtpReceivers
  • 3.5 ICE
    • 3.5.1 ICE Gathering Overview (ICE收集概述)
    • 3.5.2 ICE Candidate Trickling (ICE候选涓流)
      • 3.5.2.1 ICE Candidate Format (ICE候选格式)
    • 3.5.3 ICE Candidate Policy (ICE候选策略)
    • 3.5.4 ICE Candidate Pool (ICE候选池)
    • 3.5.5 ICE Versions (ICE版本)
  • 3.6 Video Size Negotiation (视频大小协商)
    • 3.6.1 Creating an imageattr Attribute (创建imageattr属性)
    • 3.6.2 Interpreting imageattr Attributes (解释imageattr属性)
  • 3.7 Simulcast (联播)
  • 3.8 Interactions with Forking (与分叉的交互)
    • 3.8.1 Sequential Forking (顺序分叉)
    • 3.8.2 Parallel Forking (并行分叉)
• 4. Interface (接口)
  • 4.1 PeerConnection
    • 4.1.1 Constructor (构造函数)
    • 4.1.2 addTrack
    • 4.1.3 removeTrack
    • 4.1.4 addTransceiver
    • 4.1.5 onaddtrack Event (onaddtrack事件)
    • 4.1.6 createDataChannel
    • 4.1.7 ondatachannel Event (ondatachannel事件)
    • 4.1.8 createOffer
    • 4.1.9 createAnswer
    • 4.1.10 SessionDescriptionType
      • 4.1.10.1 Use of Provisional Answers (临时应答的使用)
      • 4.1.10.2 Rollback (回滚)
    • 4.1.11 setLocalDescription
    • 4.1.12 setRemoteDescription
    • 4.1.13 currentLocalDescription
    • 4.1.14 pendingLocalDescription
    • 4.1.15 currentRemoteDescription
    • 4.1.16 pendingRemoteDescription
    • 4.1.17 canTrickleIceCandidates
    • 4.1.18 setConfiguration
    • 4.1.19 addIceCandidate
    • 4.1.20 onicecandidate Event (onicecandidate事件)
  • 4.2 RtpTransceiver
    • 4.2.1 stop
    • 4.2.2 stopped
    • 4.2.3 setDirection
    • 4.2.4 direction
    • 4.2.5 currentDirection
    • 4.2.6 setCodecPreferences
• 5. SDP Interaction Procedures (SDP交互过程)
  • 5.1 Requirements Overview (需求概述)
    • 5.1.1 Usage Requirements (使用要求)
    • 5.1.2 Profile Names and Interoperability (配置文件名称和互操作性)
  • 5.2 Constructing an Offer (构造Offer)
    • 5.2.1 Initial Offers (初始Offer)
    • 5.2.2 Subsequent Offers (后续Offer)
    • 5.2.3 Options Handling (选项处理)
      • 5.2.3.1 IceRestart
      • 5.2.3.2 VoiceActivityDetection
  • 5.3 Generating an Answer (生成Answer)
    • 5.3.1 Initial Answers (初始Answer)
    • 5.3.2 Subsequent Answers (后续Answer)
    • 5.3.3 Options Handling (选项处理)
      • 5.3.3.1 VoiceActivityDetection
  • 5.4 Modifying an Offer or Answer (修改Offer或Answer)
  • 5.5 Processing a Local Description (处理本地描述)
  • 5.6 Processing a Remote Description (处理远程描述)
  • 5.7 Processing a Rollback (处理回滚)
  • 5.8 Parsing a Session Description (解析会话描述)
    • 5.8.1 Session-Level Parsing (会话级解析)
    • 5.8.2 Media Section Parsing (媒体部分解析)
    • 5.8.3 Semantics Verification (语义验证)
  • 5.9 Applying a Local Description (应用本地描述)
  • 5.10 Applying a Remote Description (应用远程描述)
  • 5.11 Applying an Answer (应用Answer)
• 6. Processing RTP/RTCP (处理RTP/RTCP)
• 7. Examples (示例)
  • 7.1 Simple Example (简单示例)
  • 7.2 Detailed Example (详细示例)
  • 7.3 Early Transport Warmup Example (早期传输预热示例)
• 8. Security Considerations (安全考虑)
• 9. IANA Considerations (IANA考虑)
• 10. References (参考文献)
  • 10.1 Normative References (规范性参考文献)
  • 10.2 Informative References (信息性参考文献)
• Appendix A. SDP ABNF Syntax (SDP ABNF语法)
• Acknowledgements (致谢)
• Authors' Addresses (作者地址)