WebRTC: Hướng dẫn di chuyển getStats() cũ

Henrik Boström

API WebRTC getStats() cũ sẽ bị xoá trong Chrome 117. Do đó, các ứng dụng đang dùng API này sẽ cần chuyển sang API chuẩn. Bài viết này giải thích cách di chuyển mã và việc cần làm nếu bạn cần thêm thời gian để thực hiện thay đổi này.

Trước đây, có hai phiên bản cạnh tranh của API WebRTC getStats(). API getStats() cũ, chạy trước quy trình chuẩn hoá và nhận đối số gọi lại, cũng như API được chuẩn hoá và hỗ trợ rộng rãi sẽ trả về một kết quả hứa hẹn.

API tiêu chuẩn có nhiều tính năng phong phú hơn và có các chỉ số được xác định rõ ràng được ghi lại công khai trong Giá trị nhận dạng cho API thống kê của WebRTC thông số kỹ thuật W3C. Đặc tả bao gồm phần mô tả của từng chỉ số được liệt kê trong hướng dẫn này và nhiều chỉ số khác.

Từ Chrome 117, API getStats() cũ sẽ gửi một ngoại lệ vào Kênh phát hành chính thức (việc gửi ngoại lệ sẽ được triển khai dần). Hãy làm theo hướng dẫn này để dễ dàng chuyển sang API tiêu chuẩn.

Loại số liệu thống kê cũ so với số liệu thống kê chuẩn

Bạn có thể tìm thấy danh sách đầy đủ các loại số liệu thống kê chuẩn bằng cách xem enum RTCStatsType trong thông số kỹ thuật. Điều này bao gồm việc định nghĩa từ điển thống kê nào mô tả các chỉ số được thu thập cho từng loại.

Tất cả các đối tượng thống kê đều có thuộc tính mã nhận dạng duy nhất đối tượng cơ bản trong nhiều lệnh gọi getStats(). Cùng một đối tượng sẽ có cùng mã nhận dạng mỗi khi phương thức này được gọi. Điều này rất hữu ích khi tính toán tốc độ thay đổi của các chỉ số (có ví dụ trong phần tiếp theo). Các mã nhận dạng này cũng hình thành mối quan hệ tham chiếu. Ví dụ: đối tượng số liệu thống kê outbound-rtp tham chiếu đến đối tượng số liệu thống kê media-source được liên kết thông qua thuộc tính outbound-rtp.mediaSourceId. Nếu vẽ tất cả các mối quan hệ ...Id, bạn sẽ nhận được một biểu đồ.

API cũ có các loại số liệu thống kê sau, tương ứng với các loại tiêu chuẩn như sau:

Liên kết từ cũ sang chỉ số chuẩn

Việc liên kết này nhằm giúp nhà phát triển tìm ra chỉ số cũ tương ứng với chỉ số chuẩn nào. Tuy nhiên, xin lưu ý rằng chỉ số tương ứng có thể dùng các đơn vị khác nhau hoặc được biểu thị dưới dạng bộ đếm tổng thay vì giá trị tức thời. Hãy tham khảo quy cách để biết định nghĩa về các chỉ số.
API tiêu chuẩn ưu tiên hiển thị tổng số bộ đếm thay vì giá. Tức là để có được tốc độ tương ứng (ví dụ: tốc độ bit) như trong API cũ, ứng dụng phải tính tốc độ trung bình bằng cách thực hiện delta giữa 2 lệnh gọi getStats(). Ví dụ:

// Periodically (e.g. every second or every 10 seconds)...
const currReport = await pc.getStats();
// Calculate bitrate since the last getStats() call.
// Handling of undefined is omitted for clarity.
const currOutboundRtp = currReport.values().find(s => s.type == 'outbound-rtp');
const prevOutboundRtp = prevReport.get(currOutboundRtp.id);
const deltaBits = (currOutboundRtp.bytesSent - prevOutboundRtp.bytesSent) * 8;
const deltaSeconds = (currOutboundRtp.timestamp - prevOutboundRtp.timestamp) / 1000;
logBitrateMeasurement(deltaBits / deltaSeconds);
// Remember the report for next time.
prevReport = currReport;

Việc phải tự tính toán tốc độ và tính trung bình như thế này có vẻ là một bước bổ sung rườm rà, nhưng nó có ưu điểm là giúp bạn có được số liệu trung bình trong bất kỳ khoảng thời gian mong muốn nào. Việc gọi API chuẩn ít thường xuyên hơn so với việc bạn phải thực hiện với API cũ có một số lợi ích về hiệu suất.

API tiêu chuẩn có thể nhận biết bằng mô phỏng

Nếu sử dụng simulcast, bạn có thể nhận thấy rằng API cũ chỉ báo cáo một SSRC duy nhất ngay cả khi bạn đang sử dụng simulcast để gửi (ví dụ) 3 luồng RTP qua 3 SSRC riêng biệt.

API tiêu chuẩn không có chung giới hạn này và sẽ trả về 3 đối tượng số liệu thống kê outbound-rtp, mỗi đối tượng cho một SSRC. Điều này có nghĩa là bạn có thể phân tích riêng từng luồng RTP, nhưng cũng có nghĩa là để có được tổng tốc độ bit của tất cả các luồng gửi RTP, bạn cần tự tổng hợp các luồng đó.

Mặt khác, luồng SVC hoặc luồng RTP có nhiều lớp không gian được định cấu hình thông qua API scalabilityMode vẫn hiển thị dưới dạng một outbound-rtp duy nhất vì những luồng này được gửi qua một SSRC.

Nếu bạn cần thêm thời gian để di chuyển

Khi API cũ bị xoá trong Chrome 117, việc sử dụng API này sẽ tạo ra một trường hợp ngoại lệ. Nếu bạn không thể di chuyển mã kịp thời, bản dùng thử theo nguyên gốc cho API getStats() dựa trên lệnh gọi lại RTCPeerConnection sẽ giúp các trang web đã đăng ký có thêm thời gian để di chuyển. Khi sử dụng mã thông báo dùng thử theo nguyên gốc, bạn có thể tiếp tục sử dụng API getStats() cũ cho đến Chrome 121.