ApsaraVideo VOD:Masalah umum pemutar

Kegagalan pemutaran VOD

Pemutaran dapat gagal karena masalah pada encoding stream, titik akhir jaringan, CDN, format, atau bucket penyimpanan. Untuk mengidentifikasi penyebabnya, periksa pesan kesalahan pemutar dan permintaan jaringan. Masalah umum beserta solusinya meliputi:

• Pembayaran tertunggak: Periksa saldo akun Anda. Jika akun Anda tertunggak, video tidak dapat diputar.

• Masalah klien jaringan: Video gagal diputar dan mengembalikan kode kesalahan 4400. Kode kesalahan 4400 menunjukkan bahwa resource tidak dapat dimuat karena masalah server atau jaringan. Harap periksa apakah sertifikat SSL telah dikonfigurasi dan apakah sertifikat HTTPS telah kedaluwarsa atau tidak valid.

• Masalah format: Format video tidak kompatibel dengan pemutar. Untuk informasi lebih lanjut tentang format pemutaran yang didukung oleh ApsaraVideo VOD, lihat Fitur SDK Pemutar.

  Catatan

  Untuk memutar file M3U8 dengan otentikasi, Anda harus menggunakan nama domain kustom. Untuk menambahkan nama domain, lihat Tambahkan nama domain yang dipercepat.

• Masalah bucket: Bucket penyimpanan yang dikonfigurasi tidak valid, atau URL yang ditandatangani untuk bucket privat telah kedaluwarsa. Hal ini menyebabkan kegagalan pemutaran. Untuk mengatasinya, nonaktifkan penandatanganan URL untuk bucket tersebut dan atur izinnya menjadi public-read.

• Masalah lintas domain: Periksa apakah wilayah nama domain yang dipercepat sama dengan wilayah pemutaran video. Jika berbeda, pemutaran akan gagal. Anda dapat membuat nama domain yang dipercepat baru atau mengubah wilayah domain aslinya.

Kesalahan GetPlayInfo: Status video tidak valid atau sedang dalam tinjauan

Agar berhasil mendapatkan informasi pemutaran, status utama video (Status) harus berupa Normal dan status tinjauannya (AuditStatus) harus berupa Normal. Jika status video adalah UploadSucc (unggahan berhasil tetapi transkoding belum selesai) atau AuditStatus bernilai Init (sedang dalam tinjauan), Anda harus menunggu hingga transkoding selesai dan tinjauan lolos sebelum dapat memperoleh informasi pemutaran. Kami merekomendasikan agar Anda menggunakan API GetVideoInfo untuk menanyakan status terbaru video dan memeriksa apakah pengaturan tinjauan global memengaruhi progres tinjauan.

Kesalahan saat memutar video M3U8 lokal

File M3U8 berisi beberapa segmen Transport Stream (TS). Untuk pemutaran lokal, segmen-segmen ini harus tersedia secara lokal dengan path relatif yang benar dalam file M3U8, karena URL remote tidak didukung.

File indeks M3U8 dan file segmen .ts yang sesuai (seperti 000000.ts, 000001.ts, dll.) harus ditempatkan dalam direktori yang sama.

File M3U8 lokal harus mengikuti struktur direktori ini.

Kegagalan pemutaran eksternal

Lakukan troubleshooting sebagai berikut:

1. Periksa apakah video masih ada di ApsaraVideo VOD.

2. Periksa apakah nama domain yang dipercepat telah ditambahkan.

   • Nama domain yang dipercepat belum ditambahkan: Periksa izin bucket penyimpanan. Periksa apakah bucket penyimpanan bersifat privat. Jika iya, otentikasi diperlukan. Untuk memutar video secara langsung, Anda dapat menonaktifkan otentikasi dan mengatur izin bucket menjadi public-read. Perhatikan bahwa mengatur bucket menjadi public-read menimbulkan risiko keamanan.

   • Nama domain yang dipercepat telah ditambahkan: Periksa apakah otentikasi diaktifkan. Jika iya, Anda dapat memperpanjang periode validitas otentikasi atau menonaktifkan otentikasi. Perhatikan bahwa menonaktifkan otentikasi menimbulkan risiko keamanan.

