Partilhar 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 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. O uso dos conectores para a integração oferece visibilidade sobre a integridade do seu fluxo de trabalho e uma maneira de depurá-lo.

Introdução

O exemplo neste artigo cria fluxos do Aplicativo Lógico. 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, suporta carregamento assíncrono e 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. Ele carrega o novo arquivo no 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 é 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 um novo aplicativo lógico de consumo de tipo, 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, ele recuperará os insights gerados pelo Azure AI Video Indexer. Neste exemplo, ele armazenará a saída do seu trabalho de indexação no Armazenamento do Azure. No entanto, depende de você o que você faz 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 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. Ele carrega o novo arquivo no 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 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 Aplicativo Lógico na mesma região da região da conta do Indexador de Vídeo do Azure (recomendado, mas não obrigatório).

  2. Chame o aplicativo UploadIndexVideosApplógico .

    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 do lado esquerdo, 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 a guia Designer de aplicativo lógico, no painel à esquerda.
    8. Escolha um fluxo de Aplicativo Lógico em Branco.
    9. Procure por "blob" na folha Escolha uma operação .
    10. Na guia Tudo, escolha o componente Armazenamento de Blob do Azure.
    11. Em Triggers, selecione o gatilho Quando um blob é adicionado ou modificado (somente propriedades) (V2).

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

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

    Key valor
    Nome da ligação <Atribua um nome à sua ligação>.
    Authentication type 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.
    Key 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).
    Key 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) Disponível em: 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:

    Key valor Notas
    Método POST
    URI [Token de acesso](#generate 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:
    Key valor
    Authentication type 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 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, procure o nome dos Aplicativos Lógicos que você criou (neste caso, UploadIndexVideosApp).
    4. Pressione Select.
    5. Pressione Review + atribuir.

Criar uma ação Carregar vídeo e í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:

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

    1. Selecione Criar.

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

      Gorjeta

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

      Key valor
      Location Localização da conta associada do Azure AI Video Indexer.
      ID de conta ID da conta da conta associada do Azure AI Video Indexer. Pode encontrar o ID da Conta na página Descrição Geral da sua conta, no portal do Azure. Ou, a guia Configurações de conta , à esquerda do site do 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 Nome 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 um novo aplicativo lógico de consumo de tipo

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 um pedido de HTTP é recebido
  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 não será gerado até que você salve seu fluxo; no entanto, você precisará do URL eventualmente.

    Gorjeta

    Voltaremos 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 o Get Video Indexer insights

  1. Procure por "Video Indexer".

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

    Defina o nome da conexão:

    Key valor
    Nome da ligação <Um nome para conexão>. Por exemplo, aviconnection.
    Chave de API Esta é 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:

      Key valor
      Location O local 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 diz ao conector para obter o ID de vídeo da saída do seu gatilho. Neste caso, a saída do seu gatilho será a saída de Upload de vídeo e índice no seu primeiro gatilho.

    3. Selecione Salvar ->+ Nova etapa.

Crie um blob e armazene os insights JSON.

  1. Procure por "Azure blob", no grupo de ações.

  2. Selecione Criar blob(V2).

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

    Key valor
    Nome da ligação <Insira um nome> de conexão.
    Authentication type Tecla de Acesso
    Nome da Conta de Armazenamento do Azure <* O nome da conta de armazenamento onde os insights serão armazenados*>.
    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 serão armazenadas.
    Key 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).>
    Folder path Na lista suspensa, selecione o botão /insights
    Blob name 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
    Blob content 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.

Depois que o fluxo é salvo, um HTTP POST URL é criado 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 URL de retorno de chamada.

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