Partager via

Utiliser avec un connecteur Logic Apps

  • Article

L’API REST Azure AI Video Indexer (VI) prend en charge les communications serveur à serveur et client à serveur. L’API vous permet d’intégrer des insights vidéo et audio dans votre logique d’application.

Nous prenons en charge les connecteurs Logic Apps et Power Automate compatibles avec l’API Azure AI Video Indexer.

Vous pouvez utiliser les connecteurs pour configurer des workflows personnalisés afin d’indexer et d’extraire efficacement des insights à partir d’une grande quantité de fichiers vidéo et audio, sans écrire une seule ligne de code. L’utilisation des connecteurs pour l’intégration vous donne une visibilité sur l’intégrité de votre flux de travail et un moyen de le déboguer.

Introduction

L’exemple de cet article crée des flux d’application logique. Les fonctionnalités Logic App et Power Automate et leurs éditeurs sont presque identiques.

L’approche de deux flux, deux flux qui fonctionnent ensemble, prennent en charge efficacement le chargement asynchrone et l’indexation de fichiers plus volumineux.

  • Le premier flux est déclenché quand un blob est ajouté ou modifié dans un compte Stockage Azure. Elle charge le nouveau fichier vers Azure AI Video Indexer avec une URL de rappel pour envoyer une notification une fois l’opération d’indexation terminée.
  • Le deuxième flux est déclenché en fonction de l’URL de rappel ; il enregistre les informations extraites dans un fichier JSON dans Stockage Azure.

Les applications logiques que vous créez dans cet article contiennent un flux par application. La deuxième section, Créer une application logique de consommation de type explique comment connecter les deux. Le deuxième flux est autonome et est déclenché par le premier.

Lorsqu’un fichier est chargé et indexé à partir du premier flux, il envoie une requête HTTP avec l’URL de rappel correcte pour déclencher le deuxième flux. Ensuite, ce flux récupère les insights générés par Azure AI Video Indexer. Dans cet exemple, il stocke la sortie de votre travail d’indexation dans votre Stockage Azure. Toutefois, c’est vous qui décidez de ce que vous pouvez faire avec la sortie.

Prérequis

  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
  • Créez un compte Azure AI Video Indexer basé sur ARM.
  • Créer un compte de stockage Azure Les comptes de stockage pour VI doivent être un compte de stockage v2 universel standard. Prenez note de la clé d’accès de votre compte de stockage.
    • Créez deux conteneurs : un pour stocker les fichiers multimédias, deuxièmement pour stocker les insights générés par Azure AI Video Indexer. Dans cet article, les conteneurs sont videos et insights.

Générer un jeton d’accès

  1. Générez un jeton d’accès à l’aide de generateAccessToken. Appuyez sur Essayer pour obtenir les valeurs correctes pour votre compte.
  2. Copiez et collez-le dans le Bloc-notes pour une étape ultérieure.

Flux n°1 : Configurer le flux de chargement de fichier

Cette section explique comment configurer le premier flux de chargement de fichiers. Le premier flux est déclenché quand un blob est ajouté ou modifié dans un compte Stockage Azure. Elle charge le nouveau fichier vers Azure AI Video Indexer avec une URL de rappel pour envoyer une notification une fois l’opération d’indexation terminée.

Les étapes de flux sont les suivantes :

  1. Lorsqu’un objet blob est ajouté ou modifié (propriétés uniquement) (V2)
  2. Créer un URI SAS par chemin d’accès (V2)
  3. HTTP
  4. Charger la vidéo et l’index

Créer l’étape Lors de l’ajout ou de la modification d’un blog (propriétés uniquement)(V2)

  1. Créez l’application logique dans la même région que la région du compte Azure Video Indexer (recommandée, mais non obligatoire).

  2. Appelez l’application UploadIndexVideosApplogique .

    1. Sélectionnez Consommation pour Type de plan.
    2. Appuyez sur Vérifier + créer ->Créer.
    3. Une fois le déploiement de l’application logique terminé, dans le Portail Azure, accédez à l’application logique nouvellement créée.
    4. Sous la section Paramètres, dans le volet gauche, sélectionnez l’onglet Identité.
    5. Sous Affecté par le système, remplacez l’état Désactivé par l’état activé (l’étape est importante pour les instructions disponibles plus loin dans ce tutoriel).
    6. Appuyez sur Enregistrer (en haut de la page).
    7. Sélectionnez l’onglet Concepteur d’application logique (dans le volet de gauche).
    8. Sélectionnez un flux Application logique vide.
    9. Recherchez « blob » dans le panneau Choisir une opération.
    10. Sous l’onglet Tous, choisissez le composant Stockage Blob Azure.
    11. Sous Déclencheurs, sélectionnez le déclencheur Lorsqu’un objet blob est ajouté ou modifié (propriétés uniquement) (V2).

  3. Créez un déclencheur Quand un objet blob est ajouté ou modifié (propriétés uniquement) (V2).

  4. Définissez la connexion de stockage sur ces valeurs :

    Clé Valeur
    Nom de connexion <Nommez votre connexion>.
    Type d’authentification Clé d’accès
    Nom du compte de stockage Azure <Nom du compte de stockage dans lequel les fichiers multimédias seront stockés>.
    Clé d’accès au compte de stockage Azure Pour obtenir la clé d’accès de votre compte de stockage : dans le portail Azure -> my-storage -> sous Sécurité + mise en réseau ->Clés d’accès ->, copiez l’une des clés.
    1. Sélectionnez Créer.
    2. Spécifiez le conteneur de stockage d’objets blob surveillé pour les modifications.
    Clé Valeur
    Nom du compte de stockage Nom du compte de stockage dans lequel les fichiers multimédias sont stockés
    Conteneur /videos
    1. Sélectionner Enregistrer ->

