Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Melihat thumbnail masukan
MediaLive dapat menghasilkan thumbnail untuk video dari input di saluran Anda. Thumbnail memberikan verifikasi visual bahwa konten berisi video. Anda dapat melihat thumbnail untuk setiap saluran di konsol. MediaLive Anda juga dapat menggunakan salah satu AWS APIs untuk bekerja dengan thumbnail secara terprogram.
**Bagaimana thumbnail dihasilkan**
Ketika Anda telah mengaktifkan thumbnail di saluran dan saluran sedang berjalan, buat thumbnail MediaLive JPEG setiap 2 detik. Thumbnail hanya ada selama 2 detik, sampai digantikan oleh thumbnail berikutnya. Setiap input memiliki thumbnail sendiri, yang berarti MediaLive menghasilkan satu thumbnail untuk saluran pipa tunggal, dan dua thumbnail untuk saluran standar.
Segera setelah thumbnail dibuat, MediaLive tampilkan di konsol, di halaman detail saluran. Itu juga membuat thumbnail tersedia sebagai data biner. Anda dapat menggunakan AWS API untuk bekerja dengan data biner secara terprogram.
**Enkripsi thumbnail**
MediaLive selalu mengenkripsi setiap thumbnail saat dibuat.
**Topics**
+ [Mengaktifkan thumbnail di saluran](thumbnails-enable.md)
+ [Melihat thumbnail di konsol](thumbnails-view.md)
+ [Mengambil thumbnail secara terprogram](thumbnails-work-cli.md)
+ [Batasi thumbnail di MediaLive](thumbnail-limits.md)
# Mengaktifkan thumbnail di saluran
Anda harus mengaktifkan fitur thumbnail di masing-masing. MediaLivechannel
Anda dapat mengaktifkan atau menonaktifkan thumbnail hanya ketika saluran dalam keadaan idle (tidak berjalan).
**Topics**
+ [Menyediakan akses IAM](#thumbnails-enable-iam)
+ [Mengaktifkan thumbnail di konsol](#thumbnails-enable-console)
+ [Mengaktifkan thumbnail secara terprogram](#thumbnails-enable-progammatically)
## Menyediakan akses IAM
Agar fitur thumbnail berfungsi, MediaLive perlu akses ke Amazon S3:
+ Jika organisasi Anda menggunakan entitas MediaLiveAccessRole tepercaya, buka halaman **Saluran dan masukan detail** konfigurasi saluran, dan lihat di bagian **Info umum**. Jika tombol **Perbarui peran** muncul di bagian ini, pilih tombol. Jika tombol tidak muncul, maka entitas tepercaya sudah memiliki akses yang dibutuhkannya
+ Jika organisasi Anda menggunakan peran entitas tepercaya khusus, administrator IAM harus memperbarui peran entitas tepercaya yang sesuai. Untuk informasi tentang operasi yang akan ditambahkan, baca[Persyaratan akses untuk entitas tepercaya](trusted-entity-requirements.md). Cari **thumbnails** di halaman itu. Untuk informasi tentang cara memperbarui peran, lihat[Buat entitas tepercaya - opsi kompleks](setup-trusted-entity-complex.md).
## Mengaktifkan thumbnail di konsol
**catatan**
Bagian ini mengasumsikan bahwa Anda terbiasa membuat atau mengedit saluran, seperti yang dijelaskan dalam[Membuat saluran dari awal](creating-channel-scratch.md).
1. Buka MediaLive konsol di [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/).
1. Pada halaman **Buat saluran** atau **Edit saluran**, pilih **Pengaturan umum**, lalu buka bagian **konfigurasi Thumbnail**.
1. Pilih **Aktifkan konfigurasi thumbnail**. Di **Negara Bagian**, pilih **AUTO** atau **DINONAKTIFKAN**.
## Mengaktifkan thumbnail secara terprogram
Untuk mengaktifkan fitur thumbnail, sertakan `ThumbnailConfiguration` grup parameter di JSON untuk saluran. Atur `State` parameter ke `AUTO` (untuk mengaktifkan) atau`DISABLED`.
Contoh berikut menunjukkan lokasi relatif parameter di JSON untuk saluran.
```
{
"ChannelClass": "SINGLE_PIPELINE",
.
.
.
"EncoderSettings": {
.
.
.
"TimecodeConfig": {
"Source": "EMBEDDED"
},
"ThumbnailConfiguration": {
"State": "DISABLED"
},
.
.
.
```
# Melihat thumbnail di konsol
Saat thumbnail diaktifkan, buat MediaLive thumbnail untuk input yang saat ini aktif di saluran yang sedang berjalan. Untuk saluran standar, buat dua MediaLive thumbnail. Untuk saluran pipa tunggal, buat satu MediaLive thumbnail.
1. Buka MediaLive konsol di [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/).
1. Pilih **Saluran** dari bilah navigasi. Pada daftar saluran, pilih saluran dengan namanya. Halaman Detail muncul.
Bagian **Status** mencakup bingkai thumbnail. Jika saluran memiliki dua input, layar menyertakan tab untuk setiap input.
Saat saluran berjalan dan halaman Detail ditampilkan, thumbnail secara otomatis diperbarui setiap 2 detik, untuk pipeline di tab aktif. MediaLive tidak menghasilkan thumbnail apa pun jika halaman ini tidak ditampilkan.
Jika saluran tidak berjalan, bingkai berwarna hitam.
Jika saluran berhenti berjalan, pratinjau thumbnail berhenti diperbarui. Setelah beberapa detik, thumbnail saat ini diganti dengan pesan.
# Mengambil thumbnail secara terprogram
Saat fitur thumbnail diaktifkan, buat MediaLive thumbnail untuk input yang sedang aktif di saluran yang sedang berjalan. Untuk saluran standar, buat dua MediaLive thumbnail. Untuk saluran pipa tunggal, buat satu MediaLive thumbnail.
Anda dapat menggunakan AWS CLI untuk bekerja dengan thumbnail secara terprogram. Informasi berikut mengasumsikan bahwa Anda terbiasa dengan dasar-dasar penggunaan. AWS CLI Untuk informasi tentang dasar-dasarnya, lihat [Referensi AWS CLI Perintah](https://docs.aws.amazon.com/cli/latest/reference/).
Gunakan perintah `DescribeThumbnails`. Perintah ini direpresentasikan secara berbeda dalam antarmuka yang berbeda:
+ Dalam AWS CLI, perintahnya adalah`describe-thumbnails`.
+ Di API, perintah diwakili oleh `HTTP GET` on`describe-thumbnails/kmsKeyId`.
+ Dalam AWS SDKs, perintah diwakili oleh konstruksi yang sesuai dengan bahasa SDK itu.
**Untuk mengambil thumbnail menggunakan AWS CLI**
1. Pastikan Anda telah [mengaktifkan thumbnail di saluran](thumbnails-enable.md), dan pastikan saluran berjalan.
1. Masukkan perintah ini:
**aws medialive describe-thumbnails --channel-id *value* --pipeline-id *value* --thumbnail-type *value* **
Di mana:
`channel-id` diperlukan.
`pipeline-id`adalah 0 atau 1. Jika Anda ingin thumbnail untuk kedua pipeline, masukkan perintah dua kali.
`thumbnail-type` selalu `CURRENT_ACTIVE`. Opsi ini diperlukan, meskipun hanya memiliki satu nilai.
1. Respons muncul di layar. Contoh:
```
{
"ThumbnailDetails": [
{
"PipelineId": "0",
"Thumbnails": [
{
"Body"base64 string of the JPEG image",
"ContentType": "image/jpeg",
"ThumbnailType": "CURRENT_ACTIVE",
"TimeStamp": "2023-07-15T21:01:11"
}
]
}
]
}
```
Jika thumbnail dinonaktifkan, responsnya terlihat seperti ini:
```
{
"ThumbnailDetails": []
}
```
# Batasi thumbnail di MediaLive
Ada batasan jumlah yang dapat Anda lihat atau ambil. MediaLivethumbnails Batasnya adalah:
`A number of API transactions per second, per account, in one Region`
Batas transaksi dibagi oleh semua thumbnail — yang Anda tampilkan di konsol, dan yang Anda ambil menggunakan API. AWS Untuk batas saat ini, lihat MediaLive halaman di konsol [Service Quotas](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/services/medialive/quotas).
Di konsol, thumbnail dibuat untuk saluran hanya ketika halaman detail saluran ditampilkan, dan hanya di tab aktif (artinya hanya untuk satu saluran di saluran). Untuk pipeline yang relevan, MediaLive lakukan panggilan ke API kira-kira setiap 2 detik.