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 de saída.

• Para mais informações sobre o termo chave de objeto, consulte Termos.

• Há suporte para placeholders. Para mais informações, consulte a seção Regras de substituição de placeholders deste tópico.

• Regras para especificar a extensão do nome de arquivo:

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

  • Trabalho de transcodificação: Especifique a extensão do nome de arquivo, que deve corresponder ao formato de contêiner do modelo de transcodificação. Se o formato de contêiner for M3U8, o MPS adiciona automaticamente a extensão .m3u8 à playlist. Um número de série de cinco dígitos é adicionado automaticamente como sufixo ao nome da playlist para gerar o nome de um arquivo de segmento de mídia. O número de série 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 do arquivo da playlist for filename.m3u8, o nome do primeiro arquivo de segmento de mídia 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 Codificação de URL.

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

TemplateId

String

Sim

O ID do modelo de transcodificação.

• Especifique o ID de um modelo de transcodificação personalizado ou predefinido como valor deste parâmetro. Para mais informações, consulte Criar um modelo de transcodificação e Detalhes do modelo predefinido.

• Exemplo: S00000002-200040.

Container

Object

Não

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

• Se você especificar este parâmetro, o parâmetro correspondente no modelo de transcodificação especificado será substituído.

Video

Object

Não

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

• Se você especificar este parâmetro, o parâmetro correspondente no modelo de transcodificação especificado será substituído.

Audio

Object

Não

O parâmetro relacionado à transcodificação de áudio. Para mais informações, consulte a seção Áudio deste tópico.

• Se você especificar este parâmetro, o parâmetro correspondente no modelo de transcodificação especificado será substituído.

TransConfig

Object

Não

O parâmetro relacionado ao processo de transcodificação. Para mais informações, consulte a seção TransConfig deste tópico.

• Se você especificar este parâmetro, o parâmetro correspondente no modelo de transcodificação especificado será substituído.

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

VideoStreamMap

String

Não

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}: Um fluxo de vídeo específico é selecionado. O número de série especifica o subscrito do fluxo de vídeo, começando em 0. Por exemplo, 0:v:1 indica que o segundo fluxo de vídeo foi selecionado para transcodificação.

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

AudioStreamMap

String

Não

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 de áudio em chinês, multicanal e de alta qualidade.

• 0:a:{Número de série}: Um fluxo de áudio específico é selecionado. O número de série especifica o subscrito do fluxo de áudio, começando em 0. Por exemplo, 0:a:1 indica que o segundo fluxo de áudio foi selecionado para transcodificação.

• 0:a: Todos os fluxos de áudio são selecionados. Este valor aplica-se a cenários de dublagem multi-idioma.

Rotate

String

Não

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. Marcas d'água são imagens ou textos adicionados aos quadros de vídeo. Se você especificar este parâmetro, o parâmetro correspondente no modelo de marca d'água especificado será substituído. Para mais informações, consulte a seção WaterMarks deste tópico.

• É possível adicionar até quatro marcas d'água a um trabalho 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

A operação de desfoque. Para mais informações, consulte a seção DeWatermark deste tópico.

• 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

As configurações de legenda fixa. Este parâmetro permite adicionar arquivos externos de legendas ao vídeo. Para mais informações, consulte a seção SubtitleConfig deste tópico.

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

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

Clip

Object

Não

O clipe. Para mais informações, consulte a seção Clipe deste tópico.

• Exemplo: {"TimeSpan":{"Seek":"00:01:59.999","End":"18000.30"},"ConfigToClipFirstPart":false}, indicando que o clipe começa em 1 minuto, 59 segundos e 999 milissegundos, terminando no ponto situado 5 minutos e 30 milissegundos antes do fim do vídeo. O clipe é recortado do vídeo formado pela mesclagem de vários arquivos de entrada.

MergeList

Object[]

Não

A lista de mesclagem. É possível mesclar vários arquivos de entrada e clipes sequencialmente para gerar um novo vídeo. Para mais informações, consulte a seção MergeList deste tópico.

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

• É possível adicionar até quatro parâmetros MergeURL a um trabalho de transcodificação. Para adicionar mais parâmetros MergeURL, especifique o parâmetro MergeConfigUrl.

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

