RTCRtpReceiver: Methode getSynchronizationSources()

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.

Die getSynchronizationSources() Methode des RTCRtpReceiver Interfaces gibt ein Array von Objekten zurück, die jeweils einer SSRC (Synchronisationsquelle) entsprechen, die vom aktuellen RTCRtpReceiver in den letzten zehn Sekunden empfangen wurde.

Syntax

js
getSynchronizationSources()

Parameter

Keine.

Rückgabewert

Ein Array von Objekten, die jeweils eine der Synchronisationsquellen beschreiben, die in den letzten zehn Sekunden Daten an den eingehenden Stream geliefert haben. Diese Objekte enthalten die folgenden Eigenschaften:

audioLevel

Ein Gleitkommawert zwischen 0,0 und 1,0, der den Audiopegel angibt, der im letzten von der Synchronisationsquelle gespielten RTP-Paket enthalten ist.

Der Wert ist linear skaliert und wird in Einheiten von dBov oder Dezibel (Übersteuerung) definiert. Dies ist die Amplitude relativ zu dem Punkt, an dem die Übersteuerung des Audios aufzutreten 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 eine Änderung des Schalldruckpegels um etwa 6 dB SPL (Dezibel des Schalldruckpegels) von 0 dBov.

Dieser Wert ist erforderlich und immer vorhanden.

rtpTimestamp Optional

Der RTP-Zeitstempel (ein Ganzzahlenwert DOMHighResTimeStamp) des Mediums. Dieser von der Quelle generierte Zeitstempel gibt die Zeit an, zu der das Medium in diesem Paket, das zur Wiedergabe zu der von timestamp angegebenen Zeit geplant ist, ursprünglich abgetastet oder erzeugt wurde. Dies kann für Sequenzierungs- und Synchronisationszwecke nützlich sein.

source Optional

Ein positiver Ganzzahlenwert, der die SSRC-Kennung der Synchronisationsquelle angibt. Dies identifiziert eindeutig die Quelle der spezifischen RTP-Paketströme.

timestamp Optional

Ein DOMHighResTimeStamp, der die letzte Zeit angibt, zu der ein von dieser Quelle stammendes Frame an den MediaStreamTrack des Empfängers geliefert wurde.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser