RTCPeerConnection: Methode getConfiguration()

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 getConfiguration()-Methode der RTCPeerConnection-Schnittstelle gibt ein Objekt zurück, das die aktuelle Konfiguration der RTCPeerConnection, auf der die Methode aufgerufen wird, angibt.

Die zurückgegebene Konfiguration ist die zuletzt über setConfiguration() angewandte oder, falls setConfiguration() nicht aufgerufen wurde, die Konfiguration, mit der die RTCPeerConnection erstellt wurde. Die Konfiguration enthält eine Liste der von der Verbindung verwendeten ICE-Server, Informationen über Transportrichtlinien und Identitätsinformationen.

Syntax

js
getConfiguration()

Parameter

Keine.

Rückgabewert

Ein Objekt, das die aktuelle Konfiguration der RTCPeerConnection beschreibt. Siehe RTCPeerConnection() für weitere Informationen über zulässige Optionen.

Beispiele

Dieses Beispiel fügt einer aktiven Verbindung ein neues Zertifikat hinzu, falls bereits keines verwendet wird.

js
let configuration = myPeerConnection.getConfiguration();

if (configuration.certificates?.length === 0) {
  RTCPeerConnection.generateCertificate({
    name: "RSASSA-PKCS1-v1_5",
    hash: "SHA-256",
    modulusLength: 2048,
    publicExponent: new Uint8Array([1, 0, 1]),
  }).then((cert) => {
    configuration.certificates = [cert];
    myPeerConnection.setConfiguration(configuration);
  });
}

Dieses Beispiel ruft die aktuelle Konfiguration der RTCPeerConnection ab und prüft dann, ob Zertifikate gesetzt sind, indem (a) überprüft wird, ob die Konfiguration einen Wert für certificates hat, und (b) ob deren Länge null ist.

Wenn festgestellt wird, dass keine Zertifikate vorhanden sind, wird RTCPeerConnection.generateCertificate() aufgerufen, um ein neues Zertifikat zu erstellen; es wird ein Erfüllungs-Handler bereitgestellt, der ein neues Array mit dem neu erstellten Zertifikat zur aktuellen Konfiguration hinzufügt und es an setConfiguration() übergibt, um das Zertifikat zur Verbindung hinzuzufügen.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch