RTCInboundRtpStreamStats
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
* Some parts of this feature may have varying levels of support.
Từ điển RTCInboundRtpStreamStats của WebRTC API được dùng để báo cáo các thống kê liên quan đến đầu nhận của một luồng RTP ở phía 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à inbound-rtp.
Thuộc tính phiên bản
audioLevel-
Một số chỉ ra mức âm thanh của track được nhận. Không xác định đối với luồng video.
bytesReceived-
Một số nguyên dương chỉ ra tổng số byte đã nhận được cho đến nay từ nguồn media này.
concealedSamples-
Một số nguyên dương chỉ ra số lượng mẫu phải được che giấu do nằm trong các gói bị mất hoặc đến quá muộn để phát. Không xác định đối với luồng video.
concealmentEvents-
Một số nguyên dương chỉ ra số lần xảy ra sự kiện che giấu, trong đó một sự kiện duy nhất được đếm cho tất cả các mẫu che giấu liên tiếp theo sau một mẫu không bị che giấu. Không xác định đối với luồng video.
estimatedPlayoutTimestampExperimental-
Một
DOMHighResTimeStampchỉ ra thời gian phát ước tính của track ở bộ nhận này. fecPacketsDiscarded-
Một số nguyên dương chỉ ra số gói RTP Forward Error Correction (FEC) đã nhận được cho nguồn này mà phần dữ liệu sửa lỗi đã bị bỏ qua.
fecPacketsReceived-
Một số nguyên dương chỉ ra tổng số gói Forward Error Correction (FEC) đã nhận được cho nguồn này.
frameHeight-
Một số nguyên dương chỉ ra chiều cao của khung hình được giải mã gần nhất, tính bằng pixel. Không xác định đối với luồng âm thanh và trước khi khung hình đầu tiên được giải mã.
framesAssembledFromMultiplePacketsExperimental-
Một số nguyên dương chỉ ra tổng số khung hình được giải mã đúng trong luồng RTP này được lắp ráp từ nhiều hơn một gói RTP. Không xác định đối với luồng âm thanh.
framesDecoded-
Một số nguyên kiểu long chỉ ra tổng số khung hình video đã được giải mã thành công cho đến nay từ nguồn media này. Đây là số khung hình sẽ được hiển thị nếu không có khung nào bị bỏ. Không xác định đối với luồng âm thanh.
framesPerSecond-
Một số nguyên dương chỉ ra số khung hình được giải mã trong giây vừa qua. Không xác định đối với luồng âm thanh.
framesReceived-
Một số nguyên dương chỉ ra tổng số khung hình hoàn chỉnh đã nhận được trên luồng RTP này. Không xác định đối với luồng âm thanh.
frameWidth-
Một số nguyên dương chỉ ra chiều rộng của khung hình được giải mã gần nhất, tính bằng pixel. Không xác định đối với luồng âm thanh và trước khi khung hình đầu tiên được giải mã.
freezeCountExperimental-
Một số nguyên dương chỉ ra tổng số lần đóng băng video mà bộ nhận này gặp phải. Không xác định đối với luồng âm thanh.
headerBytesReceived-
Một số nguyên dương chỉ ra tổng số byte tiêu đề và đệm RTP đã nhận cho SSRC này, bao gồm cả các lần truyền lại.
insertedSamplesForDeceleration-
Một số nguyên dương chỉ ra số lượng mẫu được chèn vào để làm chậm tốc độ phát từ bộ đệm jitter. Không xác định đối với luồng video.
jitterBufferDelay-
Một số chỉ ra tổng thời gian tích lũy mà tất cả các mẫu âm thanh và khung hình video hoàn chỉnh đã trải qua trong bộ đệm jitter, tính bằng giây.
jitterBufferEmittedCount-
Một số nguyên dương chỉ ra tổng số mẫu âm thanh và/hoặc khung hình video đã ra khỏi bộ đệm jitter.
jitterBufferMinimumDelay-
Một số chỉ ra độ trễ tối thiểu có thể đạt được chỉ dựa trên các đặc tính mạng như jitter và mất gói.
jitterBufferTargetDelay-
Một số chỉ ra tổng độ trễ mục tiêu của bộ đệm jitter tích lũy.
keyFramesDecoded-
Một số nguyên dương chỉ ra tổng số khung hình chính được giải mã thành công cho luồng media RTP này. Không xác định đối với luồng âm thanh.
lastPacketReceivedTimestamp-
Một
DOMHighResTimeStampchỉ ra thời điểm nhận được gói cuối cùng từ nguồn này. Ngược lại, thuộc tínhtimestampchỉ ra thời điểm đối tượng thống kê được tạo ra. mid-
Một chuỗi xác định duy nhất cặp nguồn và đích của luồng transceiver. Đây là giá trị của
RTCRtpTransceiver.midtương ứng trừ khi giá trị đó là null, trong trường hợp đó thuộc tính thống kê này không tồn tại. packetsDiscarded-
Một số nguyên dương chỉ ra tổng số gói RTP đã bị bộ đệm jitter loại bỏ do đến muộn hoặc sớm.
pauseCountExperimental-
Một số nguyên dương chỉ ra tổng số lần dừng video mà bộ nhận này gặp phải. Không xác định đối với luồng âm thanh.
playoutIdExperimental-
Một chuỗi xác định
RTCAudioPlayoutStatstương ứng cho luồng âm thanh. Không xác định đối với luồng video. remoteId-
Một chuỗi xác định đối tượng
RTCRemoteOutboundRtpStreamStatscung cấp thống kê cho peer từ xa với cùng SSRC này. ID này ổn định qua nhiều lần gọigetStats(). removedSamplesForAcceleration-
Một số nguyên dương chỉ ra số lượng mẫu bị loại bỏ để tăng tốc độ phát từ bộ đệm jitter. Không xác định đối với luồng video.
silentConcealedSamples-
Một số nguyên dương chỉ ra số lượng mẫu che giấu im lặng. Không xác định đối với luồng video.
totalAssemblyTimeExperimental-
Một số chỉ ra tổng thời gian dành để lắp ráp các khung hình video được giải mã thành công được truyền trong nhiều gói RTP, tính bằng giây. Không xác định đối với luồng âm thanh.
totalAudioEnergy-
Một số đại diện cho tổng năng lượng âm thanh của track được nhận trong suốt vòng đời của đối tượng thống kê. Không xác định đối với luồng video.
totalDecodeTime-
Một số chỉ ra tổng thời gian dành để giải mã các khung hình trong luồng này, tính bằng giây. Không xác định đối với luồng âm thanh.
totalFreezesDurationExperimental-
Một số dương chỉ ra tổng thời gian luồng bị đóng băng, tính bằng giây. Không xác định đối với luồng âm thanh.
totalInterFrameDelay-
Một số dương chỉ ra tổng thời gian giữa các khung hình được hiển thị liên tiếp, được ghi lại ngay sau khi một khung hình được hiển thị. Không xác định đối với luồng âm thanh.
totalPausesDurationExperimental-
Một số dương chỉ ra tổng thời gian luồng ở trạng thái dừng video, tính bằng giây. Không xác định đối với luồng âm thanh.
totalProcessingDelay-
Một số dương chỉ ra tổng thời gian xử lý các mẫu âm thanh hoặc video, tính bằng giây.
totalSamplesDuration-
Một số dương chỉ ra tổng thời lượng của tất cả các mẫu đã nhận được, tính bằng giây. Không xác định đối với luồng video.
totalSamplesReceived-
Một số nguyên dương chỉ ra tổng số mẫu đã nhận trên luồng này. Không xác định đối với luồng video.
totalSquaredInterFrameDelay-
Một số dương chỉ ra tổng bình phương của độ trễ giữa các khung hình được hiển thị liên tiếp, được ghi lại ngay sau khi một khung hình được hiển thị. Không xác định đối với luồng âm thanh.
trackIdentifier-
Một chuỗi cung cấp giá trị
idcủaMediaStreamTrackđược liên kết với luồng đến.
Các phép đo chỉ ở cục bộ
Các thuộc tính này được tính toán cục bộ và chỉ có sẵn cho thiết bị nhận luồng media. Mục đích chính của chúng là để xem xét khả năng chịu lỗi của kết nối, vì chúng cung cấp thông tin về các gói bị mất, khung hình bị mất và mức độ nén dữ liệu.
nackCount-
Một số chỉ ra số lần bộ nhận thông báo cho người gửi rằng một hoặc nhiều gói RTP đã bị mất bằng cách gửi gói Negative ACKnowledgement (NACK, còn gọi là "Generic NACK") cho người gửi. Giá trị này chỉ có sẵn cho bộ nhận.
qpSum-
Một số nguyên dương cung cấp tổng các giá trị QP cho mỗi khung hình được bộ nhận RTP này giải mã cho đến nay trên track video được mô tả bởi đối tượng thống kê này. Chỉ hợp lệ đối với luồng video.
Thống kê được đo ở đầu nhận của luồng RTP
Các thống kê này được đo ở đầu nhận của luồng RTP, bất kể đó là cục bộ hay từ xa.
packetsReceived-
Tổng số gói RTP đã nhận cho nguồn đồng bộ hóa (SSRC) này, bao gồm cả các lần truyền lại.
packetsLost-
Tổng số gói RTP bị mất cho nguồn đồng bộ hóa (SSRC) này. Lưu ý rằng giá trị này có thể âm vì có thể nhận được nhiều gói hơn so với bộ nhận mong đợi.
jitter-
Jitter gói của nguồn đồng bộ hóa (SSRC) này, được đo bằng giây.
Thống kê luồng RTP chung
codecId-
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
MediaStreamTrackliên kết với luồng là track âm thanh hay video. ssrc-
Số nguyên 32-bit xác định nguồn của các gói RTP mà đối tượng này cung cấp. Giá trị này được tạo theo đặc tả RFC 3550.
transportId-
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.
Thông số kỹ thuật
| Specification |
|---|
| Identifiers for WebRTC's Statistics API> # dom-rtcstatstype-inbound-rtp> |