As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Uso de variáveis em configurações de tarefa
Você pode usar variáveis, também chamadas de *identificadores de formato*, nas configurações de tarefa. Os identificadores de formato são valores que você pode colocar nas configurações de tarefa que são resolvidos de forma diferente nas saídas de acordo com as características dos arquivos de entrada ou da tarefa. Eles são particularmente úteis em predefinições de saída, modelos de tarefa e tarefas que você pretende duplicar e reutilizar. Observe que as variáveis diferenciam maiúsculas de minúsculas.
Por exemplo, você pode usar o identificador de formato de data `$d$` para a configuração **Destination (Destino)**. Se você quiser que as saídas sejam organizadas por data e hora de início da tarefa, em **Destination (Destino)**, insira **s3://amzn-s3-demo-bucket1/\$1d\$1/**. Para um trabalho que começa em 4 de junho de 2020, o serviço criará as saídas em `s3://amzn-s3-demo-bucket1/20200604/`.
Para obter uma lista dos identificadores de formato disponíveis e exemplos de como usá-los, consulte [Lista de variáveis de configurações com exemplos](#list-of-settings-variables-with-examples).
Para obter informações sobre identificadores de formato que funcionam de forma diferente em saídas de streaming, consulte [Usar variáveis de configurações com saídas de streaming](#using-settings-variables-with-streaming-outputs).
**Topics**
+ [Lista de variáveis de configurações com exemplos](#list-of-settings-variables-with-examples)
+ [Usar variáveis de configurações com saídas de streaming](#using-settings-variables-with-streaming-outputs)
+ [Especificar um número mínimo de dígitos](#specifying-a-minimum-number-of-digits)
## Lista de variáveis de configurações com exemplos
A tabela a seguir fornece informações sobre cada um dos identificadores de formato que você pode usar em seu AWS Elemental MediaConvert trabalho. Para obter informações sobre identificadores de formato que funcionam de forma diferente em saídas de streaming, consulte [Usar variáveis de configurações com saídas de streaming](#using-settings-variables-with-streaming-outputs).
| Identificador de formato | Valor a ser colocado na configuração da tarefa | Configurações de tarefa compatíveis | Descrição e exemplo |
| --- |--- |--- |--- |
| Data e hora | `$dt$` | Destino Modificador de nome Modificador de segmento | Data e hora UTC de início da tarefa. Formato: AAAAMMDDTHHMMSS Exemplo: para uma tarefa que começa às 3:05:28 PM em 4 de junho de 2020, o **\$1dt\$1** é resolvido como `20200604T150528`. |
| Data | `$d$` | Destino Modificador de nome Modificador de segmento | Data UTC do horário de início da tarefa. Formato: AAAAMMDD Exemplo: para uma tarefa que começa em 4 de junho de 2020, o **\$1d\$1** é resolvido como `20200604`. |
| Hora | `$t$` | Destino Modificador de nome Modificador de segmento | Horário de início UTC da tarefa. Formato: HHMMSS Exemplo: para uma tarefa que começa às 3:05:28 PM, o **\$1t\$1** é resolvido como `150528`. |
| Taxa de bits de vídeo | `$rv$` | Modificador de nome Modificador de segmento | A taxa de bits do vídeo de saída, em kilobits. Para saídas QVBR, o serviço usa a taxa de bits de vídeo máxima em kilobits. Exemplo: se você definir **Encoding settings (Configurações de codificação)**, **Video (Vídeo)**, **Bitrate (Taxa de bits) (bits/s)** como **50000000**, **\$1rv\$1** será resolvido como `50000`. |
| Taxa de bits de áudio | `$ra$` | Modificador de nome Modificador de segmento | Total de todas as taxas de bits de áudio na saída, em kilobits. Exemplo: se você tiver uma saída com uma única guia de áudio e definir **Encoding settings (Configurações de codificação)**, **Audio 1 (Áudio 1)**, **Bitrate (Taxa de bits) (kbit/s)** como **256000**, **\$1ra\$1** será resolvido como `256000`. |
| Taxa de bits de contêiner | `$rc$` | Modificador de nome Modificador de segmento | Taxa de bits de áudio e vídeo combinada para a saída, em kilobits. Exemplo: você tem uma saída com uma guia de configurações de **Video (Vídeo)** e uma guia de configurações de **Audio 1 (Áudio 1)**. Se você definir **Encoding settings (Configurações de codificação)**, **Video (Vídeo)**, **Bitrate (Taxa de bits) (bits/s)** como **5000000** e definir **Encoding settings (Configurações de codificação)**, **Audio (Áudio)**, **Bitrate (Taxa de bits) (bits/s)** como **96000** (96 kilobits), **\$1rc\$1** será resolvido como `5096`. |
| Largura de quadros de vídeo | `$w$` | Modificador de nome Modificador de segmento | A largura do quadro, ou resolução horizontal, em pixels. Exemplo: se você definir **Encoding settings (Configurações de codificação)**, **Video (Vídeo)**, **Resolution (w x h) (Resolução (l x a)** como **1280** x **720**, **\$1w\$1** será resolvido como `1280`. |
| Altura de quadros de vídeo | `$h$` | Modificador de nome Modificador de segmento | A altura do quadro, ou resolução vertical, em pixels. Exemplo: se você definir **Encoding settings (Configurações de codificação)**, **Video (Vídeo)**, **Resolution (w x h) (Resolução (l x a)** como **1280** x **720**, **\$1h\$1** será resolvido como `720`. |
| Framerate | `$f$` | Modificador de nome Modificador de segmento | Taxa de quadros, em quadros por segundo, truncados para o número inteiro mais próximo. Exemplo: se a taxa de quadros for **59.940**, **\$1f\$1** será resolvido como `59`. |
| Nome do arquivo de entrada | `$fn$` | Destino Modificador de nome Modificador de segmento | Nome do arquivo de entrada, sem a extensão do arquivo. Para tarefas que têm várias entradas, este é o primeiro arquivo especificado na tarefa. Exemplo: se **Input 1 (Entrada 1)** para a tarefa for **s3://amzn-s3-demo-bucket/my-video.mov**, **\$1fn\$1** será resolvido como `my-video`. |
| Extensão de arquivo de contêiner de saída | `$ex$` | Modificador de nome Modificador de segmento | Varia, dependendo do grupo de saída. Para saídas **File group (Grupo de arquivos)**, esta é a extensão do arquivo de contêiner de saída. Para outros grupos de saída, esta é a extensão do manifesto. Exemplo de grupo de arquivos: se você escolher **MPEG2-TS para as** **configurações de saída**, **Container**, **\$1ex\$1** resolverá para. `m2ts` Exemplo de grupo de HLS: se seu grupo de saída for HLS, **\$1ex\$1** será resolvido como `m3u8`. |
| \$1 | `$$` | Modificador de nome Modificador de segmento | `$` com escape. Exemplo: Suponha que você forneça os seguintes valores: Nome do arquivo de entrada: **file1.mp4** Destino: **s3://amzn-s3-demo-bucket/** Nome do modificador: **my-video\$1\$1hi-res-** O nome e o caminho do arquivo de saída são resolvidos como `s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4`. |
## Usar variáveis de configurações com saídas de streaming
As variáveis nas configurações da tarefa, também chamadas de *identificadores de formato*, funcionam de forma diferente para saídas em grupos de saída Apple HLS e DASH ISO. Veja as diferenças:
**Para saídas Apple HLS**
Quando você usa os identificadores de formato de data e hora (`$dt$`, `$t$`, `$d$`) na configuração **Segment modifier (Modificador de segmento)**, esses identificadores são resolvidos como a hora de conclusão de cada segmento, em vez de como a hora de início da tarefa.
**nota**
Para tarefas que usam transcodificação acelerada, os segmentos podem ser concluídos ao mesmo tempo. Isso significa que os identificadores de formato de data e hora nem sempre são resolvidos como valores exclusivos.
**Para saídas DASH ISO**
Você pode usar dois identificadores de formato adicionais na configuração **Name modifier (Modificador de nome)**. Eles afetam o manifesto DASH, além do nome de arquivo de saída. Aqui estão os identificadores:
\$1Number\$1
Nos nomes de arquivo de saída , `$Number$` é resolvido como uma série de números que aumentam a partir de 1. Isso substitui a numeração de segmentos padrão de nove dígitos nos nomes de arquivo de segmento. Por exemplo:
+ Se você especificar **video\$1\$1Number\$1** para **Name modifier (Modificador de nome)**, o serviço criará arquivos de segmento chamados `video_1.mp4`, `video_2.mp4`, e assim por diante.
+ Se você especificar apenas **video\$1** para **Name modifier (Modificador de nome)**, o serviço criará arquivos de segmento chamados `video_000000001.mp4`, `video_000000002.mp4`, e assim por diante.
Em seu manifesto DASH, AWS Elemental MediaConvert inclua `duration` e `startNumber` dentro do `SegmentTemplate` elemento, assim: ``
Se você usar o identificador de formato `$Number$` em uma saída, também deverá usá-lo em todas as outras saídas do grupo de saídas.
\$1Bandwidth\$1
Nos nomes de arquivo de saída, `$Bandwidth$` é resolvido como o valor de **Video (Vídeo)**, **Bitrate (Taxa de bits)** mais o valor de **Audio (Áudio)**, **Bitrate (Taxa de bits)** na saída. Independentemente de você incluir esse identificador de formato, o serviço usa a numeração de segmentos de nove dígitos nos nomes de arquivo de segmento.
Por exemplo, suponha que você especifique esses valores:
+ **Video (Vídeo)**, **Bitrate (Taxa de bits) (bits/s)**: **50000000**
+ **Audio (Áudio)**, **Bitrate (Taxa de bits) (kbits/s)**: **96.0** (96.000 bits/s)
+ **Name modifier (Modificador de nome)**: **video\$1\$1Bandwidth\$1**
O valor de \$1Bandwidth\$1 é resolvido para 50.096.000. O serviço cria arquivos de segmento chamados `video_50096000_000000001.mp4`, `video_50096000_000000002.mp4`, e assim por diante.
No manifesto, AWS Elemental MediaConvert inclui `duration` e `startNumber` dentro do `SegmentTemplate` elemento, assim:``.
\$1Time\$1
Nos nomes de arquivo de saída, `$Time$` é resolvido como a duração, em milissegundos, do segmento. Quando você inclui esse identificador de formato, o serviço não usa a numeração de segmentos de nove dígitos padrão nos nomes de arquivo de segmento.
Por exemplo, se você especificar **video180\$1\$1\$1Time\$1** para **Name modifier (Modificador de nome)**, o serviço criará arquivos de segmento chamados `video180__345600.mp4`, `video180__331680.mp4`, e assim por diante. Nesses exemplos, as durações de segmento são 345.600 ms e 331.680 ms.
No manifesto, AWS Elemental MediaConvert inclui `SegmentTimeline` dentro do `SegmentTemplate` elemento, assim:
```