Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Visualizzazione delle miniature di input
MediaLive puoi generare miniature per il video dagli input dei tuoi canali. La miniatura consente di verificare visivamente che il contenuto contenga video. È possibile visualizzare le miniature di ogni canale sulla console. MediaLive Puoi anche usarne una per lavorare con le miniature AWS APIs a livello di codice.
**Come vengono generate le miniature**
Quando hai abilitato le miniature in un canale e il canale è in esecuzione, MediaLive genera una miniatura JPEG ogni 2 secondi. La miniatura esiste solo per 2 secondi, finché non viene sostituita dalla miniatura successiva. Ogni input ha una propria miniatura, il che significa che MediaLive genera una miniatura per un canale a pipeline singola e due miniature per un canale standard.
Non appena la miniatura viene generata, la MediaLive visualizza sulla console, nella pagina dei dettagli del canale. Inoltre, rende disponibile la miniatura come dati binari. È possibile utilizzare un' AWS API per lavorare con i dati binari a livello di codice.
**Crittografia della miniatura**
MediaLive crittografa sempre ogni miniatura man mano che viene creata.
**Topics**
+ [Abilitare le miniature in un canale](thumbnails-enable.md)
+ [Visualizzazione delle miniature sulla console](thumbnails-view.md)
+ [Recupero delle miniature a livello di codice](thumbnails-work-cli.md)
+ [Limite alle miniature in MediaLive](thumbnail-limits.md)
# Abilitare le miniature in un canale
È necessario abilitare la funzionalità delle miniature in ciascuna di esse. MediaLivechannel
È possibile abilitare o disabilitare le miniature solo quando il canale è inattivo (non in esecuzione).
**Topics**
+ [Fornire l'accesso IAM](#thumbnails-enable-iam)
+ [Attivazione delle miniature sulla console](#thumbnails-enable-console)
+ [Attivazione delle miniature a livello di codice](#thumbnails-enable-progammatically)
## Fornire l'accesso IAM
Affinché la funzionalità delle miniature funzioni, è MediaLive necessario accedere ad Amazon S3:
+ Se la tua organizzazione utilizza l'entità MediaLiveAccessRole fidata, vai alla pagina **Canale e inserisci i dettagli** della configurazione del canale e consulta la sezione Informazioni **generali**. Se in questa sezione viene visualizzato il pulsante **Aggiorna ruolo**, selezionalo. Se il pulsante non viene visualizzato, l'entità fidata dispone già dell'accesso necessario
+ Se la tua organizzazione utilizza ruoli di entità fidata personalizzati, un amministratore IAM deve aggiornare i ruoli di entità fidata appropriati. Per informazioni sulle operazioni da aggiungere, leggi[Requisiti di accesso per l'entità affidabile](trusted-entity-requirements.md). Cerca **thumbnails** in quella pagina. Per informazioni su come aggiornare il ruolo, vedere[Crea l'entità fidata: opzione complessa](setup-trusted-entity-complex.md).
## Attivazione delle miniature sulla console
**Nota**
In questa sezione si presuppone che si abbia familiarità con la creazione o la modifica di un canale, come illustrato in [Creare un canale da zero](creating-channel-scratch.md).
1. Apri la MediaLive console all'indirizzo. [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/)
1. Nella pagina **Crea canale** o **Modifica canale**, scegli **Impostazioni generali**, quindi apri la sezione **Configurazione delle miniature**.
1. Seleziona **Abilita la configurazione delle miniature**. **In **Stato**, scegli **AUTO** o DISABLED.**
## Attivazione delle miniature a livello di codice
Per abilitare la funzionalità delle miniature, includi il `ThumbnailConfiguration` gruppo di parametri nel JSON per il canale. Imposta il `State` parametro su `AUTO` (per abilitare) o. `DISABLED`
L'esempio seguente mostra la posizione relativa dei parametri nel JSON per il canale.
```
{
"ChannelClass": "SINGLE_PIPELINE",
.
.
.
"EncoderSettings": {
.
.
.
"TimecodeConfig": {
"Source": "EMBEDDED"
},
"ThumbnailConfiguration": {
"State": "DISABLED"
},
.
.
.
```
# Visualizzazione delle miniature sulla console
Quando le miniature sono abilitate, MediaLive genera miniature per l'input attualmente attivo in un canale in esecuzione. Per un canale standard, MediaLive genera due miniature. Per un canale a pipeline singola, MediaLive genera una miniatura.
1. Apri la console all'indirizzo. MediaLive [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/)
1. Scegli **Canali** dalla barra di navigazione. Nell'elenco dei canali, seleziona il canale in base al suo nome. Viene visualizzata la pagina Dettagli.
La sezione **Status** include una cornice con miniature. Se il canale ha due ingressi, lo schermo include una scheda per ogni ingresso.
Quando il canale è in esecuzione e viene visualizzata la pagina Dettagli, la miniatura si aggiorna automaticamente ogni 2 secondi, per la pipeline nella scheda attiva. MediaLive non genera alcuna miniatura se questa pagina non è visualizzata.
Se il canale non è in esecuzione, la cornice è nera.
Se il canale smette di funzionare, l'anteprima delle miniature interrompe l'aggiornamento. Dopo alcuni secondi, la miniatura corrente viene sostituita da un messaggio.
# Recupero delle miniature a livello di codice
Quando la funzionalità delle miniature è abilitata, MediaLive genera miniature per l'input attualmente attivo in un canale in esecuzione. Per un canale standard, MediaLive genera due miniature. Per un canale a pipeline singola, MediaLive genera una miniatura.
È possibile utilizzarlo per lavorare con le miniature AWS CLI a livello di codice. Le informazioni seguenti presuppongono che l'utente abbia dimestichezza con le nozioni di base relative all'utilizzo di. AWS CLI[Per informazioni di base, vedere Command Reference.AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/)
Utilizza il comando `DescribeThumbnails`. Questo comando è rappresentato in modo diverso in diverse interfacce:
+ Nel AWS CLI, il comando è`describe-thumbnails`.
+ Nell'API, il comando è rappresentato da un `HTTP GET` su `describe-thumbnails/kmsKeyId`.
+ In AWS SDKs, il comando è rappresentato da costrutti adatti a quel linguaggio SDK.
**Per recuperare le miniature utilizzando il AWS CLI**
1. Assicurati di aver [abilitato le miniature nel canale e assicurati che il canale](thumbnails-enable.md) sia in esecuzione.
1. Immettere il comando:
**aws medialive describe-thumbnails --channel-id *value* --pipeline-id *value* --thumbnail-type *value* **
Dove:
`channel-id` è obbligatorio.
`pipeline-id`è 0 o 1. Se desideri visualizzare le anteprime di entrambe le pipeline, inserisci il comando due volte.
`thumbnail-type` è sempre `CURRENT_ACTIVE`. Questa opzione è obbligatoria, anche se ha un solo valore.
1. La risposta viene visualizzata sullo schermo. Esempio:
```
{
"ThumbnailDetails": [
{
"PipelineId": "0",
"Thumbnails": [
{
"Body"base64 string of the JPEG image",
"ContentType": "image/jpeg",
"ThumbnailType": "CURRENT_ACTIVE",
"TimeStamp": "2023-07-15T21:01:11"
}
]
}
]
}
```
Se le miniature sono disabilitate, la risposta è simile alla seguente:
```
{
"ThumbnailDetails": []
}
```
# Limite alle miniature in MediaLive
Esiste un limite al numero di immagini MediaLivethumbnails che è possibile visualizzare o recuperare. Il limite è:
`A number of API transactions per second, per account, in one Region`
Il limite di transazione è condiviso da tutte le miniature, quelle visualizzate sulla console e quelle recuperate tramite un'API. AWS Per il limite attuale, consulta la MediaLive pagina nella console [Service Quotas](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/services/medialive/quotas).
Sulla console, viene generata una miniatura per un canale solo quando viene visualizzata la pagina dei dettagli del canale e solo nella scheda attiva (ovvero solo per una pipeline nel canale). Per le pipeline pertinenti, MediaLive effettua una chiamata all'API ogni 2 secondi circa.