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ó typeinbound-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.

estimatedPlayoutTimestamp Experimental

Một DOMHighResTimeStamp chỉ 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ã.

framesAssembledFromMultiplePackets Experimental

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ã.

freezeCount Experimental

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 DOMHighResTimeStamp chỉ 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ính timestamp chỉ 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.mid tươ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.

pauseCount Experimental

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.

playoutId Experimental

Một chuỗi xác định RTCAudioPlayoutStats tươ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 RTCRemoteOutboundRtpStreamStats cung 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ọi getStats().

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.

totalAssemblyTime Experimental

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.

totalFreezesDuration Experimental

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.

totalPausesDuration Experimental

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ị id của MediaStreamTrack đượ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 RTCCodecStats liên kết với luồng RTP này.

kind

Một chuỗi cho biết MediaStreamTrack liê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 RTCTransportStats liê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 DOMHighResTimeStamp chỉ 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

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

Xem thêm