RTCRtpReceiver: Methode getContributingSources()

Baseline Widely available *

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

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

Die getContributingSources() Methode der RTCRtpReceiver Schnittstelle gibt ein Array von Objekten zurück, die jeweils einem CSRC (Contributing Source) Identifikator entsprechen, der vom aktuellen RTCRtpReceiver in den letzten zehn Sekunden empfangen wurde.

Syntax

js
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 vom beitragenden Quellcode wiedergegebenen RTP-Paket angibt.

Der Wert befindet sich auf einer linearen Skala und ist in Einheiten von dBov oder Dezibel (Übersteuerung) definiert. Dies ist die Amplitude im Verhältnis zu dem Punkt, an dem das Clipping des Audios beginnt. 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 ungefähr eine Änderung des Schalldruckpegels von 6 dB SPL (Dezibel des Schalldruckpegels) gegenüber 0 dBov.

Wenn diese Eigenschaft nicht vorhanden ist, wurde vom Quellcode kein Lautstärkepegel bereitgestellt.

rtpTimestamp Optional

Der RTP-Zeitstempel (ein Ganzzahl-DOMHighResTimeStamp) der Medien. Dieser vom Quellcode erzeugte Zeitstempel gibt die Zeit an, zu der die Medien in diesem Paket, das zur Wiedergabe zu dem durch timestamp angegebenen Zeitpunkt geplant ist, ursprünglich abgetastet oder erzeugt wurden. Es kann nützlich für Sequenzierungs- und Synchronisierungszwecke sein.

source Optional

Ein positiver Ganzzahlwert, der den CSRC-Identifikator der beitragenden Quelle angibt. Dieser identifiziert eindeutig die Quelle der speziellen Stream-RTP-Pakete.

timestamp Optional

Ein DOMHighResTimeStamp, der den jüngsten Zeitpunkt angibt, zu dem ein von dieser Quelle stammendes Frame dem Empfänger 'sMediaStreamTrack geliefert wurde.

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcrtpreceiver-getcontributingsources

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getContributingSources
audioLevel property in returned object
Audio tracks supported
rtpTimestamp property in returned object
source property in returned object
timestamp property in returned object
Video tracks supported

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.