All Products
Search

This Product

    ApsaraVideo VOD:Menangani masalah pemutaran video

    Document Center

    ApsaraVideo VOD:Menangani masalah pemutaran video

    Last Updated:Jun 22, 2026

    Topik ini menjelaskan cara mengidentifikasi dan menyelesaikan masalah pemutaran video.

    Strategi troubleshooting

    Pemutaran video dapat gagal karena berbagai alasan. Untuk mengidentifikasi penyebabnya, pertama-tama periksa apakah error tersebut mengikuti pola tertentu. Jika iya, gunakan daftar kemungkinan penyebab dalam tabel berikut sebagai panduan investigasi Anda. Jika tidak ada pola yang jelas, lakukan troubleshooting dengan memeriksa perangkat akhir, aliran media, dan jaringan. Jika Anda masih belum dapat mengidentifikasi penyebabnya, hubungi dukungan teknis Alibaba Cloud.

    • Error dengan pola distribusi:

      Pola error

      Kemungkinan penyebab

      Pemutaran gagal untuk pengguna di jaringan ISP atau wilayah tertentu.

      Masalah ini mungkin disebabkan oleh gangguan jaringan penyedia layanan lokal atau isu penjadwalan CDN di wilayah tersebut.

      Pemutaran gagal pada perangkat akhir dengan sistem operasi tertentu.

      Masalah ini mungkin disebabkan oleh perbedaan implementasi SDK di berbagai platform atau isu kompatibilitas sistem.

      Pemutaran gagal pada merek atau model perangkat akhir tertentu.

      Masalah ini mungkin disebabkan oleh isu kompatibilitas perangkat.

      Pemutaran gagal untuk file audio atau video tertentu.

      Masalah ini mungkin disebabkan oleh masalah pengkodean file media, pra-ambil (prefetch) CDN, atau kebijakan akses bisnis.

    • Error tanpa pola distribusi yang jelas: Penyebabnya mungkin kompleks. Dalam kasus ini, lacak alur kerja dari konten hingga pengguna untuk mengidentifikasi node bermasalah dan menentukan akar permasalahan.

    Langkah 1: Periksa perangkat akhir

    Kompatibilitas perangkat akhir

    Pertama, verifikasi bahwa protokol aliran media didukung oleh sistem operasi dan lingkungan aplikasi. Jika tidak, Anda harus melakukan transkoding aliran tersebut. Untuk informasi lebih lanjut, lihat Rekomendasi transkoding. Tabel berikut mencantumkan protokol dan kodek video yang didukung oleh SDK Player.

    Aplikasi Native

    Sistem operasi

    Kodek video

    Protokol video

    Kodek audio

    Android

    • H.264

    • H.265

    • MP4

    • HLS

    • FLV

    • MPEG-DASH (SegmentBase dan SegmentTemplate)

    • AAC

    • MP3

    iOS

    Windows

    macOS

    Linux

    Web

    Catatan

    Jika protokol aliran media memenuhi persyaratan kompatibilitas web di bawah ini, verifikasi bahwa Anda memiliki sertifikat SSL dan telah mengaktifkan akses lintas-origin. Untuk informasi lebih lanjut, lihat Aktifkan percepatan aman HTTPS dan Konfigurasi akses lintas-origin.

    Sistem operasi

    Kodek video

    Protokol video

    Kodek audio

    Android

    H.264

    • MP4

    • HLS (Didukung sebagian. Beberapa browser memerlukan MSE. Lihat tabel di bawah untuk detailnya.)

    • FLV (Memerlukan MSE)

    • AAC

    • MP3

    iOS

    H.264

    • MP4

    • HLS

    Catatan

    FLV dan MPEG-DASH tidak didukung.

    H.265

    • MP4

    • HLS (memerlukan segmen fMP4)

    Windows

    H.264

    • MP4

    • HLS (Memerlukan MSE)

    • FLV (Memerlukan MSE)

    macOS

    H.264

    • MP4

    • HLS

    • FLV (Memerlukan MSE)

    H.265

    • MP4

    • HLS (memerlukan segmen fMP4)

    Beberapa browser di perangkat Android memerlukan MSE untuk memutar video HLS. Detailnya sebagai berikut:

    Browser di perangkat Android

    Dukungan HLS

    WeChat

    Didukung

    DingTalk

    Didukung

    UC/Quark

    Didukung

    QQ Browser

    Didukung

    Chrome

    Memerlukan MSE

    Huawei Browser

    Memerlukan MSE

    OPPO Browser

    Didukung

    vivo Browser

    Didukung

    Mi Browser

    Memerlukan MSE

    Kompatibilitas SDK Player

    Jika perangkat Anda memenuhi persyaratan kompatibilitas, gunakan player lain untuk memeriksa apakah masalah tersebut terkait dengan kompatibilitas SDK ApsaraVideo Player.

    • Jika video diputar dengan benar di player lain, kemungkinan masalah terletak pada SDK ApsaraVideo Player. Dalam hal ini, hubungi dukungan teknis.

    • Jika video juga gagal diputar di player lain, Anda perlu memeriksa aliran media dan jaringan.

    Kami menyarankan menggunakan player berikut untuk troubleshooting:

    • Player pihak ketiga: VLC

    • Player sistem: ExoPlayer (Android), AVPlayer (iOS)

    • Browser sistem (hanya Web): Chrome (Android, Windows), Safari (iOS, macOS)

    Langkah 2: Periksa aliran media

    Setelah mengesampingkan penyebab-penyebab sebelumnya, lakukan transkoding pada aliran media dan coba putar kembali. Jika berhasil diputar, kemungkinan besar aliran asli dikodekan secara tidak tepat.

    Catatan

    Video MP4 mungkin dimulai secara lambat atau video MOV mungkin gagal diputar jika atom moov (indeks data media) berada setelah atom mdat (data media). Melakukan transkoding video sumber untuk memindahkan atom moov sebelum atom mdat dapat mempercepat penguraian pemutaran.

    • Gunakan perintah berikut untuk memeriksa posisi atom moov:

      # URL video sumber dapat berupa path file lokal atau URL online, misalnya, http://pla****.alicdn.com/video/aliyunmedia.mp4
