ApsaraVideo VOD：Snapshots video

Ikhtisar

Anda dapat mengambil snapshots video pada titik waktu tertentu untuk menghasilkan file gambar. Untuk mempermudah penggunaan fitur ini, ApsaraVideo VOD menyediakan template snapshot yang dapat dibuat dengan menentukan parameter terkait. Anda dapat mengambil snapshot dengan menentukan ID dari sebuah template snapshot.

Jenis snapshot

• Snapshot Thumbnail (CoverSnapshot)

  ApsaraVideo VOD mengambil snapshot dari setiap file mezzanine video. Snapshot ini disebut snapshot thumbnail. Secara default, ApsaraVideo VOD mengambil maksimal delapan snapshot berdasarkan keyframes video. Snapshot pertama diambil pada keyframe pertama setelah lima milidetik pertama video. Anda dapat melihat snapshot thumbnail di halaman detail video konsol ApsaraVideo VOD dan memilih salah satu sebagai thumbnail video.

• Snapshot Normal (NormalSnapshot)

  Anda dapat memanggil operasi API untuk mengambil snapshot dari video tertentu. Anda dapat mengatur waktu mulai dan interval untuk mengambil snapshot, jumlah total snapshot, serta lebar dan tinggi snapshot. Jika Anda mengambil snapshot dari video berulang kali dengan memanggil operasi API, ApsaraVideo VOD hanya menyimpan data snapshot yang dikembalikan oleh operasi terakhir. Untuk informasi lebih lanjut, lihat SubmitSnapshotJob.

• Snapshot Sprite (SpriteSnapshot)

  Untuk mengambil snapshot sprite dari video, ApsaraVideo VOD mengambil snapshot normal dan kemudian menggabungkannya berdasarkan aturan penyusunan tertentu. Snapshot normal ini disebut snapshot sumber sprite. Snapshot sprite dapat mengurangi jumlah permintaan snapshot sehingga informasi dari beberapa snapshot dapat diperoleh melalui satu permintaan snapshot sprite. Ini meningkatkan performa klien.

  Sebagai contoh, jika Anda menyusun snapshot normal menjadi 10 baris dan 10 kolom dalam snapshot sprite, Anda dapat memperoleh hingga 100 snapshot normal dari snapshot sprite. Jika jumlah snapshot normal kurang dari 100, snapshot sprite yang berisi kurang dari 100 snapshot normal akan dihasilkan. Jika jumlah snapshot normal melebihi 100, snapshot sprite kedua akan dihasilkan untuk menampung snapshot normal tambahan. Proses ini berulang sampai semua snapshot diperoleh. Gambar-gambar berikut menunjukkan contoh snapshot sprite.

  Catatan

  Pada gambar-gambar di atas, jumlah total snapshot normal adalah 50. Snapshot normal disusun menjadi 10 baris dan 3 kolom dalam snapshot sprite. Snapshot sprite pertama berisi 30 snapshot normal, dan snapshot sprite kedua berisi 20 snapshot normal.

• Snapshot Sumber Sprite (SpriteOriginSnapshot)

  Snapshot sumber sprite adalah snapshot normal yang digunakan untuk menyusun snapshot sprite. Anda dapat menghapus atau menyimpan snapshot sumber sprite. Jika snapshot sumber sprite disimpan, Anda dapat menanyakan mereka dengan memanggil operasi API. Untuk informasi lebih lanjut, lihat ListSnapshots.

• Tangkapan Layar WebVTT

  Tangkapan layar WebVTT adalah file VTT yang berisi informasi dasar dari semua tangkapan layar, seperti waktu dan URL. Informasi dalam file VTT dapat diperoleh dan diuraikan untuk digunakan sebagai pratinjau thumbnail pada bilah kemajuan.

WebVTT metode penyimpanan snapshot

• Penyimpanan Terpisah

  Snapshot disimpan secara terpisah dan lokasi relatif serta waktunya disimpan dalam file VTT, seperti yang ditunjukkan pada gambar berikut.

• Penyimpanan Kolektif

  Semua snapshot disimpan sebagai satu gambar. Ketika sistem mengakses snapshot tertentu, ia menemukan snapshot berdasarkan isi file VTT, seperti yang ditunjukkan pada gambar berikut.

Catatan penggunaan

• Snapshot Thumbnail

  Setelah video diunggah, ApsaraVideo VOD mengambil snapshot thumbnail dari file mezzanine video sebagai thumbnail video yang direkomendasikan. Anda tidak dikenakan biaya selama proses ini.

• Snapshot yang Diambil dengan Memanggil Operasi API

  Anda dapat mengambil snapshot normal dan sprite dari video tertentu dengan memanggil operasi API. Untuk informasi lebih lanjut, lihat SubmitSnapshotJob. Anda dapat menggunakan metode ini untuk mengambil snapshot normal dan snapshot sprite.

• Cara Menanyakan Snapshot

  ApsaraVideo VOD memungkinkan Anda menanyakan snapshot video dengan menggunakan metode berikut:

  • Anda dapat memperoleh informasi snapshot dengan menerima notifikasi event SnapshotComplete. Untuk informasi lebih lanjut, lihat SnapshotComplete.

  • Anda dapat memperoleh informasi snapshot default dengan memanggil operasi GetVideoInfo. Untuk informasi lebih lanjut, lihat GetVideoInfo.

  • Anda dapat menanyakan snapshot dengan memanggil operasi ListSnapshots. Untuk informasi lebih lanjut, lihat ListSnapshots.

