RTCPeerConnection: createAnswer() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die createAnswer()-Methode der RTCPeerConnection Schnittstelle erstellt eine SDP-Antwort auf ein Angebot, das von einem entfernten Peer während der Angebot/Antwort-Verhandlung einer WebRTC-Verbindung empfangen wurde.

Die Antwort enthält Informationen über bereits an die Sitzung angehängte Medien, von dem Browser unterstützte Codecs und Optionen sowie bereits gesammelte ICE-Kandidaten. Die Antwort wird an das zurückgegebene Promise geliefert und sollte dann an die Quelle des Angebots gesendet werden, um den Verhandlungsprozess fortzusetzen.

Syntax

js
createAnswer()
createAnswer(options)

createAnswer(successCallback, failureCallback) // deprecated
createAnswer(successCallback, failureCallback, options) // deprecated

Parameter

options Optional

Ein optionales Objekt, das angeforderte Optionen für die Antwort bereitstellt. Derzeit sind keine Optionen verfügbar.

Veraltete Parameter

In älterem Code und Dokumentationen kann eine callback-basierte Version dieser Funktion auftreten. Diese wurde veraltet und ihre Verwendung wird dringend abgeraten. Sie sollten vorhandenen Code aktualisieren, um die Promise-basierte Version von createAnswer() zu verwenden. Die Parameter der älteren Form von createAnswer() werden nachstehend beschrieben, um die Aktualisierung vorhandenen Codes zu erleichtern.

successCallback

Eine Callback-Funktion, die ein einzelnes RTCSessionDescription-Objekt erhält, das die neu erstellte Antwort beschreibt.

failureCallback

Eine Callback-Funktion, die ein einzelnes DOMException-Objekt erhält, das erklärt, warum die Anforderung, eine Antwort zu erstellen, fehlgeschlagen ist.

options Optional

Ein optionales Objekt, das angeforderte Optionen für die Antwort bereitstellt.

Ausnahmen

NotReadableError

Der Identitätsanbieter war nicht in der Lage, eine Identitätsbehauptung bereitzustellen.

OperationError

Die Erstellung der SDP ist aus irgendeinem Grund fehlgeschlagen; dies ist eine allgemeine Fehlerausnahme.

Rückgabewert

Ein Promise, das ein Objekt mit den gleichen Eigenschaften wie ein RTCSessionDescription-Objekten erfüllt:

type

Ein String, dessen Wert "answer" ist.

sdp

Ein String, der die SDP beschreibt, welche die Sitzung an den entfernten Peer liefern soll.

Beispiele

Hier ist ein Code-Segment aus dem Artikel Signalisierung und Videoanruf. Dieser Code stammt aus dem Handler für die Nachricht, die ein Angebot über den Signalisierungskanal an einen anderen Peer sendet.

Hinweis: Beachten Sie, dass dies Teil des Signalisierungsprozesses ist, dessen Transportschicht ein Implementierungsdetail ist, das vollständig Ihnen überlassen bleibt. In diesem Fall wird eine WebSocket-Verbindung verwendet, um eine JSON-Nachricht mit einem type-Feld mit dem Wert "video-answer" an den anderen Peer zu senden, die die Antwort an das Gerät trägt, das das Verbindungsangebot gesendet hat. Der Inhalt des Objekts, das an die sendToServer()-Funktion übergeben wird, sowie alles andere im Promise-Erfüllungs-Handler hängen vollständig von Ihrem Design ab.

js
pc.createAnswer()
  .then((answer) => pc.setLocalDescription(answer))
  .then(() => {
    // Send the answer to the remote peer through the signaling server.
  })
  .catch(handleGetUserMediaError);

Dies fordert RTCPeerConnection auf, eine neue Antwort zu erstellen und zurückzugeben. In unserem Promise-Handler wird die zurückgegebene Antwort als Beschreibung des lokalen Endes der Verbindung durch Aufrufen von setLocalDescription() gesetzt.

Sobald dies erfolgreich ist, wird die Antwort unter Verwendung des von Ihnen gewählten Protokolls an den Signalisierungsserver gesendet.

Promise.catch() wird verwendet, um Fehler abzufangen und zu behandeln.

Siehe Handling the invitation in unserem WebRTC-Chat-Beispiel, um den vollständigen Code zu sehen, von dem dieses Snippet abgeleitet ist; das wird Ihnen helfen, den Signalisierungsprozess und die Funktionsweise von Antworten zu verstehen.

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcpeerconnection-createanswer

Browser-Kompatibilität

BCD tables only load in the browser