RTCRemoteInboundRtpStreamStats

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since February 2020.

* Some parts of this feature may have varying levels of support.

Từ điển RTCRemoteInboundRtpStreamStats của WebRTC API được dùng để báo cáo thống kê từ điểm cuối từ xa về một luồng RTP đến cụ thể. Chúng sẽ tương ứng với một luồng RTP đi ở đầu cục bộ của RTCPeerConnection.

Có thể lấy các thống kê bằng cách duyệt qua RTCStatsReport được trả về bởi RTCPeerConnection.getStats() hoặc RTCRtpReceiver.getStats() cho đến khi tìm thấy báo cáo có typeremote-inbound-rtp.

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

Thống kê luồng đến từ xa

fractionLost Optional

Một số cho biết tỷ lệ gói bị mất cho SSRC này kể từ báo cáo người gửi hoặc người nhận cuối cùng.

localId Optional

Một chuỗi được dùng để tìm đối tượng RTCOutboundRtpStreamStats cục bộ có cùng nguồn đồng bộ hóa (SSRC).

roundTripTime Optional

Một số cho biết thời gian vòng lặp (RTT) ước tính cho SSRC này, tính bằng giây. Thuộc tính này sẽ không tồn tại cho đến khi nhận được dữ liệu RTT hợp lệ.

roundTripTimeMeasurements Optional

Một số nguyên dương cho biết tổng số phép đo thời gian vòng lặp hợp lệ đã nhận được cho nguồn đồng bộ hóa (SSRC) này.

totalRoundTripTime Optional

Một số cho biết tổng tích lũy của tất cả các phép đo thời gian vòng lặp kể từ đầu phiên, tính bằng giây. Thời gian vòng lặp trung bình có thể được tính bằng cách chia totalRoundTripTime cho roundTripTimeMeasurements.

Thống kê luồng RTP được nhận

jitter Optional

Một số cho biết jitter gói cho nguồn đồng bộ hóa này, đo bằng giây.

packetsLost Optional

Một số nguyên cho biết tổng số gói RTP bị mất cho SSRC này, được đo tại điểm cuối từ xa. Giá trị này có thể âm nếu nhận được các gói trùng lặp.

packetsReceived Optional Experimental

Một số nguyên dương cho biết tổng số gói RTP đã nhận cho SSRC này, bao gồm cả các lần truyền lại.

Thống kê luồng RTP chung

codecId Optional

Một chuỗi xác định duy nhất đối tượng được kiểm tra để tạo ra đối tượng RTCCodecStats liên kết với luồng RTP này.

kind

Một chuỗi cho biết liệu MediaStreamTrack liên kết với luồng là track âm thanh hay video.

ssrc

Một số nguyên dương xác định SSRC của các gói RTP trong luồng này.

transportId Optional

Một chuỗi xác định duy nhất đối tượng được kiểm tra để tạo ra đối tượng RTCTransportStats liên kết với luồng RTP này.

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

Các thuộc tính sau đây có ở tất cả các đối tượng thống kê WebRTC.

id

Một chuỗi xác định duy nhất đối tượng đang được giám sát để tạo ra tập hợp thống kê này.

timestamp

Một đối tượng DOMHighResTimeStamp chỉ ra thời điểm lấy mẫu cho đối tượng thống kê này.

type

Một chuỗi có giá trị "inbound-rtp", chỉ ra loại thống kê mà đối tượng chứa.

Ví dụ

Với biến peerConnection là một phiên bản của RTCPeerConnection, đoạn code dưới đây sử dụng await để chờ báo cáo thống kê, sau đó duyệt qua nó bằng RTCStatsReport.forEach(). Nó lọc các từ điển chỉ lấy những báo cáo có type là remote-inbound-rtp và ghi lại kết quả.

js
const stats = await myPeerConnection.getStats();

stats.forEach((report) => {
  if (report.type === "remote-inbound-rtp") {
    console.log("Remote Inbound RTP Stream Stats:");
    console.log(`id: ${report.id}`);
    console.log(`timestamp: ${report.timestamp}`);
    console.log(`transportId: ${report.transportId}`);
    console.log(`ssrc: ${report.ssrc}`);
    console.log(`kind: ${report.kind}`);
    console.log(`codecId: ${report.codecId}`);
    console.log(`packetsReceived: ${report.packetsReceived}`);
    console.log(`packetsLost: ${report.packetsLost}`);
    console.log(`jitter: ${report.jitter}`);
    console.log(`totalRoundTripTime: ${report.totalRoundTripTime}`);
    console.log(
      `roundTripTimeMeasurements: ${report.roundTripTimeMeasurements}`,
    );
    console.log(`roundTripTime: ${report.roundTripTime}`);
    console.log(`localId: ${report.localId}`);
    console.log(`fractionLost: ${report.fractionLost}`);
  }
});

Thông số kỹ thuật

Specification
Identifiers for WebRTC's Statistics API
# dom-rtcstatstype-remote-inbound-rtp

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

Xem thêm