Cara menambahkan templat snapshot - ApsaraVideo VOD

ApsaraVideo VOD menyediakan templat snapshot dengan parameter yang telah ditentukan untuk secara otomatis mengambil tangkapan video dalam alur kerja pemrosesan media. Topik ini menjelaskan cara memilih jenis snapshot, membuat dan mengelola templat, serta menggunakan templat dalam alur kerja untuk menghasilkan snapshot secara otomatis.

Perbandingan jenis snapshot

Jenis snapshot terdiri dari Normal Snapshot, WebVTT, dan Image Sprite. Untuk informasi selengkapnya, lihat Video Snapshots.

Jenis 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, yang memengaruhi performa pemuatan.
WebVTT	Menampilkan gambar mini pratinjau saat mengarahkan kursor ke bilah progres pada pemutar Web/H5.	Kelebihan: Kompatibel dengan pratinjau bilah progres pada pemutar Web/H5. Kekurangan: Memiliki tujuan tunggal. Tidak dapat digunakan sebagai gambar mandiri.
Image Sprite	Skenario yang memerlukan gambar mini pratinjau pada klien seluler atau pada pemutar yang membutuhkan performa pemuatan optimal.	Kelebihan: Mengurangi jumlah permintaan HTTP dan mengoptimalkan performa pemuatan antarmuka depan. Ideal untuk skenario seluler. Kekurangan: Proses konfigurasinya relatif kompleks. Gambar kecil individual tidak dapat dirujuk secara langsung.

Buat templat snapshot

Masuk ke Konsol ApsaraVideo VOD.
Pada bilah navigasi kiri, pilih Configuration Management > Media Processing > Snapshot Templates untuk membuka halaman Snapshot Templates.

Klik Create Snapshot Template. Pada halaman Add Snapshot Template, konfigurasikan templat snapshot sesuai kebutuhan bisnis Anda.

Penting

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

Configuration

Parameter umum

Parameter berikut berlaku untuk semua jenis snapshot.

Parameter	Deskripsi
Template Name	Nama kustom untuk templat. Digunakan untuk identifikasi dan referensi dalam alur kerja.
Start Time	Waktu mulai pengambilan Snapshot, dalam format HH:MM:SS.
Snapshot Count	Jumlah total snapshot yang akan dihasilkan.
Snapshot Interval	Interval waktu antar beberapa snapshot. Jika Anda mengatur parameter ini ke 0 atau membiarkannya kosong, snapshot diambil pada interval yang merata berdasarkan durasi video.
Size (Width × Height)	Lebar dan tinggi snapshot. Satuan: piksel. Catatan Jika Anda tidak mengatur lebar dan tinggi, snapshot memiliki dimensi yang sama dengan video input. Jika Anda hanya mengatur lebar atau tinggi, dimensi lainnya diskalakan berdasarkan rasio aspek video agar tidak terdistorsi.
Frame Type	Jenis frame untuk snapshot mencakup keyframe dan frame normal. Catatan Jika Anda memilih Keyframe, hanya keyframe yang diambil. Jika titik waktu yang ditentukan bukan keyframe, keyframe terdekat akan dipilih secara otomatis. Dalam kondisi yang sama, pengambilan keyframe lebih cepat daripada pengambilan frame normal.

Parameter khusus WebVTT

Parameter	Deskripsi
Generate Large Image	Menentukan apakah akan menggabungkan beberapa gambar mini yang diperlukan untuk WebVTT menjadi satu gambar besar untuk disimpan.

Parameter khusus image sprite

Parameter	Deskripsi
Arrangement (Rows × Columns)	Pengaturan lebar dan tinggi untuk gambar kecil dalam image sprite. Catatan Jika Anda tidak mengatur parameter ini, gambar kecil memiliki dimensi yang sama dengan snapshot normal. Jika Anda hanya mengatur satu dimensi, dimensi lainnya diskalakan secara proporsional.
Row Spacing	Ruang vertikal antar baris gambar kecil dalam image sprite. Satuan: piksel.
Column Spacing	Ruang horizontal antar kolom gambar kecil dalam image sprite. Satuan: piksel.
Background Color	Warna latar belakang image sprite.
Retain Small Images	Menentukan apakah akan menyimpan gambar asli penyusun image sprite saat sprite dihasilkan.

Setelah konfigurasi selesai, klik Save.

Gunakan templat snapshot dalam alur kerja

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

Sambungkan templat ke alur kerja.
Masuk ke atau Konsol ApsaraVideo VOD, buka Configuration Management > Media Processing > Workflows, tambahkan atau edit alur kerja, sisipkan node Snapshots, lalu pilih templat Snapshot yang telah dibuat di pengaturan node pada panel sebelah kanan.
Picu alur kerja.
Setelah templat disambungkan, Anda dapat memicu alur kerja dengan cara berikut.
1. Pemicu Otomatis: Tentukan alur kerja saat Anda mengunggah file audio atau video. Setelah unggahan selesai, alur kerja akan dieksekusi secara otomatis. Untuk informasi selengkapnya, lihat Unggah file menggunakan 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 tersebut.
3. Pemicu API: Panggil operasi Submit Video-on-Demand Workflow Job untuk menentukan pekerjaan alur kerja ini.
Dapatkan hasil snapshot.
Anda dapat memperoleh hasil tangkapan layar melalui notifikasi event Video Screenshot Completion. Setelah tangkapan video berhasil, sistem mengirim pesan callback ke alamat yang dikonfigurasi, dan isi pesan berisi daftar data tangkapan layar.

Penagihan

Fitur snapshot ApsaraVideo VOD tidak dikenai biaya.

FAQ

Apa yang harus saya lakukan jika tidak menerima event SnapshotComplete?

Anda dapat melakukan pemecahan masalah sebagai berikut:

Pastikan status video input adalah Normal dan file video tidak rusak.
Pastikan parameter dalam templat snapshot valid. Misalnya, periksa apakah waktu mulai melebihi durasi video.
Verifikasi bahwa konfigurasi callback notifikasi event benar. Untuk informasi selengkapnya, lihat Event Notifications.

Bagaimana cara menggunakan templat snapshot langsung melalui API?

Anda dapat memanggil operasi Submit Media Snapshot Job untuk memulai pekerjaan snapshot secara independen.