ffmpeg -v trace -i "source_video_url" 2>&1 | grep -e type:\'mdat\' -e type:\'moov\'

      Dalam skenario normal, atom moov berada sebelum atom mdat, yang menunjukkan adanya optimasi faststart. Contoh output ditampilkan di bawah ini.

      # ffmpeg -v trace -i sample_faststart.mp4 2>&1 | grep -e type:\'mdat\' -e type:\'moov\'
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x54d3b80] type:'moov' parent:'root' sz: 603629 40 231901466
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x54d3b80] type:'mdat' parent:'root' sz: 231297797 603677 231901466

      Dalam skenario abnormal, atom moov berada setelah atom mdat.

      # ffmpeg -v trace -i sample.mp4 2>&1 | grep -e type:"mdat" -e type:"moov"
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x59e1b80] type:'mdat' parent:'root' sz: 231297797 48 231901466
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x59e1b80] type:'moov' parent:'root' sz: 603629 231297845 231901466

    • Gunakan perintah berikut atau tool baris perintah ffprobe (tool ffprobe) untuk menanyakan informasi seperti kodek audio dan kodek video dari file sumber. Hal ini membantu Anda menganalisis apakah video bermasalah memiliki pola yang sama:

      ffprobe "input.mp4" atau ffprobe "source_video_url"

      Input #0, mov, mp4, m4a, 3gp, 3g2, mj2, from 'input.mp4':
    Metadata:
      major_brand     : isom
      minor_version   : 512
      compatible_brands: isomiso2avc1mp41
      encoder         : www.aliyun.com - Media Transcoding
    Duration: 00:00:17.56, start: 0.000000, bitrate: 3088 kb/s
    Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 1440x2560, 2890 kb/s, 25 fps, 25 tbr, 12800 tbn, 50 tbc (default)
      Metadata:
        handler_name    : VideoHandler
    Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 191 kb/s (default)
      Metadata:
        handler_name    : SoundHandler

    Rekomendasi transkoding

    • Output transkoding: Kami menyarankan melakukan transkoding ke aliran video H.264 MP4 atau HLS.

    • Metode transkoding: Kami menyarankan menggunakan layanan Alibaba Cloud atau tool lokal berikut.

      Kategori

      Layanan atau tool

      Deskripsi

      Layanan Alibaba Cloud

      ApsaraVideo VOD

      ApsaraVideo VOD menyediakan kemampuan transkoding dan transmuxing yang komprehensif untuk memenuhi berbagai kebutuhan konversi format media. Layanan ini mendukung transkoding standar, Narrowband HD 1.0, Narrowband HD 2.0, dan transkoding kualitas sumber. Untuk informasi lebih lanjut, lihat Transkoding audio dan video.

      ApsaraVideo Media Processing (MPS)

      ApsaraVideo Media Processing (MPS) melakukan transkoding data multimedia ke format yang sesuai untuk pemutaran di semua platform. Layanan ini mendukung transkoding standar, Narrowband HD 1.0, Narrowband HD 2.0, transkoding berkecepatan tinggi, dan transkoding penggandaan resolusi. Layanan ini ideal bagi pengguna yang menyimpan file video sumber di bucket OSS mereka sendiri. Untuk informasi lebih lanjut, lihat Transkoding media.

      Intelligent Media Services (IMS)

      Intelligent Media Services (IMS) menyediakan kemampuan transkoding on-demand dan transkoding real-time. Layanan ini mendukung transkoding media yang disimpan di OSS atau ApsaraVideo VOD, serta transkoding aliran langsung.

      Tool lokal

      FFmpeg Codecs

      Unduh di: FFmpeg Codecs

    Langkah 3: Periksa jaringan

    Jika langkah-langkah sebelumnya belum menyelesaikan masalah, periksa transmisi jaringan untuk menemukan penyebab error pemutaran.

    1. Verifikasi bahwa perangkat akhir memiliki koneksi jaringan yang stabil.

      • Wi-Fi: Apakah jaringan saat ini stabil dan dapat diakses? Apakah kecepatan jaringan downstream lebih besar dari atau sama dengan bitrate video?

        Anda dapat menggunakan Speedtest.net untuk memeriksa kecepatan jaringan downstream. Jika kecepatan lebih rendah daripada bitrate video, kegagalan pemuatan atau pemutaran tersendat-sendat dapat terjadi.

      • Jaringan seluler: Apakah perangkat terhubung ke jaringan berkecepatan tinggi seperti 4G atau 5G? Bagaimana kekuatan sinyalnya?

        Dalam kondisi jaringan lemah, kecepatan mungkin tidak cukup untuk memuat aliran media.

      Catatan

      Jika Anda mengalami pembajakan DNS, konfigurasikan DNS Anda secara manual ke Alibaba Cloud Public DNS (223.5.5.5, 223.6.6.6) untuk memulihkan pemutaran.

      1. Buka Settings > Wi-Fi di perangkat seluler Anda.

      2. Ketuk tombol detail di sebelah kanan jaringan Anda saat ini untuk membuka halaman detail jaringan.

      3. Konfigurasikan DNS.

        Di halaman konfigurasi jaringan, Anda akan menemukan tiga bagian: IP address (subnet, gateway), IPv6 address (alamat IP, gateway), dan DNS. Ketuk panah di sebelah entri DNS untuk membuka konfigurasi detail.

    2. Periksa apakah percepatan CDN telah diaktifkan.

      • Jika percepatan CDN belum diaktifkan, kami menyarankan untuk mengonfigurasinya guna meningkatkan pengalaman pemutaran. Untuk informasi lebih lanjut, lihat Tambahkan nama domain yang dipercepat.

      • Jika percepatan CDN telah diaktifkan:

        • Isu konfigurasi CDN: Apakah konten media telah dipra-ambil? Apakah cache konten telah kedaluwarsa?

          Cache miss CDN, yang disebabkan oleh konten yang belum dipra-ambil atau cache yang kedaluwarsa, dapat menyebabkan kegagalan pemuatan atau pemutaran tersendat-sendat. Masalah ini umum terjadi pada video yang baru diunggah. Kami menyarankan untuk secara aktif melakukan pra-ambil konten untuk video baru. Untuk informasi lebih lanjut, lihat Segarkan dan pra-ambil sumber daya.

        • Isu lainnya: Apakah video dari aplikasi lain diputar secara normal di perangkat akhir yang sama?

          Jika CDN dikonfigurasi dengan benar dan aplikasi lain dapat memutar video tanpa masalah, error pemutaran mungkin disebabkan oleh masalah penjadwalan CDN lokal.

    3. Periksa lokasi server origin dan pengguna akhir Anda.

      Jika server origin berada di Tiongkok daratan dan pengguna berada di luar negeri, tersendat-sendat yang signifikan dapat terjadi. Dalam kasus ini, deploy server origin di wilayah yang lebih dekat dengan pengguna Anda untuk meningkatkan performa.

    4. Periksa waktu tontonan puncak.

      Jika terlalu banyak orang menonton pada waktu yang sama, server origin mungkin melakukan pengendalian aliran (throttle) trafik, sehingga menyebabkan pemutaran tersendat-sendat.

    Dokumen terkait

    Jika Anda masih belum dapat mengidentifikasi penyebabnya setelah mengikuti langkah-langkah di atas, periksa dokumen berikut untuk kasus dan solusi serupa:

    Hubungi dukungan teknis

    Jika masalah tetap berlanjut, kirimkan tiket. Untuk informasi lebih lanjut tentang cara mengirimkan tiket, lihat Kontak Kami.

    Untuk membantu kami menyelesaikan masalah Anda secara efisien, sertakan informasi berikut dalam tiket Anda.

    Item

    Contoh

    Deskripsi

    Sistem operasi dan platform perangkat

    Android 9, Xiaomi

    Sertakan merek perangkat dan versi sistem operasi, contohnya: Xiaomi dengan Android 9, iOS 15, Windows 11, atau macOS 12.

    SDK dan versi

    Android SDK 5.4.8.0

    Tentukan SDK Player yang Anda gunakan beserta nomor versinya. SDK Player meliputi Web SDK, Android SDK, iOS SDK, Flutter SDK, dan Windows SDK.

    Sumber video

    https://xxxxxx.m3u8

    Sertakan URL sumber video atau file video yang mereproduksi masalah tersebut.

    Deskripsi masalah, log, dan rekaman layar

    Pemutaran dimulai pukul 16.40 pada 29 Agustus 2022, dan tersendat-sendat terjadi sekitar pukul 17.00. Log dilampirkan.

    Jelaskan langkah reproduksi dan gejala yang diamati secara rinci, termasuk timestamp spesifik. Untuk masalah yang dapat direproduksi, sertakan log lengkap dari langkah reproduksi. Untuk informasi tentang cara mendapatkan log, lihat Dapatkan log di Android atau Dapatkan log di iOS. Jika perlu, lampirkan rekaman layar.

    Pola error

    Masalah hanya terjadi pada perangkat Android, tidak pada iOS. Masalah selalu dapat direproduksi.

    Jelaskan apakah masalah mengikuti pola tertentu dan frekuensinya. Misalnya, tentukan apakah masalah terbatas pada sumber video, platform perangkat, atau versi SDK tertentu, serta apakah masalah bersifat intermiten atau selalu dapat direproduksi.