Fitur Snapshot ApsaraVideo Live - ApsaraVideo Live

Fitur Snapshots mengambil snapshot siaran langsung secara real-time.

Prasyarat

Fitur Snapshots menyimpan file snapshot di dalam bucket. Anda harus mengaktifkan Object Storage Service (OSS) dan membuat setidaknya satu bucket untuk menyimpan file snapshot tersebut. Untuk informasi selengkapnya, lihat Aktifkan OSS dan Buat bucket.

Penting

Bucket harus berada di wilayah yang sama dengan live center dari domain streaming. Snapshot lintas wilayah tidak didukung.

Aturan snapshot

Anda dapat mengonfigurasi Snapshots untuk setiap AppName. Anda dapat menetapkan aturan snapshot untuk semua stream ingest di bawah AppName tertentu.
Catatan
Jika Anda menetapkan AppName ke tanda bintang (*), aturan snapshot akan berlaku untuk semua stream ingest di bawah nama domain tersebut.
Saat mengonfigurasi fitur Snapshots, Anda dapat memilih dari dua jenis snapshot: overwrite dan real-time.
- Snapshot overwrite: Setiap snapshot baru akan menimpa snapshot sebelumnya.
- Snapshot real-time: Setiap snapshot baru disimpan tanpa menimpa yang sebelumnya. Snapshot disimpan secara bertahap.
- Snapshots saat ini hanya mendukung format JPG.
  Catatan
  Anda dapat memilih kedua jenis tersebut. Anda harus memilih setidaknya satu jenis.

Tinjauan fitur

Catatan

Templat snapshot yang baru dikonfigurasi tidak berlaku untuk siaran langsung yang sedang berlangsung. Anda harus me-restart stream ingest agar templat tersebut berlaku.

Konfigurasikan fitur video snapshot

Anda dapat mengonfigurasi fitur Snapshots menggunakan salah satu metode berikut:

Konfigurasikan fitur snapshot di konsol

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi di sebelah kiri, pilih Feature Management > Snapshots. Pada halaman Snapshots, klik tab Snapshot Settings.
Pilih domain streaming yang akan dikonfigurasi.
Klik Add.

Konfigurasikan templat snapshot.

Tabel berikut menjelaskan parameter untuk templat snapshot.

Parameter	Deskripsi
Application Name	Nama aplikasi. Application Name harus sama dengan AppName yang digunakan untuk stream ingest. Untuk mengonfigurasi snapshot untuk nama domain, masukkan tanda bintang (*).
Snapshot Interval	Interval snapshot dalam detik. Nilai yang valid: 5 hingga 3600.
Storage Location	Pilih lokasi penyimpanan file snapshot di OSS. Bucket OSS harus berada di wilayah yang sama dengan live center dari domain streaming. Snapshot lintas wilayah tidak didukung.
Storage Mode	Tersedia dua metode penyimpanan. Anda dapat memilih keduanya. Overwrite: Snapshot diambil pada interval yang ditentukan. Setiap snapshot baru akan menimpa yang sebelumnya. New: Snapshot diambil pada interval yang ditentukan. Snapshot baru disimpan secara berurutan di OSS dalam urutan N+1 (N≥0). Catatan Jika Anda memilih keduanya, snapshot akan diambil menggunakan kedua metode tersebut.

Catatan

Setelah konfigurasi selesai, snapshot akan diambil dan disimpan untuk semua Application Name yang ditentukan di bawah nama domain berdasarkan templat tersebut.

Perubahan pengaturan snapshot akan berlaku setelah Anda me-restart stream ingest.

Klik OK.

Snapshot konfigurasi API

Panggil operasi AddLiveAppSnapshotConfig untuk mengonfigurasi fitur snapshot.

Kelola file snapshot

Lihat file snapshot

Anda dapat melihat file snapshot dengan salah satu cara berikut.

