Partilhar via

Usar com um conector do Logic Apps

A API REST do Azure AI Video Indexer (VI) dá suporte à comunicação de servidor para servidor e cliente para servidor. A API permite que você integre insights de vídeo e áudio na lógica do aplicativo.

Suportamos Aplicações Lógicas e conectores Power Automate que são compatíveis com a API do Azure AI Video Indexer.

Você pode usar os conectores para configurar fluxos de trabalho personalizados para indexar e extrair insights de forma eficaz de uma grande quantidade de arquivos de vídeo e áudio, sem escrever uma única linha de código. Utilizar os conectores para a integração proporciona visibilidade sobre o estado do seu fluxo de trabalho e oferece uma maneira de o depurar.

Introdução

O exemplo neste artigo configura fluxos das Aplicações Logic. Os recursos do Logic App e do Power Automate e seus editores são quase idênticos.

A abordagem de dois fluxos, dois fluxos que trabalham juntos, suportam o upload assíncrono e a indexação de arquivos maiores de forma eficaz.

  • O primeiro fluxo é acionado quando um blob é adicionado ou modificado em uma conta de Armazenamento do Azure. Carrega o novo ficheiro para o Azure AI Video Indexer e utiliza uma URL de retorno de chamada para enviar uma notificação quando a operação de indexação estiver concluída.
  • O segundo fluxo é acionado com base na URL de retorno de chamada e salva as informações extraídas de volta em um arquivo JSON no Armazenamento do Azure.

Os aplicativos lógicos criados neste artigo contêm um fluxo por aplicativo. A segunda seção, Criar uma nova aplicação lógica de tipo consumo, explica como conectar os dois. O segundo fluxo fica sozinho e é acionado pelo primeiro.

Quando um arquivo é carregado e indexado a partir do primeiro fluxo, ele envia uma solicitação HTTP com a URL de retorno de chamada correta para acionar o segundo fluxo. Em seguida, recupera as informações geradas pelo Azure AI Video Indexer. Neste exemplo, ele armazena a saída do seu trabalho de indexação no Armazenamento do Azure. No entanto, cabe-lhe decidir o que fazer com o resultado.

Pré-requisitos

  • Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
  • Crie uma conta do Azure AI Video Indexer baseada no Azure Resource Manager.
  • Criar uma conta de Armazenamento do Azure. As contas de armazenamento para VI devem ser uma conta de armazenamento v2 de uso geral padrão. Anote a chave de acesso da sua conta de armazenamento.
    • Crie dois contêineres: um para armazenar os arquivos de mídia, o segundo para armazenar as informações geradas pelo Azure AI Video Indexer. Neste artigo, os contêineres são videos e insights.

Gerar um token de acesso

  1. Gere um token de acesso usando o generateAccessToken. Pressione Experimentar para obter os valores corretos para sua conta.
  2. Copie e cole-o no Bloco de Notas para uma etapa posterior.

Fluxo #1: Configurar o fluxo de upload de arquivos

Esta seção descreve como configurar o primeiro fluxo de upload de arquivos. O primeiro fluxo é acionado quando um blob é adicionado ou modificado em uma conta de Armazenamento do Azure. Carrega o novo ficheiro para o Azure AI Video Indexer e utiliza uma URL de retorno de chamada para enviar uma notificação quando a operação de indexação estiver concluída.

As etapas de fluxo são:

  1. Quando um blob é adicionado ou modificado (somente propriedades) (V2)
  2. Criar URI SAS por caminho (V2)
  3. HTTP
  4. Carregar vídeo e índice

