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.

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/$d$/. 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.

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.

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 sua tarefa AWS Elemental MediaConvert . 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.

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$	Destination (Destino) Modificador de nome Modificador de segmento	UTCdata e hora da hora de início do trabalho. Formato: YYYYMMDDTHHMMSS Exemplo: para uma tarefa que começa às 3:05:28 PM em 4 de junho de 2020, o $dt$ é resolvido como 20200604T150528.
Data	$d$	Destination (Destino) Modificador de nome Modificador de segmento	UTCdata da hora de início do trabalho. Formato: YYYYMMDD Exemplo: para uma tarefa que começa em 4 de junho de 2020, o $d$ é resolvido como 20200604.
Tempo	$t$	Destination (Destino) Modificador de nome Modificador de segmento	UTChora de início do trabalho. Formato: HHMMSS Exemplo: para uma tarefa que começa às 3:05:28 PM, o $t$ é 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 QVBR saídas, o serviço usa a taxa de bits máxima de vídeo, em kilobits. Exemplo: se você definir Encoding settings (Configurações de codificação), Video (Vídeo), Bitrate (Taxa de bits) (bits/s) como 50000000, $rv$ 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, $ra$ 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), $rc$ 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, $w$ 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, $h$ 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, $f$ será resolvido como 59.
Nome do arquivo de entrada	$fn$	Destination (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, $fn$ 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, $ex$ resolverá para. m2ts Exemplo de HLS grupo: Se seu grupo de saída forHLS, $ex$ resolve param3u8.
$	$$	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$$hi-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 do seu trabalho, também chamadas de identificadores de formato, funcionam de forma diferente nas saídas na Apple HLS e nos grupos DASH ISO de saída. Veja as diferenças:

Para HLS saídas Apple

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 DASH ISO saídas

Você pode usar dois identificadores de formato adicionais na configuração Name modifier (Modificador de nome). Eles afetam o DASH manifesto, além do nome do arquivo de saída. Aqui estão os identificadores:

$Number$

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_$Number$ 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_ 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 DASH manifesto, AWS Elemental MediaConvert inclui duration e startNumber está dentro do SegmentTemplate elemento, assim: <SegmentTemplate timescale="90000" media="main_video_$Number$.mp4" initialization="main_video_$Number$init.mp4" duration="3375000"/>

nota

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.

$Bandwidth$

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_$Bandwidth$

O valor de $Bandwidth$ é 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 está dentro do SegmentTemplate elemento, assim:<SegmentTemplate timescale="90000" media="main_video_$Bandwidth$.mp4" initialization="main_video_$Bandwidth$init.mp4" duration="3375000"/>.

$Time$

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__$Time$ 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:

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

nota

Se você usar o identificador de formato $Time$ em uma saída, também deverá usá-lo em todas as outras saídas do grupo de saídas.

Especificar um número mínimo de dígitos

Para identificadores de formato que retornam um número, você pode especificar um número mínimo de dígitos em que o identificador de formato será resolvido. Quando você faz isso, o serviço adiciona zeros à esquerda antes de qualquer valor que deve retornar um número menor de dígitos.

Use a sintaxe a seguir para especificar o número de dígitos: %0[number of digits]. Coloque esse valor apenas antes do $ final do identificador de formato.

Por exemplo, suponha que a altura do quadro de vídeo seja 720 e você deseja especificar um mínimo de quatro dígitos, para que ele apareça no nome de arquivo como 0720. Para fazer isso, use o seguinte identificador de formato: $h%04$.

nota

Os valores que são muito grandes para serem expressos no número de dígitos especificado são resolvidos com mais dígitos.