Prasyarat
Fitur Snapshots memerlukan file snapshot disimpan dalam bucket. Oleh karena itu, Anda harus mengaktifkan layanan OSS dan memiliki setidaknya satu bucket untuk menyimpan file snapshot tersebut. Untuk informasi lebih lanjut, lihat Aktifkan Layanan OSS dan Buat Bucket.
Penting
Bucket harus berada di Wilayah yang sama dengan live center dari domain ingest. Snapshot lintas-Wilayah tidak didukung.
Aturan snapshot
-
Snapshots dikonfigurasi untuk stream ingest pada level AppName. Anda dapat mengatur aturan snapshot untuk semua stream ingest di bawah AppName tertentu.
Catatan
Jika Anda mengatur AppName ke tanda bintang (*), aturan snapshot berlaku untuk semua stream ingest di bawah domain ingest.
-
Saat mengonfigurasi fitur Snapshots, Anda dapat menentukan dua jenis snapshot: snapshot overwrite dan snapshot real-time.
-
Snapshot overwrite menggantikan file snapshot sebelumnya setiap kali snapshot baru dihasilkan.
-
Snapshot real-time tidak menggantikan file snapshot sebelumnya. Setiap snapshot baru disimpan sebagai file inkremental.
-
Saat ini, Snapshots hanya dapat dihasilkan dalam format JPG.
Catatan
Anda dapat memilih kedua mode, tetapi Anda harus memilih minimal satu.
Konfigurasi dan manajemen snapshot
Catatan
Templat snapshot yang baru dikonfigurasi tidak berlaku untuk siaran langsung yang sedang berlangsung. Anda harus restart stream ingest agar perubahan diterapkan.
Konfigurasi snapshot
Anda dapat mengonfigurasi fitur video Snapshots dengan dua cara berikut:
Konfigurasi snapshot di Konsol
-
Masuk ke Konsol ApsaraVideo Live.
-
Di bilah navigasi kiri, pilih Feature Management > Snapshots. Di halaman Snapshots, pilih tab Snapshot Settings.
-
Pilih domain ingest yang ingin Anda konfigurasikan.
-
Klik Add.
-
Konfigurasi templat snapshot.
Tabel berikut menjelaskan parameter untuk templat snapshot.
|
Parameter
|
Deskripsi
|
|
Application Name
|
Nama aplikasi. Pengaturan ini hanya berlaku jika Application Name yang dimasukkan cocok dengan Application Name yang digunakan untuk ingest siaran langsung. Untuk mengonfigurasi snapshot pada level domain, masukkan tanda bintang (*).
|
|
Snapshot Interval
|
Interval pengambilan snapshot. Satuan: detik. Nilai valid: 5 hingga 3600.
|
|
Storage Location
|
Pilih lokasi di OSS untuk menyimpan file snapshot.
Bucket OSS harus berada di Wilayah yang sama dengan live center dari domain ingest. Snapshot lintas-Wilayah tidak didukung.
|
|
Storage Mode
|
Tersedia dua mode penyimpanan. Anda dapat memilih satu atau keduanya.
-
Overwrite: Snapshot diambil pada interval yang ditentukan. Setiap snapshot baru menggantikan yang sebelumnya.
-
New: Snapshot diambil pada interval yang ditentukan. Snapshot baru disimpan secara berurutan dalam urutan N+1, dengan N ≥ 0.
Catatan
Jika Anda memilih kedua mode, snapshot akan dihasilkan dan disimpan dengan kedua cara tersebut.
|
Catatan
Setelah konfigurasi selesai, screenshot akan diambil dan disimpan untuk semua Application Name yang dikonfigurasi di bawah Nama domain ini sesuai dengan templat yang telah ditentukan.
Perubahan pada pengaturan snapshot akan berlaku setelah stream ingest berikutnya.
-
Klik OK.
Manajemen file snapshot
Menampilkan snapshot
Anda dapat melihat file snapshot dengan tiga cara:
Lihat file snapshot di Konsol
-
Masuk ke Konsol ApsaraVideo Live.
-
Di bilah navigasi kiri, pilih Feature Management > Snapshots. Di halaman Snapshots, pilih Snapshot Management.
-
Pilih domain dan rentang waktu untuk kueri Anda. Lalu, masukkan atau pilih AppName dan StreamName.
-
Klik Search untuk melihat snapshot dalam rentang waktu yang dipilih. Jika Anda tidak dapat melihat snapshot, pastikan izin bucket OSS diatur ke public-read. Untuk informasi lebih lanjut, lihat Konfigurasi ACL bucket OSS.
Di tab Snapshot Management, Anda dapat memfilter snapshot berdasarkan tanggal, AppName, dan StreamName.
-
Arahkan kursor ke gambar untuk melihat versi yang lebih besar atau menyalin URL snapshot.
Lihat file snapshot di OSS
Saat mengonfigurasi fitur snapshot, Anda telah menentukan path penyimpanan di OSS. Untuk melihat file snapshot di OSS, lihat List objects.
Menghapus snapshot
ApsaraVideo Live menyimpan metadata file snapshot, seperti AppName, StreamName, dan path penyimpanan OSS. File aktual disimpan di OSS. Untuk menghapus file di OSS saat Anda menghapus catatan snapshot terkait di ApsaraVideo Live, Anda harus membuat peran layanan AliyunMTSVideoLifecycleRole dan memberikan izin menggunakan kebijakan sistem AliyunMTSVideoLifecycleRolePolicy.
Prosedur otorisasi
Sebelum Anda dapat menghapus snapshot atau rekaman di Konsol ApsaraVideo Live, Anda harus memberikan izin yang diperlukan. Ikuti langkah-langkah berikut untuk membuat dan mengotorisasi peran Resource Access Management (RAM) di Konsol RAM, lalu kembali ke Konsol ApsaraVideo Live untuk menghapus file.
Buat peran layanan
-
Masuk ke Konsol RAM sebagai administrator RAM.
-
Di panel navigasi kiri, pilih .
-
Di halaman Roles, klik Create Role.
-
Di halaman Create Role, pilih Alibaba Cloud Service untuk Trusted Entity Type, lalu klik OK.
Catatan
Dari daftar drop-down Trusted Service, pilih Media Processing.
-
Di kotak dialog Create Role, masukkan "AliyunMTSVideoLifecycleRole" untuk Role Name dan klik OK. Nama peran dapat memiliki panjang maksimal 64 karakter dan boleh berisi huruf, angka, tanda hubung (-), serta titik (.).
-
Setelah peran dibuat, di halaman Basic Information, klik tab Permissions.
-
Klik Input and Attach dan konfigurasikan parameter berikut:
Setelah mengonfigurasi parameter, klik OK.
Hapus file snapshot di Konsol
-
Masuk ke Konsol ApsaraVideo Live.
-
Di bilah navigasi kiri, pilih Feature Management> Snapshots. Di halaman Snapshots, pilih Snapshot Management.
-
Pilih domain dan rentang waktu untuk kueri Anda. Lalu, masukkan atau pilih AppName dan StreamName.
-
Arahkan kursor ke gambar dan klik ikon hapus untuk menghapus satu snapshot.
Untuk menghapus beberapa snapshot, centang kotak pilihan masing-masing lalu klik Batch Delete. Anda dapat menghapus hingga 200 snapshot sekaligus.
Hapus file snapshot menggunakan API
Panggil operasi DeleteSnapshotFiles untuk menghapus file snapshot. Ini juga akan menghapus file yang tersimpan di OSS.
Anda dapat mengonfigurasi event callback untuk mengirim informasi snapshot, termasuk timestamp, ke sistem bisnis Anda. Hal ini memungkinkan Anda menghapus file terkait berdasarkan kebijakan kustom, seperti pembersihan berkala. Untuk informasi lebih lanjut, lihat panduan pengembangan event callback.