RTCRtpReceiver: getContributingSources() 方法

Baseline 廣泛可用 *

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2019 年 3 月以來,它已在所有瀏覽器中可用。

* 此特性的某些部分可能存在不同級別的支援。

RTCRtpReceiver 介面的 getContributingSources() 方法會返回一個物件陣列,每個物件對應當前 RTCRtpReceiver 在過去十秒鐘內接收到的一個 CSRC(contributing source,貢獻源)識別符號。

語法

js
getContributingSources()

引數

無。

返回值

返回一個物件陣列,每個物件描述過去十秒內為傳入流提供資料的貢獻源之一。這些物件包含以下屬性:

audioLevel 可選

一個介於 0.0 和 1.0 之間的浮點數值,指定從貢獻源播放的最後一個 RTP 資料包中包含的音訊水平。

該值是線性的,以 dBov(分貝過載)為單位。這是相對於音訊開始出現削波(clipping)的點的幅度。值為 1.0 表示 0 dBov(最大音量),值為 0.0 表示靜音,值為 0.5 表示聲壓級(SPL)約有 6 dB 的變化(從 0 dBov 開始)。

如果此屬性不存在,則表示該源未提供音量資訊。

rtpTimestamp 可選

媒體的 RTP 時間戳(一個整數 DOMHighResTimeStamp)。此源生成的時戳指示了此資料包中的媒體(將在 timestamp 指定的時間播放)最初取樣或生成的時間。它可能對排序和同步很有用。

source 可選

一個正整數,指定貢獻源的 CSRC 識別符號。這唯一標識了特定流 RTP 資料包的來源。

timestamp 可選

一個 DOMHighResTimeStamp,指示從該源發出的幀最近一次交付到接收器的 MediaStreamTrack 的時間。

規範

規範
WebRTC:瀏覽器中的即時通訊
# dom-rtcrtpreceiver-getcontributingsources

瀏覽器相容性