ApsaraVideo Media Processing:Atividades de fluxo de trabalho

Nome da atividade

Tipo de atividade na topologia

Descrição

Input

Start

Obrigatório. Configure o caminho de entrada do Object Storage Service (OSS) e as definições globais, incluindo a fila do ApsaraVideo Media Processing (MPS) e as notificações de mensagens.

Publish

Report

Obrigatório. Defina o modo de publicação. Há dois modos compatíveis: Auto e Manual.

Analyze

Analysis

Analisa inteligentemente os arquivos de mídia de entrada e recomenda modelos predefinidos adequados.

Encode

Transcode

Transcodifica os arquivos de mídia de entrada para diferentes formatos, garantindo a reprodução em diversas plataformas.

Snapshot

Screenshot

Captura snapshots de vídeos em momentos específicos. Use um snapshot como miniatura do vídeo ou utilize vários para gerar um sprite.

Pack

PackageConfig

Empacota arquivos de vídeo com múltiplas resoluções, faixas de áudio e legendas para gerar arquivos M3U8.

Video Group

VideoGroup

Audio Group

AudioGroup

Subtitle Group

SubtitleGroup

Extract Video

Extract Audio

Extract Subtitle

Transcode

Generate

GenerateMasterPlayList

Content Moderation

Censor

Detecta conteúdo pornográfico, terrorista e indesejado em falas, textos e cenas de vídeo. Essa funcionalidade reduz custos com revisão manual e diminui os riscos associados a conteúdo não compatível.

Video DNA

FpShot

Identifica exclusivamente um vídeo. Permite extrair e comparar impressões digitais de imagens e áudio para localizar vídeos duplicados, rastrear a origem de clipes e identificar plágio.

Intelligent Thumbnail

Cover

Seleciona o melhor quadro-chave ou clipe do vídeo para usar como miniatura, melhorando a taxa de conversão de cliques e a experiência do usuário. A seleção utiliza algoritmos baseados na compreensão do conteúdo do vídeo, na estética da imagem e em grandes volumes de dados de comportamento do usuário.

Parâmetro

Tipo

Obrigatório

Descrição

InputFile

String

Sim

Arquivo de entrada. Use os parâmetros Bucket, Location e Object para especificar o local do arquivo.

• Para mais informações sobre as regras de acionamento de fluxo de trabalho, consulte Regras de acionamento de fluxo de trabalho para arquivos.

• O arquivo deve estar armazenado exclusivamente no OSS. Para obter detalhes sobre o parâmetro InputFile, consulte Detalhes dos parâmetros.

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

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

PipelineId

String

Sim

ID da fila do MPS (definição global).

• Este ID de fila do MPS aplica-se apenas às atividades Analyze, Encode, Snapshot e Pack. Para tarefas de IA, configure separadamente o ID da fila do MPS para cada atividade.

• Em um fluxo de trabalho de mídia, as configurações de mensagem de uma fila específica do MPS são inválidas. Em vez disso, use a configuração do parâmetro QueueName ou TopicName do fluxo de trabalho.

MessageType

String

Não

Tipo da mensagem (definição global). Valores válidos:

• Queue: Fila do Simple Message Queue (anteriormente MNS). Se você definir este parâmetro como Queue, especifique o parâmetro QueueName.

• Topic: Tópico do SMQ. Se você definir este parâmetro como Topic, especifique o parâmetro TopicName.

• Valor padrão: Queue.

QueueName

String

Não

Fila do SMQ associada à fila do MPS (definição global). Após a conclusão de uma tarefa na fila do MPS, os resultados são enviados para a fila do SMQ. Para mais informações sobre notificações de mensagens, consulte Receber notificações.

• Especifique uma das filas do SMQ já criadas. Se nenhuma fila do SMQ estiver disponível, crie uma no SMQ console.

TopicName

String

Não

Tópico do SMQ associado à fila do MPS (definição global). Quando uma tarefa é concluída na fila do MPS, os resultados são enviados para o tópico do SMQ. O tópico associado envia uma mensagem com os resultados para a URL inscrita nele. Para mais informações, consulte Receber notificações.

• Especifique um dos tópicos do SMQ já criados. Se nenhum tópico do SMQ estiver disponível, crie um no SMQ console.

RoleName

String

Não

Nome da função do Resource Access Management (RAM) (definição global).

• Valor padrão: AliyunMTSDefaultRole.

Parâmetro

Tipo

Obrigatório

Descrição

PublishType

String

Não

Modo de publicação do arquivo de mídia (definição global). Valores válidos:

• Manual: publica o arquivo de mídia manualmente. Após a execução do fluxo de trabalho, o arquivo permanece não publicado. Publique-o manualmente conforme necessário. Para mais informações, consulte Gerenciar arquivos de mídia.

• Auto: publica automaticamente o arquivo de mídia após a conclusão de todas as atividades. A publicação ocorre automaticamente ao final do fluxo de trabalho.

• TranscodeCompletedAuto: publica automaticamente o arquivo de mídia após a conclusão de uma atividade Transcode. As configurações de mensagem da atividade Input notificam a conclusão da transcodificação. Se o sistema ignorar a atividade Transcode, nenhuma mensagem será enviada.

