ApsaraVideo Media Processing:Atividades de fluxo de trabalho

Nome da atividade

Tipo de atividade na topologia

Descrição

Input

Start

Defina a configuração global, incluindo filas do MPS, mensagens e o caminho de entrada do OSS para o fluxo de trabalho de mídia.

Publish (obrigatório)

Report

Define o modo de publicação como manual ou automático.

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 vários snapshots para gerar um sprite.

Configuração de empacotamento

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 riscos associados a conteúdo não conforme.

Video DNA

FpShot

Identifica um vídeo de forma única por meio da extração e comparação de fingerprints de imagens e áudio. Permite localizar vídeos duplicados, rastrear a origem de clipes e identificar plágio.

Intelligent Thumbnail

Cover

Seleciona o melhor keyframe ou clipe do vídeo como miniatura para melhorar 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, estética da imagem e grandes volumes de dados de comportamento do usuário.

Nome

Tipo

Obrigatório

Descrição

InputFile

String

Sim

Arquivo de entrada. Utilize 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 Workflow triggering rules for files.

• O arquivo deve estar armazenado no OSS. Para detalhes sobre o parâmetro InputFile, consulte Parameter details.

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

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

PipelineId

String

Sim

ID da fila de configuraçã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. Utilize a configuração do parâmetro QueueName ou TopicName do fluxo de trabalho de mídia.

MessageType

String

Não

Configuração global: Categoria da mensagem

• Queue: Fila do Simple Message Queue (antigo MNS). Ao definir este parâmetro como Queue, especifique o parâmetro QueueName.

• Topic: Tópico do MNS. Defina como TopicName.

• Valor padrão: Queue.

QueueName

String

Não

A configuração global especifica a fila do MNS a ser associada a um pipeline do ApsaraVideo Media Processing. Após a associação, os resultados das tarefas concluídas no pipeline são enviados para esta fila. Para mais informações sobre mensagens, consulte Receive message notifications.

• Valores válidos: uma fila do MNS criada por você. Caso não haja nenhuma fila disponível, acesse o console do Simple Message Queue (formerly MNS) para criar uma.

TopicName

String

Não

Tópico do SMQ a ser associado à fila do MPS, definido como configuração global. Após a conclusão de uma tarefa 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 que assina o tópico do SMQ. Para mais informações, consulte Receive notifications.

• Valores válidos: um tópico do MNS criado por você. Caso não haja nenhum tópico disponível, acesse o console do Simple Message Queue (formerly MNS) para criar um.

RoleName

String

Não

Nome da função do Resource Access Management (RAM), definido como configuração global.

• Valor padrão: AliyunMTSDefaultRole.

Nome

Tipo

Obrigatório

Descrição

PublishType

String

Não

Configuração global para o tipo de publicação da mídia.

• Manual: publica o arquivo de mídia manualmente. O arquivo permanece não publicado após a execução do fluxo de trabalho. Publique-o manualmente quando necessário. Para mais informações, consulte Manage media files.

• 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

  • Quando o ApsaraVideo Media Processing executa um fluxo de trabalho para processar arquivos, ele utiliza um usuário temporário do Security Token Service (STS) para modificar os arquivos de saída conforme o tipo de publicação.

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

    • Não publicado: Arquivos de vídeo, áudio e captura de tela possuem permissões de acesso privadas.

    • Publicado: Arquivos de vídeo, áudio e captura de tela herdam as permissões de acesso do Bucket que os contém.

Nome

Tipo

Obrigatório

Descrição

KeepOnlyHighestDefinition

String

Não

Especifique se apenas os resultados de análise de maior definição devem ser mantidos.

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

Nome

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 de cada objeto Output, consulte Parameter details.

• 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 da atividade Pack tem precedência sobre o parâmetro OutputBucket.

OutputLocation

String

Não

Especifique a região de saída.

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

MultiBitrateVideoStream

String

Não

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

• Para mais informações, consulte Parameter details.

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

ExtXMedia

String

Não

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

• Para mais informações, consulte Parameter details.

• 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 streams de legenda durante o empacotamento HLS.

• Apenas arquivos de legenda Web Video Text Tracks (WebVTT) são suportados. A URL da legenda deve seguir o padrão 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 streams de vídeo, áudio ou legenda durante o empacotamento DASH.

• Para mais informações, consulte Parameter details.

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

InputConfig

String

Não

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

• Para mais informações, consulte Parameter details.

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

Nome

Tipo

Obrigatório

Descrição

SnapshotConfig

String

Sim

Configurações do snapshot.

• Para mais informações, consulte Parameter details.

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

• false: Não

• Valor padrão: false.

Nome

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.

Nome

Tipo

Obrigatório

Descrição

AdaptationSet

String

Não

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

• Para mais informações, consulte Parameter details.

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

Nome

Tipo

Obrigatório

Descrição

GroupId

String

Não

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

• O comprimento máximo é de 32 bytes.

AdaptationSet

String

Não

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

• Para mais informações, consulte Parameter details.

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

Nome

Tipo

Obrigatório

Descrição

GroupId

String

Não

ID do grupo de legendas. Parâmetro obrigatório para empacotamento HLS.

• O comprimento máximo é de 32 bytes.

AdaptationSet

String

Não

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

• Para mais informações, consulte Parameter details.

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

Nome

Tipo

Obrigatório

Descrição

MasterPlayList

String

Não

• Streams de vídeo com múltiplas taxas de bits. Parâmetro exclusivo e obrigatório para empacotamento HLS. Para mais informações, consulte Parameter details.

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