Phương thức getStats() của RTCRtpSender

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 getStats() của RTCRtpSender yêu cầu bất đồng bộ một đối tượng RTCStatsReport cung cấp thống kê về lưu lượng outgoing trên RTCPeerConnection sở hữu sender này, trả về một Promise được fulfilled khi kết quả có sẵn.

Cú pháp

js
getStats()

Tham số

Không có.

Giá trị trả về

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

RTCStatsReport được trả về tích lũy thống kê cho tất cả các luồng đang được gửi bằng cách sử dụng RTCRtpSender, cũng như thống kê cho bất kỳ phụ thuộc nào mà các luồng đó có.

Các thống kê này có thể bao gồm, ví dụ, các thống kê với types: outbound-rtp, candidate-pair, local-candidate, remote-candidate.

Ví dụ

Ví dụ đơn giản này lấy thống kê cho một RTCRtpSender và cập nhật innerText của một phần tử để hiển thị thời gian khứ hồi hiện tại cho các yêu cầu trên sender.

js
sender.getStats().then((stats) => {
  document.getElementById("currentRTT").innerText = stats.roundTripTime;
});

Đặc tả kỹ thuật

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

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

Xem thêm