Configurações especificadas ao criar um trabalho do Elastic Transcoder

Ao criar um trabalho usando o console do Elastic Transcoder, você pode especificar os seguintes valores.

nota

Você pode configurar o Elastic Transcoder para notificá-lo quando o status de um trabalho muda, incluindo quando o Elastic Transcoder começa e termina o processamento de um trabalho e quando o Elastic Transcoder encontra um aviso ou uma condição de erro. Para ter mais informações, consulte Notificações de status de trabalho.

Região

O Elastic Transcoder cria o trabalho na região em que você está.

Configurações gerais

Pipeline

O nome do pipeline que o Elastic Transcoder deve usar na transcodificação. O pipeline determina várias configurações, incluindo o bucket do Amazon S3 do qual o Elastic Transcoder obterá os arquivos para transcodificação e o bucket no qual o Elastic Transcoder colocará os arquivos transcodificados.

Output Key Prefix

O valor, se houver, que o Elastic Transcoder deve colocar na frente dos nomes de todos os arquivos criados pelo trabalho em questão, incluindo arquivos de saída, miniaturas e listas de reprodução. Se você especificar um valor, ele deverá conter um / em algum lugar após o primeiro caractere, a fim de simplificar o gerenciamento de arquivos pelo Amazon S3.

Detalhes de entrada, parte 1

Use as configurações nesta seção para especificar informações sobre os arquivos de entrada. Se você fornecer mais de um arquivo de entrada, o Elastic Transcoder os transcodifica e, em seguida, os combina em um arquivo de saída. Para ter mais informações, consulte Combinação de clipes.

Input Key

O nome dos arquivos que você deseja transcodificar. Para determinar o bucket do Amazon S3 do qual obter o arquivo, o Elastic Transcoder consulta o campo Bucket de entrada no pipeline que você especificou para o trabalho.

Se um nome de arquivo inclui um prefixo, por exemplo, cooking/lasagna.mpg, inclua-o na chave. Se o arquivo não estiver no bucket especificado, o Elastic Transcoder retornará um erro.

Input Decryption

As configurações de criptografia, se houver, usadas para descriptografar seus arquivos de entrada. Se seu arquivo de entrada estiver criptografado, você deverá especificar o modo que o Elastic Transcoder usará para descriptografar seu arquivo.

Decryption Mode (obrigatório para descriptografia)

O modo de criptografia específico que você deseja que o Elastic Transcoder use ao descriptografar seus arquivos.

O Elastic Transcoder é compatível com as seguintes opções:

• Criptografia do lado do servidor do Amazon S3: o Amazon S3 trata a criptografia e descriptografia dos seus arquivos. Desde que o Elastic Transcoder tenha permissões de acesso ao seu bucket do Amazon S3, você não precisa tomar nenhuma ação adicional.

  Para obter mais informações, consulte Proteger dados usando criptografia do lado do servidor no Guia do usuário do Amazon Simple Storage Service.

• Criptografia do lado do cliente usando chaves fornecidas pelo cliente: o Elastic Transcoder oferece suporte a três tipos de criptografia usando chaves fornecidas pelo cliente:

  • aes-cbc-pkcs7: Um modo de operação de bloco de cifras acolchoado.

  • aes-ctr: modo contador do AES.

  • aes-gcm: modo contador do AES Galois, um modo de operação que é um formato de criptografia autenticado, o que significa que um arquivo, chave ou vetor de inicialização que tenha sido adulterado falhará no processo de descriptografia.

  Se você escolheu um dos modos de criptografia AES, também deve especificar os seguintes três valores (todos os três devem estar codificados em base64):

  • Chave de criptografia

  • Chave de criptografia do MD5

  • Vetor de inicialização de criptografia

Chave de descriptografia (obrigatório para descriptografia AES)

A chave de criptografia de dados usadas para criptografar seu arquivo. A chave deve ser codificada em base64 e deve ter um dos seguintes comprimentos de bits antes de ser codificada em base64:

96 (Somente AES-GCM), 128, 192 ou 256.

A chave também deve ser criptografada usando AWS KMS. Para obter mais informações, consulte Criptografia e descriptografia de dados) no Guia do desenvolvedor do AWS Key Management Service .

Decryption Key MD5 (obrigatório para descriptografia AES)

O resumo MD5 da chave usada para criptografar seu arquivo de entrada e que você deseja que o Elastic Transcoder utilize como um checksum para garantir que sua chave não foi corrompida durante a transmissão. A chave do MD5 deve ser codificada em base64 e deve ter exatamente 16 bytes antes de ser codificada em base64.

Decryption Initialization Vector (obrigatório para descriptografia AES)

A série de bits aleatórios criada por um gerador de bits aleatórios, única para cada operação de criptografia, que você utilizou para criptografar seus arquivos de entrada. O vetor de inicialização deve ser codificado em base64 e deve ter exatamente 16 bytes antes de ser codificado em base64.

Para obter mais informações, acesse Vetor de inicialização.

Detalhes de entrada, parte 2, configurações de clipe e legenda

Use as configurações nesta seção para especificar informações sobre clipes e legendas para os arquivos de entrada. Essas configurações estão disponíveis apenas quando você fornece várias entradas.

Para obter mais informações sobre legendas, consulte Legendas.

(Opcional) Clip Start Time

