

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à.

# Utilizzo delle variabili nelle impostazioni del lavoro
<a name="using-variables-in-your-job-settings"></a>

Puoi utilizzare variabili, denominate anche *identificatori di formato*, nelle impostazioni del processo. Gli identificatori di formato sono valori che puoi inserire nelle impostazioni di processo che vengono risolti in modo diverso negli output a seconda delle caratteristiche dei file di input o del processo. Sono particolarmente utili nei set di impostazioni dell'output, nei modelli di processo e nei processi che si desidera duplicare e riutilizzare. Nota che le variabili fanno distinzione tra maiuscole e minuscole

Ad esempio, puoi utilizzare l'identificatore del formato data `$d$` per l'impostazione **Destination (Destinazione)**. Se gli output devono essere organizzati per data e ora di avvio del processo, per **Destination (Destinazione)** è possibile immettere **s3://amzn-s3-demo-bucket1/$d$/**. Per un processo che inizia il 4 giugno 2020, il servizio crea gli output in `s3://amzn-s3-demo-bucket1/20200604/`.

Per un elenco degli identificatori di formato disponibili ed esempi di come utilizzarli, consulta [Elenco delle variabili di impostazione con esempi](#list-of-settings-variables-with-examples).

Per informazioni sugli identificatori di formato che funzionano diversamente negli output di streaming, consulta [Utilizzo di variabili di impostazione con output di streaming](#using-settings-variables-with-streaming-outputs).

**Topics**
+ [Elenco delle variabili di impostazione con esempi](#list-of-settings-variables-with-examples)
+ [Utilizzo di variabili di impostazione con output di streaming](#using-settings-variables-with-streaming-outputs)
+ [Specificare un numero minimo di cifre](#specifying-a-minimum-number-of-digits)

## Elenco delle variabili di impostazione con esempi
<a name="list-of-settings-variables-with-examples"></a>

La tabella seguente fornisce informazioni su ciascuno degli identificatori di formato che è possibile utilizzare nel proprio AWS Elemental MediaConvert job. Per informazioni sugli identificatori di formato che funzionano diversamente negli output di streaming, consulta [Utilizzo di variabili di impostazione con output di streaming](#using-settings-variables-with-streaming-outputs).


| Identificatore di formato | Valore da inserire nell'impostazione del lavoro | Impostazioni di lavoro compatibili | Descrizione ed esempio | 
| --- |--- |--- |--- |
| Data e ora | `$dt$` | Destinazione<br />Modificatore nome<br />Modificatore segmento | Data e ora UTC dell'ora di avvio del processo.<br />Formato: AAAAMMGGTHHMMSS<br />Esempio: per un processo che inizia alle 15:05:28 del 4 giugno 2020, **$dt$** viene risolto in `20200604T150528`.  | 
| Data | `$d$` | Destinazione<br />Modificatore nome<br />Modificatore segmento | Data UTC dell'ora di inizio del processo. <br />Formato: AAAAMMGG<br />Esempio: per un processo che inizia il 4 giugno 2020, **$d$** viene risolto in `20200604`.  | 
| Orario | `$t$` | Destinazione<br />Modificatore nome<br />Modificatore segmento | Ora di inizio in formato UTC del processo. <br />Formato: HHMMSS<br />Esempio: per un processo che inizia alle 15:05:28, **$t$** viene risolto in `150528`.  | 
| Bitrate video | `$rv$` | Modificatore nome<br />Modificatore segmento | Il bitrate video dell'output, in kilobit. Per output QVBR, il servizio utilizza bitrate video massimo, in kilobit.<br />Esempio: se imposti **Encoding settings (Impostazioni di encoding)**, **Video**, **Bitrate (bits/s)** su **50000000**, **$rv$** viene risolto in `50000`. | 
| Bitrate audio | `$ra$` | Modificatore nome<br />Modificatore segmento | Totale di tutti i bitrate audio nell'output, in kilobit.<br />Esempio: se disponi di un output con una singola scheda audio e imposti **Encoding settings (Impostazioni di encoding)**, **Audio 1**, **Bitrate (Kbit/s)** su **256000**, **$ra$** viene risolto in `256000`. | 
| Bitrate container | `$rc$` | Modificatore nome<br />Modificatore segmento | Bitrate audio e video combinato per l'output, in kilobit.<br />Esempio: disponi di un output con una scheda delle impostazioni **Video** e una scheda delle impostazioni **Audio 1**. Se imposti **Encoding settings (Impostazioni di encoding)**, **Video**, **Bitrate (bits/s)** su **5000000** e imposti **Encoding settings (Impostazioni di encoding)**, **Audio**, **Bitrate (bits/s)** su **96000** (96 kilobits), **$rc$** viene risolto in `5096`. | 
| Larghezza frame video | `$w$` | Modificatore nome<br />Modificatore segmento | La larghezza frame, o risoluzione orizzontale, in pixel.<br />Esempio: se imposti **Encoding settings (Impostazioni di encoding)**, **Video**, **Resolution (w x h) (Risoluzione (l x a))** su **1280** x **720** , **$w$** viene risolto in `1280`. | 
| Altezza frame video | `$h$` | Modificatore nome<br />Modificatore segmento | L'altezza frame, o risoluzione verticale, in pixel.<br />Esempio: se imposti **Encoding settings (Impostazioni di encoding)**, **Video**, **Resolution (w x h) (Risoluzione (l x a))** su **1280** x **720** , **$h$** viene risolto in `720`. | 
| Framerate | `$f$` | Modificatore nome<br />Modificatore segmento | Framerate, in fotogrammi al secondo, troncato al numero intero più vicino. <br />Esempio: se il framerate è **59.940**, **$f$** viene risolto in `59`.  | 
| Nome del file di input | `$fn$` | Destinazione<br />Modificatore nome<br />Modificatore segmento | Nome del file di input, senza l'estensione file. Per i processi che dispongono di più input, questo è il primo file specificato nel processo.<br />Esempio: se **Input 1** per il processo è **s3://amzn-s3-demo-bucket/my-video.mov**, **$fn$** viene risolto in `my-video`. | 
| Estensione file del container di output | `$ex$` | Modificatore nome<br />Modificatore segmento | Varia in funzione del gruppo di output. Per output **File group (Gruppo di file)**, questa è l'estensione del file di container di output. Per gli altri gruppi di output, questa è l'estensione del manifest.<br />Esempio di gruppo di file: se scegli **MPEG2-TS** per **le impostazioni di output**, **Container**, **$ex$** si risolve in. `m2ts`<br />Esempio per gruppo HLS: se il gruppo di output è HLS, **$ex$** viene risolto in `m3u8`. | 
| $ | `$$` | Modificatore nome<br />Modificatore segmento | `$` in sequenza escape.<br />Esempio: <br />Supponi di fornire i seguenti valori:   Nome file di input: **file1.mp4**   Destinazione: **s3://amzn-s3-demo-bucket/**   Modificatore del nome: **my-video$$hi-res-**  <br />Il nome del file di output e il percorso vengono risolti in `s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4`. | 

## Utilizzo di variabili di impostazione con output di streaming
<a name="using-settings-variables-with-streaming-outputs"></a>

Le variabili nelle impostazioni del processo, denominate anche *identificatori di formato*, funzionano in modo diverso per gli output in gruppi di output Apple HLS e DASH ISO. Di seguito sono illustrate le differenze:

**Per output Apple HLS**  
Quando utilizzi identificatori del formato di data e ora (`$dt$`, `$t$`, `$d$`) nell'impostazione **Segment modifier (Modificatore del segmento)**, questi identificatori di formato vengono risolti nell'ora di completamento di ogni segmento, piuttosto che nell'ora di inizio del processo.

**Nota**  
Per i processi che utilizzano la transcodifica accelerata, i segmenti potrebbero terminare nello stesso momento. Ciò significa che gli identificatori del formato di data e ora non sempre vengono risolti in valori univoci.

**Per output DASH ISO**  
Puoi usare due ulteriori identificatori di formato aggiuntivi nell'impostazione **Name modifier (Modificatore nome)**. Questi influenzano il manifest DASH in aggiunta al nome del file di output. Di seguito sono descritti gli identificatori:

$Number$  
Nei nomi di file di output, `$Number$` viene risolto in una serie di numeri che vengono incrementati da 1. Questo sostituisce la numerazione segmento a nove cifre, predefinita nei nomi dei file di segmento. Esempio:   
+ Se specifichi **video\_$Number$** per **Name modifier (Modificatore nome)**, il servizio crea file di segmento denominati `video_1.mp4`, `video_2.mp4` e così via.
+ Se specifichi solo **video\_** per **Name modifier (Modificatore nome)**, il servizio crea file di segmento denominati `video_000000001.mp4`, `video_000000002.mp4` e così via.
Nel tuo manifesto DASH, AWS Elemental MediaConvert include `duration` e `startNumber` all'interno dell'`SegmentTemplate`elemento, in questo modo: `<SegmentTemplate timescale="90000" media="main_video_$Number$.mp4" initialization="main_video_$Number$init.mp4" duration="3375000"/>`  
Se utilizzi l'identificatore di formato `$Number$` in un output, devi anche utilizzarlo in qualsiasi altro output del gruppo di output.

$Bandwidth$   
Nei nomi di file di output, `$Bandwidth$` viene risolto nel valore di **Video**, **Bitrate** più il valore di **Audio**, **Bitrate** nell'output. A prescindere che questo identificatore di formato venga incluso o meno, il servizio utilizza la numerazione segmento a nove cifre nei nomi dei file di segmento.  
Ad esempio, supponi di specificare i seguenti valori:  
+ **Video**, **Bitrate (bits/s)**: **50000000** 
+  **Audio**, **Bitrate (kbit/s)**: **96.0** (96.000 bits/s)
+ **Name modifier (Modificatore nome)**: **video\_$Bandwidth$**
Il valore di $Bandwidth$ si risolve a 50.096.000. Il servizio crea file di segmento denominati `video_50096000_000000001.mp4`, `video_50096000_000000002.mp4` e così via.  
Nel manifesto, AWS Elemental MediaConvert include `duration` e `startNumber` all'interno dell'`SegmentTemplate`elemento, in questo modo:`<SegmentTemplate timescale="90000" media="main_video_$Bandwidth$.mp4" initialization="main_video_$Bandwidth$init.mp4" duration="3375000"/>`.

$Time$  
Nei nomi di file di output, `$Time$` viene risolto nella durata, in millisecondi, del segmento. Quando includi questo identificatore di formato, il servizio non utilizza la numerazione segmento a nove cifre, predefinita nei nomi dei file di segmento.  
Ad esempio, se specifichi **video180\_\_$Time$** per **Name modifier (Modificatore nome)**, il servizio crea file di segmento denominati `video180__345600.mp4`, `video180__331680.mp4` e così via. In questi esempi, le durate del segmento sono 345.600 ms e 331.680 ms.  
Nel manifesto, AWS Elemental MediaConvert include `SegmentTimeline` all'interno dell'`SegmentTemplate`elemento, in questo modo:   

```
<Representation id="5" width="320" height="180" bandwidth="200000" codecs="avc1.4d400c">
        <SegmentTemplate media="video180_$Time$.mp4" initialization="videovideo180_init.mp4">
          <SegmentTimeline>
            <S t="0" d="345600" r="2"/>
            <S t="1036800" d="316800"/>
          </SegmentTimeline>
        </SegmentTemplate>
      </Representation>
```
Se utilizzi l'identificatore di formato `$Time$` in un output, devi anche utilizzarlo in qualsiasi altro output del gruppo di output.

$representationId$  
Nei nomi dei file di output, viene `$RepresentationID$` risolto in base all'ordine numerico dell'output nelle impostazioni del processo.  
Nel manifesto, AWS Elemental MediaConvert utilizza questo identificatore nell'`SegmentTemplate`elemento per fare riferimento ai percorsi corretti per ogni rappresentazione.  
Questo identificatore di formato è particolarmente utile quando è necessario organizzare gli output DASH in base all'ID di rappresentazione.

## Specificare un numero minimo di cifre
<a name="specifying-a-minimum-number-of-digits"></a>

Per identificatori di formato che restituiscono un numero, puoi specificare un numero minimo di cifre in cui verrà risolto l'identificatore di formato. In questo caso, il servizio aggiunge zeri di riempimento prima di qualsiasi valore che restituisce un numero minore di cifre.

Utilizza la sintassi seguente per specificare il numero di cifre: **%0[number of digits]**. Inserisci questo valore prima del `$` finale dell'identificatore di formato.

Ad esempio, supponi che l'altezza dei frame video sia 720 e che desideri specificare un minimo di quattro cifre, in modo che venga visualizzata nel nome file come `0720`. A tale scopo, utilizza l'identificatore di formato seguente: **$h%04$**.

**Nota**  
I valori troppo grandi per essere espressi nel numero di cifre specificato vengono risolti con più cifre.