All Products
Search
Document Center

ApsaraVideo VOD:FAQ Transkoding

Last Updated:Aug 06, 2026

Topik ini menjawab pertanyaan yang sering diajukan mengenai transkoding di ApsaraVideo VOD.

Bagaimana cara memecahkan masalah kegagalan transkoding?

  • Verifikasi bahwa file sumber dapat diputar di perangkat lokal. Ini merupakan langkah awal yang kritis karena sebagian besar kegagalan transkoding disebabkan oleh masalah pada file sumber itu sendiri, seperti tidak adanya aliran video, metadata tidak valid, kesalahan frame, atau tidak adanya header video. Masalah-masalah tersebut dapat memicu pemantauan efisiensi transkoding dan menyebabkan pekerjaan transkoding gagal.

    • Jalankan perintah ffprobe -show_streams -show_format -of json -i [filePath] untuk memeriksa metadata file guna mengidentifikasi masalah seperti tidak adanya atom moov atau anomali aliran.

    • Jalankan perintah ffprobe -show_packets -i [filePath] untuk memeriksa masalah pada aliran data dan memverifikasi bahwa durasi aliran sesuai dengan durasi yang ditentukan dalam metadata.

      Catatan

      Ketidaksesuaian antara durasi yang ditentukan dalam metadata dan durasi aliran aktual dapat menyebabkan kegagalan transkoding. Jika suatu file memiliki metadata yang tidak valid, gunakan tool seperti FFmpeg untuk memperbaiki file tersebut secara lokal sebelum mengunggahnya untuk transkoding.

  • Temukan kode kesalahan yang sesuai dalam daftar Error Codes untuk mengidentifikasi penyebab spesifik kegagalan tersebut.

  • Untuk mencegah pemotongan atau kegagalan pekerjaan, lakukan escape terhadap karakter khusus yang digunakan dalam watermark teks.

  • Jika pekerjaan transkoding enkripsi gagal, lihat Video Encryption FAQ untuk informasi mengenai kesalahan umum terkait enkripsi standar HLS.

Masalah pemutaran dengan templat No Transcoding

Masalah ini dapat terjadi karena alasan berikut:

  • Penyebab 1: Video sumber rusak dan tidak dapat diputar.

  • Penyebab 2: Hanya video dalam format MP4, FLV, M3U8, MP3, dan WEBM yang dapat diputar langsung tanpa transkoding.

    • Saat Anda mengunggah video ke ApsaraVideo VOD menggunakan kelompok templat bawaan No Transcoding, aliran video original quality akan dihasilkan jika video sumber berada dalam format MP4, FLV, M3U8, MP3, atau WEBM. Untuk format lainnya, aliran original video akan dihasilkan.

    • Aliran original video tidak dapat dipratinjau di Konsol ApsaraVideo VOD, dan Anda tidak dapat memperoleh URL pemutaran-nya dengan memanggil API Get audio and video playback URL. Anda hanya dapat memperoleh URL file sumber untuk pemutaran dengan memanggil API Get source file information. Sebaliknya, aliran video original quality dapat dipratinjau di Konsol ApsaraVideo VOD, dan Anda dapat memperoleh URL pemutaran-nya dengan memanggil API Get audio and video playback URL.

  • Penyebab 3: Kodek video tidak kompatibel dengan pemutar browser.

    • Kontainer video sumber mungkin dalam format MP4, tetapi jika aliran video di dalam kontainer dikodekan dalam MPEG-4 Part 2 (mp4v), pemutar HTML5 browser tidak mendukung kodek ini. Jika Anda mengunggah video semacam itu menggunakan kelompok templat No Transcoding, video tersebut tidak dapat diputar. Browser mendukung kodek H.264 dan H.265.

    • Untuk memeriksa kodek, jalankan perintah ffprobe -show_streams -i [filePath] dan periksa bidang codec_name dalam output. Jika nilainya adalah mpeg4, video tersebut dikodekan dalam MPEG-4 Part 2, sehingga browser tidak dapat memutarnya.

    • Untuk mengatasi masalah ini, gunakan salah satu metode berikut:

      • Gunakan FFmpeg secara lokal untuk melakukan transkoding video ke kodek H.264, lalu unggah ulang file tersebut ke lokasi Object Storage Service (OSS) yang sama menggunakan nama file yang sama. ApsaraVideo VOD akan menghasilkan URL yang dapat diputar berdasarkan file yang diunggah ulang tersebut.

      • Buat kelompok templat transkoding yang menggunakan kodek H.264 di Konsol ApsaraVideo VOD, lalu gunakan untuk melakukan transkoding video yang sudah ada. Anda kemudian dapat memutar aliran yang telah dikodekan ulang tersebut.

