RFC 8829 - JavaScript Session Establishment Protocol (JSEP)

• Status: Proposed Standard
• Veröffentlicht: January 2021
• Stream: IETF
• Ersetzt durch: RFC9429
• Errata: Keine Errata

---

Abstract (Zusammenfassung)

Dieses Dokument beschreibt die Mechanismen, die es einer JavaScript-Anwendung ermöglichen, die Signalisierungsebene einer Multimedia-Sitzung über die in der W3C RTCPeerConnection API spezifizierte Schnittstelle zu steuern, und diskutiert, wie dies mit bestehenden Signalisierungsprotokollen zusammenhängt.

Status of This Memo (Status dieses Memorandums)

Dies ist ein Internet Standards Track Dokument.

Dieses Dokument ist ein Produkt der Internet Engineering Task Force (IETF). Es repräsentiert den Konsens der IETF-Gemeinschaft. Es hat eine öffentliche Überprüfung erhalten und wurde von der Internet Engineering Steering Group (IESG) zur Veröffentlichung genehmigt. Weitere Informationen zu Internet-Standards sind in Abschnitt 2 von RFC 7841 verfügbar.

Informationen über den aktuellen Status dieses Dokuments, etwaige Errata und wie Feedback gegeben werden kann, sind unter https://www.rfc-editor.org/info/rfc8829 erhältlich.

Copyright Notice (Urheberrechtshinweis)

Copyright (c) 2021 IETF Trust und die als Dokumentautoren identifizierten Personen. Alle Rechte vorbehalten.

