RTCRtpReceiver: getContributingSources() 方法

getContributingSources() 方法是 RTCRtpReceiver 接口的方法,它返回一个对象数组,每个对象对应当前 RTCRtpReceiver 在过去十秒内接收到的一个 CSRC(贡献源)标识符。

语法

js
getContributingSources()

参数

无。

返回值

一个对象数组,每个对象描述过去十秒内向传入流提供数据的其中一个贡献源。这些对象包含以下属性

audioLevel 可选

一个介于 0.0 和 1.0 之间的浮点值,指定从贡献源播放的最后一个 RTP 数据包中包含的音频级别。

该值使用线性比例,并以 dBov 或分贝(过载)为单位定义。这是相对于音频开始削波的点的振幅。值 1.0 表示 0 dBov(最大音量),值 0.0 表示静音,值 0.5 表示声音压力级变化约 6 dB SPL(分贝声压级)从 0 dBov 变化。

如果此属性不存在,则源未提供任何音量级别。

rtpTimestamp 可选

媒体的 RTP 时间戳(一个整数 DOMHighResTimeStamp)。此源生成的 timestamps 指示在由 timestamp 指示的时间点播放的该数据包中的媒体最初采样或生成的时间。它可能对排序和同步目的有用。

source 可选

一个正整数,指定贡献源的 CSRC 标识符。这唯一标识特定流 RTP 数据包的源。

timestamp 可选

一个 DOMHighResTimeStamp,表示最近一次从该源发送的帧传递到接收器 MediaStreamTrack 的时间。

规范

规范
WebRTC:浏览器中的实时通信
# dom-rtcrtpreceiver-getcontributingsources

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。