Tüm Ürünler
Search
Belge Merkezi

ApsaraVideo Live:SDK kalite izleme

Son Güncelleme:Oct 02, 2026

Uygulamanızda ApsaraVideo Player SDK kullanıyorsanız, SDK tarafından raporlanan olay izleme verileri aracılığıyla hizmet kalitesini (QoS) izleyebilirsiniz. Oynatma başarı oranı, anında başlatma oranı ve takılma oranı gibi temel ölçümler, canlı yayın kalitesini hızla değerlendirmenize olanak tanır.

Nasıl çalışır

Canlı oynatma veri hizmeti, ApsaraVideo Player SDK tarafından raporlanan olay izleme verilerine dayanır. Aşağıdaki diyagram olay izleme mantığını göstermektedir.

image.png

Kullanım notları

  1. ApsaraVideo MediaBox SDK'yı kullanmanız, lisansınızın geçerli olduğundan emin olmanız ve veri raporlama özelliğini etkinleştirmeniz gerekir.

  2. Yerel player SDK sürüm 5.4.9.2 ve üzeri desteklenir.

  3. Web player SDK sürüm 2.16.0 ve üzeri desteklenir.

  4. Player SDK'yı indirmek için bkz. SDK'ya genel bakış. Lisanslama bilgileri için bkz. Lisans Yönetimi.

Oynatma verileri

  1. ApsaraVideo Live konsoluna giriş yapın.

  2. Sol gezinme bölmesinde Live Center > Data Monitoring > SDK Quality Monitoring seçeneğini tıklayın.

  3. Playback Data sekmesinde bir uygulama adı seçin ve Query seçeneğini tıklayın.

    Not

    Uygulama adı, ApsaraVideo Player SDK lisansınız için yapılandırılan uygulama başlığıyla eşleşmelidir. Aksi takdirde sorgu veri döndürmez.

    Verileri aşağıdaki boyutlara göre filtreleyebilirsiniz:

    • İstemci türüne, işletim sistemi türüne, çözünürlüğe ve ağ türüne göre filtreleme yapabilirsiniz.

    • Son üç gün içindeki özel bir zaman aralığı için veri sorgulayabilirsiniz. Tek bir sorgu birden fazla günü kapsayamaz.

    • SDK sürümü, kodlama biçimi, video biçimi, donanım kod çözme durumu, internet servis sağlayıcısı, alan adı veya il bazında filtreleme yapmak için New Filter Condition seçeneğini tıklayın. Sık kullanılan filtre kurallarını gelecekte kullanmak üzere kaydedebilirsiniz.

  4. Uygulama genel bakışı, oynatma hizmetinin kalitesini değerlendirmenize yardımcı olmak için aşağıdaki QoS ölçümlerini sunar.

    Not

    Ortalama oynatma kare hızı (fps) ölçümü yalnızca video senaryolarında mevcuttur. Diğer ölçümler sadece sesli ve sesli-video senaryolarında kullanılabilir.


    Ölçüm


    Açıklama


    Ortalama ilk kare süresi (ms)


    Kullanıcı oynatma isteğinde bulunduktan sonra ilk karenin oluşturulması için geçen süre.


    Süre bazında takılma oranı (%)


    Toplam takılma süresinin toplam oynatma süresine yüzdesel oranı. Formül: Toplam takılma süresi / Toplam oynatma süresi.


    Ortalama oynatma kare hızı (fps)


    Oynatma sırasında saniyede oluşturulan ortalama video kare sayısı.


    Aşağı yönlü bit hızı (Kbps)


    Canlı oynatma sırasındaki ağ indirme hızı.


    Anında başlatma oranı (%)


    1 saniye içinde oynatmaya başlayan akışların yüzdesi. Formül: ≤ 1 sn içinde başlayan akış sayısı / Toplam oynatma oturumu sayısı.


    Yavaş başlatma oranı (%)


    Başlaması 3 saniye veya daha uzun süren akışların yüzdesi. Formül: ≥ 3 sn içinde başlayan akış sayısı / Toplam oynatma oturumu sayısı.


    Oynatma başarı oranı (%)


    Başarılı oynatma oturumlarının yüzdesi. Formül: Başarılı oynatma sayısı / Toplam oynatma sayısı.


    CPU kullanımı (%)


    Canlı oynatma sırasında tüketilen CPU kaynaklarının yüzdesi.

Tek nokta izleme

Bir oynatma hatası oluşursa, belirli bir kullanıcıyı veya oturumu uçtan uca izlemek için Tek Nokta İzleme özelliğini kullanın. Bu, kök nedenleri teşhis etmenize ve izleyici deneyimini iyileştirmenize yardımcı olur.

  1. ApsaraVideo Live konsoluna giriş yapın.

  2. Sol gezinme bölmesinde Live Center > Data Monitoring > SDK Quality Monitoring seçeneğini tıklayın.

  3. Single-point Tracing sekmesini tıklayın ve sorguyu çalıştırmak için player oluşturma sırasında sağlanan TraceID veya UUID bilgisini girin.

    Sorgu için bir tarih aralığı belirleyebilirsiniz. Sonuçlar arasında ilk kare süresi trend grafiği ve bir veri tablosu bulunur. Tablo sütunları şunları içerir: TraceID, Video ID/URL, SessionID, First Frame Duration (ms), Status, Current Playback Duration (s) ve Stuttering Duration (ms).

  4. Actions sütununda, bir oturumun ayrıntılı bilgilerini görüntülemek için View Details seçeneğini tıklayın.

İlgili belgeler

SDK'ya genel bakış