Você pode criar um arquivo de saída que contém um trecho do arquivo de entrada. Clip Start Time indica o local no arquivo de entrada em que você deseja que um clipe comece. O formato pode ser HH:mm:ss.SSS (valor máximo: 23:59:59.999, onde SSS são os milésimos de segundo) ou sssss.SSS (valor máximo: 86399.999). Se você não especificar um valor, o Elastic Transcoder iniciará no começo do arquivo de entrada.

(Opcional) Clip Duration

A duração do seu trecho de clipe. O formato pode ser HH:mm:ss.SSS (valor máximo: 23:59:59.999, onde SSS são os milésimos de segundo) ou sssss.SSS (valor máximo: 86399.999). Se você não especificar um valor, o Elastic Transcoder recorta o clipe da Hora de início do clipe até o fim do arquivo.

Se você especificar um valor maior do que a duração do arquivo de entrada, o Elastic Transcoder transcodificará da Hora de início do clipe até o fim do arquivo e retornará uma mensagem de aviso.

(Somente vídeo) Política de mesclagem de legendas

Uma política que determina como o Elastic Transcoder trata a existência de várias legendas.

• MergeOverride: o Elastic Transcoder transcodifica legendas incorporadas e secundárias em saídas. Se legendas para um idioma estiverem incorporadas no arquivo de entrada e também aparecerem em um arquivo sidecar, o Elastic Transcoder usará as legendas do sidecar e ignorará as legendas incorporadas para esse idioma.

• MergeRetain: o Elastic Transcoder transcodifica legendas incorporadas e secundárias em saídas. Se as legendas para um idioma estiverem incorporadas no arquivo de entrada e também aparecerem em um arquivo sidecar, o Elastic Transcoder usará as legendas incorporadas e ignorará as legendas do sidecar para esse idioma. Se a Caption Source estiver vazia, o Elastic Transcoder omitirá todas as legendas sidecar nos arquivos de saída.

• Override: o Elastic Transcoder transcodifica apenas as legendas sidecar que você especifica em Caption Source.

(Somente vídeo, opcional) Chave de entrada

O nome do arquivo de legenda sidecar que você deseja que o Elastic Transcoder transcodifique e inclua nas saídas.

(Somente vídeo) Idioma

Uma string que especifica o idioma da legenda em um dos seguintes formatos:

• Código ISO 639-1 de 2 caracteres, por exemplo, en para inglês

• Código ISO 639-2 de 3 caracteres, por exemplo, eng para inglês

Para obter mais informações sobre códigos de idioma ISO, consulte a lista de códigos ISO 639-1.

(Somente vídeo, opcional) TimeOffset

Para geração de clipes ou legendas que não começam ao mesmo tempo que o arquivo de vídeo associado, ele TimeOffsetinforma ao Elastic Transcoder quanto do vídeo deve ser codificado antes de incluir as legendas.

Especifique o TimeOffset no formato [+-] ss.sss ou [+-] HH:mm:ss.ss.

(Somente vídeo, opcional) Rótulo

O rótulo da legenda mostrada no player na escolha do idioma. Recomendamos que você coloque aqui o nome do idioma da legenda.

Detalhes de saída, parte 1

Use as configurações nesta seção para especificar informações sobre os arquivos de saída.

Preset

A predefinição que você deseja usar para esta saída. A predefinição determina as configurações de áudio, vídeo e miniatura que o Elastic Transcoder usa na transcodificação.

(Somente saídas MP4/MPEG-TS fragmentas) Segment Duration

Se você especificar uma predefinição para a saída atual cujo valor de Container seja ts (MPEG-TS) ou fmp4 (MP4 fragmentado), Segment Duration será a duração de destino máxima de cada segmento, em segundos. No caso das listas de reprodução com formato HLSv3, cada segmento de mídia é armazenado em um arquivo .ts individual. Em listas de reprodução nos formatos HLSv4, MPEG-DASH e Smooth, todos os segmentos de mídia para uma saída são armazenados em um único arquivo. Cada segmento tem aproximadamente o mesmo tamanho da Segment Duration. Porém, os segmentos individuais podem ser mais curtos ou longos.

O intervalo de valores válidos é de 1 a 60 segundos. Se não for possível dividir uniformemente a duração do vídeo pela Segment Duration, a duração do último segmento será o restante de:

total length/Segment Duration

O Elastic Transcoder cria uma lista de reprodução específica para cada saída HLS especificada em Output Keys. Para adicionar uma saída a uma lista de reprodução mestra no trabalho, inclua-a em Outputs in Master Playlist.

O Elastic Transcoder aplica essa segmentação a todas as legendas associadas ao vídeo de saída.

Output Key

O nome que o Elastic Transcoder deve atribuir ao arquivo transcodificado e à lista de reprodução. O Elastic Transcoder salva o arquivo ou os arquivos no bucket do Amazon S3 especificado pelo campo Bucket no pipeline que você especificou em Pipeline. Se o bucket já contiver um arquivo com o nome especificado, ocorrerá uma falha na saída. No entanto, é possível que outras saídas sejam geradas com êxito no mesmo trabalho.

O formato dos nomes de arquivo depende do tipo do contêiner e se foi definida uma duração para o segmento. Se o tipo do contêiner for diferente de ts ou não houver informação sobre a duração do segmento, o nome do arquivo de saída será uma concatenação de Output Key Prefix e Output Key.