Beberapa aliran audio direduksi menjadi satu aliran

Saat ini, transkoding hanya menyimpan satu aliran audio. Hal ini dikendalikan oleh pengaturan audioMap=0 dalam parameter Output. Jika kasus penggunaan Anda memerlukan beberapa aliran audio, submit a ticket.

Resolusi output tidak sesuai dengan pengaturan

Dalam templat transkoding ApsaraVideo VOD, fitur auto-rotate screen (LongShortMode) diaktifkan secara default. Saat fitur ini diaktifkan, width bersesuaian dengan sisi panjang dan height bersesuaian dengan sisi pendek. Anda hanya perlu mengatur salah satu nilai ini dan biarkan yang lain kosong. Jika Anda ingin menetapkan resolusi output tertentu, Anda harus menonaktifkan fitur auto-rotate screen. Menonaktifkan fitur ini dapat menyebabkan video output tampak meregang atau terdistorsi.

Orientasi video salah setelah transkoding

Hal ini biasanya terjadi jika video sumber berisi flag metadata rotasi, seperti rotation=-90, yang menukar lebar dan tinggi video selama transkoding. Anda dapat menggunakan tool seperti FFmpeg untuk memeriksa informasi rotasi pada file sumber. Untuk memeriksa informasi file, jalankan perintah berikut:

ffprobe -show_streams -show_format -of json -i  [filepath]

Layar hitam pada file M3U8 hasil transkoding

Pertama, periksa apakah aliran video dalam file sumber Anda valid. Jika segmen Transport Stream (TS) pertama dari file sumber tidak berisi data video, pemutar mungkin gagal menampilkan video. Jika hal ini terjadi, coba lakukan transkoding file sumber ke MP4 terlebih dahulu, lalu lakukan transkoding file MP4 yang dihasilkan ke M3U8. Hal ini seharusnya menyelesaikan masalah pemutaran.

Masalah eksposur setelah konversi HDR ke SDR

Jika video sumber Anda dalam format HDR, pilih SDR Mapping dalam pengaturan dynamic range pada templat transkoding Anda.

SDR Mapping sedang dalam pratinjau publik. Fitur ini akan dikenai biaya setelah masa pratinjau publik berakhir. Untuk informasi lebih lanjut, lihat Audio and video enhancement fees. Jika masalah tetap berlanjut, submit a ticket untuk bantuan lebih lanjut.

Penanganan moov box dalam transkoding

Setelah transkoding, ApsaraVideo VOD secara default menempatkan moov box di awal file MP4. Perilaku ini tidak dapat dikustomisasi. File yang tidak memiliki moov box tidak dapat diproses dan akan menyebabkan pekerjaan transkoding gagal.

Ketidaksesuaian durasi dalam konversi video-ke-audio

Untuk memastikan konsistensi durasi, logika transkoding ApsaraVideo VOD menggunakan aliran audio terpendek dalam file input sebagai dasar penentuan waktu. Jika timestamp pada beberapa segmen file sumber tidak kontinu, layanan mungkin tidak dapat mengambil informasi media dari aliran video. Hal ini memengaruhi perkiraan durasi dan dapat menyebabkan ketidaksesuaian.

