Compartilhar via

Usar com um conector de Aplicativos Lógicos

  • Artigo

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

Oferecemos suporte a conectores de Aplicativos Lógicos e Power Automate compatíveis com a API do Azure AI Video Indexer.

Você pode usar os conectores para configurar fluxos de trabalho personalizados a fim de indexar e extrair insights de uma grande quantidade de arquivos de vídeo e áudio, sem escrever uma só linha de código. O uso dos conectores para a integração oferece visibilidade sobre a integridade do fluxo de trabalho e uma maneira de depurá-lo.

Introdução

O exemplo neste artigo cria fluxos de Aplicativo Lógico. Os recursos do Aplicativo Lógico e do Power Automate e seus editores são quase idênticos.

A abordagem de dois fluxos, dois fluxos que funcionam juntos, dá suporte ao upload assíncrono e à indexação de arquivos maiores de forma eficaz.

  • O primeiro fluxo é disparado quando um blob é adicionado ou modificado em uma conta de Armazenamento do Azure. Ele carrega o novo arquivo para o Azure AI Video Indexer com uma URL de retorno de chamada para enviar uma notificação assim que a operação de indexação for concluída.
  • O segundo fluxo é disparado com base na URL de retorno de chamada e salva os insights extraídos em um arquivo JSON no Armazenamento do Azure.

Os aplicativos lógicos que você cria neste artigo contêm um fluxo por aplicativo. A segunda seção, Criar um novo aplicativo lógico de consumo de tipo, explica como conectar os dois. O segundo fluxo é autônomo 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, isso recuperará os insights gerados pelo Azure AI Video Indexer. Neste exemplo, ele armazena a saída de seu trabalho de indexação no Armazenamento do Azure. No entanto, você decide o que deseja fazer com a saída.

Pré-requisitos

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
  • Crie uma conta do Azure AI Video Indexer baseada em ARM.
  • Criar uma conta de Armazenamento do Microsoft Azure. As contas de armazenamento para VI devem ser uma conta de armazenamento Standard de uso geral v2. Anote a chave de acesso de sua conta de armazenamento.
    • Crie dois contêineres: um para armazenar os arquivos de mídia e o segundo para armazenar os insights gerados 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 arquivo

Esta seção descreve como configurar o primeiro fluxo, upload de arquivo. O primeiro fluxo é disparado quando um blob é adicionado ou modificado em uma conta de Armazenamento do Azure. Ele carrega o novo arquivo para o Azure AI Video Indexer com uma URL de retorno de chamada para enviar uma notificação assim que a operação de indexação for concluída.

As etapas do fluxo são:

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

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

  1. Crie o Aplicativo Lógico na mesma região que a região da conta do Azure Video Indexer (recomendado, mas não obrigatório).

  2. Chame o aplicativo UploadIndexVideosApplógico .

    1. Selecione Consumo para Tipo de Plano.
    2. Pressione Examinar + criar – >Criar.
    3. Depois que a implantação do Aplicativo Lógico for 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 esquerdo, selecione a guia Identidade.
    5. Em Sistema atribuído, altere o Status de Desativado para Ativado (a etapa é importante para posteriormente neste tutorial).
    6. Pressione Salvar na parte superior da página.
    7. Selecione a guia Designer de Aplicativo Lógico, no painel à esquerda.
    8. Escolha um fluxo do aplicativo lógico em branco.
    9. Pesquise "blob" na folha Escolher uma Operação.
    10. Na guia Todos, escolha o componente Armazenamento de Blobs do Azure.
    11. Em Gatilhos, selecione o gatilho Quando um blob é adicionado ou modificado (somente propriedade) (V2).

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

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

    Chave Valor
    Nome da conexão <Nomeie sua conexão>.
    Tipo de autenticação Chave 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 Microsoft Azure Para obter a chave de acesso da sua conta de armazenamento: no portal do Azure – >meu armazenamento> em Segurança + rede – >Chaves de acesso – > copie uma das chaves.
    1. Selecione Criar.
    2. Especifique o contêiner de armazenamento de blobs que é monitorado quanto a alterações.
    Chave Valor
    Nome da conta de armazenamento Nome da conta de armazenamento em que os arquivos de mídia serão armazenados
    Contêiner /videos
    1. Selecione Salvar ->

Criar URI SAS por caminho (V2)

  1. Selecione +Nova etapa

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

    1. Selecione a guia Ação.
    2. Pesquise e selecione Criar URI SAS por caminho (V2).
    Chave Valor
    Nome da conta de armazenamento <Nome da conta de armazenamento onde os arquivos de mídia são armazenados>.
    Caminho do Blob Em conteúdo dinâmico, selecione Lista de Caminho dos Arquivos
    Identificador da Política de Grupo Mantenha o valor padrão.
    Permissões Leitura
    Protocolo de Acesso Compartilhado (aparece depois de pressionar Adicionar novo parâmetro) HttpsOnly
    1. Selecione Salvar.

  3. Selecione + Nova etapa.