Dieses Dokument unterliegt BCP 78 und den rechtlichen Bestimmungen des IETF Trust in Bezug auf IETF-Dokumente (https://trustee.ietf.org/license-info), die zum Zeitpunkt der Veröffentlichung dieses Dokuments in Kraft sind. Bitte lesen Sie diese Dokumente sorgfältig durch, da sie Ihre Rechte und Einschränkungen in Bezug auf dieses Dokument beschreiben. Aus diesem Dokument extrahierte Codekomponenten müssen den vereinfachten BSD-Lizenztext gemäß Abschnitt 4.e der Trust Legal Provisions enthalten und werden ohne Gewährleistung wie in der vereinfachten BSD-Lizenz beschrieben bereitgestellt.

Contents

• 1. Introduction (Einführung)
  • 1.1 General Design of JSEP (Allgemeines Design von JSEP)
  • 1.2 Other Approaches Considered (Betrachtete alternative Ansätze)
  • 1.3 Contradiction regarding bundle-only "m=" sections (Widerspruch bezüglich bundle-only "m=" Abschnitte)
• 2. Terminology (Terminologie)
• 3. Semantics and Syntax (Semantik und Syntax)
  • 3.1 Signaling Model (Signalisierungsmodell)
  • 3.2 Session Descriptions and State Machine (Sitzungsbeschreibungen und Zustandsautomat)
  • 3.3 Session Description Format (Sitzungsbeschreibungsformat)
  • 3.4 Session Description Control (Sitzungsbeschreibungssteuerung)
    • 3.4.1 RtpTransceivers
    • 3.4.2 RtpSenders
    • 3.4.3 RtpReceivers
  • 3.5 ICE
    • 3.5.1 ICE Gathering Overview (ICE-Sammlungsübersicht)
    • 3.5.2 ICE Candidate Trickling (ICE-Kandidaten-Trickling)
      • 3.5.2.1 ICE Candidate Format (ICE-Kandidatenformat)
    • 3.5.3 ICE Candidate Policy (ICE-Kandidatenrichtlinie)
    • 3.5.4 ICE Candidate Pool (ICE-Kandidatenpool)
    • 3.5.5 ICE Versions (ICE-Versionen)
  • 3.6 Video Size Negotiation (Videogrößenaushandlung)
    • 3.6.1 Creating an imageattr Attribute (Erstellen eines imageattr-Attributs)
    • 3.6.2 Interpreting imageattr Attributes (Interpretation von imageattr-Attributen)
  • 3.7 Simulcast
  • 3.8 Interactions with Forking (Interaktionen mit Forking)
    • 3.8.1 Sequential Forking (Sequentielles Forking)
    • 3.8.2 Parallel Forking (Paralleles Forking)
• 4. Interface (Schnittstelle)
  • 4.1 PeerConnection
    • 4.1.1 Constructor (Konstruktor)
    • 4.1.2 addTrack
    • 4.1.3 removeTrack
    • 4.1.4 addTransceiver
    • 4.1.5 onaddtrack Event (onaddtrack-Ereignis)
    • 4.1.6 createDataChannel
    • 4.1.7 ondatachannel Event (ondatachannel-Ereignis)
    • 4.1.8 createOffer
    • 4.1.9 createAnswer
    • 4.1.10 SessionDescriptionType
      • 4.1.10.1 Use of Provisional Answers (Verwendung vorläufiger Antworten)
      • 4.1.10.2 Rollback (Rückgängigmachung)
    • 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-Ereignis)
  • 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-Interaktionsverfahren)
  • 5.1 Requirements Overview (Anforderungsübersicht)
    • 5.1.1 Usage Requirements (Nutzungsanforderungen)
    • 5.1.2 Profile Names and Interoperability (Profilnamen und Interoperabilität)
  • 5.2 Constructing an Offer (Konstruktion eines Angebots)
    • 5.2.1 Initial Offers (Initiale Angebote)
    • 5.2.2 Subsequent Offers (Nachfolgende Angebote)
    • 5.2.3 Options Handling (Optionsbehandlung)
      • 5.2.3.1 IceRestart
      • 5.2.3.2 VoiceActivityDetection
  • 5.3 Generating an Answer (Generierung einer Antwort)
    • 5.3.1 Initial Answers (Initiale Antworten)
    • 5.3.2 Subsequent Answers (Nachfolgende Antworten)
    • 5.3.3 Options Handling (Optionsbehandlung)
      • 5.3.3.1 VoiceActivityDetection
  • 5.4 Modifying an Offer or Answer (Änderung eines Angebots oder einer Antwort)
  • 5.5 Processing a Local Description (Verarbeitung einer lokalen Beschreibung)
  • 5.6 Processing a Remote Description (Verarbeitung einer entfernten Beschreibung)
  • 5.7 Processing a Rollback (Verarbeitung einer Rückgängigmachung)
  • 5.8 Parsing a Session Description (Parsing einer Sitzungsbeschreibung)
    • 5.8.1 Session-Level Parsing (Sitzungsebenen-Parsing)
    • 5.8.2 Media Section Parsing (Medienabschnitts-Parsing)
    • 5.8.3 Semantics Verification (Semantikverifizierung)
  • 5.9 Applying a Local Description (Anwendung einer lokalen Beschreibung)
  • 5.10 Applying a Remote Description (Anwendung einer entfernten Beschreibung)
  • 5.11 Applying an Answer (Anwendung einer Antwort)
• 6. Processing RTP/RTCP (Verarbeitung von RTP/RTCP)
• 7. Examples (Beispiele)
  • 7.1 Simple Example (Einfaches Beispiel)
  • 7.2 Detailed Example (Detailliertes Beispiel)
  • 7.3 Early Transport Warmup Example (Beispiel für frühes Transport-Warmup)
• 8. Security Considerations (Sicherheitsüberlegungen)
• 9. IANA Considerations (IANA-Überlegungen)
• 10. References (Referenzen)
  • 10.1 Normative References (Normative Referenzen)
  • 10.2 Informative References (Informative Referenzen)
• Appendix A. SDP ABNF Syntax (SDP-ABNF-Syntax)
• Acknowledgements (Danksagungen)
• Authors' Addresses (Adressen der Autoren)