All Products
Search
Document Center

ApsaraVideo VOD:Troubleshoot playback errors

Last Updated:Mar 01, 2026

Diagnosis dan atasi kegagalan pemutaran video dengan memeriksa tiga area secara berurutan: kompatibilitas perangkat, integritas aliran media, dan konektivitas jaringan.

Identifikasi pola error

Sebelum memulai troubleshooting, tentukan apakah error tersebut mengikuti suatu pola. Error berpola memiliki akar penyebab spesifik yang lebih mudah diisolasi dibandingkan kegagalan acak.

Error patternLikely cause
Mempengaruhi pengguna di wilayah tertentu atau pada ISP tertentuMasalah jaringan ISP atau kesalahan penjadwalan Alibaba Cloud CDN
Mempengaruhi pengguna pada sistem operasi tertentuPerbedaan implementasi SDK atau masalah kompatibilitas sistem
Mempengaruhi pengguna pada merek atau model perangkat tertentuMasalah kompatibilitas perangkat
Mempengaruhi file media tertentuError encoding, kegagalan prefetch, atau kesalahan konfigurasi kebijakan akses

Jika error terjadi secara acak tanpa pola yang jelas, lakukan langkah-langkah dari Langkah 1 hingga Langkah 3 di bawah ini untuk mengisolasi penyebab sepanjang pipeline pengiriman lengkap, mulai dari perangkat pemutaran, aliran media, hingga jaringan.

image

Langkah 1: Periksa kompatibilitas perangkat

Dukungan protokol dan codec

Pastikan protokol dan codec aliran media Anda didukung pada perangkat target. Jika format tidak didukung, transkode aliran tersebut ke format yang kompatibel. Lihat Recommended output formats and transcoding tools.

Tabel berikut mencantumkan protokol dan codec yang didukung oleh SDK ApsaraVideo Player.

Aplikasi native

Sistem operasiVideo codecVideo protocolAudio codec
Android, iOS, Windows, macOS, LinuxH.264, H.265MP4, HLS, FLV, MPEG-DASH (SegmentBase dan SegmentTemplate)AAC, MP3

Web

Catatan

Jika protokol yang digunakan oleh aliran media Anda memenuhi persyaratan kompatibilitas SDK ApsaraVideo Player untuk Web seperti yang dijelaskan dalam tabel berikut, periksa apakah Anda telah mengonfigurasi sertifikat SSL dan mengaktifkan Cross-Origin Resource Sharing (CORS). Untuk informasi selengkapnya, lihat HTTPS security acceleration dan Configure CORS.

Sistem operasiVideo codecVideo protocolAudio codec
AndroidH.264MP4; HLS (MSEs diperlukan untuk browser tertentu); FLV (MSEs diperlukan)AAC, MP3
iOSH.264MP4, HLSAAC, MP3
iOSH.265MP4; HLS (hanya segmen fMP4)AAC, MP3
WindowsH.264MP4; HLS (MSEs diperlukan); FLV (MSEs diperlukan)AAC, MP3
macOSH.264MP4; HLS; FLV (MSEs diperlukan)AAC, MP3
macOSH.265MP4; HLS (hanya segmen fMP4)AAC, MP3
Catatan

Protokol FLV dan MPEG-DASH tidak didukung pada browser web iOS.

Dukungan video terenkripsi HLS pada browser Android

Beberapa browser Android memerlukan Media Source Extensions (MSEs) untuk memutar video HLS terenkripsi. Tabel berikut menunjukkan browser mana yang mendukung pemutaran video HLS terenkripsi.

Browser AndroidHLS-encrypted video support
WeChatYes
DingTalk IDYes
UC Browser, Quark BrowserYes
QQ BrowserYes
ChromeMSEs required
Huawei BrowserMSEs required
OPPO BrowserYes
Vivo BrowserYes
Mi BrowserMSEs required

Uji dengan pemutar pihak ketiga

Jika perangkat Anda memenuhi persyaratan kompatibilitas di atas, uji dengan pemutar pihak ketiga untuk menentukan apakah masalah tersebut khusus terjadi pada SDK ApsaraVideo Player.

  • Pemutar pihak ketiga berhasil memutar aliran: Masalah kemungkinan merupakan masalah kompatibilitas SDK ApsaraVideo Player. Hubungi technical support Alibaba Cloud.

  • Pemutar pihak ketiga juga gagal: Masalah terletak pada aliran media atau jaringan. Lanjutkan ke Langkah 2.

Pemutar dan browser pihak ketiga yang direkomendasikan untuk pengujian:

TipeRekomendasi
Pemutar desktopVLC media player
Pemutar mobileExoPlayer (Android), AVPlayer (iOS)
Browser sistemChrome (Android, Windows), Safari (iOS, macOS)

Langkah 2: Periksa aliran media

Jika perangkat kompatibel, masalah mungkin terletak pada aliran media. Transkode aliran tersebut dan putar kembali. Jika versi hasil transkoding diputar dengan benar, berarti file asli memiliki masalah encoding.

Periksa penempatan atom moov (MP4 dan MOV)

Untuk file MP4 dan MOV, startup lambat atau kegagalan pemutaran sering disebabkan oleh urutan atom yang salah. Atom moov (indeks metadata) harus ditempatkan sebelum atom mdat (data media) agar pemutar dapat mengurai metadata tanpa mengunduh seluruh file.

Jalankan perintah berikut untuk memeriksa urutan atom:

# Ganti dengan path file lokal atau URL video online
ffmpeg -v trace -i "<video-source>" 2>&1 | grep -e type:\'mdat\' -e type:\'moov\'
  • moov sebelum mdat: Urutan benar. Video diputar seperti yang diharapkan.

    moov before mdat

  • mdat sebelum moov: Urutan salah. Transkode file untuk memindahkan atom moov ke bagian depan.

    mdat before moov

