WebRTC: Eski getStats() taşıma rehberi

Henrik Boström

Eski getStats() WebRTC API'si Chrome 117'de kaldırılacaktır. Bu nedenle, bu API'yi kullanan uygulamaların standart API'ye taşınması gerekecektir. Bu makalede, kodunuzu nasıl taşıyacağınız ve bu değişikliği yapmak için daha fazla zamana ihtiyacınız varsa ne yapmanız gerektiği açıklanmaktadır.

Geçmişte WebRTC getStats() API'nin birbiriyle rekabet eden iki sürümü olmuştur. Standartlaştırma işleminden önce gelen ve bir geri çağırma bağımsız değişkeni alan eski getStats() API'si ve bir taahhüt döndüren, standartlaştırılmış ve yaygın olarak desteklenen API.

Standart API daha fazla özelliğe sahiptir ve WebRTC'nin Tanımlayıcıları for WebRTC İstatistik API'si W3C spesifikasyonunda herkese açık şekilde belgelenmiş, iyi tanımlanmış metriklere sahiptir. Spesifikasyon, bu kılavuzda listelenen her bir metriğin açıklamasını ve daha fazlasını içerir.

Chrome 117'den itibaren eski getStats() API, Kararlı sürüm kanalında bir istisna oluşturacaktır (İstisna ekleme işlemi kademeli olarak kullanıma sunulacaktır). Standart API'ye geçişinizi kolaylaştırmak için bu kılavuzdaki adımları uygulayın.

Eski istatistik türleri ile standart istatistik türleri karşılaştırması

Standart istatistik türlerinin tam listesini, spesifikasyondaki RTCStatsType sıralamasına bakarak bulabilirsiniz. Her tür için toplanan metrikleri açıklayan istatistik sözlüğü tanımı da buna dahildir.

İstatistik nesnelerinin tümünde, birden fazla getStats() çağrısında temel nesneyi benzersiz şekilde tanımlayan bir id [no] özelliği vardır. Yöntem her çağrıldığında aynı nesne aynı kimliğe sahip olur. Bu, metriklerdeki değişim oranını hesaplamak için yararlıdır (sonraki bölümde bir örnek bulunmaktadır). Kimlikler ayrıca referans ilişkilerini de oluşturur. Örneğin, outbound-rtp istatistik nesnesi, outbound-rtp.mediaSourceId özelliği aracılığıyla ilişkilendirilmiş media-source istatistik nesnesine başvuruda bulunur. ...Id ilişkilerinin tümünü çizerseniz bir grafik elde edersiniz.

Eski API, standart türlere karşılık gelen aşağıdaki istatistik türlerine sahiptir:

Eski metrikleri standart metriklerle eşleme

Bu eşlemenin amacı, geliştiricilerin hangi eski metriğin hangi standart metriğe karşılık geldiğini bulmalarına yardımcı olmaktır. Ancak ilgili metriğin farklı birimler kullanabileceğini veya anlık bir değer yerine toplam sayaç olarak ifade edilebileceğini unutmayın. Metrik tanımları için spesifikasyona bakın.
. Standart API, ücretler yerine toplam sayaçları göstermeyi tercih eder. Yani, eski API'de olduğu gibi karşılık gelen hızı (ör. bit hızı) almak için uygulamanın iki getStats() çağrısı arasındaki deltayı alarak ortalama hızı hesaplaması gerekir. Örneğin:

// 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;

Ücretleri ve ortalamaları kendiniz bu şekilde hesaplamak zahmetli bir ek adım gibi görünse de, istenen herhangi bir zaman aralığındaki ortalamaları elde etmenize olanak sağlaması açısından avantajlıdır. Standart API'yi, eski API'yi kullanmak zorunda kaldığınızdan daha seyrek çağırmanın bazı performans avantajları vardır.

Standart API, simulcast duyarlı

Simulcast kullanıyorsanız, (örneğin) üç ayrı SSRC'de üç RTP akışı göndermek için simulcast'i kullanıyor olsanız bile eski API'nin yalnızca tek bir SSRC raporladığını fark etmiş olabilirsiniz.

Standart API bu sınırlamayı paylaşmaz ve her SSRC için bir tane olmak üzere üç outbound-rtp istatistik nesnesi döndürür. Bu, her bir RTP akışını ayrı ayrı analiz edebileceğiniz anlamına gelir, ancak aynı zamanda tüm RTP gönderme akışlarının toplam bit hızını elde etmek için bunları kendiniz toplamanız gerekir.

Diğer yandan scalabilityMode API'si aracılığıyla yapılandırılan birden fazla mekansal katmana sahip SVC akışları veya RTP akışları, tek bir SSRC üzerinden gönderildiğinden yine tek bir outbound-rtp olarak görünür.

Taşıma için daha fazla zamana ihtiyacınız varsa

Eski API, Chrome 117'de kaldırıldığında bu API'nin kullanılması bir istisna oluşturur. Kodunuzu zamanında taşıyamıyorsanız RTCPeerConnection geri çağırmaya dayalı getStats() API'sinin kaynak denemesi, kayıtlı web sitelerinin taşınması için daha fazla zaman tanır. Kaynak deneme jetonuyla eski getStats() API, Chrome 121'e kadar kullanılmaya devam edebilir.