• Cara Menghapus Snapshot

  ApsaraVideo VOD tidak memungkinkan Anda mengelola snapshot secara terpisah. Anda harus mengelolanya bersama-sama dengan video. Saat Anda menghapus video, semua snapshotnya juga dihapus dan tidak dapat dipulihkan.

Pengelolaan template snapshot

Banyak parameter terlibat ketika snapshot diambil. Tidak efisien untuk menentukan semua parameter ini saat Anda mengirimkan tugas pengambilan snapshot. Oleh karena itu, ApsaraVideo VOD menyediakan template snapshot yang dapat Anda buat dengan menentukan parameter terkait. Anda dapat mengambil snapshot dengan menentukan ID dari sebuah template snapshot.

Anda dapat mengelola template snapshot melalui konsol ApsaraVideo VOD atau dengan memanggil operasi API.

• Kelola Template Snapshot Menggunakan Konsol

  Anda dapat membuat, memodifikasi, dan menghapus template snapshot di konsol ApsaraVideo VOD.

• Kelola Template Snapshot dengan Memanggil Operasi API

  Untuk informasi lebih lanjut, lihat AddVodTemplate.

Parameter snapshot

• Parameter untuk Snapshot Normal

  Catatan

  Tabel berikut hanya mencantumkan beberapa parameter untuk snapshot normal. Untuk informasi lebih lanjut, lihat bagian SnapshotConfig dari Parameter Pemrosesan Media.

  Parameter API	Parameter Konsol	Deskripsi
  FrameType	Tipe Frame	Tipe frame dari snapshot. Nilai valid: intra dan normal. intra menunjukkan keyframes dan normal menunjukkan frames. Lebih cepat menangkap keyframes daripada frames ketika aturan snapshot yang sama diterapkan.
  SpecifiedOffsetTime	Waktu Mulai	Waktu mulai untuk mengambil snapshot. Nilainya adalah bilangan bulat positif. Unit: milidetik. Jika hanya satu snapshot yang diambil, SpecifiedOffsetTime menentukan waktu snapshot diambil.
  Count	Jumlah Snapshot	Jumlah total snapshot yang akan diambil.
  Interval	Interval Snapshot	Interval antara snapshot ketika beberapa snapshot diambil. Jika nilai Count lebih besar dari 1 dan nilai Interval tidak 0, sistem mengambil jumlah snapshot yang ditentukan pada interval yang ditentukan. Jika nilai Count lebih besar dari 1 dan nilai Interval adalah 0, sistem mengambil jumlah snapshot yang ditentukan dalam durasi video. Jika parameter FrameType diatur ke intra dan jumlah keyframes lebih kecil dari nilai Count, jumlah snapshot yang diambil lebih kecil dari nilai Count. Jika nilai Count adalah 1, sistem mengambil satu snapshot.
  Width	Lebar	Lebar snapshot. Unit: piksel. Nilai valid: 8 hingga 4096. Catatan Deskripsi parameter Width dan Height: Jika tidak ada parameter Width atau Height yang ditentukan, lebar dan tinggi snapshot sama dengan file mezzanine video. Jika hanya salah satu dari parameter Width atau Height yang ditentukan, parameter lainnya diatur otomatis berdasarkan rasio aspek video input untuk memastikan bahwa snapshot tidak terdistorsi.
  Height	Tinggi	Tinggi snapshot. Unit: piksel. Nilai valid: 8 hingga 4096.

• Parameter untuk Snapshot WebVTT

  Ketika Anda mengambil snapshot WebVTT, Anda harus menentukan parameter Format dan SubOut seperti yang tercantum dalam tabel berikut selain dari yang untuk snapshot normal.

  Parameter API	Parameter Konsol	Deskripsi
  Format	Format	Format untuk mengumpulkan informasi indeks untuk snapshot. Tetapkan nilainya ke VTT. Catatan Parameter ini hanya diperlukan ketika Anda mengambil snapshot WebVTT.
  SubOut		Menentukan metode penyimpanan snapshot WebVTT. Nilai valid: false: menyimpan snapshot secara terpisah. true: menyimpan snapshot sebagai satu gambar. Parameter ini hanya diperlukan ketika Anda mengambil snapshot WebVTT. Contoh: { "IsSptFrag":"true" }

• Parameter untuk Snapshot Sprite

  Catatan

  Tabel berikut hanya mencantumkan beberapa parameter yang harus ditentukan ketika Anda mengambil snapshot sprite. Untuk informasi lebih lanjut, lihat bagian SpriteSnapshotConfig dari Parameter Pemrosesan Media.

  Parameter API	Parameter Konsol	Deskripsi
  CellWidth	Lebar	Lebar dan tinggi gambar kecil dalam snapshot sprite. Jika tidak ada parameter CellWidth atau CellHeight yang ditentukan, lebar dan tinggi gambar kecil sama dengan snapshot normal. Jika hanya salah satu dari parameter CellWidth atau CellHeight yang ditentukan, parameter lainnya diatur otomatis berdasarkan rasio aspek video input.
  CellHeight	Tinggi
  KeepCellPic	Simpan Snapshot	Menentukan apakah akan menyimpan snapshot sumber sprite setelah snapshot sprite dihasilkan. Nilai valid: delete dan keep. Catatan Kami sarankan Anda menghapus snapshot sumber sprite kecuali diperlukan sebaliknya.
  Color	Warna Latar Belakang	Warna latar belakang snapshot sprite. Untuk informasi lebih lanjut, lihat Parameter pengaturan warna. Catatan Nilai RGB tidak didukung. Gambar berikut memberikan diagram skematik parameter snapshot sprite.