ApsaraVideo VOD：FAQ Umum untuk pemutar di berbagai platform

Bagaimana cara memecahkan masalah kegagalan pemutaran video ApsaraVideo VOD?

Kegagalan pemutaran dapat disebabkan oleh masalah pengkodean aliran, titik akhir jaringan atau CDN, format, atau bucket. Untuk mengidentifikasi penyebabnya, periksa pesan kesalahan dari pemutar dan permintaan jaringan. Daftar berikut menjelaskan masalah umum beserta solusinya:

• Pembayaran tertunda: Periksa saldo akun Anda. Jika akun memiliki pembayaran tertunda, video tidak dapat diputar.

• Masalah titik akhir jaringan: Video gagal diputar dan melaporkan kode kesalahan 4400. Kode kesalahan 4400 menunjukkan bahwa sumber daya tidak dapat dimuat karena masalah server atau jaringan. Periksa apakah Sertifikat SSL telah dikonfigurasi serta apakah sertifikat HTTPS telah kedaluwarsa atau tidak valid.

• Masalah format: Format video tidak kompatibel dengan pemutar. Untuk informasi selengkapnya 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 menyambungkan nama domain, lihat Tambahkan nama domain yang dipercepat.

• Masalah bucket: Bucket yang ditentukan tidak valid, atau otentikasi untuk bucket pribadi telah kedaluwarsa, sehingga menyebabkan kegagalan pemutaran. Untuk mengatasinya, Anda dapat menonaktifkan otentikasi bucket dan mengatur izin bucket menjadi baca-publik.

• 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 asal.

Kesalahan saat memutar video M3U8 lokal

File M3U8 berisi beberapa shard TS yang harus tersedia secara lokal. Jalur dalam file M3U8 harus mengarah ke lokasi yang benar dari file-file TS tersebut. Jika tidak, file tidak dapat dimuat. Jika shard Anda ditentukan sebagai tautan, pemutaran tidak didukung.

Gambar berikut menunjukkan:

File M3U8 lokal harus dalam format seperti yang ditunjukkan pada gambar di atas.

Video ApsaraVideo VOD diputar dengan benar di situs saya tetapi tidak dapat dibagikan dan diputar secara eksternal

Anda dapat memecahkan masalah ini sebagai berikut:

1. Periksa apakah video masih ada di ApsaraVideo VOD.

2. Periksa apakah nama domain yang dipercepat telah ditambahkan.

   • Tidak ada nama domain yang dipercepat yang ditambahkan: Periksa izin bucket penyimpanan. Jika bucket penyimpanan bersifat pribadi, otentikasi diperlukan. Untuk memutar video secara langsung, Anda dapat menonaktifkan otentikasi dan mengatur izin bucket menjadi baca-publik. Perhatikan bahwa mengatur bucket menjadi baca-publik 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

Saat menggunakan Pemutar Video Apsara untuk Web untuk memutar video terenkripsi DRM, terdapat batasan pada browser. Untuk informasi selengkapnya tentang browser yang didukung, lihat Kompatibilitas fitur.

Apa parameter MtsHlsUriToken yang diperlukan untuk memutar video terenkripsi HLS, dan bagaimana cara mendapatkannya?

Parameter MtsHlsUriToken adalah parameter kustom. Dalam enkripsi HLS standar, setelah string enkripsi ditulis ke dalam aliran HLS, alamat server dekripsi ditambahkan ke manifes M3U8. Untuk membatasi akses hanya kepada pengguna tertentu, alamat dekripsi memerlukan fitur otentikasi identitas. Parameter MtsHlsUriToken menambahkan lapisan otentikasi ke server dekripsi Anda. Parameter khusus kemudian dihasilkan berdasarkan logika otentikasi ini dan ditambahkan ke proses otentikasi dekripsi.

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

Video yang diunggah ke OSS di wilayah Inggris (London) dimuat secara lambat di Daratan Tiongkok

Mengakses wilayah Inggris (London) dari Daratan Tiongkok merupakan akses lintas wilayah. Anda dapat menambahkan nama domain yang dipercepat lalu menggunakan Akselerator Global.

Bagaimana cara mengatasi akses lambat dan sering tersendat saat memutar video ApsaraVideo VOD 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.

Apa yang harus saya lakukan jika banyak permintaan dikirim saat memutar video tertentu yang disimpan di OSS?