Periksa properti file sumber

Gunakan ffprobe untuk memeriksa codec dan properti lain dari file sumber. Hal ini membantu menentukan apakah error mengikuti pola spesifik berdasarkan codec atau format.

ffprobe "<video-source>"
ffprobe output example

Unduh ffprobe dari FFmpeg Downloads.

Format output dan tool transkoding yang direkomendasikan

Untuk kompatibilitas maksimal, transkode aliran media ke video H.264 dalam kontainer MP4 atau HLS.

KategoriToolDeskripsi
Alibaba CloudApsaraVideo VODMendukung transkoding reguler, Narrowband HD 1.0, Narrowband HD 2.0, dan transkoding kualitas asli. Untuk informasi selengkapnya, lihat Audio and video transcoding.
Alibaba CloudApsaraVideo Media Processing (MPS)Mendukung transkoding reguler, Narrowband HD 1.0, Narrowband HD 2.0, kecepatan tinggi, dan transkoding penggandaan resolusi. Ideal untuk file media yang disimpan di Object Storage Service (OSS). Untuk informasi selengkapnya, lihat Overview.
Alibaba CloudIntelligent Media Services (IMS)Mendukung transkoding untuk video on-demand yang disimpan di OSS dan ApsaraVideo VOD, serta aliran live.
On-premisesFFmpegTool transkoding open source.

Langkah 3: Periksa koneksi jaringan

Jika perangkat dan aliran media keduanya baik, masalah kemungkinan besar terkait jaringan.

1. Verifikasi konektivitas jaringan perangkat

  • Wi-Fi: Pastikan koneksi stabil dan bandwidth downstream melebihi bitrate media. Gunakan SpeedTest untuk mengukur kecepatan downstream. Jika kecepatan downstream lebih rendah daripada bitrate video, buffering dan kegagalan loading akan terjadi.

  • Jaringan seluler: Pastikan koneksi 4G atau 5G dengan sinyal stabil. Pemutaran dapat gagal atau tersendat pada koneksi seluler yang buruk.

Catatan

Jika terjadi DNS hijacking pada jaringan, atur manual server DNS ke Alibaba Cloud Public DNS (223.5.5.5 atau 223.6.6.6) untuk memulihkan pemutaran.

Pada iOS:

  1. Buka Settings > Wi-Fi.Wi-Fi settings

  2. Ketuk ikon informasi di sebelah jaringan yang terhubung.

    Network info

  3. Konfigurasi pengaturan Domain Name System (DNS).

    DNS configuration

2. Periksa konfigurasi Alibaba Cloud CDN

  • CDN belum diaktifkan: Aktifkan CDN untuk mempercepat pengiriman video. Untuk informasi selengkapnya, lihat Add a domain name for CDN.

  • CDN telah diaktifkan: Periksa hal-hal berikut:

    • Cache miss: Verifikasi bahwa konten media telah diprefetch dan konten cache belum kedaluwarsa. Cache miss menyebabkan kegagalan loading atau tersendat, terutama untuk video yang baru diunggah. Konfigurasikan prefetch untuk video baru. Untuk informasi selengkapnya, lihat Purge and prefetch.

    • Penjadwalan CDN: Jika tidak ada kesalahan konfigurasi dan aliran diputar di pemutar lain pada perangkat yang sama, masalah mungkin terletak pada penjadwalan CDN.

3. Periksa server origin dan kedekatan pengguna

Jika server origin ditempatkan di Tiongkok daratan dan pengguna terhubung dari luar Tiongkok daratan, latensi dan tersendat dapat terjadi. Tempatkan server origin di wilayah yang sama dengan pengguna Anda untuk mengurangi latensi pengiriman.

4. Periksa lonjakan lalu lintas

Saat terjadi lonjakan lalu lintas, permintaan ke server origin mungkin dikendalikan alirannya, menyebabkan pemutaran tersendat.

Referensi

Untuk bantuan troubleshooting tambahan, lihat topik-topik berikut:

Hubungi technical support

Jika masalah tetap berlanjut setelah menyelesaikan langkah-langkah di atas, kirimkan tiket. Untuk informasi selengkapnya, lihat Contact us.

Sertakan informasi berikut dalam tiket Anda untuk mempercepat penyelesaian:

InformasiContohDetail
Sistem operasi dan model perangkatAndroid 9, XiaomiMerek dan OS perangkat yang terpengaruh (Android, iOS, Windows, macOS, atau Linux)
Tipe dan versi SDKAndroid SDK 5.4.8.0Varian SDK ApsaraVideo Player (Web, Android, iOS, Flutter, atau Windows) dan nomor versi
Sumber videohttps://xxxxxx.m3u8URL pemutaran atau file video yang memicu error
Deskripsi masalah, log, dan rekaman layar"Pemutaran dimulai pukul 16.40 pada 29 Agustus 2022. Tersendat dimulai sekitar pukul 17.00."Jelaskan operasi yang dilakukan dan gejala yang diamati, termasuk timestamp tepat. Jika error dapat direproduksi, lampirkan log lengkap. Untuk petunjuk pengumpulan log, lihat How do I obtain the error log in ApsaraVideo Player SDK for Android? dan How do I obtain the error log in ApsaraVideo Player SDK for iOS?.
Distribusi error"Terjadi setiap kali, hanya pada perangkat Android."Apakah error mengikuti pola (video, platform, atau versi SDK tertentu) dan frekuensinya (selalu, intermiten, atau acak)