Cara menambahkan templat snapshot - ApsaraVideo VOD - Alibaba Cloud Documentation Center

ApsaraVideo VOD menyediakan templat snapshot dengan parameter yang telah ditetapkan untuk secara otomatis mengambil tangkapan video dalam alur kerja. Topik ini menjelaskan cara memilih metode snapshot, membuat dan mengelola templat, serta menggunakan templat dalam alur kerja guna mengotomatiskan proses pengambilan snapshot.

Perbandingan metode snapshot

Metode snapshot mencakup Normal Snapshot, WebVTT, dan Image Sprite. Untuk informasi selengkapnya, lihat Video snapshots.

Metode snapshot	Skenario	Kelebihan dan kekurangan
Normal Snapshot	Gambar mini video, moderasi konten, dan berbagi sorotan.	Kelebihan: Sangat fleksibel. Cocok untuk skenario yang memerlukan gambar tunggal. Kekurangan: Banyak snapshot menghasilkan banyak file dan permintaan HTTP. Hal ini dapat memengaruhi kinerja pemuatan.
WebVTT	Menampilkan gambar mini saat Anda mengarahkan kursor ke bilah progres pemutar web atau H5.	Kelebihan: Kompatibel dengan pratinjau gambar mini pada bilah progres pemutar web dan H5. Kekurangan: Memiliki tujuan tunggal. Tidak dapat digunakan sebagai gambar mandiri.
Sprite	Skenario yang memerlukan pratinjau gambar mini pada klien seluler atau pemutar dengan persyaratan kinerja pemuatan tinggi.	Kelebihan: Mengurangi jumlah permintaan HTTP. Mengoptimalkan kinerja pemuatan antarmuka depan. Cocok untuk skenario seluler. Kekurangan: Proses konfigurasi relatif kompleks. Gambar mini individual dalam sprite tidak dapat dirujuk secara langsung.

Buat templat snapshot

Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi di sebelah kiri, pilih Configuration Management > Media Processing > Snapshot Templates.

Klik Create Snapshot Template. Pada halaman Add Snapshot Template, konfigurasikan parameter templat.

Penting

Metode snapshot (Normal Snapshot, WebVTT, atau Sprite) tidak dapat diubah setelah templat dibuat. Pastikan pilihan Anda sebelum menyimpan templat.

Parameter umum

Parameter berikut berlaku untuk semua metode snapshot.

Parameter	Deskripsi
Template Name	Nama kustom templat. Digunakan untuk identifikasi dan referensi dalam alur kerja.
Start Time	Waktu mulai proses Snapshot (HH:MM:SS).
Number of Snapshots	Jumlah total snapshot yang akan dihasilkan.
Snapshot Interval	Interval waktu antara beberapa snapshot. Jika Anda mengatur nilai ini ke 0 atau membiarkannya kosong, snapshot diambil pada interval yang sama berdasarkan durasi video.
Dimensions (Width × Height)	Lebar dan tinggi snapshot dalam piksel. Catatan Jika Anda tidak mengatur lebar dan tinggi, dimensi snapshot akan sama dengan video input. Jika Anda hanya mengatur lebar atau tinggi, dimensi lainnya diskalakan secara proporsional sesuai rasio aspek video agar tidak terjadi distorsi.
Frame Type	Jenis frame yang diambil untuk snapshot. Opsi mencakup keyframe dan frame biasa. Catatan Jika Anda memilih keyframe, hanya keyframe yang diambil. Jika tidak ada keyframe pada titik waktu yang ditentukan, keyframe terdekat dipilih secara otomatis. Dalam kondisi yang sama, mengambil keyframe lebih cepat daripada mengambil frame biasa.

Parameter khusus WebVTT

Parameter	Deskripsi
Generate a large image	Menentukan apakah akan menggabungkan beberapa gambar mini yang diperlukan untuk WebVTT menjadi satu gambar besar untuk penyimpanan.

Parameter khusus Sprite

Parameter	Deskripsi
Layout (Rows × Columns)	Parameter untuk mengatur lebar dan tinggi gambar kecil dalam sprite. Catatan Jika tidak diatur, lebar dan tinggi gambar kecil akan sama dengan snapshot normal. Jika hanya satu dimensi yang diatur, dimensi lainnya diskalakan secara proporsional.
Row Spacing	Jarak vertikal antar baris gambar kecil dalam sprite, dalam piksel.
Column Spacing	Jarak horizontal antar kolom gambar kecil dalam sprite, dalam piksel.
Background Color	Warna latar belakang sprite yang dihasilkan.
Keep Individual Images	Menentukan apakah akan menyimpan gambar asli penyusun sprite setelah sprite dihasilkan.

Setelah menyelesaikan konfigurasi, klik Save.

Gunakan templat snapshot dalam alur kerja

Setelah membuat templat snapshot, Anda harus menambahkannya ke alur kerja agar dapat digunakan selama unggah atau pemrosesan media.

Sambungkan templat ke alur kerja.

Masuk ke atau ApsaraVideo VOD console. Di panel navigasi kiri, pilih Configuration Management > Media Processing > Workflows. Tambahkan atau edit alur kerja, lalu sisipkan node Snapshots ke dalam alur kerja tersebut. Di panel konfigurasi node di sebelah kanan, pilih templat snapshot yang telah Anda buat.
Picu alur kerja.

Setelah menyambungkan templat, Anda dapat memicu alur kerja dengan salah satu cara berikut.
1. Pemicu Otomatis: Saat Anda mengunggah file audio atau video, tentukan alur kerja ini. Alur kerja akan berjalan secara otomatis setelah file diunggah. Untuk informasi selengkapnya, lihat Unggah file di Konsol ApsaraVideo VOD.
2. Pemicu Manual: Pada halaman Media Files > Audio/Video, pilih aset media target, klik Processing, pilih Use Workflow, lalu tentukan alur kerja ini.
3. Pemicu API: Panggil operasi SubmitWorkflowJobs untuk menentukan alur kerja ini.
Ambil hasil snapshot.

Anda dapat mengambil hasil snapshot dari Notifikasi event SnapshotComplete. Saat tangkapan video berhasil diambil, sistem mengirimkan pesan callback ke URL yang telah dikonfigurasi. Isi pesan berisi daftar data snapshot.

Penagihan

Fitur snapshot ApsaraVideo VOD tidak dikenai biaya.

FAQ

Apa yang harus saya lakukan jika tidak menerima notifikasi event SnapshotComplete?

Anda dapat melakukan langkah-langkah berikut untuk memecahkan masalah:

Pastikan status video input adalah Normal dan file video tidak rusak.
Verifikasi bahwa parameter dalam templat snapshot valid. Misalnya, waktu mulai tidak boleh melebihi durasi video.
Pastikan callback notifikasi event telah dikonfigurasi dengan benar. Untuk informasi selengkapnya, lihat Event notifications.

Bagaimana cara menggunakan templat snapshot secara langsung melalui API?

Anda dapat memanggil operasi SubmitSnapshotJob untuk memulai pekerjaan snapshot secara independen.