Se o tipo do contêiner for ts e houver informação sobre a duração do segmento, o Elastic Transcoder usará o valor da Chave de saída para nomear a lista de reprodução da saída e os arquivos .ts:

• Lista de reprodução:

  • HLSv3: o nome de arquivo é uma concatenação de Output Key Prefix e Output Key além da extensão de nome de arquivo .m3u8:

    Output Key PrefixOutput Key.m3u8

  • HLSv4: o nome de arquivo é uma concatenação de Output Key Prefix e Output Key além da extensão de nome de arquivo _v4.m3u8. As saídas de vídeo criam um segundo arquivo com um nome de arquivo que é uma concatenação de Output Key Prefix e Output Key além da extensão de nome de arquivo _iframe.m3u8:

    Output Key PrefixOutput Key_v4.m3u8

    Output Key PrefixOutput Key_iframe.m3u8 (somente vídeo)

• Arquivos (.ts) segmentados:

  • HLSv3: o nome do arquivo é uma concatenação de Output Key Prefix e Output Key, além de um contador de cinco dígitos que começa com 00000, e a extensão de nome de arquivo .ts:

    Output Key PrefixOutput Key00000.ts

  • HLSv4: o nome de arquivo é uma concatenação de Output Key Prefix e Output Key além da extensão de nome de arquivo .ts:

    Output Key PrefixOutput Key.ts

Se a saída de ts segmentada não for inclusa em uma lista de reprodução mestra, o Elastic Transcoder tratará a saída como HLSv3.

nota

O Elastic Transcoder acrescenta automaticamente a extensão de arquivo pertinente às saídas em uma lista de reprodução HLSv3 ou HLSv4. Se você inclui uma extensão de arquivo em Output Key para saídas de lista de reprodução HLSv3 ou HLSv4, o nome do arquivo terá duas extensões.

Prefixo da chave de saída agrupa todos os arquivos de uma tarefa em conjunto no seu bucket do Amazon S3. Para agrupar os arquivos de cada saída em um trabalho, basta incluir um prefixo no valor de Output Key, por exemplo:

OutputKeyPrefixiPhone/chave 00000.ts

OutputKeyPrefixKindleFireHD/chave 00000.ts

Segment Filename Preview

O nome do arquivo do primeiro segmento, com base no valor que você informou em Output Key.

Detalhes de saída, parte 2

Use as configurações nesta seção para especificar informações sobre os arquivos de saída.

(Somente vídeo) Create Thumbnails

Se você deseja que o Elastic Transcoder crie miniaturas para seus vídeos, selecione Sim e especifique o formato dos nomes de arquivos no campo Nome padrão de arquivo de miniatura.

(Somente vídeo) Thumbnail Filename Pattern

Se você selecionou Yes em Thumbnail Filename Pattern, especifique o formato dos nomes de arquivos. Você pode especificar os valores a seguir em qualquer sequência:

• {count} (obrigatório): um número de cinco dígitos começando com 00001 que indica onde uma determinada miniatura aparece na sequência de miniaturas de um arquivo transcodificado. Você deve incluir {count} em algum lugar no campo. Se você omitir isso, o Elastic Transcoder acrescentará automaticamente a contagem ao fim do nome de arquivo, imediatamente antes da extensão do nome do arquivo (.jpg ou .png).

• Valores literais (opcional): você pode especificar valores literais em qualquer lugar do campo, por exemplo, como um prefixo do nome do arquivo ou como um delimitador entre {resolution} e {count}.

• (Opcional) {resolution}: se você deseja que o Elastic Transcoder inclua a resolução no nome do arquivo, inclua {resolution} no campo.

O campo Thumbnail Filename Preview exibe um exemplo de nomes de arquivos para miniaturas com base no valor inserido em Thumbnail Filename Pattern.

Ao criar miniaturas, o Elastic Transcoder salva automaticamente os arquivos no formato (.jpg ou .png) que aparece na predefinição especificada em Preset. O Elastic Transcoder também acrescenta a extensão de nome de arquivo aplicável.

(Somente vídeo/miniaturas, opcional) Output Rotation

O número de graus em sentido horário que o Elastic Transcoder deve rotacionar a saída em relação à entrada. Se você desejar que o Elastic Transcoder detecte automaticamente se o arquivo de entrada está girado, selecione auto. Observe, no entanto, que geralmente o Elastic Transcoder só pode detectar se a saída precisa ser girada se o arquivo que está sendo transcodificado contém metadados sobre a rotação.

Detalhes de saída, parte 3, Configurações de legenda

Use as configurações nesta seção para especificar informações sobre legendas para os arquivos de saída.

Para obter mais informações sobre legendas, consulte Legendas.

(Somente vídeo) Caption Format

O formato que você especificar determinará se o Elastic Transcoder gerará uma legenda inserida ou em arquivo associado na saída. Se você deixar esse valor em branco, o Elastic Transcoder retornará um erro.

• Embedded Caption Formats: para contêineres MP4, há suporte para mov-text e CEA-708. Para contêineres MPEG-TS, há suporte para CEA-708. Para outros tipos de contêineres, não há suporte para formatos de legenda incorporada.

  As legendas CEA-708 são inseridas nos dados de usuário H.264 SEI da transmissão por streaming. O Elastic Transcoder oferece suporte para o máximo de um formato de legenda incorporada por saída.