Criar a etapa Quando um blog é adicionado ou modificado (somente propriedades)(V2)

  1. Crie o Logic App na mesma região da conta de Indexador de Vídeo do Azure (recomendado, mas não obrigatório).

  2. Inicie a aplicação lógica UploadIndexVideosApp.

    1. Selecione Consumo para Tipo de plano.
    2. Pressione Review + Create ->Create.
    3. Quando a implantação do Aplicativo Lógico estiver concluída, no portal do Azure, pesquise e navegue até o Aplicativo Lógico recém-criado.
    4. Na seção Configurações, no painel à esquerda, selecione a guia Identidade.
    5. Em Sistema atribuído, altere o Status de Desativado para Ativado (a etapa é importante para mais adiante neste tutorial).
    6. Pressione Salvar (na parte superior da página).
    7. Selecione o separador Designer de aplicações lógicas, no painel à esquerda.
    8. Escolha um fluxo de Logic App em branco.
    9. Pesquise por "blob" na página Escolha uma Operação.
    10. Na aba Tudo, escolha o componente de Armazenamento Blob do Azure.
    11. Em Triggers, selecione o trigger Quando um blob é adicionado ou modificado (somente propriedades) (V2).

  3. Crie um gatilho Quando um blob é adicionado ou modificado (V2) (somente propriedades).

  4. Defina a conexão de armazenamento com estes valores:

    Chave valor
    Nome da ligação < Atribua um nome à sua ligação>.
    Tipo de autenticação Tecla de Acesso
    Nome da Conta de Armazenamento do Azure < Nome da conta de armazenamento onde os arquivos de mídia serão armazenados>.
    Chave de Acesso da Conta de Armazenamento do Azure Para obter a chave de acesso da sua conta de armazenamento: no portal do Azure -> my-storage -> em Segurança + rede ->Chaves de acesso -> copie uma das chaves.
    1. Selecione Criar.
    2. Especifique o contêiner de armazenamento de blob que é monitorado quanto a alterações.
    Chave valor
    Nome da conta de armazenamento Nome da conta de armazenamento onde os arquivos de mídia são armazenados
    Contentor /videos
    1. Selecione Salvar ->

Criar URI SAS por caminho (V2)

  1. Selecione +Novo passo

  2. Criar URI SAS por ação de caminho.

    1. Selecione a guia Ação.
    2. Procure e selecione Criar URI SAS por caminho (V2).
    Chave valor
    Nome da conta de armazenamento < O nome da conta de armazenamento onde os arquivos de mídia foram armazenados>.
    Caminho do blob Em Conteúdo dinâmico, selecione Caminho da lista de arquivos
    Identificador de Política de Grupo Deixe o valor predefinido.
    Permissões Ler
    Protocolo de acesso compartilhado (aparece depois de pressionar Adicionar novo parâmetro) Apenas HTTPS
    1. Selecione Guardar.

  3. Selecione +Nova etapa.

