Transformações e trabalhos nos Serviços de Mídia

  • Artigo

Logotipo dos Serviços de Mídia v3

Aviso

Os Serviços de Mídia do Azure serão desativados em 30 de junho de 2024. Para obter mais informações, consulte o Guia de Desativação do AMS.

Dica

Quer gerar miniaturas, costurar dois vídeos, gerar clipes de um vídeo ou girá-lo (entre outras coisas)? Você pode encontrar código de exemplo dos Serviços de Mídia na página de Exemplos.

Este tópico fornece detalhes sobre transformações e trabalhos e explica a relação entre essas entidades.

Fluxo de trabalho típico

Uma Transformação é como uma receita. Ela ajuda você a criar uma vez a receita (Etapa 1) e enviar trabalhos usando essa receita (Etapa 2).

  1. Criar uma transformação.
  2. Enviar trabalhos sob essa transformação.
  3. Listar transformações.
  4. Excluir uma transformação, se você não planeja usá-la no futuro.

Exemplo

Suponha que você deseja extrair o primeiro quadro de todos os seus vídeos como uma miniatura. Estas são as etapas necessárias:

  1. Defina a receita ou a regra para processar seus vídeos: "usar o primeiro quadro do vídeo como a miniatura".
  2. Para cada vídeo. você deve informar ao serviço:
    1. Onde encontrar esse vídeo.
    2. Onde gravar a saída a imagem em miniatura de saída.

Observação

As propriedades de transformação e trabalho do tipo Datetime estão sempre em formato UTC.

Transformações

Use Transformações para configurar tarefas comuns para codificar ou analisar vídeos. Cada transformação descreve uma receita ou um fluxo de trabalho de tarefas para processar os arquivos de áudio ou vídeos. Uma única transformação pode aplicar mais de uma regra. Por exemplo, uma transformação poderia especificar que cada vídeo seja codificado em um arquivo MP4 em uma determinada taxa de bits, e que uma imagem em miniatura gerada desde o primeiro quadro do vídeo. Você precisaria adicionar uma entrada de TransformOutput para cada regra que você deseja incluir em sua Transformação. Você usa predefinições para informar à transformação como os arquivos de mídia de entrada devem ser processados.

Exibição do esquema

Nos Serviços de Mídia v3, as predefinições são entidades fortemente tipadas na própria API. Você pode encontrar a definição do "esquema" para esses objetos em Especificação de Open API (ou Swagger). Você também pode ver as definições predefinidas (como StandardEncoderPreset) na API REST, no SDK do .NET ou em outra documentação de referência do SDK dos Serviços de Mídia v3.

Criação de transformações

Você pode criar transformações usando o REST, a CLI ou qualquer um dos SDKs publicados. A API é controlada pelo Azure Resource Manager v3, portanto, você também pode usar modelos do Azure Resource Manager para criar Transformações na sua conta dos Serviços de Mídia do Microsoft Azure. O controle de acesso baseado em função do Azure pode ser usado para bloquear o acesso a transformações.

Atualização de transformações

Se você precisar atualizar sua transformação, use a operação de Atualização. Ela serve para fazer alterações na descrição ou nas prioridades do TransformOutputs subjacente. Você deve concluir as atualizações quando todos os trabalhos em andamento tiverem terminado. Se você pretende reescrever a receita, é preciso criar uma transformação.

Trabalhos

O trabalho é a solicitação real aos Serviços de Mídia para que eles apliquem a transformação a determinado conteúdo de áudio ou vídeo de entrada. Quando a Transformação for criada, você poderá enviar trabalhos usando as APIs dos Serviços de Mídia ou um dos SDKs publicados. O Trabalho especifica informações como a localização do vídeo de entrada e a localização da saída. Você pode especificar a localização de sua entrada usando vídeo: URLs HTTPs, URLs de SAS ou Ativos.

Entrada de trabalho do HTTPS

Use uma entrada de trabalho do HTTPS se o seu conteúdo já estiver acessível por meio de uma URL e você não precisar armazenar o arquivo de origem no Azure (por exemplo, importar do S3). Esse método também é adequado se você tiver o conteúdo no Armazenamento de Blobs do Azure, mas não precisar que o arquivo esteja em um ativo. No momento, esse método dá suporte apenas a um arquivo para entrada.

Ativo como entrada de trabalho

Use um ativo como entrada de trabalho se o conteúdo de entrada já estiver em um ativo ou se o conteúdo estiver armazenado no arquivo local. Também é uma boa opção se você planeja publicar o ativo de entrada para streaming ou download (digamos que você deseja publicar o mp4 para download, mas também deseja fazer a conversão de fala em texto ou detecção facial). Esse método dá suporte a ativos de vários arquivos (por exemplo, conjuntos de streaming MBR que foram codificados localmente).

Verificação do progresso do trabalho

O progresso e o estado de trabalhos podem ser obtidos pelo monitoramento de eventos com a Grade de Eventos do Azure. Para obter mais informações, consulte Monitorar eventos usando EventGrid.

Atualização de trabalhos

A operação de atualização na entidade Trabalho pode ser usada para modificar as propriedades description e priority depois que o trabalho é enviado. Uma alteração na propriedade priority só será eficaz se o trabalho ainda estiver na fila. Se o trabalho tiver iniciado o processamento ou tiver sido concluído, a alteração da prioridade não terá qualquer efeito.

Exemplos de codificação

Consulte a extensa lista de Exemplos de Codificação para obter uma codificação.

Obter ajuda e suporte

Você pode entrar em contato com os Serviços de Mídia com perguntas ou seguir nossas atualizações por um dos seguintes métodos: