ApsaraVideo Media Processing:Detalhes dos parâmetros

Parâmetro

Tipo

Obrigatório

Descrição

OutputObject

String

Sim

O caminho do OSS para o arquivo de saída. Esse caminho é completo e inclui o nome do arquivo gerado.

• Para mais informações sobre o termo object key, consulte Terms.

• Placeholders são suportados. Para mais detalhes, veja a seção Placeholder replacement rules deste tópico.

• Regras para especificação da extensão de arquivo:

  • Workflow: Não é necessário especificar a extensão. O MPS adiciona automaticamente a extensão ao valor do parâmetro OutputObject com base no formato de contêiner do modelo de transcodificação.

  • Job de transcodificação: Especifique a extensão de arquivo, que deve corresponder ao formato de contêiner do modelo. Se o formato for M3U8, o MPS adiciona automaticamente a extensão .m3u8 à playlist. Um número de série de cinco dígitos é adicionado como sufixo ao nome da playlist para gerar o nome do arquivo de segmento de mídia. Esse número começa em 00001 e conecta-se ao nome da playlist por um hífen (-). A extensão do arquivo de segmento de mídia é .ts. Por exemplo, se o nome da playlist for filename.m3u8, o primeiro segmento será filename-00001.ts.

• Codifique o caminho de um objeto do OSS em UTF-8 com URL encoding antes de utilizá-lo no MPS. Para mais informações, consulte URL encoding.

• Por exemplo, se o caminho do arquivo de entrada for a/b/example.flv e você desejar definir o caminho de saída como a/b/c/example+test.mp4, utilize placeholders no formato {ObjectPrefix}/c/{FileName}+test.mp4. Após a codificação URL, o caminho será exibido como %7BObjectPrefix%7D/c/%7BFileName%7D%2Btest.mp4.

TemplateId

String

Sim

O ID do modelo de transcodificação.

• É possível utilizar modelos personalizados ou predefinidos pelo sistema. Para mais informações, consulte Custom Transcoding Templates e Preset Template Details.

• Exemplo: S00000002-200040.

Container

Object

Não

O formato de contêiner. Para mais informações, consulte a seção Container deste tópico.

• Caso este parâmetro seja especificado, ele substituirá o parâmetro correspondente no modelo de transcodificação selecionado.

Video

Object

Não

Parâmetro relacionado à transcodificação de vídeo. Para mais informações, consulte a seção Video deste tópico.

• Se especificado, este valor sobrescreve a configuração equivalente no modelo de transcodificação definido.

Audio

Object

Não

Parâmetro relacionado à transcodificação de áudio. Consulte a seção Audio deste tópico para detalhes adicionais.

• Ao definir este parâmetro, a configuração correspondente no modelo de transcodificação será substituída.

TransConfig

Object

Não

Refere-se aos parâmetros do processo de transcodificação. Veja a seção TransConfig deste tópico para mais detalhes.

• Este campo tem prioridade sobre o mesmo campo no modelo de transcodificação informado.

• Exemplo: {"TransMode":"onepass","AdjDarMethod":"none","IsCheckVideoBitrateFail":"true","IsCheckAudioBitrateFail":"true"}.

VideoStreamMap

String

Não

Identificador do fluxo de vídeo a ser mantido no arquivo de entrada. Valores válidos:

• Não especificado: Um fluxo de vídeo padrão é selecionado.

• 0:v:{Número de série}: Seleciona um fluxo específico. O número indica o índice do fluxo, iniciando em 0. Por exemplo, 0:v:1 seleciona o segundo fluxo de vídeo para transcodificação.

• 0:v: Todos os fluxos de vídeo são selecionados.

AudioStreamMap

String

Não

Identificador do fluxo de áudio a ser mantido no arquivo de entrada. Valores válidos:

• Não especificado: Um fluxo de áudio padrão é selecionado. Geralmente, prefere-se um fluxo em chinês, multicanal e de alta qualidade.

• 0:a:{Número de série}: Seleciona um fluxo de áudio específico. O número indica o índice do fluxo, começando em 0. Por exemplo, 0:a:1 seleciona o segundo fluxo de áudio para transcodificação.

• 0:a: Todos os fluxos de áudio são selecionados. Ideal para cenários de dublagem multi-idioma.

Rotate

String

Não

Ângulo de rotação do vídeo no sentido horário.

• Valores válidos: 0, 90, 180 e 270.

• Valor padrão: 0, indicando que o vídeo não sofre rotação.

WaterMarks

Object[]

Não

As marcas d'água. São imagens ou textos sobrepostos aos quadros de vídeo. Se definido, este parâmetro substitui a configuração do modelo de marca d'água especificado. Consulte a seção WaterMarks deste tópico para mais detalhes.

• Limite de até quatro marcas d'água por job de transcodificação.

• Exemplo de marca d'água única de imagem: ["WaterMarkTemplateId":"88c6ca184c0e47098a5b665e2a12****"},{"InputFile":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"},{"Timeline":{"Start":"0","Duration":"ToEND"}}].

• Exemplo de marca d'água única de texto: ["Type":"Text","TextWaterMark":{"Content":"5rWL6K+V5paH5a2X5rC05Y2w","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}].

DeWatermark

Object

Não

Permite aplicar processamento de desfoque. Para mais informações, consulte Blur processing details.

