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

浏览器兼容性