RTCPeerConnectionStats

Instanzeigenschaften

dataChannelsOpened

Ein positiver ganzzahliger Wert, der die Anzahl der eindeutigen RTCDataChannel Objekte angibt, die während ihrer Lebensdauer in den open Zustand eingetreten sind.

dataChannelsClosed

Ein positiver ganzzahliger Wert, der die Anzahl der eindeutigen RTCDataChannel Objekte angibt, die während ihrer Lebensdauer den open Zustand verlassen haben (Kanäle, die in den closing oder closed Zustand wechseln, ohne jemals open gewesen zu sein, werden in dieser Zahl nicht gezählt). Ein Kanal verlässt den open Zustand, wenn entweder das Ende der Verbindung oder das zugrundeliegende Transport geschlossen wird.

Allgemeine Instanzeigenschaften

Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.

id

Ein String, der das Objekt, das überwacht wird, um diese Gruppe von Statistiken zu erzeugen, eindeutig identifiziert.

timestamp

Ein DOMHighResTimeStamp Objekt, das die Zeit angibt, zu der das Sample für dieses Statistikobjekt genommen wurde.

type

Ein String mit dem Wert "peer-connection", der den Typ der Statistiken anzeigt, den das Objekt enthält.

Beispiele

Dieses Beispiel zeigt eine Funktion, die die Gesamtzahl der offenen Verbindungen zurückgibt, oder null, wenn keine Statistiken bereitgestellt werden. Dies könnte in einer Schleife aufgerufen werden, ähnlich der Vorgehensweise im RTCPeerConnection.getStats() Beispiel.

Die Funktion wartet auf das Ergebnis eines Aufrufs von RTCPeerConnection.getStats() und durchläuft dann den zurückgegebenen RTCStatsReport, um nur die Statistiken des Typs "peer-connection" zu erhalten. Sie gibt dann die Gesamtzahl der offenen Kanäle oder null zurück, basierend auf den Daten im Bericht.

async function numberOpenConnections(peerConnection) {
  const stats = await peerConnection.getStats();
  let peerConnectionStats = null;

  for (const report of stats.values()) {
    if (report.type === "peer-connection") {
      peerConnectionStats = report;
      break;
    }
  }

  if (
    peerConnectionStats === null ||
    typeof peerConnectionStats.dataChannelsOpened === "undefined" ||
    typeof peerConnectionStats.dataChannelsClosed === "undefined"
  ) {
    return null;
  }

  return (
    peerConnectionStats.dataChannelsOpened -
    peerConnectionStats.dataChannelsClosed
  );
}

Spezifikationen

Browser-Kompatibilität