全部产品
Search
文档中心

ApsaraVideo VOD:Pemantauan kualitas pemutaran (Legacy)

更新时间:Jan 29, 2026

Jika aplikasi Anda menggunakan ApsaraVideo Player SDK untuk memutar video, Anda dapat memanfaatkan layanan Pemantauan Kualitas Pemutaran guna memantau kualitas pemutaran dan perilaku menonton pengguna. Layanan ini menganalisis data instrumentasi yang dilaporkan oleh ApsaraVideo Player SDK serta menyediakan berbagai metrik—seperti laju kegagalan pemutaran, laju tampilan frame pertama, dan laju tersendat—untuk membantu Anda menilai kualitas pemutaran video secara cepat.

Deskripsi metrik

Metrik QoS

Metrik Quality of Service (QoS) membantu Anda memahami kualitas layanan pemutaran aplikasi Anda.

Metric

Calculation method

Description

Playback count

Jumlah total kali video diputar. Hitungan tercatat setiap kali ApsaraVideo Player SDK dipanggil untuk memulai pemutaran.

Pemutaran dihitung ketika aplikasi memanggil ApsaraVideo Player SDK untuk memulai pemutaran (prepare) untuk pertama kalinya. Skenario lain tidak dihitung sebagai pemutaran baru. Misalnya, memanggil play setelah jeda atau pemutaran berikutnya dalam mode loop playback tidak dihitung sebagai pemutaran baru.

Actual playback count

Actual playback count = Total playback count - Total playback failures - Playback start churns

Laju kegagalan memulai pemutaran biasanya dapat diabaikan.

First frame time (ms)

Waktu dari saat pengguna memulai permintaan pemutaran dengan memanggil ApsaraVideo Player SDK hingga frame pertama dirender.

Jika pemutaran tidak dimulai, tidak ada first frame time.

Metrik QoE

Metrik Quality of Experience (QoE) membantu Anda memahami perilaku menonton pengguna aplikasi Anda.

Metric

Calculation method

Description

Number of users

Hitungan unik berdasarkan ID pengguna. ApsaraVideo Player SDK menghasilkan universally unique identifier (UUID).

Jumlah total pengguna yang menonton video dalam rentang waktu tertentu. Ini adalah jumlah Pengguna aktif aplikasi yang memanggil ApsaraVideo Player SDK. Untuk klien mobile, pengguna unik diidentifikasi berdasarkan device ID.

Playbacks per user

Playbacks per user = Playback count ÷ Number of users

-

Average video duration (seconds)

AVG(Video duration)

Durasi rata-rata semua video yang ditonton pengguna.

Prasyarat

Sebelum menggunakan fitur Pemantauan Kualitas Pemutaran:

  • Fitur Pemantauan Kualitas Pemutaran hanya tersedia untuk versi ApsaraVideo Player SDK berikut: V5.4.9.2 atau lebih baru untuk Android dan iOS, serta V2.16.0 atau lebih baru untuk Web. Untuk informasi selengkapnya, lihat Download the ApsaraVideo Player SDK.

  • ApsaraVideo Player SDK untuk Android, iOS, dan Web memerlukan lisensi yang valid. Untuk informasi selengkapnya, lihat Obtain a license.

  • Pastikan fitur pelaporan log ApsaraVideo Player SDK telah diaktifkan. Fitur ini diaktifkan secara default.

  • Opsional: Saat membuat player, sertakan traceId. Anda kemudian dapat menggunakan single-point tracking untuk melokalisasi pengguna atau perangkat tertentu, menganalisis perilaku pemutaran mereka, dan mengidentifikasi masalah—seperti error pemutaran—secara cepat. Untuk informasi tentang cara menyertakan traceId, lihat Basic features of ApsaraVideo Player for Android, Basic features of ApsaraVideo Player for iOS, dan Web player API reference.

Batasan

Anda dapat mengkueri data pemutaran untuk 3 hari terakhir. Satu kueri tidak boleh mencakup beberapa hari sekaligus.

Prosedur

  1. Masuk ke ApsaraVideo VOD console.

  2. Di panel navigasi sebelah kiri, pilih Data Center > Playback Quality Monitoring untuk membuka halaman Pemantauan Kualitas Pemutaran.

  3. Anda dapat melihat data metrik berdasarkan dimensi.

    播放质量监控1.png

    Anda dapat memfilter dan mengkueri data menggunakan dimensi berikut:

    • Filter dan kueri data berdasarkan dimensi seperti jenis terminal, jenis sistem, resolusi, dan jenis jaringan.

    • Kueri data untuk rentang waktu kustom mulai dari jam terakhir hingga 3 hari terakhir.

    • Anda dapat mengklik Add Filter Condition untuk mengatur kondisi filter, seperti versi SDK, format video, hardware decoding, ISP, nama domain, dan provinsi. Aturan filter yang sering digunakan dapat disimpan untuk penggunaan di masa mendatang. Tabel berikut menjelaskan kondisi filter tersebut.

      Condition

      Description

      SDK version

      Nomor versi ApsaraVideo Player SDK yang diintegrasikan ke dalam aplikasi saat ini.

      Video format

      Mengacu pada format file video, seperti HLS atau FLV.

      Hardware decoding

      Menunjukkan apakah hardware decoding diaktifkan untuk decoding video.

      Carrier

      Membedakan data pemutaran berdasarkan internet service provider (ISP).

      Domain name

      Alamat server tempat konten video berada.

      Country

      Membagi data pemutaran berdasarkan lokasi geografis pengguna.

      Chinese provinces

      Mempersempit cakupan data pemutaran ke wilayah administratif provinsi.