Video terenkripsi DRM tidak dapat diputar di browser

Pemutaran video terenkripsi DRM dengan Pemutar Video Apsara untuk Web tunduk pada pembatasan browser. Untuk informasi lebih lanjut tentang browser yang didukung, lihat Kompatibilitas fitur.

MtsHlsUriToken untuk enkripsi HLS

Parameter MtsHlsUriToken merupakan parameter kustom. Dalam enkripsi HLS standar, setelah string enkripsi ditulis ke dalam stream HLS, alamat server dekripsi ditambahkan ke manifes M3U8. Untuk membatasi akses video hanya kepada pengguna tertentu, server dekripsi memerlukan mekanisme otentikasi identitas. Parameter MtsHlsUriToken menambahkan lapisan otentikasi ke server dekripsi Anda. Parameter khusus kemudian dihasilkan berdasarkan logika otentikasi ini dan diteruskan untuk verifikasi dekripsi.

Saat mengonfigurasi enkripsi, Anda harus membangun layanan penerbitan token untuk menghasilkan MtsHlsUriToken. Untuk informasi lebih lanjut, lihat Enkripsi HLS - Langkah 4.

Pemuatan lambat untuk video dari UK (London) di Tiongkok daratan

Akses dari Tiongkok daratan ke wilayah UK (London) lebih lambat karena jarak. Untuk meningkatkan performa, tambahkan nama domain yang dipercepat dan gunakan Global Accelerator.

Akses lambat dan tersendat saat pemutaran di luar Tiongkok

Tersendat selama pemutaran biasanya disebabkan oleh jaringan yang tidak stabil. Jika tersendat cukup lama hingga menyebabkan kesalahan pemutar, kemungkinan besar terkait dengan ketidakstabilan CDN. Jika tersendat terjadi secara sering, periksa permintaan jaringan. Kecepatan jaringan mungkin tidak sesuai dengan bitrate video. Anda mungkin perlu meningkatkan kecepatan jaringan atau menurunkan bitrate.

Permintaan berlebihan selama pemutaran video OSS

Periksa apakah terdapat masalah pada video sumber. Misalnya, periksa apakah pemutar mengirim banyak permintaan duplikat saat decoding video sumber. Anda dapat menggunakan template transkoding ApsaraVideo VOD untuk mentranskode video sebelum pemutaran. Untuk informasi lebih lanjut, lihat Transkoding video dan audio.

Pratinjau resource gambar alih-alih mengunduhnya

Untuk melakukan pratinjau gambar yang disimpan di ApsaraVideo VOD alih-alih mengunduhnya, Anda harus menggunakan nama domain kustom. Anda dapat menambahkan nama domain kustom ke ApsaraVideo VOD. Untuk informasi lebih lanjut, lihat Tambahkan nama domain yang dipercepat.

Pemutaran video gagal di beberapa komputer dengan kode kesalahan 4400

Kode kesalahan 4400 menunjukkan bahwa resource tidak dapat dimuat karena masalah server atau jaringan, atau format yang tidak didukung. Periksa apakah sertifikat SSL telah dikonfigurasi.

URL pemutaran pendek

Jika izin bucket penyimpanan video bersifat privat, URL pemutaran-nya berisi string otentikasi dan merupakan URL panjang. Jika izinnya public-read atau public-read-write, URL pemutaran tidak berisi string otentikasi dan merupakan URL pendek. Untuk informasi lebih lanjut tentang izin bucket penyimpanan dan cara mengubahnya, lihat Kelola Bucket Penyimpanan.

Kegagalan pemutaran video non-transkoding dalam format HLS

