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ó type là remote-inbound-rtp.
Thuộc tính phiên bản
>Thống kê luồng đến từ xa
fractionLostOptional-
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.
localIdOptional-
Một chuỗi được dùng để tìm đối tượng
RTCOutboundRtpStreamStatscục bộ có cùng nguồn đồng bộ hóa (SSRC). roundTripTimeOptional-
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ệ.
roundTripTimeMeasurementsOptional-
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.
totalRoundTripTimeOptional-
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
totalRoundTripTimechoroundTripTimeMeasurements.
Thống kê luồng RTP được nhận
jitterOptional-
Một số cho biết jitter gói cho nguồn đồng bộ hóa này, đo bằng giây.
packetsLostOptional-
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.
packetsReceivedOptional 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
codecIdOptional-
Một chuỗi xác định duy nhất đối tượng được kiểm tra để tạo ra đối tượng
RTCCodecStatsliên kết với luồng RTP này. kind-
Một chuỗi cho biết liệu
MediaStreamTrackliê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.
transportIdOptional-
Một chuỗi xác định duy nhất đối tượng được kiểm tra để tạo ra đối tượng
RTCTransportStatsliê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
DOMHighResTimeStampchỉ 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ả.
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> |