• Exemplo especificando dois parâmetros MergeURL: [{"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

O caminho do OSS para o arquivo de configuração de mesclagem de clipes.

• Especifique apenas um dos parâmetros MergeList ou MergeConfigUrl. O parâmetro MergeConfigUrl tem prioridade maior que o parâmetro 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. Especifique-os na ordem em que deseja mesclar os clipes correspondentes, podendo definir até 50 parâmetros MergeURL. Para mais informações sobre o formato, consulte 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 partes de abertura. A abertura é um efeito especial de mesclagem que permite inserir vinhetas no início do vídeo de entrada, exibidas no modo Picture-in-Picture (PiP). Para mais informações, consulte a seção OpeningList deste tópico.

• É possível adicionar até duas partes de abertura a um trabalho de transcodificação. Especifique-as na ordem em que deseja inseri-las no vídeo de saída.

• 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 partes de encerramento. O encerramento é um efeito especial de mesclagem que permite adicionar créditos ou telas finais ao término do vídeo de entrada, utilizando efeitos de fade-in e fade-out. Para mais informações, consulte a seção TailSlateList deste tópico.

• É possível adicionar até duas partes de encerramento a um trabalho de transcodificação. Especifique-as na ordem em que deseja inseri-las 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

A configuração de mixagem de áudio. Este parâmetro é ideal para cenários onde se deseja mesclar várias faixas de áudio em um vídeo ou adicionar música de fundo. Para mais informações, consulte a seção Amix deste tópico.

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

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

• Exemplo de mixagem do fluxo de áudio de um arquivo externo com o fluxo de áudio de um 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

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

• Se você especificar este parâmetro, o parâmetro correspondente no modelo de transcodificação especificado será substituído.

• Exemplo: {"Segment":{"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}, indicando que o vídeo é segmentado forçadamente nos segundos 1, 2, 4, 6, 10, 14, 18, 20, 30, 40 e 50. Por padrão, o intervalo é de 10 segundos.

M3U8NonStandardSupport

Object

Não

O suporte não padrão para o formato M3U8. Para mais informações, consulte a seção M3U8NonStandardSupport deste tópico.

• Exemplo: {"TS":{"Md5Support":true,"SizeSupport":true}}, indicando que o valor MD5 e o tamanho de cada arquivo TS são incluídos no vídeo M3U8 de saída.

Encryption

String

Não

A configuração de criptografia. Este parâmetro entra em vigor apenas se o formato de contêiner estiver definido como M3U8. Para mais informações, consulte a seção Criptografia deste tópico.

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

UserData

String

Não

Os dados personalizados, com tamanho máximo de 1.024 bytes.

Priority

String

Não

A prioridade do trabalho de transcodificação na fila do MPS à qual ele foi adicionado.

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

• Valor padrão: 6.

• Melhor prática: As filas do MPS possuem limites de concorrência. Ao enviar um grande volume de trabalhos, eles podem entrar em fila. Recomendamos configurar uma prioridade mais alta para trabalhos que exigem alto desempenho temporal ou processam conteúdo crítico.

Metata

Map

Não

Especifique metadados para o formato de contêiner do vídeo de saída. O formato é um objeto JSON de chave-valor, por exemplo: {"key1":"value1","key2":"value2"}.

• Comprimento máximo da chave: 64 caracteres.

• Comprimento máximo do valor: 512 caracteres.

• Suporte para até 4 pares de chave-valor de metadados.

Parâmetro

Tipo

Obrigatório

Descrição

Format

String

Não

O formato de contêiner.

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

  • 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

  • Formatos suportados para stickers animados: GIF e WebP.

• Formato padrão: MP4.

Parâmetro

Tipo

Obrigatório

Descrição

Remove

String

Não

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

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

• false: mantém o fluxo de vídeo.

• 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 Formatos suportados.

• Valor padrão: H.264.

Width

String

Não

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

• 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, assume-se a largura ou o lado maior do vídeo de entrada.

  • Caso apenas o parâmetro Height seja definido, o cálculo baseia-se na proporção de tela do vídeo original.

Height

String

Não

Altura ou lado menor do vídeo de saída. Com LongShortMode definido como false ou vazio, refere-se à altura do vídeo. Se LongShortMode for true, corresponde ao lado menor.

• Unidade: pixel.

• Valores válidos: [128,4096]. O valor precisa ser par.

• Valor padrão:

  • Na ausência dos parâmetros Width e Height, utiliza-se a largura do vídeo de entrada.

  • Ao especificar somente Width, o sistema calcula a altura conforme a proporção do vídeo original.

LongShortMode

String

Não

Indica se o recurso de rotação automática de tela está ativo. Este parâmetro só funciona se Width ou Height estiverem definidos. Valores válidos:

• true: ativa a rotação automática de tela.

• false: desativa a rotação automática de tela.

• Valor padrão: false.

• Melhor prática: Se seus vídeos de entrada misturarem orientações paisagem e retrato, ative a rotação automática e ajuste os parâmetros de dimensionamento conforme a resolução. Isso evita distorções ou estiramentos da imagem. Consulte a seção "Ativar rotação automática de tela" no tópico Como especificar uma resolução para um vídeo de saída? para detalhes.

Fps

String

Não

Taxa de quadros do fluxo de vídeo.

• Unidade: quadros por segundo.

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

• Valor padrão: taxa de quadros do arquivo de entrada. Se ultrapassar 60, o limite de 60 será aplicado.

• Valores comuns: 24, 25 e 30.

MaxFps

String

Não

Taxa máxima de quadros.

Gop

String

Não

Intervalo de tempo ou de quadros entre dois quadros I consecutivos.

• Formato para intervalo máximo de tempo entre quadros I: {Tempo}s. Valores válidos: [1,100000].

• Formato para intervalo máximo de quadros entre quadros I: {Número de quadros}. Valores válidos: [1,100000].

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

• Recomendação: Em cenários de streaming, configure intervalos entre dois e sete segundos para acelerar o início da reprodução e melhorar a resposta nas buscas.

Bitrate

String

Não

Taxa de bits média do vídeo de saída. Nos modos CBR, ABR ou VBR, especifique o parâmetro Bitrate e defina TransMode adequadamente. Consulte a seção Modo de controle de taxa de bits neste tópico.

• Unidade: Kbit/s.

• Valores válidos: -1 e [10,50000]. O valor -1 preserva a taxa de bits 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 Bitrate. Opcionalmente, use Maxrate e Bufsize para limitar a variação da taxa.

  • VBR: Use twopass em TransMode e especifique Maxrate ou BitrateBnd junto com Bufsize.

BitrateBnd

String

Não

Intervalo da taxa de bits média do vídeo de saída.

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

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

Maxrate

String

Não

Taxa de bits de pico do vídeo resultante. Veja mais na seção Modo de controle de taxa de bits.

• Unidade: Kbit/s.

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

Bufsize

String

Não

Tamanho do buffer para controle de taxa de bits. Utilize este parâmetro para gerenciar flutuações na taxa. Detalhes adicionais estão disponíveis na seção Modo de controle de taxa de bits.

• Unidade: Kbit/s.

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

• Valor padrão: 6000.

Crf

String

Não

Fator de controle de qualidade. Para operar no modo CRF, defina Crf e configure TransMode como fixCRF. Mais detalhes na seção Modo de controle de taxa de bits.

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

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

• Orientações de uso:

  • O valor 0 indica compressão sem perdas, enquanto 51 resulta na pior qualidade possível. Recomenda-se manter valores entre 23 e 29, ajustando conforme a complexidade da cena. Alterar o valor em seis pontos dobra ou reduz pela metade a taxa de bits. Animações geralmente toleram valores mais altos que filmagens reais mantendo a mesma definição.

  • No modo CRF, a prioridade é a qualidade visual, tornando a taxa de bits imprevisível. Use Maxrate e Bufsize para estabelecer limites.

Qscale

String

Não

Fator de controle de qualidade de vídeo, aplicável no modo VBR.

• Funciona exclusivamente com Codec H.264.

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

Profile

String

Não

Perfil de codificação. Consulte a descrição do termo perfil de codificação em Termos.

• Restrito ao codec H.264.

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

• Valor padrão: high.

• Sugestão: Ao gerar múltiplas resoluções a partir da mesma fonte, utilize baseline para a menor definição, garantindo compatibilidade ampla. Para as demais resoluções, prefira main ou high.

Preset

String

Não

Modo predefinido do codificador H.264.

• Válido apenas para Codec H.264.

• Opções: veryfast, fast, medium, slow e slower.

• Valor padrão: medium.

ScanMode

String

Não

Modo de varredura. Valores válidos:

• Se deixado em branco, adota-se o modo do arquivo original. Opções:

• auto

• progressive

• interlaced

• Por padrão, o campo permanece vazio, herdando o modo de varredura da entrada.

Melhor prática: Embora a varredura entrelaçada economize tráfego de dados comparada à progressiva, sua qualidade é inferior. Por isso, produções modernas preferem o modo progressivo.

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

• Para maior compatibilidade, recomenda-se deixar este parâmetro vazio ou defini-lo como auto.

PixFmt

String

Não

Formato de pixel.

• Deixe em branco para preservar o formato de cor original.

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

Crop

String

Não

Método de recorte de vídeo. Bordas podem ser detectadas automaticamente ou o recorte pode ser manual.

• Utilize quando a resolução de entrada superar a de saída. Não combine com AdjDarMethod.

• Para remoção automática de bordas, defina como border.

• Recortes personalizados seguem o formato {largura}:{altura}:{esquerda}:{topo}.

  • width: largura final após o recorte.

  • height: altura final após o recorte.

  • left: margem esquerda entre a imagem recortada e a original.

  • top: margem superior entre a imagem recortada e a original.

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

Pad

String

Não

Configuração de barras pretas.

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

• Estrutura: {largura}:{altura}:{esquerda}:{topo}.

  • width: largura total incluindo as bordas pretas.

  • height: altura total incluindo as bordas pretas.

  • left: deslocamento horizontal da imagem original.

  • top: deslocamento vertical da imagem original.

• Exemplo: 1920:1080:0:140.

Parâmetro

Tipo

Obrigatório

Descrição

Remove

String

Não

Determina a exclusão do fluxo de áudio. Valores válidos:

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

• false: preserva o fluxo de áudio.

• Valor padrão: false.

Codec

String

Não

Formato de codificação de áudio.

• Suporta AAC, AC3, EAC3, MP2, MP3, FLAC, OPUS, VORBIS, WMA-V1, WMA-V2 e pcm_s16le. Consulte Formatos suportados para detalhes sobre compatibilidade.

• Valor padrão: AAC.

Profile

String

Não

Perfil de codificação de áudio.

• Aplica-se somente ao codec AAC.

• Escolha entre aac_low, aac_he, aac_he_v2, aac_ld e aac_eld. Saiba mais sobre perfis de codificação em Termos.

• Valor padrão: aac_low.

Bitrate

String

Não

Taxa de bits do áudio de saída.

• Unidade: Kbit/s.

• Intervalo válido: [8,1000].

• Valor padrão: 128.

• Valores frequentes: 64, 128 e 256.

Samplerate

String

Não

Taxa de amostragem.

• Unidade: Hz

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

  Nota

  A disponibilidade depende do codec e do container. Verifique Taxas de amostragem suportadas. Por exemplo, MP3 não aceita 96000, e FLV restringe a escolha a 22050 ou 44100.

• Valor padrão: 44100.

Channels

String

Não

Quantidade de canais de som.

• Aceita 0, 1, 2, 4, 5, 6 e 8.

  • Para MP3 ou OPUS, limite-se a 0, 1 ou 2.

  • AAC e FLAC permitem 0, 1, 2, 4, 5, 6 ou 8.

  • VORBIS exige valor 2.

  • O formato MPD não suporta 8 canais.

• Valor padrão: 2.

• Defina como 0 para manter a contagem original de canais.

Volume

String

Não

Ajuste de volume. Consulte a seção Volume para instruções detalhadas.

• Suportado apenas para configurações com um único fluxo de áudio de saída. Múltiplos fluxos desabilitam esta opção.

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, é necessário especificar 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. Use os parâmetros Bucket, Location e Object para especificar o local 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.

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

• 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 relacionados à marca d'água de imagem:

• ReferPos: 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.

• Timeline: do início ao fim.

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 este parâmetro for especificado, o parâmetro correspondente no modelo de marca d'água informado será substituído. Os seguintes tipos de valor são suportados:

• Inteiro: 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 até 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:

• Inteiro: 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 até 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:

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

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

  • Unidade: pixel.

• Decimal: proporção da largura da marca d'água em relação à largura do vídeo de saída.

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

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

Height

String

Não

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

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

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

  • Unidade: pixel.

• Decimal: proporção da altura da marca d'água em relação à altura do vídeo de saída.

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

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

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.

• Exemplo: 5rWL6K+V5paH5a2X5rC05Y2w.

FontName

String

Não

Fonte da marca d'água de texto.

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

• Valor padrão: SimSun.

FontSize

Int

Não

Tamanho da fonte da marca d'água de texto.

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

• Valor padrão: 16.

FontColor

String

Não

Cor da marca d'água de texto.

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

• Valor padrão: Black.

FontAlpha

Float

Não

Transparência da marca d'água de texto.

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

• Valor padrão: 1.0.

BorderWidth

Int

Não

Largura do contorno da marca d'água de texto.

• Unidade: pixel.

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

• Valor padrão: 0.

BorderColor

String

Não

Cor do contorno da marca d'água de texto.

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

• Valor padrão: Black.

Top

Int

Não

Margem superior da marca d'água de texto.

• Unidade: pixel.

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

• Valor padrão: 0.

Left

Int

Não

Margem esquerda da marca d'água de texto.

• 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].

• Valores válidos: [0.000,86399.999]. Se o horário inicial de exibição da marca d'água de imagem for posterior ao horário final do vídeo, o trabalho de transcodificação falhará.

• 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. Valores válidos:

• 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 ilustra como utilizar 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:

• Inteiro: 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 até 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:

• Inteiro: 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 até 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:

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

  • Unidade: pixel.

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

• Decimal: proporção da largura da marca d'água em relação à largura do vídeo de saída.

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

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

Height

String

Não

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

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

  • Unidade: pixel.

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

• Decimal: proporção da altura da marca d'água em relação à altura do vídeo de saída.

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

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

Timeline

String

Não

Linha do tempo da marca d'água dinâmica. Para mais informações, consulte a seção Timeline deste tópico.

Parameter

Type

Required

Description

ExtSubtitleList

Object[]

No

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"}].

Parameter

Type

Required

Description

Input

String

Yes

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 do arquivo de legenda podem ser lidas.

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

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

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

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

CharEnc

String

No

Formato de codificação das legendas externas.

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

• Valor padrão: auto.

FontName

String

No

Fonte da legenda.

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

• Valor padrão: SimSun.

FontSize

Int

No

Tamanho da fonte da legenda.

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

• Valor padrão: 16.

Parameter

Type

Required

Description

TimeSpan

String

No

Intervalo de tempo para recortar um clipe do arquivo de entrada. Para obter mais informações, consulte a seção TimeSpan deste tópico.

• Exemplo de especificação do intervalo de tempo usando o parâmetro Duration: {"Seek":"00:01:59.999","Duration":"18000.30"}, que define o início do clipe em 1 minuto, 59 segundos e 999 milissegundos, terminando em 5 minutos e 30 milissegundos.

• Exemplo de especificação do intervalo de tempo usando o parâmetro End: {"Seek":"00:01:59.999","End":"18000.30"}, que define o início do clipe em 1 minuto, 59 segundos e 999 milissegundos, terminando no ponto situado 5 minutos e 30 milissegundos antes do fim do vídeo.

ConfigToClipFirstPart

Boolean

No

Define se a primeira parte do arquivo deve ser recortada como um clipe antes da mesclagem de clipes. Valores válidos:

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

• false: mescla os clipes antes de recortar a primeira parte do arquivo.

• Valor padrão: false.

Parameter

Type

Required

Description

Seek

String

No

Ponto inicial do clipe. Utilize este parâmetro para definir o momento de início do clipe. 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: 00:01:59.999 ou 180.30.

Duration

String

No

Duração do clipe. Especifique a duração do clipe em relação ao ponto definido pelo parâmetro Seek. Por padrão, a duração vai do ponto especificado em Seek até o final do vídeo. Apenas um dos parâmetros Duration ou End pode ser especificado. Se o parâmetro End for definido, 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

No

Duração da parte final do vídeo original a ser removida. Apenas um dos parâmetros Duration ou End pode ser especificado. Se o parâmetro End for definido, 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.999 ou 18000.30.

Parameter

Type

Required

Description

MergeURL

String

Yes

Caminho no OSS do clipe a ser mesclado.

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

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

Start

String

No

Momento em que o clipe de saída é cortado a partir do clipe original. Especifique este parâmetro caso deseje mesclar apenas uma parte do vídeo no arquivo de saída. 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

No

Duração do vídeo mesclado. A duração é relativa ao ponto inicial definido pelo parâmetro Start. Especifique este parâmetro caso deseje mesclar apenas uma parte do vídeo no arquivo de saída. Por padrão, a duração corresponde ao período entre o ponto inicial definido por Start e o final 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.

Parameter

Type

Required

Description

OpenUrl

String

Yes

Caminho no OSS da parte de abertura.

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

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

Start

String

No

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

• Unidade: segundos.

• Valor padrão: 0.

Width

String

No

Largura da parte de abertura de saída. Valores válidos:

• Largura personalizada: permite personalizar a largura da parte de abertura de saída. Valores válidos: [0,4096]. Unidade: pixel.

• -1: a largura da parte de abertura de saída é igual à largura da parte de abertura de entrada.

• full: a largura da parte de abertura de saída é igual à largura da parte principal.

• Valor padrão: -1.

Height

String

No

Altura da parte de abertura de saída. Valores válidos:

• Altura personalizada: permite personalizar a altura da parte de encerramento de saída. Valores válidos: [0,4096]. Unidade: pixel.

• -1: a altura da parte de abertura de saída é igual à altura da parte de abertura de entrada.

• full: a altura da parte de abertura de saída é igual à altura da parte principal.

• Valor padrão: -1.

Parameter

Type

Required

Description

TailUrl

String

Yes

Caminho no OSS da parte de encerramento do vídeo.

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

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

BlendDuration

String

No

Tempo entre o fim da parte principal e o início da parte de encerramento. Durante a transição, o último quadro da parte principal desaparece gradualmente (fade out) e o primeiro quadro da parte de encerramento surge gradualmente (fade in).

• Unidade: segundos.

• Valor padrão: 0.

Width

String

No

Largura da parte de encerramento de saída. Valores válidos:

• Largura personalizada: permite personalizar a largura da parte de encerramento de saída. Valores válidos: [0,4096]. Unidade: pixel.

• -1: a largura da parte de encerramento de saída é igual à largura da parte de encerramento de entrada.

• full: a largura da parte de encerramento de saída é igual à largura da parte principal.

• Valor padrão: -1.

Height

String

No

Altura da parte de encerramento de saída. Valores válidos:

• Altura personalizada: permite personalizar a altura da parte de encerramento de saída. Valores válidos: [0,4096]. Unidade: pixel.

• -1: a altura da parte de encerramento de saída é igual à altura da parte de encerramento de entrada.

• full: a altura da parte de encerramento de saída é igual à altura da parte principal.

• Valor padrão: -1.

IsMergeAudio

Boolean

No

Define se o conteúdo de áudio da parte de encerramento deve ser mesclado. Valores válidos:

• true: mescla o conteúdo de áudio da parte de encerramento.

• false: não mescla o conteúdo de áudio da parte de encerramento.

• Valor padrão: true.

BgColor

String

No

Cor da margem caso a largura e a altura da parte de encerramento sejam menores que as da parte principal.

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

• Valor padrão: White.

Parameter

Type

Required

Description

AmixURL

String

Yes

Fluxo de áudio a ser mixado. Valores válidos:

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

• Caminho no OSS: adiciona um fluxo de áudio externo. Por exemplo, é possível adicionar música de fundo. Mixe um fluxo de áudio do arquivo de entrada com o fluxo especificado pelo caminho no OSS. Exemplo: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv.

Map

String

No

Número sequencial do fluxo de áudio no arquivo de entrada. Após especificar um fluxo de áudio com o parâmetro AmixURL, utilize o parâmetro Map para indicar um fluxo de áudio do arquivo de entrada.

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

• Por exemplo, 0:a:1 especifica o segundo fluxo de áudio.

MixDurMode

String

No

Modo para determinar a duração do arquivo de saída após a mixagem. Valores válidos:

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

• longest: utiliza a maior duração entre o arquivo de entrada e o fluxo de áudio especificado pelo parâmetro AmixURL.

• Valor padrão: longest.

Start

String

No

Ponto inicial do fluxo de áudio. Especifique este parâmetro caso deseje mixar apenas uma parte do áudio no arquivo de saída. O ponto inicial padrão é o 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

No

Duração do áudio mixado. A duração é relativa ao ponto inicial definido pelo parâmetro Start. Especifique este parâmetro caso deseje mixar apenas uma parte do áudio no arquivo de saída. Por padrão, a duração corresponde ao período entre o ponto inicial definido por Start e 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.

Parameter

Type

Required

Description

Segment

String

No

Configuração de segmentação. Para obter mais informações, consulte a seção Segment deste tópico.

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

• Exemplo: {"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}, que força a segmentação do vídeo nos segundos 1, 2, 4, 6, 10, 14, 18, 20, 30, 40 e 50. Por padrão, o intervalo é de 10 segundos.

Parameter

Type

Required

Description

Duration

Int

No

Duração do 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

No

Pontos em que o vídeo é segmentado forçadamente. Separe os pontos por vírgulas (,). É possível especificar até 10 pontos.

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

• Tipo: decimal. Este parâmetro suporta até três casas decimais.

• Unidade: segundos.

• Exemplo: 1,2,4,6,10,14,18, que força a segmentação do vídeo nos segundos 1, 2, 4, 6, 10, 14 e 18.

Parameter

Type

Required

Description

TS

Object

No

Suporte não padrão para arquivos TS. Para obter mais informações, consulte a seção TS deste tópico.

Parameter

Type

Required

Description

Md5Support

Boolean

No

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

SizeSupport

Boolean

No

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

Parameter

Type

Required

Description

Type

String

Yes

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

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

KeyType

String

Yes

Método de criptografia da chave. Valores válidos:

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

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

Key

String

Yes

Chave cifrada usada para criptografar o vídeo. Especifique este parâmetro com base no valor do parâmetro KeyType. Valores válidos:

• Base64:

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

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

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

• 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

Yes

URL da chave. Você deve construir a URL.

• A URL não pode ser passada ao MPS em texto simples. É necessário criptografar a URL em Base64.

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

SkipCnt

String

No

Número de clipes não criptografados no início do vídeo. Isso garante um tempo de carregamento menor durante a 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 é ativado por padrão. O valor de 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 um snapshot sincronamente no momento indicado.

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

• Quando o parâmetro Num for maior que 1, o sistema inicia a captura assíncrona de snapshots no momento definido pelo parâmetro Time e para ao atingir a quantidade definida em Num. As capturas ocorrem no intervalo definido pelo parâmetro Interval. Sem a definição de Interval, as capturas ocorrem 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 do vídeo serão gerados. Após a geração, o número real de snapshots é retornado.

• Se o parâmetro Num for maior que 1 e Interval for 0, o sistema inicia a captura assíncrona no momento especificado em Time. A quantidade de snapshots é determinada por 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.

• Se o valor do parâmetro Time ultrapassar a duração do vídeo, os snapshots não serão gerados.

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

  Nota

  No cenário de captura em momentos específicos, o MPS converte o menor ponto de tempo do parâmetro TimeArray para milissegundos. Esse valor é utilizado no parâmetro Time. Se o placeholder {SnapshotTime} for especificado 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 Interval com um valor maior que 0 para capturar múltiplos snapshots assincronamente. Unidade: segundos.

• Defina Interval como 0 para distribuir as capturas uniformemente ao longo da duração do vídeo de entrada.

• Valor padrão: 10. Este valor é aplicado quando o parâmetro Num é especificado, mas Interval permanece vazio.

TimeArray

Array

Não

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

• Unidade: milissegundo. O valor deve ser um array de inteiros únicos.

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

• É possível especificar os momentos em ordem sequencial ou não. Recomendamos a ordem sequencial. Se forem especificados fora de ordem, o MPS os organizará automaticamente.

FrameType

String

Não

O tipo de snapshot. Valores válidos:

• Valor padrão: intra.

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

• intra (padrão): keyframes. Os keyframes possuem boa qualidade de imagem e captura rápida, pois são decodificados independentemente. Porém, aparecem em intervalos no vídeo e não permitem captura em momentos exatos. Se o momento especificado não for preciso, o sistema captura o keyframe mais próximo. Se a distância entre dois keyframes for maior que o intervalo de captura, o número 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:

  • Se nenhuma largura ou altura for especificada, a largura do vídeo de entrada é utilizada.

  • Se apenas a altura for especificada, a largura é 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:

  • Se nenhuma largura ou altura for especificada, a altura do vídeo de entrada é utilizada.

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

BlackLevel

String

Não

O limite superior de pixels pretos em um snapshot. Se os pixels pretos excederem esse valor, o sistema considera a imagem como tela preta. Para mais detalhes sobre pixels pretos, veja 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 melhorar a filtragem de telas pretas, especifique um valor mais alto. Recomenda-se iniciar com 30 e ajustar conforme a necessidade do negócio.

• 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 fica vazio e o arquivo de saída é gerado 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 Format for definido como vtt.

TileOut

Object

Não

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

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

• Se deixado vazio, nenhum sprite de imagem será gerado.

OutputFile

Object

Sim

Os snapshots originais. É necessário especificar o caminho de armazenamento dos objetos no OSS. Para mais informações, consulte a seção OutputFile deste tópico.

• Os arquivos de snapshot estão no formato JPG.

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

TileOutputFile

Object

Não

O sprite de imagem de saída. É necessário especificar o caminho de armazenamento do objeto no OSS. O valor segue o mesmo formato do parâmetro OutputFile.

• Este parâmetro é obrigatório ao usar TileOut para gerar um sprite de imagem.

• O sprite de imagem está no 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 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

A largura de um único snapshot antes da formação do mosaico.

• Unidade: pixel.

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

CellHeight

String

Não

A altura de um único snapshot antes da formação do mosaico.

• Unidade: pixel.

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

Padding

String

Não

A distância entre dois snapshots.

• Unidade: pixel.

• Valor padrão: 0.

Margin

String

Não

A largura da margem do snapshot em mosaico.

• 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 imagens.

• Aceita palavras-chave de cores ou valores aleatórios. Para fundo preto, use formatos como Black, black ou #000000.

• Valor padrão: black.

IsKeepCellPic

String

Não

Define se os snapshots originais devem ser armazenados. Valores válidos:

• true: armazena os snapshots originais. OutputFile define as informações de armazenamento.

• false: não armazena os snapshots originais.

• Valor padrão: false.

Parâmetro

Tipo

Obrigatório

Descrição

Bucket

String

Sim

O bucket do OSS onde os snapshots originais são armazenados.

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

Location

String

Sim

A região onde o bucket do OSS reside.

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

• Para mais informações sobre o termo região, consulte Termos.

Object

String

Sim

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

• O caminho inclui o nome do arquivo e sua extensão. Para mais informações sobre chave de objeto, consulte Termos.

• Placeholders são suportados. Para mais informações, consulte a seção Regras de substituição de placeholders deste tópico.

• O arquivo de saída deve estar no formato JPG.

• O caminho de um objeto OSS deve ter codificação URL em UTF-8 antes de ser usado no MPS. Para mais informações, consulte Codificação URL.

Parâmetro

Tipo

Obrigatório

Descrição

QueueName

String

Não

A fila SMQ para recebimento de notificações. Após a conclusão do job na fila MPS, os resultados são enviados para esta fila SMQ. Para mais informações, consulte Receber notificações.

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

• É necessário especificar uma fila SMQ. Se não existir, crie uma no console SMQ.

Topic

String

Não

O tópico SMQ para recebimento de notificações. Após a conclusão do job, os resultados são enviados ao tópico SMQ, que distribui a mensagem para filas ou URLs assinantes. Para mais informações, consulte Receber notificações.

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

• É necessário especificar um tópico SMQ. Se não existir, crie um no console SMQ.

Parâmetro

Tipo

Obrigatório

Descrição

Bucket

String

Sim

O bucket do OSS que armazena o arquivo de entrada.

• Conceda permissões de leitura no bucket do OSS ao MPS na página Controle de Permissões do console OSS.

• Para mais informações sobre o termo bucket, consulte Glossário.

Location

String

Sim

A região onde o bucket do OSS reside.

Para mais informações sobre o termo região, consulte Glossário.

Object

String

Sim

O objeto OSS usado como arquivo de entrada.

• O caminho do objeto OSS deve seguir a RFC 2396 e ter codificação URL em UTF-8. Para mais informações, consulte Codificação URL.

• Para mais informações sobre o termo objeto, consulte Glossário.

Audio

String

Não

A 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

A configuração de container 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

O 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

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

Samplerate

String

Sim

A 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

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

PropertiesControl

String

Não

A 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

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

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 se o desentrelaçamento deve ser executado forçosamente. Valores válidos:

• Auto: executa o desentrelaçamento automaticamente.

• Force: força a execução do desentrelaçamento.

• None: proíbe o desentrelaçamento.

Crop

String

Não

A configuração de recorte da imagem de vídeo.

• Por padrão, o recorte automático é realizado.

• Se este parâmetro não for um objeto JSON vazio, o parâmetro Mode é 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 Crop não for um objeto JSON vazio. Valores válidos:

• Auto: realiza o recorte automaticamente.

• Force: força a execução do recorte.

• None: proíbe o recorte.

Width

Integer

Não

A largura da imagem de vídeo após o recorte das margens.

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

• Se Mode for Auto ou None, a configuração deste parâmetro é inválida.

Height

Integer

Não

A altura da imagem de vídeo após o recorte das margens.

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

• Se Mode for Auto ou None, a configuração deste parâmetro é inválida.

Top

Integer

Não

A margem superior a ser recortada.

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

• Se Mode for Auto ou None, a configuração deste parâmetro é inválida.

Left

Integer

Não

A margem esquerda a ser recortada.

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

• Se Mode for Auto ou None, a configuração deste parâmetro é inválida.

Parâmetro

Tipo

Obrigatório

Descrição

MergeList

String

Não

As URLs dos clipes a serem mesclados.

• 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

O caminho OSS do arquivo de saída.

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

• Se este parâmetro não for especificado, os parâmetros Bucket, Location e Object tornam-se obrigatórios.

Bucket

String

Não

• O bucket do OSS que armazena o arquivo de saída. Obrigatório se URL não for especificado.

• Caso contrário, a configuração é inválida. Antes de especificar um bucket, conceda permissões de escrita ao MPS na página Controle de Acesso do console OSS.

• Para mais informações sobre o termo bucket, consulte Glossário.

Location

String

Não

• A região do bucket OSS que armazena o arquivo de saída. Obrigatório se URL não for especificado.

• Caso contrário, a configuração é inválida.

• Para mais informações sobre o termo região, consulte Glossário.

Object

String

Não

• O nome do objeto OSS a ser usado como arquivo de saída. Obrigatório se URL não for especificado.

• Caso contrário, a configuração é inválida. O valor deve seguir a RFC 2396 e ter codificação URL em UTF-8. Para mais informações, consulte Codificação URL.

• Para mais informações sobre o termo objeto, consulte Glossário.

Parâmetro

Tipo

Obrigatório

Descrição

URI

String

Não

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

O nome da atividade associada.

ExtXStreamInfo

Json

Sim

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

Parâmetro

Tipo

Obrigatório

Descrição

Name

String

Sim

O nome do recurso. Pode ter até 64 bytes e deve estar codificado em UTF-8. Corresponde a NAME no protocolo HTTP Live Streaming (HLS) V5.

Language

String

Não

O idioma do recurso, devendo seguir a RFC 5646. Corresponde a LANGUAGE no protocolo HLS V5.

URI

String

Sim

O 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

O 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

A largura de banda. Especifica o limite superior da taxa de bits total e corresponde a BANDWIDTH no protocolo HLS V5.

Audio

String

Não

O ID do grupo de streams de áudio. Corresponde a AUDIO no protocolo HLS V5.

Subtitles

String

Não

O ID do grupo de streams de legendas. Corresponde a SUBTITLES no protocolo HLS V5.

Parâmetro

Tipo

Obrigatório

Descrição

Group

String

Sim

O 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

O idioma do recurso. Pode ser especificado para recursos de áudio e legenda.

Parâmetro

Tipo

Obrigatório

Descrição

Id

String

Sim

O ID do stream. Exemplo:

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

URI

String

Sim

O 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

O 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"}