• Formatos de legenda sidecar: o Elastic Transcoder oferece suporte a dfxp, scc, srt e webvtt. Contêineres Fmp4 com listas de reprodução Smooth oferecem suporta e apenas dfxp, e o Elastic Transcoder cria um arquivo com a extensão .ismt. Contêineres fmp4 com listas de reprodução MPEG-DASH oferecem suporte a apenas webvtt, e o Elastic Transcoder cria um arquivo com a extensão .vtt. Se você desejar usar legendas compatíveis com o formato ttml ou smpte-tt, especifique dfxp como formato de saída.

(Somente vídeo) Captions Filename Pattern

O prefixo para os nomes de arquivos de legenda no formato descrição{language}, onde:

• descrição é uma descrição do vídeo.

• {language} é um valor literal que o Elastic Transcoder substitui por um código de duas ou três letras referente ao idioma da legenda nos nomes dos arquivos de saída.

Se você não incluir {language} no padrão dos nomes de arquivos, o Elastic Transcoder automaticamente acrescentará "{language}" ao valor especificado como descrição. Além disso, o Elastic Transcoder automaticamente acrescenta a contagem ao final dos arquivos segmentados.

Por exemplo, suponha que você esteja fazendo a transcodificação para o formato srt. Se você inserir "Sydney-{language}-sunrise" e o idioma das legendas for o inglês (en), o nome do primeiro arquivo de legenda será Sydney-en-sunrise00000.srt.

(Somente vídeo) Captions Filename Preview

O nome do primeiro arquivo de legenda, com base no valor que você informou em Captions Filename Pattern. A visualização usa o código ISO "en" referente ao inglês para mostrar como {language} será exibido em seu nome de arquivo.

(Opcional) Output Encryption

Você pode especificar configurações de criptografia para todos os arquivos de saída que deseja usar para um trabalho de transcodificação. Isso inclui o arquivo de saída e todas as marcas d'água, miniaturas, arte do álbum ou legendas desejadas. Você deve especificar configurações de criptografia para cada arquivo individualmente.

Output Encryption

As configurações de criptografia, se houver, que você deseja que o Elastic Transcoder aplique aos seus arquivos de saída. Se você optar por usar a criptografia, deverá especificar um modo a ser usado. Se você optar por não usar criptografia, o Elastic Transcoder gravará um arquivo não criptografado no seu bucket do Amazon S3.

(Obrigatório para criptografia no nível do arquivo) Encryption Mode

O modo de criptografia específico que você deseja que o Elastic Transcoder use ao criptografar seus arquivos de saída individualmente. O Elastic Transcoder oferece suporte às seguintes opções do Modo de criptografia:

• s3: o Amazon S3 cria e gerencia as chaves usadas para criptografar seus arquivos.

  Para obter mais informações, consulte Proteger dados usando criptografia do lado do servidor no Guia do usuário do Amazon Simple Storage Service.

• s3-aws-kms: AWS KMS chamadas do Amazon S3, que criam e gerenciam as chaves usadas para criptografar seus arquivos. Se você especificar s3-aws-kms e não quiser usar a chave padrão, deve adicionar a chave do AWS-KMS que você deseja usar no seu pipeline.

  Para obter mais ninformações, consulte Proteção de dados usando a criptografia no lado do servidor com chaves gerenciadas pela AWS KMS no Guia do usuário do Amazon Simple Storage Service.

• aes-cbc-pkcs7: Um modo de operação de bloco de cifras acolchoado.

• aes-ctr: modo contador do AES.

• aes-gcm: modo contador do AES Galois, um modo de operação que é um formato de criptografia autenticado, o que significa que um arquivo, chave ou vetor de inicialização que tenha sido adulterado falhará no processo de descriptografia.

Se você escolheu um dos modos de criptografia AES, também deve especificar os seguintes três valores (todos os três devem estar codificados em base64):

• Chave de criptografia

• Chave de criptografia do MD5

• Vetor de inicialização de criptografia

Se você escolheu um dos modos de criptografia AES e deseja que o Elastic Transcoder gere uma chave de criptografia AED de 128 bits, não especifique valores para Chave de criptografia, Chave de criptografia do MD5 ou Vetor de inicialização de criptografia. Depois que o Elastic Transcoder gerar a chave, você poderá recuperá-la chamando ReadJob. A chave não está incluída no objeto CreateJobResponse.

Importante

Para os modos AES, suas chaves de criptografia privadas específicas para a mídia e seus dados não criptografados nunca são armazenados pela AWS. Portanto, é importante que você gerencie suas chaves de criptografia com segurança. Se perdê-las, você não poderá descriptografar os seus dados.

(Opcional) Encryption Key

Se quiser que o Elastic Transcoder gere uma chave para você, deixe este campo em branco. Depois que o Elastic Transcoder gerar a chave, você poderá recuperá-la chamando Ler trabalho. A chave não está incluída no objeto Criar resposta do trabalho.

Se você optar por fornecer sua própria chave, deverá criptografar a chave usando o AWS KMS. A chave deve ser codificada em base64 e deve ter um dos seguintes comprimentos de bits antes de ser codificada em base64:

96 (Somente AES-GCM), 128, 192 ou 256.

Se você configurou o Elastic Transcoder para gerar uma chave, o Elastic Transcoder deixará esse campo em branco na resposta Criar trabalho. Para recuperar sua chave de criptografia de dados gerada, envie uma solicitação Ler trabalho.

Para obter mais informações sobre como criptografar sua chave com AWS KMS, consulte Criptografando e descriptografando dados no Guia do desenvolvedor.AWS Key Management Service

(Obrigatório se uma chave de criptografia for fornecida) Encryption Key MD5

O resumo MD5 da chave que você quer que o Elastic Transcoder use para criptografar seu arquivo de saída, e que você deseja que o Elastic Transcoder use como um checksum para garantir que sua chave não foi corrompida durante a transmissão. A chave do MD5 deve ser codificada em base64 e deve ter exatamente 16 bytes antes de ser codificada em base64.

Se o Elastic Transcoder estiver gerando sua chave, você deverá deixar esse campo em branco.

(Obrigatório se uma chave de criptografia for fornecida) Encryption Initialization Vector

A série de bits aleatórios criada por um gerador de bits aleatórios, única para cada operação de criptografia, que você deseja que o Elastic Transcoder utilize para criptografar seus arquivos de saída. O vetor de inicialização deve ser codificado em base64 e deve ter exatamente 16 bytes antes de ser codificado em base64.

Se o Elastic Transcoder estiver gerando sua chave, você deverá deixar esse campo em branco.

Para obter mais informações, acesse Vetor de inicialização.

(Somente vídeo/miniaturas) Watermarks

Informações sobre as marcas d'água que você deseja que o Elastic Transcoder adicione ao vídeo durante a transcodificação. Você pode especificar até quatro marcas-d'água para cada saída. É necessário definir as configurações de cada marca-d'água na predefinição especificada em Preset da saída atual.

As marcas d'água são adicionadas ao vídeo de saída na sequência em que você as lista na saída da tarefa. A primeira marca d'água na lista é adicionada ao vídeo de saída primeiro, a segunda marca d'água na lista é adicionada em seguida, e assim por diante. Como resultado, se as configurações em um predefinido fizerem com que o Elastic Transcoder coloque todas as marcas d'água no mesmo local, a segunda marca d'água que você adicionar cobrirá a primeira, a terceira cobrirá a segunda e a quarta cobrirá a terceira.

Para obter mais informações sobre marcas-d'água, consulte Marcas d'água.

Preset Watermark ID

O ID das configurações de marca-d'água que o Elastic Transcoder usa para adicionar marcas-d'água ao vídeo durante a transcodificação. As configurações estão na predefinição especificada por Preset para a saída atual. Nessa predefinição, o valor de ID da marca-d'água informa ao Elastic Transcoder quais configurações usar.

Input Key for Preset Watermark Id

O nome do arquivo .png ou .jpg que você deseja usar como marca-d'água. Para determinar em qual bucket do Amazon S3 está o arquivo especificado, o Elastic Transcoder verifica o pipeline especificado pelo Pipeline; o objeto Bucket de entrada naquele pipeline identifica o bucket.

Se o nome do arquivo incluir um prefixo, por exemplo, logos/128x64.png, inclua-o na chave. Se o arquivo não estiver no bucket especificado, o Elastic Transcoder retornará um erro.

(Somente FLAC/MP3/MP4) Album Art

A capa do álbum a ser associada ao arquivo de saída, se houver.

Para remover arte ou deixar a arte em branco, você pode definir Artwork como nulo ou definir Merge Policy como "Replace" e usar uma matriz Artwork vazia.

Para passar por arte existente sem alterações, defina a política Merge Policy para "Prepend", "Append" ou "Fallback", e use uma matriz Artwork vazia.

nota

A capa do álbum está disponível para saídas somente áudio em contêineres do tipo flac, mp3 ou mp4.

Album Art Merge Policy

Uma política que determina como o Elastic Transcoder vai tratar a existência de vários arquivos de capa de álbum.

• Replace: a capa do álbum especificada substituirá qualquer outra existente.

• Prepend: a capa do álbum especificada será colocada em frente de qualquer outra existente.

• Append: a capa do álbum especificada será colocada após qualquer outra existente.

• Fallback: se o arquivo de entrada contiver uma arte, o Elastic Transcoder usará essa arte na saída. Se a entrada não contiver uma arte, o Elastic Transcoder usará o arquivo de capa do álbum especificado.

Album Art Artwork

O arquivo a ser usado como capa do álbum. É possível ter até 20 artes diferentes associadas a um arquivo de áudio.

Album Art Input Key

O nome de arquivo a ser usado como capa do álbum. Para determinar qual bucket do Amazon S3 contém o arquivo especificado, o Elastic Transcoder verifica o pipeline especificado PipelineIdpor; o objeto nesse pipeline identifica InputBucketo bucket.

Se o nome do arquivo incluir um prefixo, por exemplo, cooking/pie.jpg, inclua-o na chave. Se o arquivo não estiver no bucket especificado, o Elastic Transcoder retornará um erro.

Album Art Format

O formato de capa do álbum, se houver. Os formatos válidos são jpg e png.

Album Art Max Width

