RTCRtpReceiver: phương thức getStats()

Baseline Widely available

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

Phương thức RTCRtpReceiver getStats() yêu cầu không đồng bộ một đối tượng RTCStatsReport cung cấp thống kê về lưu lượng đi vào trên RTCPeerConnection sở hữu, và trả về một Promise mà trình xử lý fulfillment sẽ được gọi khi có kết quả.

Cú pháp

js
getStats()

Tham số

Không có.

Giá trị trả về

Một Promise của JavaScript được thực thi xong khi thống kê sẵn sàng. Trình xử lý fulfillment của promise nhận một đối tượng RTCStatsReport chứa các thống kê đã thu thập.

Thống kê trả về bao gồm các thông tin từ mọi luồng đi vào qua RTCRtpReceiver, cũng như các phụ thuộc của chúng.

Chúng có thể bao gồm, ví dụ, thống kê với các loại: inbound-rtp, candidate-pair, local-candidate, remote-candidate.

Ví dụ

Ví dụ đơn giản này lấy thống kê cho một RTCRtpReceiver và cập nhật innerText của một phần tử để hiển thị số gói đã mất.

js
receiver.getStats().then((stats) => {
  document.getElementById("lost-packets").innerText = stats.packetsLost;
});

Đặc tả kỹ thuật

Specification
WebRTC: Real-Time Communication in Browsers
# widl-RTCRtpReceiver-getStats-Promise-RTCStatsReport

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

Xem thêm