RFC 8829 - JavaScript Session Establishment Protocol (JSEP)

• Stato: Proposed Standard
• Pubblicato: January 2021
• Stream: IETF
• Sostituito da: RFC9429
• Errata: Nessun errata

---

Abstract (Riassunto)

Questo documento descrive i meccanismi che consentono a un'applicazione JavaScript di controllare il piano di segnalazione di una sessione multimediale tramite l'interfaccia specificata nell'API RTCPeerConnection del W3C e discute come questo si relaziona ai protocolli di segnalazione esistenti.

Status of This Memo (Stato di questo memorandum)

Questo è un documento Internet Standards Track.

Questo documento è un prodotto dell'Internet Engineering Task Force (IETF). Rappresenta il consenso della comunità IETF. Ha ricevuto una revisione pubblica ed è stato approvato per la pubblicazione dall'Internet Engineering Steering Group (IESG). Ulteriori informazioni sugli Standard Internet sono disponibili nella Sezione 2 della RFC 7841.

Le informazioni sullo stato attuale di questo documento, eventuali errata e come fornire feedback possono essere ottenute all'indirizzo https://www.rfc-editor.org/info/rfc8829.

Copyright Notice (Avviso di copyright)

Copyright (c) 2021 IETF Trust e le persone identificate come autori del documento. Tutti i diritti riservati.

Questo documento è soggetto a BCP 78 e alle Disposizioni Legali dell'IETF Trust relative ai Documenti IETF (https://trustee.ietf.org/license-info) in vigore alla data di pubblicazione di questo documento. Si prega di esaminare attentamente questi documenti, in quanto descrivono i vostri diritti e le restrizioni rispetto a questo documento. I componenti di codice estratti da questo documento devono includere il testo della Licenza BSD Semplificata come descritto nella Sezione 4.e delle Disposizioni Legali del Trust e sono forniti senza garanzia come descritto nella Licenza BSD Semplificata.

Contents

• 1. Introduction (Introduzione)
  • 1.1 General Design of JSEP (Progettazione generale di JSEP)
  • 1.2 Other Approaches Considered (Altri approcci considerati)
  • 1.3 Contradiction regarding bundle-only "m=" sections (Contraddizione riguardante le sezioni "m=" bundle-only)
• 2. Terminology (Terminologia)
• 3. Semantics and Syntax (Semantica e sintassi)
  • 3.1 Signaling Model (Modello di segnalazione)
  • 3.2 Session Descriptions and State Machine (Descrizioni di sessione e macchina a stati)
  • 3.3 Session Description Format (Formato di descrizione della sessione)
  • 3.4 Session Description Control (Controllo della descrizione della sessione)
    • 3.4.1 RtpTransceivers
    • 3.4.2 RtpSenders
    • 3.4.3 RtpReceivers
  • 3.5 ICE
    • 3.5.1 ICE Gathering Overview (Panoramica della raccolta ICE)
    • 3.5.2 ICE Candidate Trickling (Trickling dei candidati ICE)
      • 3.5.2.1 ICE Candidate Format (Formato dei candidati ICE)
    • 3.5.3 ICE Candidate Policy (Politica dei candidati ICE)
    • 3.5.4 ICE Candidate Pool (Pool di candidati ICE)
    • 3.5.5 ICE Versions (Versioni ICE)
  • 3.6 Video Size Negotiation (Negoziazione della dimensione video)
    • 3.6.1 Creating an imageattr Attribute (Creazione di un attributo imageattr)
    • 3.6.2 Interpreting imageattr Attributes (Interpretazione degli attributi imageattr)
  • 3.7 Simulcast (Trasmissione simultanea)
  • 3.8 Interactions with Forking (Interazioni con il forking)
    • 3.8.1 Sequential Forking (Forking sequenziale)
    • 3.8.2 Parallel Forking (Forking parallelo)
• 4. Interface (Interfaccia)
  • 4.1 PeerConnection
    • 4.1.1 Constructor (Costruttore)
    • 4.1.2 addTrack
    • 4.1.3 removeTrack
    • 4.1.4 addTransceiver
    • 4.1.5 onaddtrack Event (Evento onaddtrack)
    • 4.1.6 createDataChannel
    • 4.1.7 ondatachannel Event (Evento ondatachannel)
    • 4.1.8 createOffer
    • 4.1.9 createAnswer
    • 4.1.10 SessionDescriptionType
      • 4.1.10.1 Use of Provisional Answers (Uso di risposte provvisorie)
      • 4.1.10.2 Rollback (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 (Evento 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 (Procedure di interazione SDP)
  • 5.1 Requirements Overview (Panoramica dei requisiti)
    • 5.1.1 Usage Requirements (Requisiti di utilizzo)
    • 5.1.2 Profile Names and Interoperability (Nomi di profilo e interoperabilità)
  • 5.2 Constructing an Offer (Costruzione di un'offerta)
    • 5.2.1 Initial Offers (Offerte iniziali)
    • 5.2.2 Subsequent Offers (Offerte successive)
    • 5.2.3 Options Handling (Gestione delle opzioni)
      • 5.2.3.1 IceRestart
      • 5.2.3.2 VoiceActivityDetection
  • 5.3 Generating an Answer (Generazione di una risposta)
    • 5.3.1 Initial Answers (Risposte iniziali)
    • 5.3.2 Subsequent Answers (Risposte successive)
    • 5.3.3 Options Handling (Gestione delle opzioni)
      • 5.3.3.1 VoiceActivityDetection
  • 5.4 Modifying an Offer or Answer (Modifica di un'offerta o risposta)
  • 5.5 Processing a Local Description (Elaborazione di una descrizione locale)
  • 5.6 Processing a Remote Description (Elaborazione di una descrizione remota)
  • 5.7 Processing a Rollback (Elaborazione di un rollback)
  • 5.8 Parsing a Session Description (Analisi di una descrizione di sessione)
    • 5.8.1 Session-Level Parsing (Analisi a livello di sessione)
    • 5.8.2 Media Section Parsing (Analisi della sezione media)
    • 5.8.3 Semantics Verification (Verifica semantica)
  • 5.9 Applying a Local Description (Applicazione di una descrizione locale)
  • 5.10 Applying a Remote Description (Applicazione di una descrizione remota)
  • 5.11 Applying an Answer (Applicazione di una risposta)
• 6. Processing RTP/RTCP (Elaborazione di RTP/RTCP)
• 7. Examples (Esempi)
  • 7.1 Simple Example (Esempio semplice)
  • 7.2 Detailed Example (Esempio dettagliato)
  • 7.3 Early Transport Warmup Example (Esempio di riscaldamento anticipato del trasporto)
• 8. Security Considerations (Considerazioni sulla sicurezza)
• 9. IANA Considerations (Considerazioni IANA)
• 10. References (Riferimenti)
  • 10.1 Normative References (Riferimenti normativi)
  • 10.2 Informative References (Riferimenti informativi)
• Appendix A. SDP ABNF Syntax (Sintassi ABNF SDP)
• Acknowledgements (Ringraziamenti)
• Authors' Addresses (Indirizzi degli autori)