A largura máxima em pixels da capa do álbum de saída. Se você especificar auto, o Elastic Transcoder usará 600 como valor padrão. Se você desejar especificar um valor numérico, digite um valor inteiro par entre 32 e 4096 (incluindo ambos).

Album Art Max Height

A altura máxima em pixels da capa do álbum de saída. Se você especificar auto, o Elastic Transcoder usará 600 como valor padrão. Se você desejar especificar um valor numérico, digite um valor inteiro par entre 32 e 3072 (incluindo ambos).

Album Art Sizing Policy

Um valor que controla a escalabilidade da capa do álbum de saída:

• Ajuste: o Elastic Transcoder dimensiona a arte de saída para que ela corresponda ao valor que você especificou em MaxWidthum MaxHeightou sem exceder o outro valor.

• Preencher: o Elastic Transcoder dimensiona a arte de saída para que ela corresponda ao valor especificado em MaxHeightou e corresponda MaxWidthou exceda o outro valor. O Elastic Transcoder centraliza e depois recorta a arte de saída para uma dimensão maior (se possível) do que o valor máximo.

• Stretch: o Elastic Transcoder estica a arte de saída para corresponder aos valores que você especificou para e. MaxWidthMaxHeight Se as proporções relativas da arte de entrada e de saída forem diferentes, a arte de saída será distorcida.

• Keep: o Elastic Transcoder não dimensiona a arte de saída. Se uma das dimensões da arte de entrada exceder os valores que você especificou para MaxWidthe MaxHeight, o Elastic Transcoder recorta a arte de saída.

• ShrinkToFit: o Elastic Transcoder reduz a arte de saída para que suas dimensões correspondam aos valores que você especificou para pelo menos um dos valores MaxHeighte sem exceder nenhum MaxWidthdos valores. Se você especificar essa opção, o Elastic Transcoder não dimensionará a arte para dimensões ampliadas.

• ShrinkToFill: o Elastic Transcoder reduz a arte de saída para que suas dimensões correspondam aos valores que você especificou para pelo menos um MaxHeighte sem cair abaixo MaxWidthde nenhum dos valores. Se você especificar essa opção, o Elastic Transcoder não dimensionará a arte para dimensões ampliadas.

A tabela a seguir mostra os possíveis efeitos das SizingPolicyconfigurações na capa do álbum de saída:

SizingPolicy	A escala da capa do álbum de saída pode ser ampliada	A capa do álbum de saída pode ser preenchida quando a política de preenchimento é "Pad"	A capa do álbum de saída pode ter uma taxa de proporção em pixels diferente da capa do álbum de entrada	A capa do álbum de saída pode ser recortada
Fit	Sim	Sim
Fill	Sim			Sim
Stretch	Sim		Sim
Keep	Sim	Sim		Sim
ShrinkToFit		Sim
ShrinkToFill		Sim		Sim

Album Art Padding Policy

Quando você define como PaddingPolicyPad, o Elastic Transcoder pode adicionar barras brancas na parte superior e inferior e/ou nos lados esquerdo e direito da capa do álbum de saída para fazer com que o tamanho total da arte de saída corresponda aos valores que você especificou para e. MaxWidthMaxHeight Para obter mais informações, consulte a tabela em AlbumArt:Art:SizingPolicy.

(Opcional) User Metadata

Metadados definidos pelo usuário que você deseja associar a uma tarefa do Elastic Transcoder. Você especifica os metadados em pares de key/value. Você pode usar os pares de key/value para rastrear detalhes sobre um arquivo, por exemplo, Season 1: Episode 3.

Você pode adicionar até 10 pares de chave/valor para cada tarefa. O Elastic Transcoder não garante que os pares de key/value sejam retornados na mesma ordem em que você os especificou.

Metadata Key

A chave do par de key/value de metadados que você deseja retornar com o arquivo de saída. Cada chave deve ser uma sequência exclusiva entre 1-128 caracteres e deve usar somente caracteres da lista a seguir:

• 0-9

• A-Z e a-z

• Space

• Os seguintes símbolos: _.:/=+-%@

Você pode usar chaves como um sistema de numeração para organizar seus metadados, armazenar 128 caracteres extras de metadados ou rotular os metadados armazenados no valor. Se quiser usar somente metadados de valor, você pode colocar sequências descartáveis em suas chaves, como key1, e ignorar as chaves ao recuperar seus metadados do Elastic Transcoder.

Importante

Você deve especificar strings exclusivas para todas as chaves em um trabalho. Se a mesma string for usada para mais de uma chave em um trabalho, o Elastic Transcoder retornará somente um dos pares de chave/valor que usam essa chave. Não há como garantir qual valor será retornado.

Metadata Value

O valor do par de key/value de metadados que você deseja que seja retornado com seu trabalho. Cada valor deve ser uma string exclusiva entre 0-256 caracteres e deve usar somente caracteres da lista a seguir:

• 0-9

• A-Z e a-z

• Space

• Os seguintes símbolos: _.:/=+-%@

(Somente saídas MP4/MPEG-TS fragmentadas) Playlist

Se você escolher uma predefinição na lista Preset para a qual o valor Container seja ts (MPEG-TS) ou fmp4 (MP4 fragmentado), use as configurações nesta seção para especificar informações sobre as listas de reprodução principais que você deseja que o Elastic Transcoder crie. Recomendamos que você crie, no máximo, uma lista de reprodução mestra por formato.