Criar uma ação HTTP

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

    Chave Valor Observações
    Method POST
    URI [Token de acesso] (#generate um token de acesso)
    Corpo { "permissionType": "Contributor", "scope": "Account" } Consulte o exemplo de documento REST e 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 gerenciada
    Identidade gerenciada Identidade gerenciada atribuída pelo sistema
    Público-alvo https://management.core.windows.net
    1. Selecione Salvar.

Configurar permissões

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

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

    1. Na folha do lado esquerdo e selecione Controle de acesso.
    2. Selecione Adicionar – >Adicionar atribuição de função –>Colaborador – >Próximo – >Usuário, grupo ou entidade de serviço – >+Selecionar membros.
    3. Em Membros, pesquise o nome dos Aplicativos Lógicos que você criou (neste caso, UploadIndexVideosApp).
    4. Pressione Selecionar.
    5. Pressione Revisar + Atribuir.

Criar uma ação Enviar vídeo e indexar

  1. Selecione Video Indexer(V2).

  2. Em Video Indexer(V2), escolha Carregar vídeo e índice.

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

    Chave Valor
    Nome da conexão <Insira um nome para a conexão >, nesse caso, aviconnection.
    Chave de API Essa é sua chave de API pessoal, que está disponível em Perfil no portal do desenvolvedor Como esse Aplicativo Lógico é para contas do ARM, 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 Carregar vídeo e índice.

      Dica

      Se o ID da conta VI não puder ser encontrado e não estiver no menu suspenso, use o valor personalizado.

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

    3. Selecione Salvar.

Fluxo #2: Criar um novo aplicativo lógico de consumo de tipo

Crie o segundo fluxo, Aplicativos Lógicos de consumo de tipo. O segundo fluxo é disparado com base na URL de retorno de chamada e salva os insights extraídos em um arquivo JSON no Armazenamento do Azure.

As etapas do 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. Pesquise e selecione Quando uma solicitação HTTP é recebida.

    Para o gatilho, há um campo URL HTTP POST. A URL não será gerada até que você salve o fluxo. No entanto, você precisará dela em algum momento.

    Dica

    Voltaremos à URL criada 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. Gerar um token de acesso.
  2. Selecione Salvar – >+Nova etapa.

Configurar obter insights do Video Indexer

  1. Pesquise "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 conexão <Um nome para conexão>. Por exemplo, aviconnection.
    Chave de API Essa é sua chave de API pessoal, que está disponível em Perfil no portal do desenvolvedor. Para obter mais informações, consulte Assinar API.

    1. Selecione Criar.

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

      Chave Valor
      Localidade O local da conta do Azure AI Video Indexer.
      ID da 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 de vídeo* Para a ID de Vídeo, adicione conteúdo dinâmico do tipo Expressão 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.

      Essa expressão instrui o conector a obter a ID de Vídeo da saída do gatilho. Nesse caso, a saída do gatilho será a saída de Carregar vídeo e índice no primeiro gatilho.

    3. Selecione Salvar – >+Nova etapa.

Crie um blob e armazene o JSON de insights.

  1. Pesquise "Blob do Azure", no grupo de ações.

  2. Selecione Criar blob(V2).

  3. Defina a conexão com o armazenamento de blobs que armazenará os arquivos de insights JSON.

    Chave Valor
    Nome da conexão <Insira um nome de conexão>.
    Tipo de autenticação Chave de Acesso
    Nome da conta de armazenamento do Azure <* O nome da conta de armazenamento em que os insights serão armazenados*>.
    Chave de Acesso da Conta de Armazenamento do Microsoft Azure Vá para portal do Azure >meu armazenamento> em Segurança + rede – >Chaves de acesso> – copie uma das chaves.
    1. Selecione Criar.
    2. Defina a pasta na qual os insights serão armazenados.
    Chave Valor
    Nome da conta de armazenamento <Insira 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 No menu suspenso, selecione /insights
    Nome de 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 será o nome do vídeo + insights.json
    Conteúdo 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 um trabalho de índice for concluído.

Após o fluxo ser salvo, uma URL HTTP POST será criada no gatilho.

  1. Copie a URL do gatilho.
  2. Agora, volte para o primeiro fluxo e cole a URL na ação Carregar vídeo e índice do Parâmetro de URL de retorno de chamada.

Verifique se ambos os fluxos foram salvos.