大网数据广告活动
Web 标准与前端开发

RTCVideoSourceStats

· 52CE 我爱测

The **`RTCVideoSourceStats`** dictionary of the WebRTC API provides statistics information about a video track (MediaStreamTrack) that is attached to one or more senders (RTCRtpSender).

WebRTC

The RTCVideoSourceStats dictionary of the WebRTC API provides statistics information about a video track (MediaStreamTrack) that is attached to one or more senders (RTCRtpSender).

These statistics can be obtained by iterating the RTCStatsReport returned by RTCRtpSender.getStats() or RTCPeerConnection.getStats() until you find a report with the type of media-source and a kind of video.

[!NOTE] For video information about remotely sourced tracks (that are being received), see RTCInboundRtpStreamStats.

Instance properties

  • RTCVideoSourceStats.frames
    • : A positive number that indicates the total number of frames originating from this video source.
  • RTCVideoSourceStats.framesPerSecond
    • : A positive number that represents the number of frames originating from this video source in the last second. This property is not defined on this stats object for the first second of its existence.
  • RTCVideoSourceStats.height
    • : A number that represents the height, in pixels, of the last frame originating from this source. This property is not defined on this stats object until after the first frame has been produced.
  • RTCVideoSourceStats.width
    • : A number that represents the width, in pixels, of the most recent frame originating from this source. This property is not defined on this stats object until after the first frame has been produced.

Common media-source properties

The following properties are present in both RTCVideoSourceStats and RTCAudioSourceStats:

  • RTCVideoSourceStats.trackIdentifier
    • : A string that contains the id value of the MediaStreamTrack associated with the video source.
  • RTCVideoSourceStats.kind
    • : A string indicating whether this object represents stats for a video source or a media source. For an RTCVideoSourceStats this will always be video.

Common instance properties

The following properties are common to all statistics objects.

  • RTCVideoSourceStats.id
    • : A string that uniquely identifies the object that is being monitored to produce this set of statistics.
  • RTCVideoSourceStats.timestamp
    • : A DOMHighResTimeStamp object indicating the time at which the sample was taken for this statistics object.
  • RTCVideoSourceStats.type
    • : A string with the value "media-source", indicating that the object is an instance of either RTCAudioSourceStats or RTCVideoSourceStats.

Description

The interface provides statistics about a video media source attached to one or more senders. The information includes an identifier for the associated MediaStreamTrack, along with the height and width of the last frame sent from the source, the number of frames sent from the source, and the frame rate.

Examples

This example shows how you might iterate the stats object returned from RTCRtpSender.getStats() to get the video-specific media-source stats.

// where sender is an RTCRtpSender
const stats = await sender.getStats();
let videoSourceStats = null;

for (const report of stats.values()) {
  if (report.type === "media-source" && report.kind === "video") {
    videoSourceStats = report;
    break;
  }
}

// videoSourceStats will be null if the report did not include video source stats
const frames = videoSourceStats?.frames;
const fps = videoSourceStats?.framesPerSecond;
const width = videoSourceStats?.width;
const height = videoSourceStats?.height;

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。