Master Playlist Name

O nome que o Elastic Transcoder deve atribuir à lista de reprodução mestra. Se o nome incluir um caractere /, a seção do nome antes do último / deve ser idêntica em todos os Playlist Names. Se você criar mais de uma lista de reprodução mestra, cada uma delas deve ter um nome exclusivo.

nota

O Elastic Transcoder acrescenta automaticamente a extensão de arquivo relevante ao nome de arquivo (.m3u8 para listas de reprodução HLSv3 e HLSv4, .mpd para listas de reprodução MPEG-DASH, e .ism e .ismc para listas de reprodução Smooth). Se você incluir uma extensão de arquivo em Master Playlist Name, o nome do arquivo terá duas extensões.

Todas as configurações de duração de segmento, clipe ou legenda devem ser idênticas em todas as saídas na lista de reprodução. Para listas de reprodução Smooth, a proporção entre Audio:Profile, Video:Profile e Frame Rate para Maximum Number of Frames Between Keyframes deve ser a mesma para todas as saídas.

Playlist Format

O formato da lista de reprodução. Os formatos válidos incluem HLSv3, HLSv4, MPEG-DASHe Smooth.

Outputs in Master Playlist

O valor do campo Output Key para cada saída nesse trabalho que você deseja incluir em uma lista de reprodução mestra. Se você incluir mais de uma saída em uma lista de reprodução, o valor de Segment Duration em todas as saídas deve ser o mesmo.

No caso das listas de reprodução mestras HLSv4, o Elastic Transcoder escolhe quais combinações de entradas de áudio e vídeo serão vinculadas às listas de reprodução de saída. As primeiras entradas de áudio e vídeo serão vinculadas e renderizadas como experiência de reprodução padrão, o que permite que você escolha um padrão de reprodução preferencial. No caso das outras listas de reprodução individuais na lista mestra, o Elastic Transcoder escolhe quais combinações de taxas de bits de áudio e vídeo resultarão na melhor reprodução.

(Somente saídas MP4/MPEG-TS fragmentadas, opcional) HLS Content Protection

nota

A proteção de conteúdo do HLS criptografa cada segmento de um arquivo. O Elastic Transcoder não oferece suporte à proteção de conteúdo do HLS combinada com criptografia no nível de arquivo.

Se você escolher uma predefinição na lista Preset para a qual o valor de Container é ts (MPEG-TS) ou fmp4 (MP4 fragmentado) com uma lista de reprodução Smooth, poderá especificar configurações de criptografia para o streaming de seu arquivo. Não é possível combinar criptografia de fluxo de dados com criptografia de arquivo ou legenda. Se você optar por criptografar seu fluxo de dados, use as configurações nesta seção para especificar informações sobre a criptografia do fluxo de dados.

Para usar a proteção de conteúdo HLS, você deve ter um servidor web que possa autenticar sessões (como o Amazon Elastic Compute Cloud), uma forma de distribuir seus arquivos de mídia transmitidos (como a Amazon CloudFront) e uma forma de reproduzir mídia transmitida criptografada (como um navegador habilitado para player).

Método

O método de proteção de conteúdo para sua saída. O único valor válido é:

aes-128.

Esse valor será gravado no atributo method da tag de metadados EXT-X-KEY na lista de reprodução de saída.

Chave

Se quiser que o Elastic Transcoder gere uma chave para você, deixe este campo em branco. Depois que o Elastic Transcoder gerar a chave, você poderá recuperá-la chamando ReadJob. A chave não está incluída no objeto CreateJobResponse.

Se você optar por fornecer sua própria chave, deverá criptografar a chave usando o AWS KMS. A chave deve ser codificada em base64 e deve ter um dos seguintes comprimentos de bits antes de ser codificada em base64:

96 (Somente AES-GCM), 128, 192 ou 256.

Se você configurou o Elastic Transcoder para gerar uma chave, o Elastic Transcoder deixará esse campo em branco na resposta CreateJob. Para recuperar sua chave de criptografia de dados gerada, envie uma solicitação ReadJob.

Para obter mais informações sobre como criptografar sua chave com AWS KMS, consulte Criptografando e descriptografando dados no Guia do desenvolvedor.AWS Key Management Service

Se você escolher um método de proteção de conteúdo HLS de aes-128, a chave deverá ter 128 bits. Se você tiver um relative KeyStoragePolicyconjunto, o Elastic Transcoder grava sua chave em um bucket do Amazon S3 com criptografia do lado do servidor do Amazon S3.

Key MD5 (obrigatório se for fornecida uma chave de criptografia)

O resumo MD5 da chave que você quer que o Elastic Transcoder use para criptografar seu arquivo de saída, e que você deseja que o Elastic Transcoder use como um checksum para garantir que sua chave não foi corrompida durante a transmissão. A chave do MD5 deve ser codificada em base64 e deve ter exatamente 16 bytes antes de ser codificada em base64.

Se o Elastic Transcoder estiver gerando sua chave, você deverá deixar esse campo em branco.

Initialization Vector (obrigatório se for fornecida uma chave de criptografia)

A série de bits aleatórios criada por um gerador de bits aleatórios, única para cada operação de criptografia, que você deseja que o Elastic Transcoder utilize para criptografar seus arquivos de saída. O vetor de inicialização deve ser codificado em base64 e deve ter exatamente 16 bytes antes de ser codificado em base64.

