RTCRtpReceiver: getContributingSources()-Methode
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2019.
* Some parts of this feature may have varying levels of support.
Die getContributingSources()
-Methode der RTCRtpReceiver
-Schnittstelle gibt ein Array von Objekten zurück, von denen jedes einem CSRC (Contributing Source) Identifier entspricht, der vom aktuellen RTCRtpReceiver
in den letzten zehn Sekunden empfangen wurde.
Syntax
getContributingSources()
Parameter
Keine.
Rückgabewert
Ein Array von Objekten, die jeweils eine der beitragenden Quellen beschreiben, die in den letzten zehn Sekunden Daten zum eingehenden Stream geliefert haben. Diese Objekte enthalten die folgenden Eigenschaften:
audioLevel
Optional-
Ein Gleitkommawert zwischen 0,0 und 1,0, der den Audiopegel im letzten von der beitragenden Quelle gespielten RTP-Paket angibt.
Der Wert ist auf einer linearen Skala und wird in Einheiten von dBov oder Dezibel (Übersteuerung) definiert. Dies ist die Amplitude relativ zu dem Punkt, an dem das Clipping des Audios einsetzt. Ein Wert von 1,0 repräsentiert 0 dBov (maximale Lautstärke), ein Wert von 0,0 repräsentiert Stille und ein Wert von 0,5 repräsentiert eine Änderung des Schalldruckpegels von circa 6 dB SPL (Dezibel Schalldruckpegel) von 0 dBov.
Wenn diese Eigenschaft nicht vorhanden ist, wurde vom Quellmedium keine Lautstärke bereitgestellt.
rtpTimestamp
Optional-
Der RTP-Zeitstempel (ein ganzzahliger
DOMHighResTimeStamp
) des Mediums. Dieser von der Quelle generierte Zeitstempel gibt die Zeit an, zu der das im Paket enthaltene Medium, das zum imtimestamp
angegebenen Zeitpunkt ausgespielt werden soll, ursprünglich abgetastet oder erzeugt wurde. Er kann für Sequenzierungs- und Synchronisationszwecke nützlich sein. source
Optional-
Ein positiver Integerwert, der den CSRC-Identifikator der beitragenden Quelle angibt. Dies identifiziert eindeutig die Quelle des bestimmten Streams der RTP-Pakete.
timestamp
Optional-
Ein
DOMHighResTimeStamp
, der die aktuellste Zeit angibt, zu der ein von dieser Quelle stammendes Frame zumMediaStreamTrack
des Empfangsgeräts geliefert wurde.
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # dom-rtcrtpreceiver-getcontributingsources |