Cara menangani error pemutaran - ApsaraVideo VOD - Alibaba Cloud Documentation Center

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 kesalahan	Kemungkinan penyebab
Pemutaran gagal untuk pengguna di jaringan ISP atau wilayah tertentu.	Masalah ini mungkin disebabkan oleh gangguan jaringan penyedia layanan lokal atau masalah 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 masalah kompatibilitas sistem.
Pemutaran gagal pada merek atau model perangkat akhir tertentu.	Masalah ini mungkin disebabkan oleh ketidakcocokan 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, pastikan protokol aliran media didukung oleh sistem operasi dan lingkungan aplikasi. Jika tidak, Anda harus melakukan transkoding aliran tersebut. Untuk informasi selengkapnya, 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 berikut, pastikan Anda memiliki Sertifikat SSL dan telah mengaktifkan akses lintas-origin. Untuk informasi selengkapnya, lihat Aktifkan Percepatan aman HTTPS dan Konfigurasikan 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.
iOS	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)
macOS	H.265	MP4 HLS (memerlukan segmen fMP4)

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

Browser pada 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 pemutar lain untuk memeriksa apakah masalah tersebut terkait dengan kompatibilitas SDK ApsaraVideo Player.

Jika video diputar dengan benar di pemutar lain, masalahnya mungkin terletak pada SDK ApsaraVideo Player. Dalam hal ini, hubungi dukungan teknis.
Jika video juga gagal diputar di pemutar lain, Anda perlu memeriksa aliran media dan jaringan.

Kami menyarankan menggunakan pemutar berikut untuk troubleshooting:

Pemutar pihak ketiga: VLC
Pemutar sistem: ExoPlayer (Android), AVPlayer (iOS)
Browser sistem (khusus Web): Chrome (Android, Windows), Safari (iOS, macOS)

Langkah 2: Periksa aliran media

Setelah menyingkirkan 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 mengkueri 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 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 selengkapnya, 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 selengkapnya, 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.

Pastikan 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 kecepatannya lebih rendah daripada bitrate video, kegagalan pemuatan atau pemutaran tersendat 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 saat ini untuk membuka halaman detail jaringan.
3. Konfigurasikan DNS.
  Pada 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 memasuki konfigurasi detail.
Periksa apakah percepatan CDN diaktifkan.
- Jika percepatan CDN tidak diaktifkan, kami menyarankan untuk mengonfigurasinya guna meningkatkan pengalaman pemutaran. Untuk informasi selengkapnya, lihat Tambahkan nama domain yang dipercepat.
- Jika percepatan CDN diaktifkan:
  - Masalah konfigurasi CDN: Apakah konten media telah dipra-ambil (prefetch)? 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. Masalah ini umum terjadi pada video yang baru diunggah. Kami menyarankan untuk secara aktif melakukan prefetch konten untuk video baru. Untuk informasi selengkapnya, lihat Refresh dan prefetch sumber daya.
  - Masalah lain: Apakah video dari aplikasi lain diputar secara normal pada 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.
Periksa lokasi server origin dan pengguna akhir Anda.
Jika server origin berada di Tiongkok daratan dan pengguna berada di luar negeri, tersendat yang signifikan dapat terjadi. Dalam hal ini, tempatkan server origin di wilayah yang lebih dekat dengan pengguna Anda untuk meningkatkan performa.
Periksa waktu tonton puncak.
Jika terlalu banyak orang menonton pada waktu yang sama, server origin mungkin melakukan pengendalian aliran (throttle) trafik, sehingga menyebabkan pemutaran tersendat.

Pemutaran gagal setelah Anda mengonfigurasi nama domain yang dipercepat

Jika video gagal diputar setelah Anda mengonfigurasi nama domain yang dipercepat, lakukan troubleshooting pada item berikut:

Periksa status resolusi CNAME
- Di Konsol VOD, buka Domain Management dan periksa apakah kolom CNAME menunjukkan domain sebagai aktif.
- Atau, jalankan perintah nslookup atau dig untuk memverifikasi bahwa nama domain meresolusi ke node CDN.
Periksa konfigurasi sertifikat HTTPS
- Pada halaman Domain Management, buka konfigurasi domain dan periksa status sertifikat HTTPS.
- Jika tidak ada sertifikat yang dikonfigurasi atau sertifikat telah kedaluwarsa, pemutar di lingkungan HTTPS akan menolak memuat aliran media.
Periksa konfigurasi perlindungan hotlink berbasis Referer dan penandatanganan URL
- Periksa pengaturan daftar hitam dan daftar putih Referer dalam konfigurasi domain.
- Periksa pengaturan penandatanganan URL dan pastikan jenis dan parameter penandatanganan sesuai dengan permintaan pemutaran.
Periksa status prefetch CDN
- Buka Refresh and Prefetch dan periksa status tugas prefetch.
- Pemutaran pertama video yang belum diprefetch mungkin lambat dimuat atau timeout.
Solusi pemulihan sementara
- Pada halaman Domain Management, nonaktifkan nama domain yang dipercepat, lalu aktifkan kembali setelah penyebabnya diidentifikasi.

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 selengkapnya tentang cara mengirimkan tiket, lihat Kontak Kami.

Agar kami dapat menyelesaikan masalah Anda secara efisien, berikan informasi berikut dalam tiket Anda.

Item	Contoh	Deskripsi
Sistem operasi dan platform perangkat	Android 9, Xiaomi	Berikan merek perangkat dan versi sistem operasi, misalnya: 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 dan nomor versinya. SDK Player meliputi Web SDK, Android SDK, iOS SDK, Flutter SDK, dan Windows SDK.
Sumber video	https://xxxxxx.m3u8	Berikan URL sumber video atau file video yang mereproduksi masalah.
Deskripsi masalah, log, dan rekaman layar	Pemutaran dimulai pukul 16.40 pada 29 Agustus 2022, dan tersendat terjadi sekitar pukul 17.00. Log dilampirkan.	Jelaskan langkah reproduksi dan gejala yang diamati secara detail, termasuk cap waktu spesifik. Untuk masalah yang dapat direproduksi, berikan 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.