Kesalahan pemutaran untuk file hanya audio

Periksa apakah pemrosesan video dinonaktifkan dalam templat transkoding Anda. Untuk file hanya audio, Anda harus menonaktifkan pemrosesan video. Anda dapat melakukannya dalam pengaturan templat.

Pada halaman Add Transcoding Template Group di Konsol ApsaraVideo Media Processing, atur jenis transkoding ke Normal Transcoding dan format kontainer ke MP4 (.mp4). Dalam parameter video, atur kodek ke H.264, resolusi ke By Long Side and Short Side, serta sisi panjang dan pendek ke bilangan genap dalam rentang [128, 4096].

Pengaturan bitrate tidak diterapkan

Periksa apakah Anda telah mengaktifkan mekanisme pemeriksaan bitrate dalam templat transkoding Anda. Di Konsol ApsaraVideo VOD, fitur ini dapat ditemukan dalam templat regular transcoding di bawah Conditional Transcoding Parameters sebagai Check video bitrate atau Check audio bitrate. Saat mekanisme ini diaktifkan, bitrate yang Anda atur dalam templat mungkin tidak berlaku dalam kondisi tertentu. Secara khusus, jika penyandi output sama dengan penyandi sumber dan bitrate target lebih tinggi daripada bitrate sumber, layanan akan mengatur ulang bitrate output agar sesuai dengan bitrate sumber atau melewati transkoding aliran tersebut, tergantung pada konfigurasi Anda.

Berapa lama waktu yang dibutuhkan untuk pekerjaan transkoding?

Penting

Nilai referensi di bawah ini menggambarkan kecepatan pemrosesan dalam kondisi uji khas setelah pekerjaan transkoding mulai diproses. Nilai-nilai ini tidak mencakup waktu antrian, tidak mewakili total waktu penyelesaian pekerjaan, dan bukan merupakan perjanjian tingkat layanan (SLA).

Untuk skenario transkoding khas ke H.264 720P, kecepatan pemrosesan untuk berbagai algoritma transkoding adalah sebagai berikut:

Algoritma transkoding

Kecepatan pemrosesan

Deskripsi

regular transcoding

Kecepatan rata-rata: sekitar 3x

Nilai ini mencerminkan kecepatan pemrosesan selama fase transkoding dalam kondisi khas.

Narrowband HD™ 1.0

Kecepatan rata-rata: sekitar 1,5x

Waktu pemrosesan biasanya lebih lama daripada regular transcoding.

Narrowband HD™ 2.0

Umumnya jauh lebih lambat dari kecepatan 1x

Waktu pemrosesan sering kali lebih lama daripada durasi video sumber. Waktu aktual tergantung pada pekerjaan spesifik.

Multiplier kecepatan

Multiplier kecepatan = Durasi video yang diproses per satuan waktu pemrosesan

Contoh:
Kecepatan 3x berarti sekitar 3 menit konten video dapat diproses dalam 1 menit waktu pemrosesan.
Dengan demikian, tidak termasuk waktu antrian, video berdurasi 30 menit secara teoretis membutuhkan waktu sekitar 10 menit untuk diproses.
Catatan
  • Nilai referensi hanya berlaku untuk skenario transkoding H.264 720P khas.

  • Nilai-nilai ini tidak boleh digunakan untuk memperkirakan total waktu penyelesaian pekerjaan.

  • Kecepatan pemrosesan biasanya lebih rendah untuk resolusi yang lebih tinggi, pengkodean yang lebih kompleks, atau parameter yang lebih intensif.

  • Perbedaan bitrate, laju frame, format kontainer, dan struktur aliran video sumber dapat secara signifikan memengaruhi waktu pemrosesan.

  • Kompleksitas pemrosesan Narrowband HD™ 2.0 jauh lebih tinggi daripada regular transcoding dan Narrowband HD™ 1.0.

  • Lihat kueri status pekerjaan atau notifikasi penyelesaian untuk mengetahui waktu pemrosesan aktual.