Se o Elastic Transcoder estiver gerando sua chave, você deverá deixar esse campo em branco.

Para obter mais informações, acesse Vetor de inicialização.

License Acquisition URL

A localização da chave de licença necessária para descriptografar sua lista de reprodução do HLS. O URL deve ser um caminho absoluto e é referenciado no atributo URI da tag de metadados EXT-X-KEY no arquivo da lista de reprodução. Por exemplo: .

https://www.example.com/exampleKey/

Key Storage Policy

Especifique se você deseja que o Elastic Transcoder grave sua chave de licença do HLS em um bucket do Amazon S3. Se você escolher WithVariantPlaylists, o Elastic Transcoder gravará sua chave criptografada no mesmo bucket do Amazon S3 da playlist associada.

Importante

Se você escolher NoStore, o Elastic Transcoder não armazenará sua chave. Você é responsável por armazená-la e fornecê-la aos seus usuários, fornecendo a eles o URL de aquisição da licença em que está armazenando a chave.

(Somente listas de reprodução HLSv3 e Smooth, opcional) Digital Rights Management

Se você escolher uma predefinição na lista Preset para a qual o valor de Container seja fmp4 (MP4 fragmentado) ou ts (MPEG-TS), e a Playlist seja do tipo HLSv3 ou Smooth, será possível especificar configurações de DRM para seu arquivo. Se você optar por usar o DRM para proteger seus arquivos, use as configurações nesta seção para especificar informações sobre suas configurações de DRM.

Para usar o DRM, você deve ter um servidor provedor de licenças que possa rastrear e conceder licenças, um servidor web que possa autenticar usuários, um servidor de pacotes para criptografar seus arquivos com DRM (como o Elastic Transcoder), uma forma de distribuir seus arquivos de mídia (como a Amazon) e uma forma de reproduzir mídia protegida por DRM (como um player habilitado para DRM CloudFront).

nota

PlayReady DRM, proteção de conteúdo HLS e criptografia de saída são opções mutuamente exclusivas.

PlayReady DRM (Opcional)

As configurações de DRM usadas para restringir quem pode assistir seus arquivos. Isso é feito incluindo um cabeçalho PlayReady DRM na sua playlist de saída. Isso não pode ser usado para ilustrações, legendas, miniaturas ou marcas d'água. PlayReady O DRM criptografa seus arquivos de mídia usando aes-ctr criptografia.

Se você usa DRM para uma lista de reprodução HLSv3, suas saídas devem ter uma lista de reprodução mestra.

Para ter mais informações, consulte Gerenciamento de direitos digitais.

(Obrigatório para proteção DRM) DRM Format

O formato DRM para sua lista de reprodução de saída. Os formatos válidos são discretix-3.0 e microsoft.

Para listas de reprodução do tipo Smooth, especifique microsoft. Para listas de reprodução do tipo HLSv3, especifique discretix-3.0.

(Obrigatório para proteção DRM) DRM Key

A chave DRM do seu arquivo, fornecida pelo seu provedor de licença DRM. A chave deve ser codificada em base64 e deve ter um dos seguintes comprimentos de bits antes de ser codificada em base64:

128, 192, ou 256.

A chave também deve ser criptografada usando AWS KMS. Para obter mais informações, consulte Criptografia e descriptografia de dados) no Guia do desenvolvedor do AWS Key Management Service .

(Obrigatório para proteção DRM) DRM Id

O ID da sua chave de DRM, para que seu provedor de licença de DRM saiba qual chave fornecer.

O ID da chave deve ser fornecido em big endian, e o Elastic Transcoder o converterá em little endian antes de inseri-lo nos cabeçalhos do DRM. PlayReady Se você não tiver certeza se o servidor de licenças fornece seu ID de chave em big ou little endian, verifique com seu provedor de DRM.

(Obrigatório para proteção DRM) DRM MD5

O resumo MD5 da chave usada para DRM no seu arquivo, e que você deseja que o Elastic Transcoder use como um checksum para garantir que sua chave não foi corrompida durante a transmissão. A chave do MD5 deve ser codificada em base64 e deve ter exatamente 16 bytes antes de ser codificada em base64.

(Obrigatório para proteção DRM) DRM Initialization Vector

A série de bits aleatórios criada por um gerador de bits aleatórios, exclusiva para cada operação de criptografia, que você deseja que o Elastic Transcoder use para criptografar seus arquivos. O vetor de inicialização deve ser codificado em base64 e deve ter exatamente bytes antes de ser codificado em base64. Se nenhum vetor de inicialização for fornecido, o Elastic Transcoder gerará um para você.

Para obter mais informações, acesse Vetor de inicialização.

(Obrigatório para proteção DRM) DRM License Acquisition Url

A localização da chave de licença necessária para reproduzir conteúdo DRM. O URL deve ser um caminho absoluto e é referenciado pelo PlayReady cabeçalho. O PlayReady cabeçalho é referenciado no cabeçalho de proteção do manifesto do cliente para saídas do Smooth Streaming e nas tags de metadados EXT-X-DXDRM e EXT-XDXDRMINFO para saídas de playlist HLS. Um exemplo de URL é:

https://www.example.com/exampleKey/