RTCError: RTCError() Konstruktor

Syntax

new RTCError(options)
new RTCError(options, message)

Parameter

options

Ein Objekt, das die Details des spezifischen Fehlers in einem RTCErrorEvent bereitstellt. Das Objekt hat die folgenden Eigenschaften:

errorDetail

Ein String, der den WebRTC-spezifischen Fehlercode angibt, der den Typ des aufgetretenen Fehlers identifiziert. Dies wird einer der folgenden sein:

data-channel-failure

Der RTCDataChannel der Verbindung ist fehlgeschlagen.

dtls-failure

Die Aushandlung der DTLS-Verbindung ist fehlgeschlagen oder die Verbindung wurde mit einem schwerwiegenden Fehler beendet. Die message des Fehlers enthält Details über die Art des Fehlers.

• Wenn ein schwerwiegender Fehler empfangen wird, setzen Sie receivedAlert auf den Wert des empfangenen DTLS-Alarms.
• Wenn ein schwerwiegender Fehler gesendet wurde, setzen Sie sentAlert auf den Wert des Alarms.

fingerprint-failure

Das entfernte Zertifikat für das RTCDtlsTransport stimmte mit keinem der im SDP Nachrichten aufgeführten Fingerprints überein. Wenn das entfernte Gegenüber das lokale Zertifikat nicht mit den bereitgestellten Fingerprints abgleichen kann, tritt dieser Fehler nicht auf, obwohl diese Situation stattdessen zu einem dtls-failure Fehler führen kann.

hardware-encoder-error

Der Hardware-Encoder unterstützt die angegebenen Konfigurationsparameter nicht.

hardware-encoder-not-available

Die für die angeforderte Operation erforderlichen Hardware-Encoder-Ressourcen sind nicht verfügbar.

sctp-failure

Die SCTP Aushandlung ist fehlgeschlagen oder die Verbindung wurde mit einem schwerwiegenden Fehler beendet. Der SCTP-Ursachencode sollte in sctpCauseCode gesetzt werden. SCTP-Ursachencodes 1-13 sind in der SCTP-Spezifikation definiert: RFC 4960, Abschnitt 3.3.10.

sdp-syntax-error

Die SDP-Syntax ist ungültig. Die SDP-Nachrichtenzeilennummer, bei der der Fehler entdeckt wurde, sollte in sdpLineNumber gesetzt werden.

receivedAlert Optional

Ein positiver Ganzzahlwert, der einen schwerwiegenden DTLS-Fehler angibt, der vom Netzwerk empfangen wurde. Nur setzen, wenn der errorDetail-String dtls-failure ist.

sctpCauseCode Optional

Eine Ganzzahl, die den SCTP Ursachencode angibt, der die Ursache der fehlgeschlagenen SCTP-Aushandlung anzeigt. Dies sollte nur gesetzt werden, wenn errorDetail sctp-failure ist.

sdpLineNumber Optional

Eine Ganzzahl, die die SDP Nachrichtenzeilennummer angibt, bei der ein Syntaxfehler aufgetreten ist. Nur setzen, wenn errorDetail sdp-syntax-error ist.

sentAlert Optional

Eine positive Ganzzahl, die einen schwerwiegenden DTLS-Fehler angibt, der von diesem Gerät gesendet wurde. Nur setzen, wenn errorDetail dtls-failure ist.

message Optional

Ein String für die Fehlermeldung. Standardmäßig ist dies der leere String ("").

Rückgabewert

Eine neu erstellte RTCError Objektinstanz.

Verwendungshinweise

Dieser Konstruktor führt keine vollständige Validierung des angegebenen candidateInfo-Objekts oder -Strings durch.

Spezifikationen

Browser-Kompatibilität