Lihat file snapshot di konsol

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi di sebelah kiri, pilih Feature Management > Snapshots. Pada halaman Snapshots, klik Snapshot Management.
Pilih nama domain dan rentang waktu. Lalu, masukkan atau pilih AppName dan StreamName.
Klik Search untuk melihat snapshot dalam rentang waktu yang dipilih. Jika Anda tidak dapat melihat snapshot, pastikan daftar kontrol akses (ACL) bucket OSS diatur ke public-read. Untuk informasi selengkapnya, lihat Konfigurasikan ACL bucket OSS.
Arahkan pointer ke gambar untuk melihat versi yang lebih besar atau menyalin URL snapshot.

Lihat file snapshot dengan memanggil API

Panggil operasi DescribeLiveStreamSnapshotInfo untuk melihat file snapshot.

Lihat file snapshot di OSS

Saat mengonfigurasi fitur snapshot, Anda telah menentukan alamat penyimpanan file snapshot di OSS. Untuk melihat file snapshot di OSS, lihat Daftar objek di OSS.

Hapus file snapshot

ApsaraVideo Live menyimpan informasi file snapshot, seperti AppName, StreamName, dan path penyimpanan OSS. File snapshot itu sendiri disimpan di OSS. Untuk menghapus file dari OSS saat Anda menghapus snapshot, Anda harus membuat peran layanan AliyunMTSVideoLifecycleRole dan menyambungkan kebijakan sistem AliyunMTSVideoLifecycleRolePolicy ke peran tersebut.

Prosedur otorisasi

Anda harus memberikan izin terlebih dahulu sebelum dapat menghapus snapshot atau rekaman di Konsol ApsaraVideo Live. Untuk memberikan izin yang diperlukan, buat dan otorisasi peran RAM di Konsol RAM. Setelah itu, Anda dapat masuk ke Konsol ApsaraVideo Live untuk menghapus file tersebut.

Buat peran layanan

Masuk ke Konsol RAM sebagai administrator RAM.
Pada panel navigasi di sebelah kiri, pilih Identities > Roles.
Pada halaman Roles, klik Create Role.
Pada halaman Create Role, atur Principal Type menjadi Cloud Service. Lalu, pilih layanan tepercaya dan klik OK.
Catatan
Dari daftar drop-down Principal Name, pilih ApsaraVideo Media Processing.
Pada kotak dialog Create Role, masukkan "AliyunMTSVideoLifecycleRole" di bidang Role Name dan klik OK.
Setelah peran dibuat, pada halaman Basic Information-nya, klik tab Permissions.
Klik Precise Permissions. Konfigurasikan parameter sebagai berikut:
- Policy Type: System Policy
- Policy Name: AliyunMTSVideoLifecycleRolePolicy
Setelah konfigurasi selesai, klik OK.

Anda dapat menghapus file snapshot dengan salah satu cara berikut:

Hapus file snapshot di konsol

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi di sebelah kiri, pilih Feature Management > Snapshots. Pada halaman Snapshots, klik Snapshot Management.
Pilih nama domain dan rentang waktu. Lalu, masukkan atau pilih AppName dan StreamName.
Arahkan pointer ke gambar dan klik ikon hapus untuk menghapus satu snapshot.
Untuk menghapus beberapa snapshot sekaligus, pilih snapshot tersebut dan klik Batch Delete. Anda dapat menghapus hingga 200 snapshot sekaligus.

Hapus file snapshot dengan memanggil API

Panggil operasi DeleteSnapshotFiles untuk menghapus file snapshot. Ini juga akan menghapus file yang disimpan di OSS.

Anda dapat mengonfigurasi callback snapshot untuk menyimpan informasi snapshot, termasuk timestamp, ke sistem bisnis Anda. Kemudian, Anda dapat menghapus file yang sesuai berdasarkan kebijakan kustom, seperti pembersihan terjadwal. Untuk informasi selengkapnya, lihat Callback snapshot siaran langsung.

Referensi

Untuk menggunakan Java SDK, lihat Panduan Pengguna Java SDK.

Untuk API lain terkait snapshot siaran langsung, lihat API snapshot siaran langsung.