Criar uma ação HTTP

  1. Procure e crie uma ação HTTP usando os valores na tabela a seguir:

    Chave valor Notas
    Método PUBLICAR
    URI [Token de acesso](#gerar-um-token-de-acesso)
    Corpo { "permissionType": "Contributor", "scope": "Account" } Veja o exemplo de documento REST, certifique-se de excluir a linha POST.
    Adicionar novo parâmetro Autenticação
    1. Preencha os parâmetros necessários para autenticação de acordo com a tabela a seguir:
    Chave valor
    Tipo de autenticação Identidade gerida
    Identidade gerida Identidade gerenciada atribuída ao sistema
    Audiência https://management.core.windows.net
    1. Selecione Guardar.

Configurar permissões

  1. Configure as permissões entre o aplicativo Logic e a conta do Azure AI Video Indexer.

  2. Configure a identidade gerenciada atribuída ao sistema para permissão no recurso Azure AI Video Indexer. No portal do Azure, vá para seu recurso/conta do Azure AI Video Indexer.

    1. Na página do lado esquerdo e selecione Controle de acesso.
    2. Selecione Adicionar ->Adicionar atribuição de função ->Colaborador ->Seguinte ->Utilizador, grupo ou principal de serviço ->+Selecionar membros.
    3. Em Membros, procure o nome dos Aplicativos Lógicos que você criou (neste caso, UploadIndexVideosApp).
    4. Pressione Selecionar.
    5. Carregue Review + atribuir.

Criar uma ação para carregar o vídeo e o índice

  1. Selecione Video Indexer(V2).

  2. Em Video Indexer(V2), selecione Upload Video and index.

  3. Defina a conexão com a conta do Video Indexer com os parâmetros na tabela a seguir:

    Chave valor
    Nome da ligação < Insira um nome para a conexão>, neste caso aviconnection.
    Chave de API É a sua chave de API pessoal, que está disponível em Perfil no portal do desenvolvedor Como este Aplicativo Lógico é para contas do Azure Resource Manager, não precisamos da chave de API real e você pode preencher um valor fictício como 12345

    1. Selecione Criar.

    2. Preencha os parâmetros de ação para Carregar vídeo e indexar.

      Gorjeta

      Se o ID da Conta VI não puder ser encontrado e não estiver na lista suspensa, use o valor personalizado.

      Chave valor
      Localização Localização da conta associada do Azure AI Video Indexer.
      ID de conta ID da conta associada do Azure AI Video Indexer. Pode encontrar o ID da Conta na página Visão Geral da sua conta, no portal do Azure. Ou, a guia 'Configurações de Conta', à esquerda do “site” Azure AI Video Indexer.
      Token de Acesso Use a body('HTTP')['accessToken'] expressão para extrair o token de acesso no formato correto da chamada HTTP anterior.
      Nome do Vídeo Selecione Lista de Nomes de Arquivos no conteúdo dinâmico da ação Quando um blob é adicionado ou modificado.
      URL do Vídeo Selecione URL da Web no conteúdo dinâmico da ação Criar URI SAS por caminho.
      Corpo Pode ser deixado como padrão.

    3. Selecione Guardar.

Fluxo #2: Criar uma nova aplicação lógica do tipo consumo

Crie o segundo fluxo, Aplicativos lógicos do tipo consumo. O segundo fluxo é acionado com base na URL de retorno de chamada e salva as informações extraídas de volta em um arquivo JSON no Armazenamento do Azure.

As etapas de fluxo são:

  1. Quando uma solicitação HTTP é recebida
  2. HTTP
  3. Obter índice de vídeo
  4. Criar blob (V2)

Configurar o gatilho

  1. Procure e selecione Quando uma solicitação HTTP é recebida.

    Para o gatilho, há um campo HTTP POST URL. O URL só será gerado depois de guardar o fluxo. No entanto, você acabará por precisar do URL.

    Gorjeta

    Mais tarde, você retornará ao URL criado nesta etapa.

Gerar um token de acesso

Talvez seja necessário gerar outro token de acesso, dependendo de como você configurou o primeiro. Copie e cole no bloco de notas.

  1. Gere um token de acesso.
  2. Selecione Salvar ->+ Nova etapa.

Configurar as informações do Get Video Indexer

  1. Pesquise por Video Indexer.

  2. Em Video Indexer(V2), selecione a ação Obter índice de vídeo.

    Defina o nome da conexão:

    Chave valor
    Nome da ligação < Um nome para conexão>. Por exemplo, aviconnection.
    Chave de API É a sua chave de API pessoal, que está disponível em Perfil no portal do desenvolvedor. Para obter mais informações, consulte Assinar a API.

    1. Selecione Criar.

    2. Preencha os parâmetros necessários de acordo com a tabela:

      Chave valor
      Localização A localização da conta do Azure AI Video Indexer.
      ID de conta A ID da conta do Video Indexer pode ser copiada da página Visão geral do recurso/conta no portal do Azure.
      ID do vídeo* Para Video ID, adicione conteúdo dinâmico do tipo Expression e coloque a seguinte expressão: triggerOutputs()['queries']['id'].
      Token de Acesso No conteúdo dinâmico, na seção Analisar JSON , selecione o accessToken que é a saída da ação JSON de análise.

      *Esta expressão indica ao conector para obter o identificador de vídeo da saída do seu gatilho. Neste caso, a saída do seu gatilho é a mesma saída de Carregar vídeo e indexar no seu primeiro gatilho.

    3. Selecione Salvar ->+ Nova etapa.

Crie um blob e armazene os insights JSON.

  1. Procure o blob do Azure no grupo de ações.

  2. Selecione Criar blob(V2).

  3. Configure a ligação ao armazenamento blob que armazena os ficheiros de insights JSON.

    Chave valor
    Nome da ligação < Insira um nome> de conexão.
    Tipo de autenticação Tecla de Acesso
    Nome da Conta de Armazenamento do Azure <* O nome da conta de armazenamento onde as informações são armazenadas*>.
    Chave de acesso da conta de armazenamento do Azure Vá para o portal do Azure-> my-storage-> em Segurança + rede ->Chaves de acesso -> copie uma das chaves.
    1. Selecione Criar.
    2. Defina a pasta na qual as informações são armazenadas.
    Chave valor
    Nome da conta de armazenamento < Digite o nome da conta de armazenamento que conteria a saída JSON (neste tutorial é o mesmo que o vídeo de origem).>
    Caminho da pasta Na lista suspensa, selecione o /insights
    Nome do Blob No conteúdo dinâmico, na seção Obter índice de vídeo , selecione Nome e adicione _insights.json. O nome do arquivo de insights é o nome do vídeo e insights.json
    conteúdo Blob No conteúdo dinâmico, na seção Obter Índice de Vídeo, selecione o Corpo.
    1. Selecione Salvar fluxo.

Atualize a URL de retorno de chamada para ser notificado quando uma tarefa de indexação for concluída.

Depois que o fluxo é salvo, uma URL de POST HTTP é criada no gatilho.

  1. Copie o URL do gatilho.
  2. Volte para o primeiro fluxo e cole a URL na ação Carregar vídeo e índice para o parâmetro de URL de retorno.

Certifique-se de que ambos os fluxos estão salvos.