Créer un URI SAS par chemin d’accès (V2)

  1. Sélectionnez +Nouvelle étape

  2. Créez un URI SAP par action de chemin d’accès.

    1. Sélectionnez l’onglet Action.
    2. Recherchez et sélectionnez Créer un URI SAP par chemin d’accès (V2).
    Clé Valeur
    Nom du compte de stockage <Nom du compte de stockage dans lequel les fichiers multimédias sont stockés>.
    Chemin d’accès d’objet blob Sous Contenu dynamique, sélectionnez Liste des fichiers chemin d’accès.
    Identificateur de stratégie de groupe Conservez la valeur par défaut.
    autorisations Lire
    Protocole d’accès partagé (apparaît après avoir appuyé sur Ajouter un nouveau paramètre) HttpsOnly
    1. Cliquez sur Enregistrer.

  3. Sélectionnez + Nouvelle étape.

Créer une action HTTP

  1. Recherchez et créez une action HTTP à l’aide des valeurs du tableau suivant :

    Clé Valeur Notes
    méthode POST
    URI [Jeton d’accès](jeton d’accès #generate)
    Corps { "permissionType": "Contributor", "scope": "Account" } Consultez l’exemple de document REST. Veillez à supprimer la ligne POST.
    Ajouter un nouveau paramètre Authentification
    1. Remplissez les paramètres requis pour l’authentification en fonction du tableau suivant :
    Clé Valeur
    Type d'authentification Identité gérée
    Identité managée Identité managée affectée par le système
    Audience https://management.core.windows.net
    1. Cliquez sur Enregistrer.

Définir des autorisations

  1. Configurez les autorisations entre l’application logique et le compte Azure AI Video Indexer.

  2. Configurez l’identité managée affectée par le système pour l’autorisation sur la ressource Azure AI Video Indexer. Dans le Portail Azure, accédez à votre ressource/compte Azure AI Video Indexer.

    1. Sur le volet gauche, sélectionnez Contrôle d’accès (IAM).
    2. Sélectionnez Ajouter ->Ajouter une attribution de rôle ->Contributeur ->Suivant ->Utilisateur, groupe ou principal de service ->+Sélectionner des membres.
    3. Sous Membres, recherchez le nom de l’application logique que vous avez créé (dans ce cas, UploadIndexVideosApp).
    4. Appuyez sur Sélectionner.
    5. Cliquez sur Analyser + attribuer.

Créer une action charger une vidéo et un index

  1. Sélectionnez Video Indexer(V2).

  2. À partir de Video Indexer(V2), choisissez Charger la vidéo et l’index.

  3. Définissez la connexion au compte Video Indexer avec les paramètres du tableau suivant :

    Clé Valeur
    Nom de connexion <Entrez un nom pour la connexion>, dans ce cas aviconnection.
    Clé API Il s’agit de votre clé API personnelle, disponible sous Profil dans le portail des développeurs, car cette application logique est destinée aux comptes ARM, nous n’avons pas besoin de la clé API réelle et vous pouvez renseigner une valeur factice comme 12345

    1. Sélectionnez Créer.

    2. Remplissez les paramètres d’action Charger la vidéo et l’index.

      Conseil

      Si l’ID de compte VI est introuvable et n’est pas dans la liste déroulante, utilisez la valeur personnalisée.

      Clé Valeur
      Emplacement Emplacement du compte Azure AI Video Indexer associé.
      ID de compte ID de compte du compte Video Indexer Azure AI associé. Vous trouverez l’ID de compte dans la page Vue d’ensemble de votre compte, dans le portail Azure. Ou, l’onglet Paramètres du compte, à gauche du site web Azure AI Video Indexer.
      Jeton d'accès Utilisez l’expression body('HTTP')['accessToken'] pour extraire le jeton d’accès au bon format à partir de l’appel HTTP précédent.
      Nom de la vidéo Sélectionnez Liste des noms de fichiers dans le contenu dynamique de l’action Lorsqu’un objet blob est ajouté ou modifié.
      URL de la vidéo Sélectionnez URL web dans le contenu dynamique de l’action Créer un URI SAP par chemin d’accès.
      Corps Peut être laissé comme valeur par défaut.

    3. Cliquez sur Enregistrer.

Flux n°2 : Créer une application logique de consommation de type

Créez le deuxième flux Logic Apps de type Consommation. Le deuxième flux est déclenché en fonction de l’URL de rappel ; il enregistre les informations extraites dans un fichier JSON dans Stockage Azure.

Les étapes de flux sont les suivantes :

  1. Lors de la réception d’une requête HTTP
  2. HTTP
  3. Obtenir l’index vidéo
  4. Créer un objet blob (V2)

Configurer le déclencheur

  1. Recherchez et sélectionnez le moment où une requête HTTP est reçue.

    Pour le déclencheur, il existe un champ d’URL HTTP POST. L’URL ne sera générée qu’une fois que vous aurez enregistré votre flux ; toutefois, vous en aurez besoin à un moment donné.

    Conseil

    Nous reviendrons à l’URL créée à cette étape.

Générer un jeton d’accès

Vous devrez peut-être générer un autre jeton d’accès en fonction de la façon dont vous configurez le premier. Copiez et collez-le dans le Bloc-notes.

  1. Générez un jeton d’accès.
  2. Sélectionnez Enregistrer ->+Nouvelle étape.

Configurer Obtenir des insights Video Indexer

  1. Recherchez « Video Indexer ».

  2. Dans Video Indexer(V2), choisissez l’action Obtenir l’index vidéo.

    Définissez le nom de la connexion :

    Clé Valeur
    Nom de connexion <Nom de la connexion>. Par exemple : aviconnection.
    Clé API Il s’agit de votre clé API personnelle, disponible sous Profil dans le portail des développeurs. Pour plus d’informations, consultez S’abonner à l’API.

    1. Sélectionnez Créer.

    2. Remplissez les paramètres requis en fonction du tableau :

      Clé Valeur
      Emplacement Emplacement du compte Azure AI Video Indexer.
      ID de compte L’ID de compte Video Indexer peut être copié à partir de la page Vue d’ensemble de la ressource/du compte dans le portail Azure.
      ID de la vidéo* Pour l’ID vidéo, ajoutez du contenu dynamique de type Expression et placez l’expression suivante triggerOutputs()['queries']['id'].
      Jeton d'accès Dans le contenu dynamique, sous la section Analyser JSON, sélectionnez l’accessToken qui correspond à la sortie de l’action Analyser JSON.

      *Cette expression indique au connecteur qu’il doit extraire l’ID vidéo à partir de la sortie de votre déclencheur. Dans ce cas, la sortie de votre déclencheur correspond à la sortie de « Charger une vidéo et indexer » dans votre premier déclencheur.

    3. Sélectionnez Enregistrer ->+Nouvelle étape.

Créez un objet blob et stockez les insights JSON.

  1. Recherchez « Objet blob Azure » dans le groupe d’actions.

  2. Sélectionnez Créer un objet blob(V2).

  3. Définissez la connexion au stockage blob qui stocke les fichiers d’insights JSON.

    Clé Valeur
    Nom de connexion <Entrez un nom de connexion>.
    Type d’authentification Clé d’accès
    Nom du compte de stockage Azure <* Nom du compte de stockage où les insights seront stockés*>.
    Clé d’accès au compte de stockage Azure Accédez au portail Azure-> my-storage-> sous Sécurité + mise en réseau ->Clés d’accès -> et copiez l’une des clés.
    1. Sélectionnez Créer.
    2. Définissez le dossier dans lequel les insights seront stockés.
    Clé Valeur
    Nom du compte de stockage <Entrez le nom du compte de stockage qui contiendrait la sortie JSON (dans ce tutoriel, il est identique à la vidéo source).>
    Chemin d’accès du dossier Dans la liste déroulante, sélectionnez /insights.
    Nom de l’objet blob À partir du contenu dynamique, sous la section Obtenir l’index vidéo, sélectionnez Nom et ajoutez _insights.json. Le nom du fichier Insights sera le nom de la vidéo + insights.json.
    Contenu de l’objet blob Dans le contenu dynamique, sous la section Obtenir l’index vidéo, sélectionnez le Corps.
    1. Sélectionnez Enregistrer le flux.

Mettez à jour l’URL de rappel pour recevoir une notification lorsqu’un travail d’index est terminé.

Une fois le flux enregistré, une URL HTTP POST est créée dans le déclencheur.

  1. Copiez l’URL à partir du déclencheur.
  2. Revenez au premier flux et collez l’URL dans l’action Charger une vidéo et indexer pour le paramètre d’URL de rappel.

Vérifiez que les deux flux sont enregistrés.