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

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.

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.

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.

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.

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:

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 .

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.

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.

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.

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.

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

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

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

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

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.

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

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.

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.

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:

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.

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

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

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.

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:

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.

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.

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.

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

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.

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.

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.

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:

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

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.

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

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.

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.

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.

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.

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

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

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.

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

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

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

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

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

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.

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:

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.

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:

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.

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.

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

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.

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.

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.

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.

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.

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/

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.

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.

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.

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 .

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.

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.

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.

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/