RTCRemoteInboundRtpStreamStats
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Februar 2020.
* Some parts of this feature may have varying levels of support.
Das RTCRemoteInboundRtpStreamStats-Wörterbuch der WebRTC API wird verwendet, um Statistiken vom Remote-Endpunkt über einen bestimmten eingehenden RTP-Stream zu berichten.
Diese entsprechen einem ausgehenden RTP-Stream am lokalen Ende der RTCPeerConnection.
Die Statistiken können erhalten werden, indem der RTCStatsReport, der von RTCPeerConnection.getStats() oder RTCRtpReceiver.getStats() zurückgegeben wird, durchiteriert wird, bis ein Bericht mit dem type von remote-inbound-rtp gefunden wird.
Instanz-Eigenschaften
>Remote, eingehende spezifische Statistiken
fractionLostOptional-
Eine Zahl, die den Bruchteil der für diesen SSRC verlorenen Pakete seit dem letzten Sender- oder Empfängerbericht angibt.
localIdOptional-
Ein String, der verwendet wird, um das lokale
RTCOutboundRtpStreamStats-Objekt zu finden, das die gleiche Synchronisationsquelle (SSRC) teilt. roundTripTimeOptional-
Eine Zahl, die die geschätzte Round-Trip-Zeit (RTT) für diesen SSRC in Sekunden angibt. Diese Eigenschaft wird nicht existieren, bis gültige RTT-Daten empfangen wurden.
roundTripTimeMeasurementsOptional-
Eine positive Ganzzahl, die die Gesamtzahl der gültigen Round-Trip-Zeitmessungen für diese Synchronisationsquelle (SSRC) angibt.
totalRoundTripTimeOptional-
Eine Zahl, die die kumulative Summe aller Round-Trip-Zeitmessungen seit Beginn der Sitzung in Sekunden angibt. Die durchschnittliche Round-Trip-Zeit kann berechnet werden, indem
totalRoundTripTimedurchroundTripTimeMeasurementsgeteilt wird.
Empfangene RTP-Stream-Statistiken
jitterOptional-
Eine Zahl, die das Paket-Jitter für diese Synchronisationsquelle in Sekunden misst.
packetsLostOptional-
Eine Ganzzahl, die die Gesamtzahl der für diesen SSRC verlorenen RTP-Pakete angibt, wie sie am Remote-Endpunkt gemessen wurde. Dieser Wert kann negativ sein, wenn doppelte Pakete empfangen wurden.
packetsReceivedOptional Experimentell-
Eine positive Ganzzahl, die die Gesamtzahl der für diesen SSRC empfangenen RTP-Pakete einschließlich der erneuten Übertragungen angibt.
Allgemeine RTP-Stream-Statistiken
codecIdOptional-
Ein String, der das Objekt eindeutig identifiziert, das untersucht wurde, um das
RTCCodecStats-Objekt zu erstellen, das mit diesem RTP-Stream verbunden ist. kind-
Ein String, der angibt, ob der mit dem Stream verbundene
MediaStreamTrackein Audio- oder Videotrack ist. ssrc-
Eine positive Ganzzahl, die den SSRC der RTP-Pakete in diesem Stream identifiziert.
transportIdOptional-
Ein String, der das Objekt eindeutig identifiziert, das untersucht wurde, um das
RTCTransportStats-Objekt zu erstellen, das mit diesem RTP-Stream verbunden ist.
Allgemeine Instanz-Eigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.
id-
Ein String, der das Objekt eindeutig identifiziert, das überwacht wird, um diese Statistikdaten zu produzieren.
timestamp-
Ein
DOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Stichprobe für dieses Statistikobjekt genommen wurde. type-
Ein String mit dem Wert
"inbound-rtp", der den Typ der Statistiken angibt, die das Objekt enthält.
Beispiele
Angenommen, eine Variable peerConnection, die eine Instanz von RTCPeerConnection ist, wird der folgende Code await verwenden, um auf den Statistikbericht zu warten, und ihn dann mithilfe von RTCStatsReport.forEach() durchiterieren.
Er filtert dann die Wörterbücher nur für jene Berichte, die den Typ remote-inbound-rtp haben und protokolliert das Ergebnis.
const stats = await myPeerConnection.getStats();
stats.forEach((report) => {
if (report.type === "remote-inbound-rtp") {
console.log("Remote Inbound RTP Stream Stats:");
console.log(`id: ${report.id}`);
console.log(`timestamp: ${report.timestamp}`);
console.log(`transportId: ${report.transportId}`);
console.log(`ssrc: ${report.ssrc}`);
console.log(`kind: ${report.kind}`);
console.log(`codecId: ${report.codecId}`);
console.log(`packetsReceived: ${report.packetsReceived}`);
console.log(`packetsLost: ${report.packetsLost}`);
console.log(`jitter: ${report.jitter}`);
console.log(`totalRoundTripTime: ${report.totalRoundTripTime}`);
console.log(
`roundTripTimeMeasurements: ${report.roundTripTimeMeasurements}`,
);
console.log(`roundTripTime: ${report.roundTripTime}`);
console.log(`localId: ${report.localId}`);
console.log(`fractionLost: ${report.fractionLost}`);
}
});
Spezifikationen
| Specification |
|---|
| Identifiers for WebRTC's Statistics API> # dom-rtcstatstype-remote-inbound-rtp> |
Browser-Kompatibilität
Loading…