Menanyakan progres transkoding

ApsaraVideo VOD tidak menyediakan API untuk menanyakan progres real-time pekerjaan transkoding. Sebagai gantinya, Anda dapat mengonfigurasi event notifications untuk menerima notifikasi mengenai status pekerjaan tersebut.

Apakah saya dapat melakukan batch transcoding?

ApsaraVideo VOD tidak secara langsung mendukung operasi batch transcoding untuk media yang sudah ada. Sistem secara otomatis melakukan transkoding video selama proses pengunggahan dengan menggunakan templat transkoding atau alur kerja. Namun, jika Anda menyimpan media Anda di bucket Object Storage Service (OSS) milik Anda sendiri, Anda dapat mencapai batch transcoding dengan mengintegrasikan Intelligent Media Management (IMM). Anda dapat membuat proyek IMM lalu menentukan pekerjaan pemrosesan batch dengan menggunakan kriteria seperti pencocokan awalan untuk melakukan transkoding beberapa video secara efisien. Untuk informasi lebih lanjut, lihat Batch Processing in OSS.

Mengapa pekerjaan transkoding saya terus gagal?

Kegagalan pekerjaan dapat disebabkan oleh berbagai hal. Selalu periksa pesan kesalahan yang dikembalikan. Jika Anda menerima kesalahan kegagalan preprocessing, artinya layanan tidak dapat mendekode file sumber Anda. Dalam hal ini, submit a ticket dan berikan informasi berikut untuk membantu kami mendiagnosis masalah: ID akun Alibaba Cloud Anda dan ID video.

Apakah ApsaraVideo VOD mendukung transkoding real-time?

ApsaraVideo VOD adalah layanan transkoding berbasis file dan tidak mendukung transkoding real-time.

Batch transcoding untuk video yang sudah ada

ApsaraVideo VOD tidak mendukung batch transcoding untuk video yang telah diunggah sebelumnya.

Watermark tidak muncul setelah transkoding

Periksa parameter templat watermark yang digunakan untuk transkoding, seperti dimensinya (lebar × tinggi) dan offset-nya. Pastikan pengaturan ini menempatkan watermark dalam batas resolusi video. Jika pengaturan watermark menempatkannya di luar bingkai video, watermark tersebut tidak akan terlihat meskipun pekerjaan transkoding berhasil diselesaikan.

Pada halaman Edit Watermark Template, parameter offset bersesuaian dengan bidang Horizontal Offset dan Vertical Offset. Periksa parameter ini bersama dengan Size (Width × Height) dan Position watermark untuk memastikan watermark tidak melebar melewati bingkai video.

Jika video sumber memiliki letterboxing (batang hitam), watermark mungkin ditulis ke area letterboxed tersebut. Ketika warna watermark mirip dengan warna letterbox (misalnya, watermark hitam pada letterbox hitam), watermark menjadi tidak terlihat karena kontras yang tidak mencukupi. Ubah warna font watermark menjadi warna dengan kontras tinggi terhadap letterbox (misalnya, putih), atau sesuaikan offset horizontal (Dx) dan offset vertikal (Dy) untuk memindahkan watermark ke arah tengah bingkai, menjauh dari area letterboxed.

Tidak ada callback untuk kegagalan transkoding

Saat Anda mengonfigurasi notifikasi event untuk transkoding, jika Anda hanya berlangganan event Single Definition Transcoding Complete (StreamTranscodeComplete) dan tidak berlangganan event TranscodeComplete, Anda mungkin tidak menerima notifikasi kegagalan dalam skenario tertentu. Misalnya, jika Anda mengunggah file sumber yang rusak yang menyebabkan semua aliran output gagal, ApsaraVideo VOD mengirim callback kegagalan untuk event TranscodeComplete. Karena Anda tidak berlangganan event ini, Anda tidak akan menerima notifikasi kegagalan transkoding tersebut.