RTCDataChannelStats

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Từ điển RTCDataChannelStats của WebRTC API cung cấp thống kê liên quan đến một đối tượng RTCDataChannel trên kết nối.

Báo cáo có thể được lấy bằng cách lặp qua RTCStatsReport được trả về bởi RTCPeerConnection.getStats() cho đến khi bạn tìm thấy một mục có type là data-channel.

Thống kê kênh dữ liệu có thể được tương quan với một kênh cụ thể bằng cách so sánh thuộc tính dataChannelIdentifier với một RTCDataChannel.id phù hợp.

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

bytesSent Optional: Số nguyên dương cho biết tổng số byte tải trọng được gửi trên RTCDataChannel liên kết.
bytesReceived Optional: Số nguyên dương cho biết tổng số byte tải trọng được nhận trên RTCDataChannel liên kết.
dataChannelIdentifier Optional: Số nguyên dương chứa id của RTCDataChannel liên kết.
label Optional: Chuỗi chứa nhãn của RTCDataChannel liên kết.
messagesReceived Optional: Số nguyên dương cho biết tổng số sự kiện message được kích hoạt cho các tin nhắn nhận được trên RTCDataChannel liên kết.
messagesSent Optional: Số nguyên dương cho biết tổng số sự kiện message được kích hoạt cho các tin nhắn đã gửi trên kênh.
protocol Optional: Chuỗi chứa giao thức của RTCDataChannel liên kết.
state: readyState của RTCDataChannel liên kết.

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ê WebRTC (Xem RTCStatsReport để biết thêm thông tin).

id: Chuỗi nhận dạng duy nhất đối tượng đang được theo dõi để tạo ra tập hợp thống kê này.
timestamp: Đối tượng DOMHighResTimeStamp cho biết thời điểm mẫu được lấy cho đối tượng thống kê này.
type: Chuỗi có giá trị "data-channel", cho biết loại thống kê mà đối tượng chứa.

Cho biến myPeerConnection, là một phiên bản của RTCPeerConnection, đoạn mã dưới đây sử dụng await để chờ báo cáo thống kê, sau đó lặp qua nó bằng RTCStatsReport.forEach(). Sau đó nó lọc các từ điển chỉ lấy những báo cáo có kiểu data-channel và ghi kết quả vào bảng điều khiển.

const stats = await myPeerConnection.getStats();

stats.forEach((report) => {
  if (report.type === "data-channel") {
    // Ghi thông tin kênh
    console.log(report);
  }
});