RTCAudioSourceStats

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

DasRTCAudioSourceStats-Wörterbuch derWebRTC API liefert Statistikinformationen über einen Audio-Track (MediaStreamTrack), der an einen oder mehrere Sender (RTCRtpSender) angehängt ist.

Diese Statistiken können erhalten werden, indem derRTCStatsReport durchlaufen wird, der vonRTCRtpSender.getStats() oderRTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Bericht mit demtype vonmedia-source und einemkind vonaudio finden.

Hinweis:Für Audio-Informationen über Tracks, die aus der Ferne stammen (die empfangen werden), sieheRTCInboundRtpStreamStats.

Instanz-Eigenschaften

audioLevelExperimentellOptional: Eine Zahl, die den Audiopegel der Medienquelle darstellt.
totalAudioEnergyExperimentellOptional: Eine Zahl, die die gesamte Audioenergie der Medienquelle über die Lebensdauer des Statistikobjekts darstellt.
totalSamplesDurationExperimentellOptional: Eine Zahl, die die Gesamtdauer aller von der Medienquelle erzeugten Samples über die Lebensdauer des Statistikobjekts darstellt.

Allgemeine Eigenschaften von Medienquellen

Die folgenden Eigenschaften sind sowohl inRTCAudioSourceStats als auch inRTCVideoSourceStats vorhanden:

trackIdentifier: Ein String, der denid-Wert desMediaStreamTrack, der mit der Audioquelle verbunden ist, enthält.
kind: Ein String, der angibt, ob dieses Objekt die Statistiken für eine Videoquelle oder eine Medienquelle darstellt. Für einRTCAudioSourceStats ist dies immeraudio.

Allgemeine Instanz-Eigenschaften

Die folgenden Eigenschaften sind bei allen Statistikobjekten üblich.

id: Ein String, der das Objekt, das überwacht wird, um diese Statistikmenge zu erzeugen, eindeutig identifiziert.
timestamp: EinDOMHighResTimeStamp-Objekt, das den Zeitpunkt anzeigt, zu dem die Probe für dieses Statistikobjekt entnommen wurde.
type: Ein String mit dem Wert"media-source", der anzeigt, dass das Objekt eine Instanz von entwederRTCAudioSourceStats oderRTCVideoSourceStats ist.

Beschreibung

Das Interface liefert Statistiken über eine Audio-Medienquelle, die an einen oder mehrere Sender angehängt ist.Die Informationen umfassen den aktuellen Audiopegel, gemittelt über eine kurze (implementierungsabhängige) Dauer.

Die Statistiken umfassen auch die akkumulierte Gesamtenergie und die Gesamtsample-Dauer zu einem bestimmten Zeitpunkt.Die Gesamtsummen können verwendet werden, um den durchschnittlichen Audiopegel über die Lebensdauer des Statistikobjekts zu bestimmen.Sie können einen quadratischen Mittelwert (RMS) im selben Maßeinheit wieaudioLevel mit der folgenden Formel berechnen:

\sqrt{\frac{totalAudioEnergy}{totalSamplesDuration}} \sqrt{\frac{totalAudioEnergy}{totalSamplesDuration}}

Sie können auch die akkumulierten Gesamtsummen verwenden, um den durchschnittlichen Audiopegel über einen beliebigen Zeitraum zu berechnen.

Die gesamte Audioenergie des Statistikobjekts wird akkumuliert, indem die Energie jedes Samples über die Lebensdauer des Statistikobjekts hinzugefügt wird, während die Gesamtdauer akkumuliert wird, indem die Dauer jedes Samples hinzugefügt wird.Die Energie jedes Samples wird mit der folgenden Formel bestimmt, wobeisample_level der Pegel des Samples,max_level der höchstintensive kodierbare Wert undduration die Dauer des Samples in Sekunden ist:

duration \times {(\frac{sample_level}{max_level})}^{2} duration \times⁢ \left(\left(\right. \frac{sample{\_}level}{max{\_}level} \left.\right)\right)^{2}

Der durchschnittliche Audiopegel zwischen zwei verschiedenengetStats()-Aufrufen über einen beliebigen Zeitraum kann mit der folgenden Gleichung berechnet werden:

\sqrt{\frac{{totalAudioEnergy}_{2} - {totalAudioEnergy}_{1}}{{totalSamplesDuration}_{2} - {totalSamplesDuration}_{1}}} \sqrt{\frac{\left(totalAudioEnergy\right)_{2} - \left(totalAudioEnergy\right)_{1}}{\left(totalSamplesDuration\right)_{2} - \left(totalSamplesDuration\right)_{1}}}

Beispiele

Dieses Beispiel zeigt, wie Sie das Statistikobjekt, das vonRTCRtpSender.getStats() zurückgegeben wird, durchlaufen könnten, um die Audiquellenstatistiken zu erhalten und dann denaudioLevel extrahieren.

// where sender is an RTCRtpSenderconst stats = await sender.getStats();let audioSourceStats = null;stats.forEach((report) => {  if (report.type === "media-source" && report.kind==="audio") {    audioSourceStats = report;    break;  }});const audioLevel = audioSourceStats?.audioLevel;

Spezifikationen

Specification
Identifiers for WebRTC's Statistics API # dom-rtcaudiosourcestats

Browser-Kompatibilität

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen •Fehler mit dieser Übersetzung melden

Movatterモバイル変換