RFC 8829 - JavaScript Session Establishment Protocol (JSEP)

• Statut: Proposed Standard
• Publié: January 2021
• Stream: IETF
• Remplacé par: RFC9429
• Errata: Pas d'errata

---

Abstract (Résumé)

Ce document décrit les mécanismes permettant à une application JavaScript de contrôler le plan de signalisation d'une session multimédia via l'interface spécifiée dans l'API RTCPeerConnection du W3C et discute de la manière dont cela se rapporte aux protocoles de signalisation existants.

Status of This Memo (Statut de ce mémorandum)

Ceci est un document de suivi des normes Internet.

Ce document est un produit de l'Internet Engineering Task Force (IETF). Il représente le consensus de la communauté IETF. Il a fait l'objet d'un examen public et a été approuvé pour publication par l'Internet Engineering Steering Group (IESG). De plus amples informations sur les normes Internet sont disponibles dans la section 2 de la RFC 7841.

Les informations sur le statut actuel de ce document, les éventuels errata et la manière de fournir des commentaires peuvent être obtenues à l'adresse https://www.rfc-editor.org/info/rfc8829.

Copyright Notice (Avis de droit d'auteur)

Copyright (c) 2021 IETF Trust et les personnes identifiées comme auteurs du document. Tous droits réservés.

Ce document est soumis au BCP 78 et aux dispositions légales de l'IETF Trust relatives aux documents IETF (https://trustee.ietf.org/license-info) en vigueur à la date de publication de ce document. Veuillez examiner attentivement ces documents, car ils décrivent vos droits et restrictions concernant ce document. Les composants de code extraits de ce document doivent inclure le texte de licence BSD simplifiée tel que décrit dans la section 4.e des dispositions légales du Trust et sont fournis sans garantie comme décrit dans la licence BSD simplifiée.

Contents

• 1. Introduction
  • 1.1 General Design of JSEP (Conception générale de JSEP)
  • 1.2 Other Approaches Considered (Autres approches considérées)
  • 1.3 Contradiction regarding bundle-only "m=" sections (Contradiction concernant les sections "m=" bundle-only)
• 2. Terminology (Terminologie)
• 3. Semantics and Syntax (Sémantique et syntaxe)
  • 3.1 Signaling Model (Modèle de signalisation)
  • 3.2 Session Descriptions and State Machine (Descriptions de session et machine à états)
  • 3.3 Session Description Format (Format de description de session)
  • 3.4 Session Description Control (Contrôle de description de session)
    • 3.4.1 RtpTransceivers
    • 3.4.2 RtpSenders
    • 3.4.3 RtpReceivers
  • 3.5 ICE
    • 3.5.1 ICE Gathering Overview (Aperçu de la collecte ICE)
    • 3.5.2 ICE Candidate Trickling (Trickling de candidats ICE)
      • 3.5.2.1 ICE Candidate Format (Format de candidat ICE)
    • 3.5.3 ICE Candidate Policy (Politique de candidats ICE)
    • 3.5.4 ICE Candidate Pool (Pool de candidats ICE)
    • 3.5.5 ICE Versions (Versions ICE)
  • 3.6 Video Size Negotiation (Négociation de la taille vidéo)
    • 3.6.1 Creating an imageattr Attribute (Création d'un attribut imageattr)
    • 3.6.2 Interpreting imageattr Attributes (Interprétation des attributs imageattr)
  • 3.7 Simulcast (Diffusion simultanée)
  • 3.8 Interactions with Forking (Interactions avec le forking)
    • 3.8.1 Sequential Forking (Forking séquentiel)
    • 3.8.2 Parallel Forking (Forking parallèle)
• 4. Interface
  • 4.1 PeerConnection
    • 4.1.1 Constructor (Constructeur)
    • 4.1.2 addTrack
    • 4.1.3 removeTrack
    • 4.1.4 addTransceiver
    • 4.1.5 onaddtrack Event (Événement onaddtrack)
    • 4.1.6 createDataChannel
    • 4.1.7 ondatachannel Event (Événement ondatachannel)
    • 4.1.8 createOffer
    • 4.1.9 createAnswer
    • 4.1.10 SessionDescriptionType
      • 4.1.10.1 Use of Provisional Answers (Utilisation de réponses provisoires)
      • 4.1.10.2 Rollback (Retour arrière)
    • 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 (Événement 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 (Procédures d'interaction SDP)
  • 5.1 Requirements Overview (Aperçu des exigences)
    • 5.1.1 Usage Requirements (Exigences d'utilisation)
    • 5.1.2 Profile Names and Interoperability (Noms de profils et interopérabilité)
  • 5.2 Constructing an Offer (Construction d'une offre)
    • 5.2.1 Initial Offers (Offres initiales)
    • 5.2.2 Subsequent Offers (Offres ultérieures)
    • 5.2.3 Options Handling (Gestion des options)
      • 5.2.3.1 IceRestart
      • 5.2.3.2 VoiceActivityDetection
  • 5.3 Generating an Answer (Génération d'une réponse)
    • 5.3.1 Initial Answers (Réponses initiales)
    • 5.3.2 Subsequent Answers (Réponses ultérieures)
    • 5.3.3 Options Handling (Gestion des options)
      • 5.3.3.1 VoiceActivityDetection
  • 5.4 Modifying an Offer or Answer (Modification d'une offre ou réponse)
  • 5.5 Processing a Local Description (Traitement d'une description locale)
  • 5.6 Processing a Remote Description (Traitement d'une description distante)
  • 5.7 Processing a Rollback (Traitement d'un retour arrière)
  • 5.8 Parsing a Session Description (Analyse d'une description de session)
    • 5.8.1 Session-Level Parsing (Analyse au niveau session)
    • 5.8.2 Media Section Parsing (Analyse de section média)
    • 5.8.3 Semantics Verification (Vérification sémantique)
  • 5.9 Applying a Local Description (Application d'une description locale)
  • 5.10 Applying a Remote Description (Application d'une description distante)
  • 5.11 Applying an Answer (Application d'une réponse)
• 6. Processing RTP/RTCP (Traitement RTP/RTCP)
• 7. Examples (Exemples)
  • 7.1 Simple Example (Exemple simple)
  • 7.2 Detailed Example (Exemple détaillé)
  • 7.3 Early Transport Warmup Example (Exemple de préchauffage de transport précoce)
• 8. Security Considerations (Considérations de sécurité)
• 9. IANA Considerations (Considérations IANA)
• 10. References (Références)
  • 10.1 Normative References (Références normatives)
  • 10.2 Informative References (Références informatives)
• Appendix A. SDP ABNF Syntax (Syntaxe ABNF SDP)
• Acknowledgements (Remerciements)
• Authors' Addresses (Adresses des auteurs)