RTCVideoSourceStats

Thuộc tính phiên bản

frames Optional

Một số dương cho biết tổng số khung hình xuất phát từ nguồn video này.

framesPerSecond Optional

Một số dương cho biết số khung hình xuất phát từ nguồn video này trong giây vừa qua. Thuộc tính này không được định nghĩa trên đối tượng thống kê này trong giây đầu tiên tồn tại của nó.

height Optional

Một số cho biết chiều cao, tính bằng pixel, của khung hình cuối cùng xuất phát từ nguồn này. Thuộc tính này không được định nghĩa trên đối tượng thống kê này cho đến khi khung hình đầu tiên được tạo ra.

width Optional

Một số cho biết chiều rộng, tính bằng pixel, của khung hình gần nhất xuất phát từ nguồn này. Thuộc tính này không được định nghĩa trên đối tượng thống kê này cho đến khi khung hình đầu tiên được tạo ra.

Thuộc tính media-source chung

Các thuộc tính sau có mặt trong cả RTCVideoSourceStats và RTCAudioSourceStats:

trackIdentifier

Một chuỗi chứa giá trị id của MediaStreamTrack liên kết với nguồn video.

kind

Một chuỗi cho biết đối tượng này đại diện cho thống kê của nguồn video hay nguồn media. Với RTCVideoSourceStats, giá trị này luôn là video.

Thuộc tính phiên bản chung

Các thuộc tính sau là chung cho tất cả các đối tượng thống kê.

id

Một chuỗi định danh duy nhất cho đối tượng đang được theo dõi để tạo ra tập thống kê này.

timestamp

Một đối tượng DOMHighResTimeStamp cho biết thời điểm mẫu dữ liệu được lấy cho đối tượng thống kê này.

type

Một chuỗi có giá trị "media-source", cho biết đối tượng là một phiên bản của RTCAudioSourceStats hoặc RTCVideoSourceStats.

Mô tả

Giao diện này cung cấp thống kê về một nguồn media video đang được gắn với một hoặc nhiều sender. Thông tin bao gồm mã định danh cho MediaStreamTrack liên quan, cùng với chiều cao và chiều rộng của khung hình cuối cùng được gửi từ nguồn, số khung hình đã gửi từ nguồn và tốc độ khung hình.

Ví dụ

Ví dụ này cho thấy cách duyệt qua đối tượng thống kê trả về từ RTCRtpSender.getStats() để lấy thống kê media-source dành riêng cho video.

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

stats.forEach((report) => {
  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;

Thông số kỹ thuật

Tương thích trình duyệt