O ApsaraVideo Media Processing (MPS) oferece três modos de acionamento de workflows, cada um com requisitos distintos para caminhos de entrada e automação.
Comparação dos modos de acionamento
|
Modo de acionamento |
Cenário |
|
Acionamento automático |
Processamento imediato de um arquivo pelo workflow predefinido após o upload para o caminho especificado. |
|
Acionamento manual para arquivos em um caminho verificado |
|
|
Acionamento manual para arquivos em caminhos diferentes |
Processamento de arquivos armazenados em caminhos distintos pelo mesmo workflow. |
Modo 1: Acionamento automático
Crie um workflow e defina o modo de acionamento como automático. Por padrão, novos workflows usam o modo de acionamento automático. Para mais informações sobre como criar um workflow, consulte Create a workflow.
-
Adicione um arquivo que atenda aos seguintes requisitos:
Não foi gerado pelo MPS nem pelo Intelligent Media Services (IMS). Para mais informações, consulte a seção "Arquivos não gerados pelo MPS ou IMS" deste tópico.
O caminho está em conformidade com as regras de correspondência de caminho. Para mais informações, consulte a seção "Regras de correspondência de caminho" deste tópico.
O nome obedece às regras de correspondência de extensão de nome de arquivo. Para mais detalhes, consulte a seção "Regras de correspondência de extensão de nome de arquivo" deste tópico.
-
O upload ocorreu por meio de uma das seguintes operações de API do OSS:
Operação
Descrição
PutObject
Faz upload de um objeto.
PostObject
Faz upload de um objeto para um bucket específico usando um formulário HTML.
CopyObject
Copia um objeto dentro de um bucket ou entre buckets na mesma região.
CompleteMultipartUpload
Combina as partes enviadas em um único objeto após o upload de todas as partes.
PutSymlink
Cria um link simbólico para um objeto, permitindo o acesso ao objeto por meio desse link.
Modo 2: Acionamento manual para arquivos em um caminho verificado
Crie um workflow. Antes de adicionar arquivos, altere o modo de acionamento para manual chamando a operação UpdateMediaWorkflowTriggerMode. Para mais informações sobre como criar um workflow, consulte Create a workflow.
-
Adicione um arquivo que atenda aos seguintes requisitos:
O caminho está em conformidade com as regras de correspondência de caminho. Para mais informações, consulte a seção "Regras de correspondência de caminho" deste tópico.
O nome obedece às regras de correspondência de extensão de nome de arquivo. Para mais detalhes, consulte a seção "Regras de correspondência de extensão de nome de arquivo" deste tópico.
O upload ocorreu por meio de qualquer operação de API do OSS.
Após adicionar o arquivo, chame a operação AddMedia para especificar o arquivo a ser processado e o ID do workflow a ser acionado, conforme suas necessidades de negócio.
Modo 3: Acionamento manual para arquivos em caminhos diferentes
Crie um workflow. Antes de adicionar arquivos, altere o modo de acionamento para manual chamando a operação UpdateMediaWorkflowTriggerMode. Para mais informações sobre como criar um workflow, consulte Create a workflow.
-
Adicione um arquivo que atenda aos seguintes requisitos:
Está armazenado na região onde o MPS está ativado.
O upload ocorreu por meio de qualquer operação de API do OSS.
Após adicionar o arquivo, chame a operação AddMedia para especificar o arquivo a ser processado e o ID do workflow a ser acionado, conforme suas necessidades de negócio. Além disso, defina o parâmetro InputUnbind como false para que o MPS não verifique o arquivo em relação às regras de correspondência de caminho ou às regras de correspondência de extensão de nome de arquivo.
Regras de correspondência de arquivos
Arquivos não gerados pelo MPS ou IMS
Se o caminho de entrada de um workflow for igual ao caminho de saída de um job do MPS ou IMS, os arquivos gerados por esse job não poderão acionar o workflow. Isso evita acionamentos cíclicos causados pela sobreposição de caminhos de entrada e saída. Exemplo:
O caminho de saída do Workflow A e o caminho de entrada do Workflow B são ambos http://bucket.oss-cn-hangzhou.aliyuncs.com/A/.
Se o arquivo de entrada http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv for gerado pelo Workflow A, o Workflow B não será acionado.
Se o arquivo de entrada http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv for enviado diretamente para o caminho http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, o Workflow B poderá ser acionado.
Regras de correspondência de caminho
Um arquivo de entrada só aciona um workflow se seu caminho estiver contido no caminho de entrada especificado para o nó Input do workflow. Exemplo:
Não configure o caminho de entrada de um workflow como prefixo do caminho de entrada de outro. Caso contrário, ambos serão acionados quando um arquivo for enviado para o segundo caminho. Por exemplo, se o caminho de entrada do Workflow A for test e o do Workflow B for test1, o upload de um arquivo na pasta test1 acionará ambos os workflows.
Se o caminho de entrada especificado para o nó Input de um workflow terminar com uma barra (/), como http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, a tabela a seguir mostra os resultados de correspondência para diferentes arquivos de entrada.
|
Caminho do arquivo de entrada |
Correspondência |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv |
Sim |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/example.flv |
Sim |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/example.flv |
Sim |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A1/example.flv |
Não |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A_video01.mp4 |
Não |
|
http://bucket.oss-cn-beijing.aliyuncs.com/A/example.flv |
Não |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/example.flv |
Não |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/D/example.flv |
Não |
Se o caminho de entrada especificado para o nó Input de um workflow não terminar com uma barra (/), como http://bucket.oss-cn-hangzhou.aliyuncs.com/A, a tabela a seguir mostra os resultados de correspondência para diferentes arquivos de entrada.
|
Caminho do arquivo de entrada |
Correspondência |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/example.flv |
Sim |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/example.flv |
Sim |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/example.flv |
Sim |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A1/example.flv |
Sim |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/A_video01.mp4 |
Sim |
|
http://bucket.oss-cn-beijing.aliyuncs.com/A/example.flv |
Não |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/example.flv |
Não |
|
http://bucket.oss-cn-hangzhou.aliyuncs.com/D/example.flv |
Não |
Regras de correspondência de extensão de nome de arquivo
A tabela a seguir lista as extensões de nome de arquivo compatíveis. Um arquivo de entrada só aciona um workflow se sua extensão estiver nesta tabela. Exemplo:
O arquivo de entrada é http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv. A extensão do nome do arquivo é .flv, que está em conformidade com as regras de correspondência.
A verificação baseia-se na última extensão do nome do arquivo. Por exemplo, se o arquivo de entrada for http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv.mp4, a extensão considerada será .mp4, obedecendo às regras de correspondência.
|
Tipo |
Extensão de nome de arquivo |
|
Arquivo de vídeo |
.3gp, .asf, .avi, .dat, .dv, .flv, .f4v, .gif, .m2t, .m3u8, .m4v, .mj2, .mjpeg, .mkv, .mov, .mp4, .mpe, .mpg, .mpeg, .mts, ogg, .qt, .rm, .rmvb, .swf, .vob, .wmv, .webm, .mxf e .quicktime |
|
Arquivo de áudio |
.s48, .aac, .ac3, .acm, .amr, .ape, .caf, .flac, .m4a, .mp3, .ra, .wav, .wma e .aiff |