All Products
Search

This Product

    ApsaraVideo VOD:Gunakan tool diagnostik Web Player SDK

    Document Center

    ApsaraVideo VOD:Gunakan tool diagnostik Web Player SDK

    Last Updated:Jun 11, 2026

    Web Player SDK dilengkapi tool diagnostik bawaan untuk mendiagnosis kegagalan pemutaran video dan masalah tersendat. Tool ini mengumpulkan data lingkungan dasar, status jaringan, serta log event pemutaran real-time sehingga Anda dapat mengidentifikasi penyebabnya tanpa alat eksternal.

    Prasyarat

    Sebelum memulai, konfigurasikan pengaturan berikut pada domain pemutaran video Anda:

    • Aktifkan Perlindungan hotlink untuk Referer dan tambahkan player.alicdn.com ke daftar putih. Untuk informasi selengkapnya, lihat Konfigurasi blacklist/whitelist alamat IP.

      Catatan

      player.alicdn.com adalah alamat statis untuk Aliplayer dan harus dimasukkan dalam daftar putih.

      Pada pengaturan Hotlink protection for Referer, kosongkan centang pada kotak Allow Direct Access from Browser Address Bar untuk memblokir permintaan CDN dengan Referer kosong.

    • Tambahkan header Access-Control-Allow-Origin ke domain pemutaran video Anda untuk mengaktifkan Berbagi sumber daya lintas asal (CORS). Untuk informasi selengkapnya, lihat Konfigurasi Berbagi sumber daya lintas asal.

    Diagnosis masalah pemutaran

    1. Buka tool diagnostik.

      Gunakan salah satu metode berikut:

      • Dari layar error pemutaran: Saat terjadi error pemutaran (misalnya, pesan "Failed to get the URL"), klik Diagnose pada layar error tersebut. Tool akan terbuka dengan kode error (code), ID video (vid), uuid, requestId, dan timestamp pemutaran yang telah diisi sebelumnya.

      • Secara langsung: Buka tool diagnostik.

    2. Tinjau informasi dasar.

      Tab Diagnostic Information menampilkan data lingkungan dan jaringan yang dikumpulkan dari sesi pengguna: - Informasi dasar: sistem operasi (misalnya, Windows NT 10.0) dan browser (misalnya, Chrome 90.0.4430.93) - Informasi jaringan: status Image CDN, status Script CDN, DNS lokal, ISP, dan alamat IP lokal

    3. Jalankan uji pemutaran.

      1. Pada tab Video Playback, pilih mode pemutaran dari menu Type: HTML5, Alibaba Cloud HTML5, atau Alibaba Cloud Flash.

      2. Masukkan parameter Source (URL pemutaran langsung) atau parameter Vid dan playAuth, lalu klik Play.

        Catatan

        Jika parameter Source dan Vid/playAuth keduanya diberikan, Source memiliki prioritas lebih tinggi.

      3. Baca log event pemutaran. Selama pemutaran berlangsung, tool akan menampilkan log event langsung di sisi kiri video. Setiap entri menunjukkan nama event dan timestamp-nya. Event berikut dicatat:

        Event

        Makna

        play

        Pemutaran dimulai

        waiting

        Menunggu data

        loadstart

        Memulai permintaan data

        progress

        Meminta data

        loadedmetadata

        Metadata sumber dimuat

        loadeddata

        Data frame saat ini dimuat

        canplay

        Data cukup untuk memulai pemutaran

        canplaythrough

        Data cukup untuk diputar hingga selesai tanpa buffering

        pause

        Pemutaran dijeda

        ended

        Pemutaran selesai

    Lihat juga

    Kode kesalahan