• Valor padrão: Manual.

  Nota

  • O MPS processa arquivos de mídia em um fluxo de trabalho e usa o Security Token Service (STS) para conceder permissões aos usuários do RAM. Isso permite configurar a forma de publicação dos arquivos de mídia.

  • O estado de publicação afeta as permissões de acesso ao arquivo de saída.

    • Se os arquivos de saída de vídeo, áudio e snapshot não forem publicados, as permissões de acesso serão privadas.

    • Se os arquivos de saída de vídeo, áudio e snapshot forem publicados, as permissões de acesso seguirão as permissões do bucket do OSS onde estão armazenados.

Parâmetro

Tipo

Obrigatório

Descrição

KeepOnlyHighestDefinition

String

Não

Defina se apenas os resultados de análise para vídeos na definição mais alta devem ser mantidos. Valores válidos:

• True: mantém apenas o vídeo de saída na definição mais alta.

• False: gera os vídeos de saída em todas as definições.

• Valor padrão: False.

Parâmetro

Tipo

Obrigatório

Descrição

Outputs

String

Não

Saídas das tarefas de transcodificação.

• Especifique o valor em um array JSON de objetos Output. É possível definir até 30 objetos Output.

• Para mais informações sobre os parâmetros em cada objeto Output, consulte Detalhes dos parâmetros.

• Exemplo: [{"OutputObject":"transcode%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D","TemplateId": "S00000001-000070"}].

OutputBucket

String

Não

Nome do bucket de saída.

• Durante o empacotamento HTTP Live Streaming (HLS) e Dynamic Adaptive Streaming over HTTP (DASH), o parâmetro Bucket na atividade Pack tem precedência sobre o parâmetro OutputBucket.

OutputLocation

String

Não

Região do bucket de saída.

• Durante o empacotamento HLS e DASH, o parâmetro Location na atividade Pack tem precedência sobre o parâmetro OutputLocation.

MultiBitrateVideoStream

String

Não

Parâmetro necessário para extrair fluxos de vídeo durante o empacotamento HLS.

• Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: {"URI": "c/d/video1.m3u8"}.

ExtXMedia

String

Não

Parâmetro necessário para extrair fluxos de áudio ou legendas durante o empacotamento HLS.

• Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: {"Name": "english","Language": "en-US","URI":"c/d/audio-1.m3u8"}.

WebVTTSubtitleURL

String

Não

URL da legenda. Parâmetro necessário para extrair fluxos de legendas durante o empacotamento HLS.

• Somente arquivos de legenda Web Video Text Tracks (WebVTT) são compatíveis. A URL da legenda deve cumprir o padrão de URL e pode ser sobrescrita ao chamar a operação AddMedia.

• Exemplo: http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/subtitles**-en.vtt.

Representation

String

Não

Parâmetro necessário para extrair fluxos de vídeo, áudio ou legendas durante o empacotamento DASH.

• Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: {\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}.

InputConfig

String

Não

URL da legenda. Parâmetro necessário para extrair fluxos de legendas durante o empacotamento DASH.

• Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: "{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://example-Bucket-**.oss-cn-hangzhou.aliyuncs.com/subtitle/subtitle**-en.vtt\"}}".

Parâmetro

Tipo

Obrigatório

Descrição

SnapshotConfig

String

Sim

Configurações de snapshot.

• Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: {"OutputFile": {"Bucket": "example-001", "Location": "oss-cn-hangzhou", "Object":"snapshot%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D%2F1.jpg"},"Time": "5"}.

MediaCover

String

Não

Defina se o snapshot será usado como miniatura da mídia. Este parâmetro é válido apenas para um único snapshot. Valores válidos:

• true

• false

• Valor padrão: false.

Parâmetro

Tipo

Obrigatório

Descrição

Output

String

Sim

Informações detalhadas sobre o arquivo de saída, formatadas como uma string JSON. Exemplo: {"Bucket":"output","Location":"oss-cn-hangzhou","MasterPlayListName":"a/b/c.m3u8"}.

Protocol

String

Sim

Protocolo utilizado para empacotamento. Valores válidos: hls e dash.

Parâmetro

Tipo

Obrigatório

Descrição

AdaptationSet

String

Não

Informações sobre o grupo de vídeo. Parâmetro necessário para empacotamento DASH.

• Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: "AdaptationSet":"{\"Group\":\"VideoGroup\"}".

Parâmetro

Tipo

Obrigatório

Descrição

GroupId

String

Não

ID do grupo de áudio. Parâmetro necessário para empacotamento HLS.

• O ID pode ter até 32 bytes de comprimento.

AdaptationSet

String

Não

Informações sobre o grupo de áudio. Parâmetro necessário para empacotamento DASH.

• Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: "{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}".

Parâmetro

Tipo

Obrigatório

Descrição

GroupId

String

Não

ID do grupo de legendas. Parâmetro necessário para empacotamento HLS.

• O ID pode ter até 32 bytes de comprimento.

AdaptationSet

String

Não

Informações sobre o grupo de legendas. Parâmetro necessário para empacotamento DASH.

• Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: "{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}".

Parâmetro

Tipo

Obrigatório

Descrição

MasterPlayList

String

Não

• Fluxos de vídeo com múltiplas taxas de bits. Parâmetro exclusivo e obrigatório para empacotamento HLS. Para mais informações, consulte Detalhes dos parâmetros.

• Exemplo: {"MultiBitrateVideoStreams": [{"RefActivityName": "video-1","ExtXStreamInf": {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}}]}.