Saat Anda menggunakan Pemutar Video Apsara dengan ID video (VID) dan kredensial pemutaran, Anda hanya dapat memutar video yang telah ditranskode. Anda hanya dapat memutar video yang belum ditranskode dengan menggunakan URL. Anda dapat memanggil operasi GetMezzanineInfo untuk mendapatkan URL video sumber atau login ke Konsol ApsaraVideo VOD untuk melihat URL video.

Permanensi URL pemutaran VOD

Saat izin bucket penyimpanan video bersifat privat, URL pemutaran-nya hanya berlaku untuk waktu terbatas. String otentikasi auth_key dalam URL pemutaran bervariasi berdasarkan waktu kedaluwarsa yang dikonfigurasi.

Untuk mendapatkan alamat pemutaran permanen, Anda harus mengubah izin bucket penyimpanan video menjadi public-read atau public-read-write. Bagian alamat pemutaran yang dihasilkan sebelum karakter ? merupakan alamat permanen yang dapat digunakan untuk pemutaran tanpa batas waktu. Untuk informasi lebih lanjut tentang izin bucket penyimpanan dan cara mengubahnya, lihat Kelola Bucket Penyimpanan.

URL pemutaran dialihkan ke browser

Pemutaran bergantung pada kemampuan decoding browser dan perangkat, yang sering mengakibatkan pengalihan ke browser.

Video yang diperbarui tidak muncul

Setelah memperbarui video, Anda perlu merefresh URL untuk mengambil data terbaru. Untuk merefresh URL di Konsol ApsaraVideo VOD, lihat Refresh dan pra-ambil. Untuk merefresh URL menggunakan API atau SDK, lihat PreloadVodObjectCaches atau RefreshMediaPlayUrls.

Mendapatkan piksel frame dari pemutar

• Pemutar Video Apsara untuk Android: Anda dapat memperoleh piksel dengan mendengarkan callback OnRenderFrameCallback.