Periksa apakah terdapat masalah pada video sumber, misalnya apakah pemutar mengirim banyak permintaan duplikat saat mendekode video sumber. Anda dapat menggunakan template transkoding ApsaraVideo VOD untuk melakukan transkoding video sebelum pemutaran. Untuk informasi selengkapnya, lihat Transkoding video dan audio.

Bagaimana cara saya melihat pratinjau sumber daya citra dari ApsaraVideo VOD langsung menggunakan tautannya, bukan mengunduhnya?

Citra yang disimpan di ApsaraVideo VOD hanya dapat dilihat pratinjaunya jika Anda menggunakan nama domain kustom. Jika Anda menggunakan nama domain default untuk akses, citra akan diunduh secara paksa. Anda dapat menambahkan nama domain kustom ke ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Tambahkan nama domain yang dipercepat.

Video tidak dapat diputar di beberapa komputer, dan melaporkan kode kesalahan 4400

Kode kesalahan 4400 menunjukkan bahwa sumber daya tidak dapat dimuat karena masalah server atau jaringan, atau formatnya tidak didukung. Periksa apakah Sertifikat SSL telah dikonfigurasi.

Bagaimana cara menghasilkan URL pemutaran pendek untuk video yang disimpan di ApsaraVideo VOD?

Jika izin alamat penyimpanan video bersifat pribadi, URL pemutaran-nya berisi string otentikasi dan merupakan URL panjang. Jika izinnya baca-publik atau baca-tulis publik, URL pemutaran tidak berisi string otentikasi dan merupakan URL pendek. Untuk informasi selengkapnya tentang izin alamat penyimpanan dan cara mengubahnya, lihat Kelola bucket penyimpanan.

Setelah saya mengatur format transkoding ke HLS, mengapa saya tidak dapat memutar video yang belum ditranskoding?

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

Apakah URL pemutaran untuk video yang disimpan di ApsaraVideo VOD bersifat tetap?

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

Untuk mendapatkan alamat pemutaran permanen, Anda dapat mengubah izin alamat penyimpanan video menjadi baca-publik atau baca-tulis publik. Bagian alamat pemutaran yang dihasilkan sebelum karakter ? merupakan alamat permanen yang dapat digunakan untuk pemutaran tanpa batas waktu. Untuk informasi selengkapnya tentang izin alamat penyimpanan dan cara mengubahnya, lihat Kelola Bucket Penyimpanan.

Setelah video diunggah ke ApsaraVideo VOD, mengapa video tersebut dialihkan ke browser untuk pemutaran saat URL-nya dikirim ke platform seperti Taobao?

Pemutaran video bergantung pada kemampuan decoding browser dan perangkat lokal. Oleh karena itu, biasanya dialihkan ke browser untuk pemutaran.

Setelah saya memperbarui video, mengapa video baru tidak muncul selama pemutaran?

Setelah memperbarui video, Anda perlu melakukan purge URL untuk mengambil data terbaru. Untuk melakukan purge URL di konsol ApsaraVideo VOD, lihat Segarkan dan ambil awal. Untuk melakukan purge URL menggunakan API atau SDK, lihat PreloadVodObjectCaches atau RefreshMediaPlayUrls.

Bagaimana cara mendapatkan piksel setiap frame dalam video 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.

Mengapa saya tidak dapat mendapatkan URL pemutaran untuk video AVI di ApsaraVideo VOD menggunakan API atau SDK?

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 selengkapnya, lihat Kueri file audio atau video.

Operasi GetPlayInfo melaporkan kesalahan "The video has no stream to play for the request parameter" saat mendapatkan URL pemutaran video

Anda dapat memecahkan masalah ini sebagai berikut:

1. Konfirmasi bahwa kelas penyimpanan aset media adalah Standard.

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

   

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

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

Tindakan apa saja yang dapat saya ambil untuk mengurangi tersendat video dan meningkatkan tingkat hit?

Anda dapat meningkatkan tingkat hit dengan cara berikut: mengonfigurasi penandatanganan URL, menyegarkan dan mengambil awal konten, mengonfigurasi caching, dan memfilter parameter.

Video tersendat saat saya menyeret bilah progres ke tengah video

Jika video memiliki terlalu sedikit keyframe, menyeret bilah progres memerlukan pemuatan banyak keyframe sebelum dan sesudahnya untuk menghitung frame yang sesuai, sehingga menyebabkan tersendat. Dalam kasus ini, Anda dapat melakukan transkoding video untuk menambahkan lebih banyak keyframe dan mengurangi tersendat. Untuk informasi selengkapnya tentang transkoding, lihat Transkoding video dan audio.

