All Products
Search

This Product

    ApsaraVideo Media Processing:FAQ pengambilan snapshot

    Document Center

    ApsaraVideo Media Processing:FAQ pengambilan snapshot

    Last Updated:Jun 05, 2026

    Masalah umum dan solusi untuk pekerjaan snapshot MPS, termasuk kesalahan timeout, konfigurasi parameter, dan output yang tidak sesuai harapan.

    Kesalahan umum pada pekerjaan snapshot

    Pekerjaan snapshot dapat mengembalikan kode kesalahan berikut: SnapshotTimeOut, InvalidParameter.ResourceNotFound, atau InvalidParameter.ResourceContentBad. Jika pekerjaan snapshot gagal, panggil QuerySnapshotJobList untuk mengetahui penyebab kegagalannya.

    SnapshotTimeOut

    Kesalahan ini dikembalikan ketika pekerjaan snapshot sinkron mengalami timeout. Batas waktu timeout adalah 5 detik. File input berukuran besar mungkin melebihi batas tersebut. Jika timeout terjadi secara berkala, kirimkan pekerjaan dalam mode asinkron sebagai gantinya.

    InvalidParameter.ResourceNotFound

    Kesalahan ini dikembalikan ketika file input tidak ditemukan. Periksa penyebab berikut:

    Penyebab

    Solusi

    File input belum diunggah atau telah dihapus sebelum pekerjaan dikirim.

    Unggah file input sebelum mengirimkan pekerjaan snapshot.

    Jalur OSS file input tidak valid.

    Periksa ejaan jalurnya.

    Jalur OSS file input tidak di-URL-encode.

    Terapkan URL encoding pada jalur tersebut. URL encoding.

    Bucket OSS tidak berada di wilayah yang sama dengan MPS.

    Ubah wilayahnya.

    File input menggunakan penyimpanan Cold Archive atau Deep Cold Archive.

    Pulihkan data sebelum mengaksesnya.

    File input menggunakan penyimpanan Archive dan akses real-time dinonaktifkan atau file belum dipulihkan.

    Aktifkan akses real-time untuk data Archive, atau pulihkan file sebelum mengaksesnya.

    Perlindungan hotlink berbasis Referer diaktifkan untuk bucket OSS.

    Untuk pekerjaan yang dipicu alur kerja, konfigurasikan referer untuk bucket OSS. Untuk pekerjaan yang dikirimkan secara manual, tambahkan parameter Referer ke parameter Input.

    InvalidParameter.ResourceContentBad

    Kesalahan ini dikembalikan ketika terdapat konflik parameter atau file input rusak. Lakukan pemecahan masalah sebagai berikut:

    1. Verifikasi bahwa file input tidak rusak.

    2. Periksa parameter pekerjaan snapshot, terutama Time, FrameType, dan OutputFile.

    3. Jika kesalahan tetap terjadi, hubungi dukungan teknis Alibaba Cloud dengan menyertakan ID wilayah dan ID permintaan Anda.

    Snapshot sinkron gagal untuk file M3U8

    Untuk pekerjaan snapshot sinkron pada file M3U8, file TS yang dirujuk dalam indeks M3U8 harus berada dalam direktori yang sama dengan file M3U8. Mode asinkron tidak memiliki batasan ini.

    Snapshot gagal: waktu yang ditentukan melebihi durasi video

    Kode kesalahan: InvalidParameter.ResourceContentBad

    Pesan kesalahan: Sumber daya InputFile yang dioperasikan tidak valid

    Penyebab

    Solusi

    Parameter `time` melebihi durasi video untuk pekerjaan snapshot frame reguler tunggal.

    Atur Time ke nilai yang lebih kecil dari durasi video. Atau, gunakan mode keyframe — jika Time melebihi panjang video, keyframe terdekat akan diambil alih-alih gagal.

    Pekerjaan gagal: parameter Object OutputFile tidak valid

    Kode kesalahan: InvalidParameter.ResourceContentBad

    Pesan kesalahan: Format parameter "SnapshotConfig:OutputFile:Object" tidak valid.

    Penyebab

    Solusi

    Parameter Object dalam OutputFile tidak mengandung placeholder {count} untuk pekerjaan multi-snapshot.

    Tambahkan {Count} ke parameter Object dalam OutputFile untuk mencegah snapshot saling menimpa.

    Format diatur ke vtt untuk snapshot WebVTT, tetapi parameter Object dalam OutputFile tidak menggunakan ekstensi .vtt.

    Ubah ekstensi file dalam parameter Object menjadi .vtt.

    Pekerjaan gagal: parameter Object TileOutputFile tidak valid

    Kode kesalahan: InvalidParameter.ResourceContentBad

    Pesan kesalahan: Format parameter "SnapshotConfig:TileOutputFile:Object" tidak valid.

    Penyebab

    Solusi

    Parameter Object dalam TileOutputFile tidak mengandung placeholder {TileCount} untuk pekerjaan pembuatan sprite.

    Tambahkan {TileCount} ke parameter Object dalam TileOutputFile untuk mencegah sprite saling menimpa.

    FAQ pengaturan snapshot

    Bagaimana cara membedakan antara mode snapshot sinkron dan asinkron?

    Jika parameter Interval atau Num ditentukan dalam SnapshotConfig, pekerjaan akan berjalan dalam mode asinkron terlepas dari apakah PipelineId ditentukan atau tidak.

    Apa yang terjadi jika waktu snapshot melebihi durasi video?

    • Snapshot tunggal dengan Time melebihi Durasi:

      • Frame reguler: Pekerjaan gagal dengan kode kesalahan "InvalidParameter.ResourceContentBad" dan pesan "The resource operated InputFile is bad".

      • Keyframe: Pekerjaan berhasil. Keyframe terdekat dengan waktu yang ditentukan akan diambil.

    • Snapshot ganda: Jika Time + Interval × Num melebihi durasi video, pekerjaan tetap berhasil. Snapshot hanya diambil pada titik-titik yang berada dalam durasi video. Jumlah total snapshot yang diambil akan dikembalikan.

    Hasil snapshot tidak sesuai harapan

    Jumlah snapshot tidak sesuai pengaturan

    Periksa penyebab berikut:

    Penyebab

    Solusi

    Jalur output sprite dan jalur output gambar individual identik, sehingga file saling menimpa.

    Gunakan bucket atau jalur yang berbeda untuk OutputFile dan TileOutputFile.

    Interval dan Num keduanya ditentukan (mode pengambilan sampel). Jika video terlalu pendek, jumlah snapshot yang diambil bisa lebih sedikit dari nilai Num yang ditentukan.

    Ini merupakan perilaku yang diharapkan.

    Deteksi frame hitam diaktifkan untuk pekerjaan snapshot tunggal. Tidak ada snapshot yang diambil jika frame tersebut difilter sebagai hitam.

    Atur ulang parameter BlackLevel dan PixelBlackThreshold untuk mengurangi filter frame hitam.

    Pengambilan keyframe diaktifkan (`FrameType=intra`). Kemungkinan penyebabnya:

    • Video berisi lebih sedikit I-frame daripada nilai Num.

    • Ukuran GOP tidak tetap, sehingga I-frame tersebar tidak merata. Interval snapshot dihitung sebagai durasi video / jumlah snapshot. Dengan distribusi I-frame yang tidak merata, beberapa interval mungkin berisi beberapa I-frame sementara yang lain tidak berisi sama sekali.

    • Tidak ada I-frame di dekat waktu target, sehingga tidak ada snapshot yang diambil untuk interval tersebut.

    Untuk mengambil snapshot pada waktu yang tepat, atur FrameType ke normal.

    Waktu pengambilan snapshot tidak sesuai pengaturan

    Penyebab

    Solusi

    FrameType diatur ke intra (mode keyframe). Keyframe muncul pada interval tertentu dalam video, sehingga waktu pengambilan tidak tepat — keyframe terdekat dengan waktu yang ditentukan yang diambil.

    Untuk mengambil snapshot pada waktu yang tepat, atur FrameType ke normal.

    Snapshot buram

    Penyebab

    Solusi

    FrameType diatur ke normal. Frame reguler kurang tajam dibandingkan keyframe.

    Atur FrameType ke intra untuk snapshot yang lebih tajam.

    Distorsi snapshot atau ketidaksesuaian rasio aspek

    Periksa penyebab berikut:

    Penyebab

    Solusi

    Lebar dan tinggi keduanya ditentukan, tetapi rasio aspeknya berbeda dari video input.

    Tentukan hanya lebar atau tinggi saja. Dimensi lainnya akan diskalakan secara otomatis untuk mempertahankan rasio aspek asli.

    Nilai `Cellwidth` dan `Cellheight` tidak sesuai dengan rasio aspek sumber, sehingga gambar individual dalam sprite mengalami distorsi.

    Tentukan hanya satu dimensi (lebar atau tinggi). Dimensi lainnya akan menyesuaikan secara otomatis untuk mempertahankan rasio aspek.

    Video input memiliki atribut DAR/SAR yang tidak kompatibel.

    Hubungi dukungan teknis Alibaba Cloud dengan menyertakan ID wilayah dan ID pekerjaan snapshot Anda.

    Video potret menghasilkan snapshot lanskap

    Video MP4 dalam mode potret berisi identifier rotasi (umum pada video yang direkam perangkat seluler), sehingga snapshot muncul dalam orientasi lanskap.

    Untuk memeriksa keberadaan identifier rotasi:

    Panggil SubmitMediaInfoJob dan periksa parameter Rotate. Nilai -90 atau 90 menunjukkan video diputar, sehingga orientasi tampilannya berbeda dari input aslinya.

    Snapshot sinkron tidak menghasilkan sprite atau file VTT

    Mode sinkron hanya mengambil satu snapshot dan tidak mendukung pembuatan sprite atau output WebVTT. Untuk menghasilkan sprite atau snapshot WebVTT, kirimkan pekerjaan dalam mode asinkron.