• Pemutar Video Apsara untuk iOS: Anda dapat memperoleh piksel dengan mendengarkan callback onRenderingFrame.

  player.renderingDelegate = self;
  
  #pragma mark CicadaRenderingDelegate
  - (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo{
      if(frameInfo.frameType==Cicada_FrameType_Video){
          // Video
          NSLog(@"receive HW frame:%p pts:%ld foramt %d", frameInfo.video_pixelBuffer, frameInfo.pts, CVPixelBufferGetPixelFormatType(frameInfo.video_pixelBuffer));
  
      } else if (frameInfo.frameType==Cicada_FrameType_Audio){
          // Audio
      }
      return NO;
  }

• Pemutar Video Apsara untuk Web: Fitur ini tidak didukung.

Tidak dapat mendapatkan URL pemutaran untuk video AVI

Operasi GetPlayInfo tidak mendukung pengambilan aliran video dalam format AVI. Oleh karena itu, SDK yang bergantung pada operasi ini tidak dapat memperoleh aliran video dalam format AVI.

Anda dapat melihat URL pemutaran video AVI di Konsol ApsaraVideo VOD. Untuk informasi lebih lanjut, lihat Kueri file audio atau video.

Kesalahan GetPlayInfo: "The video has no stream to play for the request parameter"

Kesalahan ini sesuai dengan kode kesalahan API InvalidVideo.NoneStream ("The video has no stream to play for the request parameter"). Di SDK pemutar, kesalahan ini dilaporkan sebagai kode kesalahan 31027.

Anda dapat melakukan troubleshooting sebagai berikut:

1. Konfirmasi bahwa kelas penyimpanan aset media adalah Standard.

   Secara default, operasi GetPlayInfo hanya mengembalikan stream pemutaran untuk aset media dalam kelas penyimpanan Standard. Untuk memperoleh stream pemutaran untuk aset media dengan kelas penyimpanan lain, atur parameter StorageClass dalam parameter PlayConfig menjadi All.

   Nilai valid lain untuk StorageClass meliputi Standard, IA (Infrequent Access), Archive, ColdArchive, SourceIA (Source Infrequent Access), SourceArchive (Source Archive), SourceColdArchive (Source Cold Archive), Changing (status aset media sedang berubah), dan SourceChanging (status file sumber sedang berubah). Nilai kosong menunjukkan tidak ada filter.

2. Konfirmasi bahwa aset media memiliki stream yang telah dikodekan ulang.

   Untuk memperoleh stream yang telah dikodekan ulang, Anda harus terlebih dahulu melakukan transkoding video dan audio lalu memanggil operasi GetPlayInfo. Untuk memperoleh URL stream sumber, lihat GetMezzanineInfo.

3. Konfirmasi apakah format video adalah MOV.

   Unggahan MOV didukung, tetapi secara default ApsaraVideo VOD tidak mentranskode file MOV. Akibatnya, operasi GetPlayInfo tidak dapat mengembalikan stream pemutaran, dan SDK pemutar melaporkan kode kesalahan 31027. Jika video dalam format MOV dan belum ditranskode, panggil operasi GetMezzanineInfo untuk memperoleh informasi file sumber (seperti URL file sumber dan metadata).

Mengurangi tersendat video dan meningkatkan tingkat hit cache

Anda dapat meningkatkan tingkat hit cache dengan mengonfigurasi penandatanganan URL, merefresh dan pra-mengambil konten, mengonfigurasi caching, serta memfilter parameter.

Tersendat saat mencari

Jika video memiliki terlalu sedikit keyframe, pencarian posisi menjadi lambat karena pemutar harus mendekode segmen video yang lebih besar untuk menemukan sebuah frame. Hal ini menyebabkan pemutaran menjadi tersendat. Dalam kasus ini, Anda dapat mentranskode video untuk menambahkan lebih banyak keyframe dan mengurangi pemutaran yang tersendat. Untuk informasi selengkapnya tentang transkoding, lihat Transkoding video dan audio.

Kesalahan 0x200600001 MEDIA_PLAYER_ERROR_CODEC_VIDEO_NOT_SUPPORT

Jika pesannya adalah vvc plugin not enabled, artinya plugin belum diaktifkan di aplikasi Anda. Panggil metode AliPlayerGlobalSettings.enableCodecPlugin untuk mengaktifkannya.

Jika pesannya adalah vvc plugin not loaded, artinya plugin tidak berhasil diintegrasikan. Periksa apakah library plugin berhasil diimpor ke dalam proyek, atau panggil secara eksplisit loadlibrary untuk memastikan plugin berhasil dimuat.

Kesalahan 0x50020002 MEDIA_PLAYER_ERROR_CODEC_PREMIUM_INVALID

Ini menunjukkan bahwa lisensi Edisi Profesional belum diperoleh. Plugin decoder H.266 merupakan fitur Edisi Profesional. Untuk informasi lebih lanjut tentang cara memperoleh lisensi Edisi Profesional, lihat Kelola lisensi.

Tidak dapat memperoleh gambar mini video

Konsol ApsaraVideo VOD secara default menggunakan protokol HTTPS. Hanya resource yang mendukung HTTPS yang dapat dipratinjau dan ditampilkan sebagai tangkapan layar secara langsung. Anda juga dapat membuka developer tools browser untuk melihat pesan kesalahan spesifik.

Video tidak dapat diputar selama tinjauan manual

ApsaraVideo VOD memiliki dua mode tinjauan. Jika mode tinjauan diatur ke "tinjau sebelum publikasi", video hanya dapat diputar setelah lolos tinjauan. Dua mode tinjauan tersebut adalah sebagai berikut:

• Publikasi sebelum tinjauan: Setelah video ditranskode, video ditandai sebagai Normal secara default dan dapat diputar langsung. Anda kemudian harus melakukan tinjauan manual terhadap video tersebut. Jika video diblokir setelah tinjauan, video tidak dapat diputar.

• Tinjau sebelum publikasi: Setelah video ditranskode, video secara default memasuki proses tinjauan dan ditandai sebagai Under Review. Video hanya dapat diputar setelah lolos tinjauan manual.

VideoID

Untuk keamanan, ApsaraVideo VOD menyediakan ID video (videoID) alih-alih URL langsung saat Anda mengunggah file media. Anda juga dapat memperoleh videoID dengan memanggil OpenAPI ApsaraVideo VOD. Untuk informasi lebih lanjut, lihat Dapatkan URL pemutaran video.

Setelah mengunggah video ke ApsaraVideo VOD, Anda memperoleh videoID.

Anda juga dapat memperoleh videoID di Konsol ApsaraVideo VOD. Prosedurnya sebagai berikut:

1. Login ke Konsol ApsaraVideo VOD.

2. Di panel navigasi kiri, di bawah bagian Media Files, klik Audio/Video.

3. Di daftar video, peroleh videoID.

Anda dapat menggunakan videoID yang diperoleh dari konsol untuk menguji pengunduhan dan pemutaran. Untuk informasi lebih lanjut tentang cara mengunggah file ke ApsaraVideo VOD, lihat Ikhtisar unggah SDK.

ID AccessKey dan Rahasia AccessKey

ID AccessKey dan Rahasia AccessKey Alibaba Cloud merupakan satu-satunya kredensial untuk mengakses API Alibaba Cloud. ID AccessKey berfungsi sebagai pengenal identitas. Rahasia AccessKey seperti password. Jangan pernah mengungkapkannya.

Untuk memperoleh kredensial Anda:

1. Login ke Konsol ApsaraVideo VOD.

2. Arahkan pointer mouse ke foto profil Anda di pojok kanan atas dan klik AccessKey di menu pintasan.

3. Di halaman AccessKey, buat Pasangan Kunci Akses atau lihat Rahasia AccessKey dari ID AccessKey yang sudah ada.

PlayKey

PlayKey (Kunci API) adalah kunci pemutaran yang digunakan untuk mengotentikasi identitas saat SDK pemutar memperoleh URL pemutaran video. Otentikasi pemutaran merupakan mekanisme otentikasi sekunder berbasis otentikasi keamanan AccessKey Alibaba Cloud. Mekanisme ini secara efektif mencegah hotlinking. Secara default, playKey disediakan untuk platform Flash, HTML5, iOS, dan Android berdasarkan platform yang mungkin digunakan pengguna untuk pemutaran.

Untuk memperoleh kunci:

1. Login ke Konsol ApsaraVideo VOD.

2. Di panel navigasi kiri, di bawah Configuration Management, pilih CDN Configuration > Download Settings. Aktifkan mode unduh aman.

3. Di bagian Dapatkan Kunci, masukkan Unique App Identifier dan Private Key.

4. Klik Generate and Download Key.

Playauth

Pemutar mendukung tiga mode pemutaran. Mode playauth, yang diimplementasikan melalui metode setAuthInfo, merupakan yang paling aman dan direkomendasikan untuk penggunaan komersial.

Playauth adalah string terenkripsi yang berisi informasi seperti videoID, ID AccessKey, dan Rahasia AccessKey. Layanan ApsaraVideo VOD mencampur dan mengenkripsi informasi ini. Saat pemutar menerima playauth, video dapat diputar.

Alur: Server memperoleh kredensial pemutaran > Server mengirim kredensial pemutaran ke klien > Pemutaran video selesai.

1. Memperoleh kredensial pemutaran: Di server, panggil SDK otentikasi pemutaran (SDK sisi server) untuk memperoleh kredensial pemutaran dari layanan ApsaraVideo VOD.

2. Menyelesaikan pemutaran video: SDK pemutar menggunakan ID video dan kredensial pemutaran untuk memperoleh URL pemutaran video dari layanan ApsaraVideo VOD. Kemudian memuat stream video dan mendekodenya untuk pemutaran.