Terjadi kesalahan 0x200600001 MEDIA_PLAYER_ERROR_CODEC_VIDEO_NOT_SUPPORT

Jika pesannya adalah vvc plugin not enabled, lapisan bisnis belum mengaktifkan plugin tersebut. Anda dapat memanggil operasi AliPlayerGlobalSettings.enableCodecPlugin untuk mengaktifkan plugin tersebut.

Jika pesannya adalah vvc plugin not loaded, plugin tersebut belum diintegrasikan. Periksa apakah pustaka plugin berhasil diimpor ke dalam proyek, atau panggil secara eksplisit loadlibrary untuk memastikannya dimuat.

Terjadi kesalahan 0x50020002 MEDIA_PLAYER_ERROR_CODEC_PREMIUM_INVALID

Hal ini menunjukkan bahwa lisensi Edisi Profesional belum diperoleh. Plugin decoder H.266 merupakan fitur Edisi Profesional. Untuk informasi selengkapnya tentang cara memperoleh lisensi Edisi Profesional, lihat Kelola lisensi.

Gagal mendapatkan gambar mini video dari ApsaraVideo VOD

Konsol ApsaraVideo VOD secara default menggunakan protokol HTTPS. Hanya sumber daya yang mendukung HTTPS yang dapat dilihat pratinjaunya dan ditampilkan sebagai tangkapan layar. Anda juga dapat membuka alat pengembang browser untuk melihat pesan kesalahan spesifik.

Video tidak dapat diputar selama Tinjauan manual di ApsaraVideo VOD

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

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

• Tinjauan sebelum publikasi: Setelah video ditranskoding, video tersebut secara default memasuki proses tinjauan dan ditandai sebagai Sedang Ditinjau. Video tersebut hanya dapat diputar setelah lulus tinjauan manual.

Apa itu videoID, mengapa diperlukan, dan bagaimana cara mendapatkannya?

Karena alasan keamanan, saat Anda mengunggah file media ke ApsaraVideo VOD, Anda menerima ID video (videoID) untuk file tersebut, bukan URL. Anda juga dapat memperoleh videoID dengan memanggil OpenAPI ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Dapatkan URL pemutaran video.

Setelah Anda mengunggah video ke ApsaraVideo VOD, Anda memperoleh videoID.

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

1. Masuk ke konsol ApsaraVideo VOD.

2. Di panel navigasi sebelah kiri, pilih Media Library > Audio/Video.

3. Di daftar video, peroleh videoID.

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

Apa itu ID AccessKey dan Rahasia AccessKey, serta bagaimana cara mendapatkannya?

ID AccessKey dan Rahasia AccessKey Alibaba Cloud adalah satu-satunya kredensial untuk mengakses API Alibaba Cloud. ID AccessKey berfungsi sebagai pengidentifikasi identitas, sedangkan Rahasia AccessKey digunakan untuk menandatangani parameter akses guna mencegah perubahan. Rahasia AccessKey mirip dengan kata sandi logon Anda—jangan berikan kepada siapa pun.

Prosedur pengambilan:

1. Masuk ke konsol ApsaraVideo VOD.

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

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

Apa itu playKey, dan bagaimana cara mendapatkannya?

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

Prosedur mendapatkan:

1. Masuk ke konsol ApsaraVideo VOD.

2. Di panel navigasi sebelah kiri, di area Configuration Management, pilih Distribution And Acceleration > Download Settings. Aktifkan Mode Unduh Aman.

3. Di bagian Dapatkan Kunci, masukkan Unique App ID dan Offline Decryption Private Key.

4. Klik Generate And Download Key.

Apa itu playauth, dan bagaimana cara mendapatkannya?

Pemutar mendukung tiga mode pemutaran untuk skenario berbeda. Mode playauth adalah yang paling aman. Gunakan mode pemutaran setAuthInfo.

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: The Server Obtains A Playback Credential > The Server Sends The Playback Credential To The Client > Video Playback Is Complete.

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

2. Selesaikan pemutaran video: SDK pemutar menggunakan ID video dan kredensial pemutaran untuk memperoleh URL pemutaran video dari layanan ApsaraVideo VOD, lalu memuat dan mendekode aliran video untuk pemutaran.