• Exemplo: {"0": [{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000": [],"250000": [{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}.

SubtitleConfig

Object

Não

Configurações de legenda fixa (hard subtitle). Este parâmetro permite adicionar arquivos externos de legenda ao vídeo. Consulte a seção SubtitleConfig deste tópico para mais informações.

• É permitido adicionar até quatro arquivos de legenda por job de transcodificação.

• Exemplo: {"ExtSubtitleList":[{"Input":{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}]}.

Clip

Object

Não

O trecho de vídeo (clip). Para mais informações, consulte a seção Clip deste tópico.

• Exemplo: {"TimeSpan":{"Seek":"00:01:59.999","End":"18000.30"},"ConfigToClipFirstPart":false}. Isso define que o clip inicia em 1 minuto, 59 segundos e 999 milissegundos, terminando 5 minutos e 30 milissegundos antes do fim do vídeo. O recorte é feito no vídeo resultante da mesclagem de múltiplos arquivos de entrada.

MergeList

Object[]

Não

Lista de mesclagem. Permite unir sequencialmente vários arquivos de entrada e clips para gerar um novo vídeo. Consulte a seção MergeList deste tópico para detalhes.

• Especifique apenas um dos parâmetros MergeList ou MergeConfigUrl. O parâmetro MergeConfigUrl possui maior prioridade que o MergeList.

• Adicione até quatro parâmetros MergeURL em um job de transcodificação. Para incluir mais URLs, utilize o parâmetro MergeConfigUrl.

• Exemplo com um único MergeURL: [{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4"}].

• Exemplo com dois MergeURLs: [{"MergeURL":"http://exampleBucket**m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket**.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}].

MergeConfigUrl

String

Não

Caminho do OSS para o arquivo de configuração de mesclagem de clips.

• Utilize exclusivamente MergeList ou MergeConfigUrl. O MergeConfigUrl prevalece sobre o MergeList.

• O arquivo deve estar armazenado em um bucket do OSS. Exemplo: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/mergeConfigfile.

• O arquivo contém múltiplos parâmetros MergeURL. Defina-os na ordem desejada para a mesclagem dos clips, respeitando o limite de 50 URLs. Para detalhes sobre o formato, veja a seção MergeList deste tópico. Exemplo de conteúdo do arquivo de configuração: {"MergeList":[{"MergeURL":"http://exampleBucket**m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket**.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}]}.

OpeningList

Object[]

Não

As vinhetas de abertura. Abertura é um efeito especial de mesclagem que insere vinhetas no início do vídeo de entrada, exibidas no modo Picture-in-Picture (PiP). Consulte a seção OpeningList deste tópico para mais informações.

• Adicione até duas vinhetas de abertura por job de transcodificação. Defina-as na ordem em que devem aparecer no vídeo final.

• Exemplo: [{"OpenUrl":"http://exampleBucket**.oss-cn-hangzhou.aliyuncs.com/opening_01.flv","Start":"1","Width":"1920","Height":"1080"},{"OpenUrl":"http://exampleBucket**.oss-cn-hangzhou.aliyuncs.com/opening_02.flv","Start":"1","Width":"-1","Height":"full"}].

TailSlateList

Object[]

Não

As vinhetas de encerramento. Encerramento é um efeito especial que adiciona vinhetas ao final do vídeo de entrada, utilizando transições de fade-in e fade-out. Veja a seção TailSlateList deste tópico para detalhes.

• É permitido inserir até duas vinhetas de encerramento por job. Ordene-as conforme a sequência desejada no vídeo de saída.

• Exemplo: [{"TailUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_01.flv","Start":"1","BlendDuration":"2","Width":"1920","Height":"1080","IsMergeAudio":false,"BgColor":"White"}].

Amix

Object[]

Não

Configuração de mixagem de áudio. Recomendado para cenários que exigem união de múltiplas faixas de áudio ou adição de música de fundo. Consulte a seção Amix deste tópico.

• Suporta até quatro arquivos de áudio mixados por job de transcodificação.

• Exemplo de mixagem de dois fluxos de áudio do arquivo de entrada: [{"AmixURL":"input","MixDurMode":"longest","Start":"1","Duration":"2"}].

• Exemplo de adição de arquivo externo mixado com o arquivo de entrada: [{"AmixURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv","Map":"0:a:1","MixDurMode":"longest","Start":"1","Duration":"2"}].

MuxConfig

Object

Não

Configurações de empacotamento. Para mais informações, consulte a seção MuxConfig deste tópico.

• Quando especificado, sobrescreve o parâmetro equivalente no modelo de transcodificação escolhido.

• Exemplo: {"Segment":{"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}}. Isso força a segmentação do vídeo nos segundos 1, 2, 4, 6, 10, 14, 18, 20, 30, 40, 50...

M3U8NonStandardSupport

Object

Não

Suporte não padrão para o formato M3U8. Consulte a seção M3U8NonStandardSupport deste tópico para detalhes.

• Exemplo: {"TS":{"Md5Support":true,"SizeSupport":true}}. Inclui o valor MD5 e o tamanho de cada arquivo TS no vídeo M3U8 de saída.

Encryption

String

Não

Configuração de criptografia. Aplica-se somente quando o parâmetro Container estiver definido como m3u8. Para mais informações, consulte Encryption parameter details.

• Exemplo: {"Type":"hls-aes-128","Key":"ZW5jcnlwdGlvbmtleTEyMw","KeyType":"Base64","KeyUri":"aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ=="}.

UserData

String

Não

Dados personalizados, com tamanho máximo de 1.024 bytes.

Priority

String

Não

Prioridade do job de transcodificação na fila do MPS.

• Valores válidos: [1,10]. O valor 1 representa a menor prioridade, enquanto 10 indica a mais alta.

• Valor padrão: 6.

• Melhor prática: Filas do MPS possuem limites de concorrência. Ao enviar muitos jobs, eles podem entrar em fila. Recomenda-se configurar prioridade mais alta para jobs críticos ou sensíveis ao tempo.

Metadata

Map

Não

Os metadata para o formato de contêiner do vídeo de saída, especificados como pares chave-valor JSON. Exemplo: {"key1":"value1","key2":"value2"}.

• Comprimento máximo da key: 64.

• Comprimento máximo do value: 512.

• Adicione até 4 pares chave-valor de metadata.

Parâmetro

Tipo

Obrigatório

Descrição

Format

String

Não

O formato de contêiner.

• Para informações sobre formatos suportados e codecs compatíveis, consulte Supported formats.

  • Formatos de vídeo suportados: 3GP, AVI, FLV, F4V, fMP4, MKV, MOV, MP4, TS, MXF, WebM, M3U8, HLS-fMP4, MPD, CMAF-HLS e CMAF-DASH.

  • Formatos de áudio suportados: AAC, M4A, MP2, MP3, MP4, Ogg, FLAC, M3U8, HLS-fMP4, MPD, CMAF-HLS e CMAF-DASH.

  • Imagens animadas: GIF e WebP.

• Formato padrão: MP4.

Parâmetro

Tipo

Obrigatório

Descrição

Remove

String

Não

Define se o stream de vídeo deve ser excluído. Valores válidos:

• true: exclui o stream de vídeo. Ao definir este parâmetro como true, todos os parâmetros relacionados ao vídeo tornam-se inválidos.

• false: o item é mantido.

• Valor padrão: false.

Codec

String

Não

Formato de codificação de vídeo.

• Valores válidos: H.264, H.265, AV1, GIF e WEBP. Para mais informações sobre formatos suportados e containers compatíveis, consulte Supported formats.

• Valor padrão: H.264.

Width

String

Não

Largura ou lado maior do vídeo de saída. Se o parâmetro LongShortMode for definido como false ou deixado vazio, este parâmetro indica a largura do vídeo de saída. Se LongShortMode for true, ele representa o lado maior do vídeo.

• Unidade: pixel.

• Valores válidos: [128,4096]. O valor deve ser um número par.

• Valor padrão:

  • Se nenhum dos parâmetros Width ou Height for especificado, o valor padrão corresponde à largura ou ao lado maior do vídeo de entrada.

  • Caso apenas o parâmetro Height seja informado, o valor padrão é calculado com base na proporção de tela do vídeo de entrada.

Height

String

Não

Altura ou lado menor do vídeo de saída. Quando LongShortMode é false ou está vazio, este parâmetro define a altura do vídeo resultante. Se LongShortMode for true, ele define o lado menor.

• Unidade: pixel.

• Valores válidos: [128,4096]. O valor deve ser um número par.

• Valor padrão:

  • Se nem Width nem Height forem definidos, utiliza-se a menor dimensão do vídeo de entrada.

  • Quando apenas o parâmetro Width é especificado, o cálculo do valor padrão considera a proporção de tela do vídeo original.

LongShortMode

String

Não

Indica se a rotação automática (adaptação às bordas longas e curtas) deve ser ativada. Esta configuração só tem efeito quando Width ou Height estiver especificado.

• true: recurso ativado.

• false: desativado.

• Valor padrão: false.

• Melhor prática: caso seus vídeos de entrada incluam tanto paisagem quanto retrato, ative a rotação automática e configure o dimensionamento proporcional usando os parâmetros de resolução para evitar estiramento e distorção da imagem. Veja um exemplo em Configure automatic rotation.

Fps

String

Não

Taxa de quadros do stream de vídeo.

• Unidade: quadros por segundo.

• Valores válidos: (0,60].

• Valor padrão: taxa de quadros do arquivo de entrada. Se essa taxa ultrapassar 60, o sistema usará 60.

• Valores comuns: 24, 25 e 30.

MaxFps

String

Não

Taxa máxima de quadros.

Gop

String

Não

Define o intervalo entre I-frames adjacentes em tempo ou quantidade de quadros.

• Formato para intervalo máximo de tempo entre dois I-frames consecutivos: {Time}s. Valores válidos: [1,100000].

• Formato para intervalo máximo de quadros entre dois I-frames consecutivos: {Number of frames}. Valores válidos: [1,100000].

• Valor padrão: 10s, indicando um intervalo de 10 segundos entre I-frames consecutivos.

• Recomendação: em cenários de streaming, defina este parâmetro com um intervalo de tempo entre dois e sete segundos para reduzir o tempo de início da reprodução e melhorar a resposta nas buscas.

Bitrate

String

Não

Bitrate médio do vídeo de saída. Nos modos de controle CBR, ABR ou VBR, especifique o parâmetro Bitrate e defina TransMode com um valor válido. Consulte a seção Bitrate control mode deste tópico para mais informações.

• Unidade: Kbit/s.

• Valores válidos: -1 e [10,50000]. O valor -1 mantém o bitrate original do vídeo de entrada.

• Melhores práticas:

  • CBR: defina TransMode como CBR e iguale os valores de Bitrate, Maxrate e Bufsize.

  • ABR: configure TransMode como onepass e informe o parâmetro Bitrate. Opcionalmente, use Maxrate e Bufsize para limitar a faixa de bitrate.

  • VBR: ajuste TransMode para twopass e especifique Maxrate ou BitrateBnd juntamente com Bufsize.

BitrateBnd

String

Não

Faixa de bitrate médio do vídeo de saída.

• Este parâmetro só entra em vigor quando Codec estiver definido como H.264.

• Exemplo: {"Max":"5000","Min":"1000"}.

Maxrate

String

Não

Bitrate de pico do vídeo de saída. Veja mais detalhes na seção Bitrate control mode deste tópico.

• Unidade: Kbit/s.

• Valores válidos: [10,50000].

Bufsize

String

Não

Tamanho do buffer para controle de bitrate. Use este parâmetro para gerenciar a flutuação do bitrate. Mais informações na seção Bitrate control mode deste tópico.

• Unidade: Kbit.

• Valores válidos: [1000,128000].

• Valor padrão: 6000.

Crf

String

Não

Fator de controle de qualidade. Para utilizar o modo CRF, informe o parâmetro Crf e defina TransMode como fixCRF. Consulte a seção Bitrate control mode para detalhes.

• Valores válidos: [20,51].

• Para Codec H.264, o padrão é 23; para H.265, é 26; e para AV1, é 32.

• Recomendações de uso:

  • O valor 0 indica compressão sem perdas, enquanto 51 representa a pior qualidade possível. Sugerimos adotar valores entre 23 e 29, ajustando conforme a complexidade visual do vídeo. Cada incremento ou decremento de seis unidades reduz ou dobra o bitrate, respectivamente. Mantendo a mesma definição, animações geralmente aceitam valores mais altos do que vídeos filmados.

  • Como o modo CRF prioriza a qualidade visual, o bitrate final torna-se imprevisível. Utilize Maxrate e Bufsize para estabelecer limites na faixa de bitrate.

Qscale

String

Não

Valor do fator de controle de qualidade do vídeo. Este parâmetro aplica-se ao modo VBR.

• Aplicável somente quando Codec for H.264.

• Valores válidos: [0,51].

Profile

String

Não

Especifica o perfil de codificação. Consulte Terms para mais informações.

• Válido apenas se Codec for H.264.

• Opções disponíveis: baseline, main e high.

• Valor padrão: high.

• Sugestão: ao gerar múltiplas resoluções a partir do mesmo vídeo, utilize baseline para a menor resolução, garantindo compatibilidade ampla com dispositivos. Para as demais resoluções, prefira main ou high.

Preset

String

Não

Modo predefinido do codificador H.264.

• Aplica-se exclusivamente quando Codec for H.264.

• Valores válidos: veryfast, fast, medium, slow e slower.

• Valor padrão: medium.

ScanMode

String

Não

Modo de varredura. Valores válidos:

• Se deixado em branco, o sistema adota o modo de varredura do arquivo de entrada.

• auto: realiza desentrelaçamento automaticamente.

• progressive: varredura sequencial linha por linha.

• interlaced: varredura entrelaçada.

• Valor padrão: None.

Melhor prática: embora o modo entrelaçado economize tráfego de dados em comparação ao progressivo, sua qualidade de imagem é inferior. Por isso, a produção de vídeo moderna adota predominantemente a varredura progressiva.

• Definir ScanMode como progressive ou interlaced incompatível com o arquivo de entrada causará falha na transcodificação.

• Recomendamos usar Original Video Mode ou Automatic Deinterlacing para garantir maior compatibilidade.

PixFmt

String

Não

Formato de cor do vídeo.

• Para preservar o formato de cor original, defina PixFmt como "".

• Inclui yuv420p, yuvj420p, yuv422p, yuvj422p, yuv444p, yuvj444p, yuv444p, yuv444p161e, pc, bt470bg e smpte170m. Quando Codec for GIF, bgr8 também é aceito.

Crop

String

Não

Método de recorte de vídeo. As bordas podem ser detectadas e removidas automaticamente, ou você pode aplicar um recorte manual.

• Utilize este parâmetro quando a resolução de entrada superar a de saída. Evite especificar AdjDarMethod simultaneamente.

• Remoção automática de barras pretas.

• Para recorte personalizado, siga o formato {width}:{height}:{left}:{top}.

  • width: largura final do vídeo após o recorte.

  • height: altura final do vídeo após o recorte.

  • left: margem esquerda entre a imagem de saída e a original.

  • top: margem superior entre a imagem de saída e a original.

• Exemplo de recorte personalizado: 1920:800:0:140.

Pad

String

Não

Adiciona barras pretas ao vídeo.

• Use quando a resolução de entrada for menor que a de saída. Não combine com IsCheckReso, IsCheckResoFail ou AdjDarMethod.

• Formato: {width}:{height}:{left}:{top}.

  • width: largura total do vídeo após adicionar as bordas pretas.

  • height: altura total do vídeo após adicionar as bordas pretas.

  • left: margem esquerda do quadro original em relação ao quadro de saída.

  • top: distância entre o topo do quadro de saída e o topo do quadro original.

• Exemplo: 1920:1080:0:140.

Parâmetro

Tipo

Obrigatório

Descrição

Remove

String

Não

Determina se o stream de áudio será excluído.

• true: remove o stream de áudio. Todos os demais parâmetros de áudio perdem o efeito.

• false: mantém o recurso.

• Valor padrão: false.

Codec

String

Não

Formato de codificação de áudio.

• Opções válidas: AAC, AC3, EAC3, MP2, MP3, FLAC, OPUS, VORBIS, WMA-V1, WMA-V2 e pcm_s16le. Consulte Supported formats para verificar formatos suportados e containers compatíveis.

• Valor padrão: AAC.

Profile

String

Não

Perfil de codificação de áudio.

• Aplicável apenas quando Codec for AAC.

• Valores válidos: aac_low, aac_he, aac_he_v2, aac_ld e aac_eld. Para entender melhor o conceito de perfil de codificação, veja Terms.

• Valor padrão: aac_low.

Bitrate

String

Não

Bitrate de áudio do arquivo de saída.

• Unidade: Kbit/s.

• Valores válidos: [8,1000].

• Valor padrão: 128.

• Valores frequentes: 64, 128 e 256.

Samplerate

String

Não

Taxa de amostragem.

• Unidade: Hz.

• Opções disponíveis: 22050, 32000, 44100, 48000 e 96000.

  Nota

  As taxas de amostragem suportadas dependem do formato de codificação e do container. Consulte Audio sample rates para detalhes. Por exemplo, com Codec MP3, não é possível usar 96000; já no formato FLV, apenas 22050 ou 44100 são permitidos.

• Valor padrão: 44100.

Channels

String

Não

Quantidade de canais de som.

• Valores válidos: 0, 1, 2, 4, 5, 6 e 8.

  • Para Codec MP3 ou OPUS, utilize 0, 1 ou 2.

  • Com Codec AAC ou FLAC, as opções são 0, 1, 2, 4, 5, 6 ou 8.

  • Se Codec for VORBIS, o único valor permitido é 2.

  • Quando Format for MPD, o valor 8 não é suportado.

• Valor padrão: 2.

• Para manter a quantidade original de canais, defina este parâmetro como 0.

Volume

String

Não

Configuração de volume. Consulte a seção Volume deste tópico para mais detalhes.

• Suportado apenas quando há um único stream de áudio de saída. Configurações com múltiplos streams de áudio não aceitam este parâmetro.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Não

Tipo da marca d'água. Valores válidos:

• Text: marca d'água de texto. Ao definir este parâmetro como Text, é necessário especificar o parâmetro TextWaterMark.

• Image: marca d'água de imagem. Ao definir este parâmetro como Image, especifique os parâmetros relacionados à marca d'água de imagem.

• Valor padrão: Image.

TextWaterMark

Object

Não

Configuração da marca d'água de texto. Para mais informações, consulte a seção TextWaterMark deste tópico.

• Se o parâmetro Type estiver definido como Text, este parâmetro será obrigatório.

• Exemplo: {"Content":"5rWL6K+V5paH5a2X5rC05Y2w","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}.

InputFile

Object

Não

Arquivo a ser usado como marca d'água de imagem. Utilize os parâmetros Bucket, Location e Object para especificar a localização do arquivo.

• Os seguintes tipos de arquivo são suportados: imagens estáticas PNG no formato .png, imagens animadas PNG no formato .apng, arquivos MOV no formato .mov e arquivos GIF no formato .gif.

• O arquivo deve estar armazenado em um bucket do OSS. Para mais informações, consulte a seção Input deste tópico.

• Na API do ApsaraVideo Media Processing, o Object requer URL Encoding (baseado em UTF-8) antes do uso.

• Exemplo: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"}.

WaterMarkTemplateId

String

Não

ID do modelo de marca d'água de imagem. Caso este parâmetro não seja especificado, as seguintes configurações padrão serão aplicadas aos parâmetros da marca d'água de imagem:

• A posição da marca d'água de imagem será TopRight.

• Dx e Dy: 0.

• Width: 0,12 vezes a largura do vídeo de saída.

• Height: dimensionada proporcionalmente com base na largura da marca d'água de imagem.

• Tempo de exibição da marca d'água de imagem: toda a duração.

ReferPos

String

Não

Localização da marca d'água de imagem.

• Valores válidos: TopRight, TopLeft, BottomRight e BottomLeft.

Dx

String

Não

Deslocamento horizontal da marca d'água de imagem em relação ao vídeo de saída. Se você especificar este parâmetro, o parâmetro correspondente no modelo de marca d'água especificado será substituído. Os seguintes tipos de valor são suportados:

• Integer: valor em pixels do deslocamento horizontal.

  • Unidade: pixel.

  • Valores válidos: [8,4096].

• Decimal: proporção do deslocamento horizontal em relação à largura do vídeo de saída.

  • Valores válidos: (0,1).

  • Suporta quatro casas decimais, como 0,9999. Casas decimais excedentes são descartadas.

Dy

String

Não

Deslocamento vertical da marca d'água de imagem em relação ao vídeo de saída. Os seguintes tipos de valor são suportados:

• Integer: valor em pixels do deslocamento vertical.

  • Unidade: pixel.

  • Valores válidos: [8,4096].

• Decimal: proporção do deslocamento vertical em relação à altura do vídeo de saída.

  • Valores válidos: (0,1).

  • Suporta quatro casas decimais, como 0,9999. Casas decimais excedentes são descartadas.

Width

String

Não

É possível definir a largura da marca d'água de imagem de duas maneiras:

• Integer: valor em pixels da largura da marca d'água.

  • Intervalo: [8,4096].

  • Unidade: pixel.

• Valor decimal que representa a largura do vídeo de saída como porcentagem.

  • Intervalo: (0,1).

  • Suporta quatro casas decimais, como 0,9999. Casas decimais excedentes são descartadas automaticamente.

Height

String

Não

É possível definir a altura da marca d'água de imagem de duas maneiras:

• Integer: valor em pixels da altura da marca d'água.

  • Intervalo: [8,4096].

  • Unidade: pixel.

• Valor decimal que especifica a altura como proporção da altura do vídeo de saída.

  • Intervalo: (0,1).

  • Suporta quatro casas decimais, como 0,9999. Casas decimais excedentes são descartadas automaticamente.

Timeline

String

Não

Tempo de exibição da marca d'água de imagem. Para mais informações, consulte a seção Timeline deste tópico.

Parâmetro

Tipo

Obrigatório

Descrição

Content

String

Sim

Texto a ser exibido como marca d'água. O texto deve estar codificado no formato Base64.

• Por exemplo, para adicionar a marca d'água de texto "test text watermark", defina Content como "5rWL6K+V5paH5a2X5rC05Y2w".

FontName

String

Não

Fonte.

• Para mais informações sobre as fontes suportadas, consulte Fonts.

• Valor padrão: SimSun.

FontSize

Int

Não

Tamanho da fonte.

• Valores válidos: (4,120).

• Valor padrão: 16.

FontColor

String

Não

Cor da fonte.

• Para mais informações sobre as cores suportadas, consulte a coluna name em FontColor.

• Valor padrão: black.

FontAlpha

Float

Não

Transparência do texto.

• Valores válidos: (0,1].

• Valor padrão: 1.0.

BorderWidth

Int

Não

Largura do contorno

• Unidade: pixel.

• Valores válidos: [0,4096].

• Valor padrão: 0.

BorderColor

String

Não

Cor do contorno.

• Para mais informações sobre as cores suportadas, consulte a coluna name em BorderColor.

• Valor padrão: Black.

Top

Int

Não

Margem superior do texto.

• Unidade: pixel.

• Valores válidos: [0,4096].

• Valor padrão: 0.

Left

Int

Não

Margem esquerda.

• Unidade: pixel.

• Valores válidos: [0,4096].

• Valor padrão: 0.

Parâmetro

Tipo

Obrigatório

Descrição

Start

String

Não

Início do intervalo de tempo em que a marca d'água de imagem é exibida.

• Formato: sssss[.SSS].

• O intervalo de valores válidos é [0,000, 86399,999]. O processo de transcodificação falhará se o tempo inicial exceder a duração.

• Valor padrão: 0.

• Exemplo: 18000.30.

Duration

String

Não

Intervalo de tempo durante o qual a marca d'água de imagem é exibida.

• Se o parâmetro estiver definido como ToEND, a marca d'água será exibida continuamente até o fim do vídeo.

• Formato: sssss[.SSS]. Unidade: segundos.

• Valor padrão: ToEND.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Não

Tipo da marca d'água.

• Image: marca d'água de imagem.

• Valor padrão: Image.

ReferPos

String

Não

Localização da marca d'água de imagem.

• Valores válidos: TopRight, TopLeft, BottomRight e BottomLeft.

• A figura a seguir mostra um exemplo de como usar os parâmetros ReferPos, Dx e Dy para especificar a localização da marca d'água de imagem.

Dx

String

Não

Deslocamento horizontal da marca d'água de imagem em relação ao vídeo de saída. Os seguintes tipos de valor são suportados:

• Integer: valor em pixels do deslocamento horizontal.

  • Unidade: pixel.

  • Valores válidos: [8,4096].

• Decimal: proporção do deslocamento horizontal em relação à largura do vídeo de saída.

  • Valores válidos: (0,1).

  • Suporta quatro casas decimais, como 0,9999. Casas decimais excedentes são descartadas.

Dy

String

Não

Deslocamento vertical da marca d'água de imagem em relação ao vídeo de saída. Os seguintes tipos de valor são suportados:

• Integer: valor em pixels do deslocamento vertical.

  • Unidade: pixel.

  • Valores válidos: [8,4096].

• Decimal: proporção do deslocamento vertical em relação à altura do vídeo de saída.

  • Valores válidos: (0,1).

  • Suporta quatro casas decimais, como 0,9999. Casas decimais excedentes são descartadas.

Width

String

Não

Largura da marca d'água de imagem. Os seguintes tipos de valor são suportados:

• Integer: valor em pixels da largura da marca d'água.

  • Unidade: pixel.

  • Intervalo: [8,4096].

• Tipo Decimal: proporção em relação à largura da resolução do vídeo de saída.

  • Intervalo de valores: (0,1).

  • Suporta quatro casas decimais, como 0,9999. Casas decimais excedentes são descartadas automaticamente.

Height

String

Não

A altura da marca d'água de imagem pode ser definida de duas maneiras:

• Integer: valor em pixels da altura da marca d'água.

  • Unidade: pixel.

  • Intervalo: [8,4096].

• Valor decimal: proporção em relação à altura da resolução do vídeo de saída.

  • Intervalo de valores: (0,1).

  • Suporta quatro casas decimais, como 0,9999. Casas decimais excedentes são descartadas automaticamente.

Timeline

String

Não

Marca d'água dinâmica: para mais informações, consulte Timeline parameter details.

Parâmetro

Tipo

Obrigatório

Descrição

ExtSubtitleList

Object[]

Não

As legendas externas. Para obter mais informações, consulte a seção ExtSubtitle deste tópico.

• É possível adicionar até quatro arquivos de legenda a um trabalho de transcodificação.

• Exemplo: [{"Input":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}].

Parâmetro

Tipo

Obrigatório

Descrição

Input

String

Sim

O arquivo de legenda externa. Utilize os parâmetros Bucket, Location e Object para especificar o local do arquivo.

• Os formatos SRT e ASS são suportados. As informações de cor presentes no arquivo de legenda podem ser lidas.

• O arquivo deve estar armazenado em um bucket do OSS. Para mais detalhes, veja a seção Input deste tópico.

• Placeholders são aceitos. Consulte a seção Placeholder replacement rules deste tópico para mais informações.

• O caminho de um objeto do OSS precisa ser codificado em URL UTF-8 antes de ser usado no MPS. Veja URL encoding para orientações.

• Por exemplo, se o caminho do arquivo de entrada for a/b/example.flv e o da legenda for a/b/example-cn.mp4, use placeholders para indicar o objeto no formato: {ObjectPrefix}{FileName}-cn.srt. Após a codificação da URL, o objeto ficará assim: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"%7bObjectPrefix%7d%7bFileName%7d-cn.srt"}.

CharEnc

String

Não

O formato de codificação das legendas externas.

• Valores válidos: UTF-8, GBK, BIG5 e auto.

• Valor padrão: auto.

FontName

String

Não

A fonte da legenda.

• Para saber mais sobre as fontes suportadas, consulte Fonts.

• Valor padrão: SimSun.

FontSize

Int

Não

O tamanho da fonte da legenda.

• Valores válidos: (4,120).

• Valor padrão: 16.

Parâmetro

Tipo

Obrigatório

Descrição

TimeSpan

String

Não

O intervalo de tempo para recortar um clipe do arquivo de entrada. Consulte a seção TimeSpan deste tópico para mais detalhes.

• Exemplo de especificação do intervalo usando o parâmetro Duration: {"Seek":"00:01:59.999","Duration":"180.30"}, indicando que o clipe começa em 1 minuto, 59 segundos e 999 milissegundos, terminando aos 5 minutos e 30 milissegundos.

• Exemplo de especificação do intervalo usando o parâmetro End: {"Seek":"00:01:59.999","End":"180.30"}, definindo que o clipe inicia em 1 minuto, 59 segundos e 999 milissegundos, encerrando no ponto correspondente a 5 minutos e 30 milissegundos antes do fim do vídeo.

ConfigToClipFirstPart

Boolean

Não

Define se a edição de vídeo deve ser aplicada ao primeiro segmento.

• true: recorta a parte inicial do arquivo como um clipe antes da mesclagem.

• false: o conteúdo é concatenado (transcodificado) primeiro e depois editado.

• Valor padrão: false.

Parâmetro

Tipo

Obrigatório

Descrição

Seek

String

Não

O ponto inicial do clipe. Use este parâmetro para definir onde o clipe começa. Por padrão, o início corresponde ao começo do vídeo.

• Formato: hh:mm:ss[.SSS] ou sssss[.SSS].

• Valores válidos: [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemplo: 00:01:59.999 ou 180.30.

Duration

String

Não

A duração do clipe. Especifique o comprimento do clipe em relação ao ponto definido pelo parâmetro Seek. Por padrão, a duração vai do ponto indicado em Seek até o final do vídeo. Apenas um dos parâmetros Duration ou End pode ser definido. Se End for especificado, a configuração de Duration será ignorada.

• Formato: hh:mm:ss[.SSS] ou sssss[.SSS].

• Valores válidos: [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemplo: 00:01:59.99 ou 180.30.

End

String

Não

A duração do trecho final do vídeo original a ser removido. Somente um dos parâmetros Duration ou End pode ser utilizado. Caso End seja informado, o valor de Duration perde o efeito.

• Formato: hh:mm:ss[.SSS] ou sssss[.SSS].

• Valores válidos: [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemplo: 00:01:59.999 ou 180.30.

Parâmetro

Tipo

Obrigatório

Descrição

MergeURL

String

Sim

O caminho no OSS do clipe a ser mesclado.

• O caminho de um objeto do OSS deve passar por codificação URL em UTF-8 antes de ser utilizado no MPS. Consulte URL encoding para mais informações.

• Exemplo: http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4.

Start

String

Não

O momento em que o clipe de saída é extraído do clipe original. Defina este parâmetro caso deseje mesclar apenas uma parte do vídeo no arquivo final. O ponto inicial padrão é o começo do vídeo.

• Formato: hh:mm:ss[.SSS] ou sssss[.SSS].

• Valores válidos: [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemplo: 01:59:59.999 ou 32000.23.

Duration

String

Não

A duração do vídeo mixado. Este valor é relativo ao ponto inicial definido pelo parâmetro Start. Utilize-o quando quiser incluir apenas um trecho do vídeo na saída. Por padrão, a duração se estende do ponto definido em Start até o fim do vídeo.

• Formato: hh:mm:ss[.SSS] ou sssss[.SSS].

• Valores válidos: [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemplo: 01:59:59.999 ou 32000.23.

Parâmetro

Tipo

Obrigatório

Descrição

OpenUrl

String

Sim

O caminho no OSS da vinheta de abertura.

• O caminho de um objeto do OSS requer codificação URL em UTF-8 antes do uso no MPS. Veja URL encoding para detalhes.

• Exemplo: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv.

Start

String

Não

O tempo decorrido após o início da reprodução do vídeo de entrada antes que a cena de abertura seja exibida. A contagem começa em 0.

• Unidade: segundos.

• Valor padrão: 0.

Width

String

Não

A largura do vídeo de saída pode ser configurada de três formas:

• Largura: Valor em pixels. Deve ser um número inteiro entre 0 e 4096.

• -1: A largura será igual à da vinheta de abertura do vídeo de entrada.

• Full: O vídeo preenche toda a área de reprodução.

• Valor padrão: -1.

Height

String

Não

A altura do vídeo de saída admite três configurações:

• Altura: Valor em pixels. Deve ser um inteiro entre 0 e 4096.

• -1: Mesma altura do vídeo de entrada.

• full: Preenche todo o quadro do vídeo.

• Valor padrão: -1.

Parâmetro

Tipo

Obrigatório

Descrição

TailUrl

String

Sim

A URL do vídeo de encerramento no OSS.

• Antes de usar o caminho de um objeto do OSS no MPS, faça a codificação URL em UTF-8. Consulte URL encoding para mais detalhes.

• Exemplo: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_01.flv.

BlendDuration

String

Não

O intervalo de tempo entre o fim da parte principal e o início do encerramento. Durante essa transição, o último quadro da parte principal desaparece gradualmente, enquanto o primeiro quadro do encerramento surge.

• Unidade: segundos.

• Valor padrão: 0.

Width

String

Não

A largura da parte final de saída. Valores válidos:

• Largura: Em pixels, deve estar no intervalo [0, 4096].

• -1: Mantém a mesma largura do vídeo de encerramento de entrada.

• full: O vídeo ocupa todo o quadro.

• Valor padrão: -1.

Height

String

Não

A altura da vinheta de encerramento de saída possui três opções de configuração:

• Altura: Em pixels, sendo um valor inteiro entre 0 e 4096.

• -1: Corresponde à altura do vídeo de encerramento de entrada.

• full: Preenche toda a área de reprodução.

• Valor padrão: -1.

IsMergeAudio

Boolean

Não

Indica se o áudio do vídeo de encerramento deve ser anexado.

• true: Ativa a concatenação.

• false: Não realiza concatenação.

• Valor padrão: true.

BgColor

String

Não

A cor da margem aplicada quando a largura e a altura do encerramento forem menores que as da parte principal.

• Para consultar as cores suportadas, veja a coluna name em bgcolor.

• Valor padrão: White.

Parâmetro

Tipo

Obrigatório

Descrição

AmixURL

String

Sim

O fluxo de áudio a ser mixado aceita dois modos:

• input: combina múltiplos fluxos de áudio do arquivo de entrada. É possível mixar dois fluxos de áudio provenientes do mesmo arquivo.

• Caminho do OSS: adiciona um fluxo de áudio externo, como uma música de fundo. Nesse caso, um fluxo do arquivo de entrada é mixado com o fluxo indicado pelo caminho do OSS. Exemplo: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv.

Map

String

Não

Para escolher o fluxo de áudio alvo para mixagem em AmixURL, utilize o parâmetro AudioStreamMap indicando o número ordinal do fluxo no arquivo de entrada.

• Formato: 0:a:{Número de série}. O número de série indica o índice do fluxo de áudio, começando em 0.

• Por exemplo, 0:a:1 refere-se ao segundo fluxo de áudio.

MixDurMode

String

Não

A duração do arquivo de saída mixado.

• first: Adota a duração do arquivo de entrada.

• longest: Considera a maior duração entre o arquivo de entrada e o fluxo de áudio especificado em AmixURL.

• Valor padrão: longest.

Start

String

Não

O ponto inicial do fluxo de áudio. Configure este parâmetro se desejar mixar apenas um trecho do áudio no arquivo final. O início padrão corresponde ao começo do áudio.

• Formato: hh:mm:ss[.SSS] ou sssss[.SSS].

• Valores válidos: [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemplo: 00:01:59.999 ou 18000.30.

Duration

String

Não

A extensão do áudio mixado. Este valor é calculado a partir do ponto inicial definido pelo parâmetro Start. Use-o para limitar a mixagem a apenas uma parte do áudio. Por padrão, a duração vai do ponto definido em Start até o final do áudio.

• Formato: hh:mm:ss[.SSS] ou sssss[.SSS].

• Valores válidos: [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemplo: 00:01:59.999 ou 18000.30.

Parâmetro

Tipo

Obrigatório

Descrição

Segment

String

Não

A configuração de segmentação. Consulte a seção Segment deste tópico para mais informações.

• Este parâmetro só tem efeito quando o formato do contêiner é M3U8, HLS-FMP4, MPD ou CMAF.

• Exemplo: {"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}, determinando que o vídeo seja segmentado forçosamente nos segundos 1, 2, 4, 6, 10, 14, 18, 20, 30, 40, 50...

Parâmetro

Tipo

Obrigatório

Descrição

Duration

Int

Não

A duração de cada segmento.

• Unidade: segundos.

• Valores válidos: [1,60].

• Valor padrão: 10, o que força a segmentação do vídeo nos segundos 10, 20, 30 e 40.

ForceSegTime

String

Não

Os momentos exatos em que o vídeo deve ser segmentado obrigatoriamente. Separe os pontos por vírgulas (,). É permitido informar até 10 pontos.

• Formato: {Ponto no tempo},{Ponto no tempo},{Ponto no tempo}.

• Tipo: decimal. Aceita até três casas decimais.

• Unidade: segundos.

• Exemplo: 1,2,4,6,10,14,18, indicando segmentação forçada nos segundos 1, 2, 4, 6, 10, 14 e 18.

Parâmetro

Tipo

Obrigatório

Descrição

TS

Object

Não

Suporte não padrão para arquivos TS. Consulte a seção TS deste tópico para mais detalhes.

Parâmetro

Tipo

Obrigatório

Descrição

Md5Support

Boolean

Não

Define se o valor MD5 de cada arquivo TS deve ser incluído no vídeo M3U8 de saída.

SizeSupport

Boolean

Não

Indica se o tamanho de cada arquivo TS deve constar no vídeo M3U8 gerado.

Parâmetro

Tipo

Obrigatório

Descrição

Type

String

Sim

O método de criptografia do vídeo. Valores válidos:

• hls-aes-128: criptografia padrão.

KeyType

String

Sim

Método de criptografia da chave.

• Base64: método básico de criptografia.

• KMS: Key Management Service (KMS). O KMS gera chaves em texto simples e cifrado.

Key

String

Sim

A chave cifrada para o vídeo criptografado. O formato depende do método de criptografia escolhido.

• Base64:

  • Criptografe a chave em texto simples usando Base64 e defina este parâmetro com a chave cifrada resultante.

  • A chave em texto simples é personalizada e pode ter até 16 caracteres.

  • Por exemplo, a chave cifrada correspondente à chave em texto simples "encryptionkey128" é "ZW5jcnlwdGlvbmtleTEyOA==".

• KMS:

  • Chame a operação GenerateKMSDataKey, passe a chave mestra do cliente (CMK) e defina o parâmetro KeySpec como AES_128 para obter a chave cifrada correspondente no parâmetro CiphertextBlob.

KeyUri

String

Sim

Trata-se do endpoint do serviço de descriptografia. Você precisa configurar esse serviço por conta própria.

• A URL não pode ser enviada ao MPS em texto simples. É necessário codificá-la em Base64.

• Por exemplo, se a URL for http://aliyun.com/document/hls128.key, ela será codificada em Base64 como aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ==.

SkipCnt

String

Não

A quantidade de clipes iniciais do vídeo que não serão criptografados. Isso garante um tempo de carregamento menor na inicialização.

• Exemplo: 3.

Parâmetro

Tipo

Obrigatório

Descrição

Num

String

Não

A quantidade de snapshots a serem capturados.

• Ao especificar um dos parâmetros Interval ou Num, o modo assíncrono é utilizado por padrão. O valor do parâmetro Num deve ser maior que 0.

• Se os parâmetros Num e Interval estiverem vazios e o parâmetro Time for especificado, o sistema captura sincronamente um único snapshot no momento indicado.

• Caso defina o parâmetro Num como 1 e especifique o parâmetro Time, o sistema captura assincronamente um snapshot no momento definido.

• Quando o parâmetro Num recebe um valor superior a 1, o sistema inicia a captura assíncrona de snapshots no momento definido pelo parâmetro Time e interrompe ao atingir a quantidade estipulada no parâmetro Num. As capturas ocorrem no intervalo definido pelo parâmetro Interval. Na ausência do parâmetro Interval, as capturas são feitas a cada 10 segundos. Se o resultado de Time + Interval × Num exceder a duração do vídeo de entrada, apenas os snapshots dentro da duração válida serão gerados. Após a geração, o sistema retorna a quantidade real de snapshots obtidos.

• Se definir o parâmetro Num com valor maior que 1 e o parâmetro Interval como 0, o sistema inicia a captura assíncrona no momento especificado em Time. A quantidade de snapshots segue o parâmetro Num, distribuídos uniformemente ao longo da duração do vídeo de entrada.

Time

String

Não

O momento no vídeo de entrada em que o sistema começa a capturar snapshots.

• Unidade: milissegundo.

• Caso o valor do parâmetro Time ultrapasse a duração do vídeo, a geração dos snapshots falhará.

• Este parâmetro não é obrigatório quando snapshots são capturados em pontos específicos. Nos demais cenários, este parâmetro é obrigatório.

  Nota

  No cenário de captura em pontos específicos, o MPS converte o menor ponto de tempo do parâmetro TimeArray para milissegundos. Esse valor é aplicado ao parâmetro Time neste contexto. Se o placeholder {SnapshotTime} estiver presente no caminho de saída, ele será substituído pelo valor do parâmetro Time.

Interval

String

Não

O intervalo entre as capturas de snapshots.

• Especificar este parâmetro ativa automaticamente o modo assíncrono de captura.

• Defina o parâmetro Interval com valor maior que 0 para capturar múltiplos snapshots de forma assíncrona. Unidade: segundos.

• O intervalo para screenshots médios assíncronos é 0.

• O valor padrão é 10. Este valor é aplicado caso Num seja definido e este parâmetro não.

TimeArray

Array

Não

O array de pontos de tempo específicos. Este parâmetro é obrigatório para capturas em momentos exatos.

• O valor deve ser um inteiro único em milissegundos.

• Os pontos de tempo não podem exceder a duração do vídeo, caso contrário a captura falhará.

• É possível especificar os pontos em ordem sequencial ou aleatória. Recomendamos a ordem sequencial; se forem informados fora de ordem, o MPS os organizará automaticamente.

FrameType

String

Não

Define o tipo de screenshot.

• Valor padrão: intra.

• normal: frames regulares. A qualidade de imagem é inferior à dos keyframes e a captura demanda mais tempo. Contudo, permite captura em um ponto exato.

• intra (padrão): keyframes. Possuem melhor qualidade e captura rápida devido à decodificação independente. Entretanto, aparecem em intervalos no vídeo, impedindo captura em pontos exatos. Se o ponto especificado não for preciso, o sistema captura o keyframe mais próximo. Nesse caso, se a distância entre dois keyframes for maior que o intervalo de captura, a quantidade de snapshots gerados pode ser inferior ao solicitado.

Width

String

Não

A largura dos snapshots.

• Unidade: pixel.

• Valores válidos: [8,4096]. Recomenda-se o uso de números pares.

• Valor padrão:

  • Por padrão, se nenhuma largura ou altura for definida, utiliza-se a largura do vídeo de entrada.

  • Se apenas a altura for especificada, a largura dos snapshots é calculada com base na proporção do vídeo de entrada.

Height

String

Não

A altura dos snapshots.

• Unidade: pixel.

• Valores válidos: [8,4096]. Recomenda-se o uso de números pares.

• Valor padrão:

  • Por padrão, se nenhuma largura ou altura for definida, utiliza-se a altura do vídeo de entrada.

  • Se apenas a largura for especificada, a altura dos snapshots é calculada com base na proporção do vídeo de entrada.

BlackLevel

String

Não

O limite máximo de pixels pretos em um snapshot. Se os pixels pretos ultrapassarem esse valor, o sistema considera a imagem como tela preta. Para detalhes sobre pixels pretos, consulte a descrição do parâmetro PixelBlackThreshold.

PixelBlackThreshold

String

Não

O limiar de valor de cor para pixels. Pixels com valor de cor abaixo desse limiar são considerados pretos.

• Valores válidos: [0,255]. 0 representa preto puro e 255 branco puro.

• Para aprimorar a filtragem de telas pretas, utilize um valor mais alto. Recomenda-se iniciar com 30 e ajustar conforme necessário.

• Por exemplo, ao definir este parâmetro como 100, pixels com valores de cor inferiores a 100 serão tratados como pretos.

Format

String

Não

O formato do arquivo de saída.

• Se definido como vtt, o arquivo de saída será WebVTT. É necessário especificar o parâmetro SubOut para determinar a geração de arquivos WebVTT.

• Por padrão, este parâmetro permanece vazio, resultando em um arquivo de saída no formato JPG.

SubOut

Object

Não

As configurações do arquivo WebVTT. Para mais informações, consulte a seção SubOut Webvtt deste tópico.

• Este parâmetro é obrigatório quando o parâmetro Format estiver definido como vtt.

TileOut

Object

Não

As configurações de image sprite. Para mais informações, consulte a seção TileOut deste tópico.

• Ao configurar este parâmetro, os snapshots gerados são combinados em um image sprite. O parâmetro TileOutputFile define o arquivo de saída do sprite.

• Se deixado vazio, nenhum image sprite será gerado.

OutputFile

Object

Sim

A saída consiste em um único arquivo de imagem pequena armazenado no local definido por OSS Bucket, Location e Object. Para mais informações, consulte OutputFile screenshot details.

• Os arquivos de snapshot utilizam o formato JPG.

• Exemplo: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.jpg"}.

TileOutputFile

Object

Não

O image sprite de saída. É necessário especificar o caminho de armazenamento do objeto no OSS. O valor deste parâmetro segue estrutura similar à do parâmetro OutputFile.

• Este parâmetro é obrigatório ao utilizar TileOut para gerar um image sprite.

• O arquivo do mosaico utiliza o formato JPG.

• Exemplo: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.jpg"}.

Parâmetro

Tipo

Obrigatório

Descrição

IsSptFrag

String

Não

Define se arquivos de índice WebVTT devem ser gerados. Valores válidos:

• true: gera arquivos de índice WebVTT, armazenados no mesmo caminho dos snapshots.

• false: não gera arquivos de índice WebVTT. Apenas os snapshots são exportados.

• Valor padrão: false.

Parâmetro

Tipo

Obrigatório

Descrição

Lines

Int

Não

O número de linhas contidas no snapshot em mosaico.

• Valores válidos: (0,10000].

• Valor padrão: 10.

Columns

Int

Não

O número de colunas contidas no snapshot em mosaico.

• Valores válidos: (0,10000].

• Valor padrão: 10.

CellWidth

String

Não

Largura de uma única imagem.

• Unidade: pixel.

• Valor padrão: a largura do snapshot original.

CellHeight

String

Não

Altura de uma única imagem.

• Unidade: pixel.

• Valor padrão: a altura do snapshot original.

Padding

String

Não

Espaçamento entre imagens individuais

• Unidade: pixel.

• Valor padrão: 0.

Margin

String

Não

Largura da borda.

• Valor padrão: 0.

• Unidade: pixel.

Color

String

Não

A cor de fundo utilizada para preencher margens, espaçamentos entre snapshots e áreas sem exibição de snapshots.

• É possível utilizar uma palavra-chave de cor ou valor aleatório. Por exemplo, para definir fundo preto, utilize um dos formatos: Black, black ou #000000.

• Valor padrão: black.

IsKeepCellPic

String

Não

Determina se as miniaturas individuais devem ser mantidas.

• true: A imagem individual é armazenada em OutputFile.

• false: O item não é mantido.

• Padrão: false (não mantido).

Parâmetro

Tipo

Obrigatório

Descrição

Bucket

String

Sim

O bucket do OSS que armazena os arquivos de saída das imagens individuais.

• O bucket deve obedecer às definições de OSS Bucket. Para mais informações, consulte Basic Concepts.

Location

String

Sim

A região onde o bucket do OSS está localizado.

• O bucket do OSS deve residir na mesma região do MPS.

• Deve seguir as definições de Região do OSS. Para mais informações, consulte Basic Concepts.

Object

String

Sim

O caminho no OSS onde os snapshots de saída serão armazenados.

• O caminho inclui o nome do arquivo e sua extensão. Para detalhes sobre chave de objeto, consulte Terms.

• Placeholders são suportados. Para mais informações, consulte a seção Placeholder replacement rules deste tópico.

• A única extensão de arquivo suportada é .jpg.

• O caminho de um objeto OSS deve ser codificado em URL UTF-8 antes de ser utilizado no MPS. Para mais informações, consulte URL encoding.

Parâmetro

Tipo

Obrigatório

Descrição

QueueName

String

Não

Fila do MNS a ser associada. Quando um job na fila do MPS é concluído, o resultado da execução é enviado para esta fila. Para mais informações sobre como receber notificações de mensagens, consulte Receive message notifications.

• Especifique apenas um dos parâmetros QueueName ou Topic.

• Valores válidos: tópicos do MNS que você criou. Se não houver tópicos ativos disponíveis, acesse o Simple Message Queue (formerly MNS) para criar um.

Topic

String

Não

Tópico do SMQ onde você deseja receber notificações. Após a conclusão do job, os resultados são enviados para o tópico do SMQ. Em seguida, o tópico do SMQ envia a mensagem para múltiplas filas ou URLs inscritas no tópico. Para mais informações sobre o recebimento de notificações, consulte Receive notifications.

• Especifique apenas um dos parâmetros QueueName ou Topic.

• O valor deve ser um tópico do MNS criado por você. Caso não existam tópicos disponíveis, acesse o console do Simple Message Queue (formerly MNS) para criar um.

Parâmetro

Tipo

Obrigatório

Descrição

Bucket

String

Sim

Bucket do OSS que armazena o arquivo de entrada.

• Conceda permissão de leitura no bucket do OSS ao ApsaraVideo Media Processing na página Bucket Authorization do console do OSS.

• O bucket deve estar em conformidade com a definição de bucket do OSS. Para mais informações, consulte Glossary.

Location

String

Sim

Região onde o bucket do OSS está localizado.

Siga a definição de Location do OSS. Para mais informações, consulte the Glossary.

Object

String

Sim

Objeto do OSS usado como arquivo de entrada.

• O caminho de um objeto do OSS deve cumprir a RFC 2396 e estar codificado em URL no formato UTF-8. Para mais informações, consulte URL encoding.

• Este parâmetro segue a definição de Object do OSS. Para mais informações, consulte Glossary.

Audio

String

Não

Configuração de áudio do arquivo de entrada. O valor deve ser um objeto JSON.

• Para mais informações, consulte a seção InputAudio deste tópico.

• Exemplo: {"Channels":"2","Samplerate":"44100"}.

Container

String

Não

Configuração do contêiner do arquivo de entrada. O valor deve ser um objeto JSON.

• Para mais informações, consulte a seção InputContainer deste tópico.

• Exemplo: {"Format":"u8"}.

Parâmetro

Tipo

Obrigatório

Descrição

Format

String

Sim

Formato de áudio do arquivo de entrada.

Valores válidos: alaw, f32be, f32le, f64be, f64le, mulaw, s16be, s16le, s24be, s24le, s32be, s32le, s8, u16be, u16le, u24be, u24le, u32be, u32le e u8.

Parâmetro

Tipo

Obrigatório

Descrição

Channels

String

Sim

Número de canais de som no arquivo de entrada. Valores válidos: [1,8].

Samplerate

String

Sim

Taxa de amostragem de áudio do arquivo de entrada.

• Valores válidos: (0,320000].

• Unidade: Hz.

Parâmetro

Tipo

Obrigatório

Descrição

QualityControl

String

Não

Configuração da qualidade do arquivo de saída. O valor deve ser um objeto JSON. Para mais informações, consulte a seção QualityControl deste tópico.

PropertiesControl

String

Não

Configuração de propriedades. O valor deve ser um objeto JSON. Para mais informações, consulte a seção PropertiesControl deste tópico.

Parâmetro

Tipo

Obrigatório

Descrição

RateQuality

String

Não

Nível de qualidade do arquivo de saída.

• Valores válidos: (0,51).

• O valor deve ser um número inteiro.

• Valor padrão: 25.

MethodStreaming

String

Não

Modo de reprodução. Valores válidos: network e local.

Valor padrão: network.

Parâmetro

Tipo

Obrigatório

Descrição

Deinterlace

String

Não

Define o modo de varredura forçada.

• Auto é a abreviação de Automatic.

• Force: executa o desentrelaçamento forçadamente.

• None: proíbe o desentrelaçamento.

Crop

String

Não

Configuração de recorte da imagem de vídeo.

• O valor padrão é Automatic.

• Se você não definir este parâmetro como um objeto JSON vazio, o parâmetro Mode será obrigatório.

• Para mais informações, consulte a seção Crop deste tópico.

Parâmetro

Tipo

Obrigatório

Descrição

Mode

String

Não

Este parâmetro é obrigatório se o valor do parâmetro Crop não for um objeto JSON vazio. Valores válidos:

• Auto (Automatic)

• Force: executa o recorte forçadamente.

• None: nenhuma operação é realizada.

Width

Integer

Não

Largura recortada

• Valores válidos: [8,4096].

• Se você definir o parâmetro Mode como Auto ou None, a configuração deste parâmetro será inválida.

Height

Integer

Não

Altura da imagem recortada.

• Valores válidos: [8,4096].

• Se você definir o parâmetro Mode como Auto ou None, a configuração deste parâmetro será inválida.

Top

Integer

Não

Margem superior a ser recortada.

• Valores válidos: [8,4096].

• Se você definir o parâmetro Mode como Auto ou None, a configuração deste parâmetro será inválida.

Left

Integer

Não

Margem esquerda a ser recortada.

• Valores válidos: [8,4096].

• Se você definir o parâmetro Mode como Auto ou None, a configuração deste parâmetro será inválida.

Parâmetro

Tipo

Obrigatório

Descrição

MergeList

String

Não

Campo de configuração para concatenação de vídeo.

• O valor deve ser um array JSON contendo até quatro parâmetros MergeURL. Para mais informações, consulte a seção MergeList deste tópico.

• Exemplo: [{"MergeURL":"http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/k/mp4.mp4"},{"MergeURL":"http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/c/ts.ts","Start":"1:14","Duration":"29"}].

Parâmetro

Tipo

Obrigatório

Descrição

URL

String

Não

URL do arquivo de entrada no OSS.

• Exemplo: http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example.flv.

• Se você não especificar este parâmetro, os parâmetros Bucket, Location e Object serão obrigatórios.

Bucket

String

Não

• Este valor é obrigatório se você não especificar uma URL.

• Caso contrário, a configuração deste parâmetro é inválida. Antes de especificar um bucket do OSS, conceda permissões de gravação no bucket ao MPS na página Access Control do console do OSS.

• Para mais informações sobre o termo bucket, consulte Glossary.

Location

String

Não

• Este valor é obrigatório se você não especificar uma URL.

• Caso contrário, o valor é inválido e o data center (OSS Location) do bucket do OSS é retornado na saída.

• Este parâmetro segue a definição de Location do OSS. Para mais informações, consulte Glossary.

Object

String

Não

• Este valor é obrigatório se você não especificar uma URL.

• Se o valor for inválido, o arquivo de saída (OSS Object) é codificado em UTF-8 e depois codificado em URL conforme especificado na RFC 2396. Para mais informações, consulte URL Encoding.

• Este parâmetro deve estar em conformidade com a definição de Object do OSS. Para mais informações, consulte Glossary.

Parâmetro

Tipo

Obrigatório

Descrição

URI

String

Não

Nome do stream de vídeo de saída, que deve terminar com .m3u8. Exemplo: a/b/test.m3u8. Formato: ^[a-z]{1}[a-z0-9./-]+$.

RefActivityName

String

Sim

Nome da atividade associada.

ExtXStreamInfo

Json

Sim

Informações sobre o stream. Exemplo: {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}.

Parâmetro

Tipo

Obrigatório

Descrição

Name

String

Sim

Nome do recurso. O nome pode ter até 64 bytes e deve estar codificado em UTF-8. Este parâmetro corresponde a NAME no protocolo HTTP Live Streaming (HLS) V5.

Language

String

Não

Opcional. Código de idioma no formato RFC 5646 que corresponde ao atributo LANGUAGE do protocolo HLS V5.

URI

String

Sim

Caminho do recurso.

Formato: ^[a-z]{1}[a-z0-9./-]+$. Exemplo: a/b/c/d/audio-1.m3u8.

Parâmetro

Tipo

Obrigatório

Descrição

MultiBitrateVideoStreams

JsonArray

Sim

Array de múltiplos streams. Exemplo: [{"RefActivityName": "video-1","ExtXStreamInfo": {"BandWidth": "111110","Audio":"auds","Subtitles": "subs"}}].

Parâmetro

Tipo

Obrigatório

Descrição

BandWidth

String

Sim

Largura de banda. Este parâmetro especifica o limite superior da taxa de bits total e corresponde a BANDWIDTH no protocolo HLS V5.

Audio

String

Não

ID do grupo de streams de áudio. Este parâmetro corresponde a AUDIO no protocolo HLS V5.

Subtitles

String

Não

ID do grupo de streams de legendas. Este parâmetro corresponde a SUBTITLES no protocolo HLS V5.

Parâmetro

Tipo

Obrigatório

Descrição

Group

String

Sim

Nome do grupo. Exemplo:

<AdaptationSet group="videostreams" mimeType="video/mp4" par="4096:1744"
              minBandwidth="258157" maxBandwidth="10285391" minWidth="426" maxWidth="4096"
              minHeight="180" maxHeight="1744" segmentAlignment="true"
              startWithSAP="1">

Lang

String

Não

Idioma do recurso. Você pode especificar este parâmetro para recursos de áudio e legendas.

Parâmetro

Tipo

Obrigatório

Descrição

Id

String

Sim

ID do stream. Exemplo:

<Representation id="240p250kbps" frameRate="24" bandwidth="258157"
              codecs="avc1.4d400d" width="426" height="180">

URI

String

Sim

Caminho do recurso. Formato: ^[a-z]{1}[a-z0-9./-]+$. Exemplo: a/b/c/d/video-1.mpd.

Parâmetro

Tipo

Obrigatório

Descrição

Format

String

Sim

Formato do arquivo de legenda de entrada. Valores válidos: stl, ttml e vtt.

InputFile

String

Sim

{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example-logo****.png"}
              or
              {"URL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/subtitle/test****.chs.vtt"}