Freigeben über

Verwenden mit einem Logic Apps-Connector

Die REST-API von Azure AI Video Indexer (VI) unterstützt sowohl die Server-zu-Server- als auch die Client-zu-Server-Kommunikation. Mit der API können Sie Video- und Audioerkenntnisse in Ihre Anwendungslogik integrieren.

Wir unterstützen Logic Apps und Power Automate-Connectors , die mit der Azure AI Video Indexer-API kompatibel sind.

Mit den Connectors können Sie benutzerdefinierte Workflows einrichten, um auf effektive Weise für eine große Zahl von Video- und Audiodateien Erkenntnisse zu indizieren und zu extrahieren, ohne auch nur eine Codezeile zu schreiben. Wenn Sie die Connectors für die Integration verwenden, erhalten Sie Einen Überblick über die Integrität Ihres Workflows und eine Möglichkeit zum Debuggen.

Einführung

Im Beispiel in diesem Artikel werden Logik-App-Flows erstellt. Die Funktionen "Logic App" und "Power Automate" und ihre Editoren sind nahezu identisch.

Der Ansatz mit zwei Flows, bei dem zwei Flows zusammenarbeiten, unterstützt das asynchrone Hochladen und die Indizierung größerer Dateien auf effektive Weise.

  • Der erste Workflow wird ausgelöst, wenn ein Blob in einem Azure Storage-Konto hinzugefügt oder geändert wird. Hierbei wird die neue Datei in Azure KI Video Indexer mit einer Rückruf-URL hochgeladen, über die eine Benachrichtigung gesendet wird, nachdem der Indizierungsvorgang abgeschlossen ist.
  • Der zweite Workflow wird basierend auf der Rückruf-URL ausgelöst, und die extrahierten Erkenntnisse werden als JSON-Datei in Azure Storage gespeichert.

Die in diesem Artikel erstellten Logik-Apps enthalten einen Fluss pro App. Im zweiten Abschnitt wird erläutert, wie eine neue Logik-App vom Typ "Verbrauch" erstellt wird und wie die beiden miteinander verbunden werden. Der zweite Fluss steht allein und wird durch den ersten ausgelöst.

Wenn eine Datei aus dem ersten Fluss hochgeladen und indiziert wird, sendet sie eine HTTP-Anforderung mit der richtigen Rückruf-URL, um den zweiten Fluss auszulösen. Anschließend werden die von Azure AI Video Indexer generierten Erkenntnisse abgerufen. In diesem Beispiel wird die Ausgabe Ihres Indizierungsauftrags in Ihrem Azure Storage gespeichert. Was Sie mit der Ausgabe tun, bleibt Ihnen überlassen.

Voraussetzungen

  • Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.
  • Erstellen Sie ein Azure Resource Manager-basiertes Azure AI Video Indexer-Konto.
  • Erstellen Sie ein Azure Storage-Konto. Speicherkonten für VI müssen ein Standard-V2-Speicherkonto sein. Notieren Sie sich den Zugriffsschlüssel für Ihr Storage-Konto.
    • Erstellen Sie zwei Container: eine zum Speichern der Mediendateien, zweitens zum Speichern der von Azure AI Video Indexer generierten Erkenntnisse. In diesem Artikel heißen die Container videos und insights.

Erstellen eines Zugriffstokens

  1. Generieren Sie ein Zugriffstoken mithilfe des generateAccessToken. Drücken Sie Ausprobieren, um die richtigen Werte für Ihr Konto abzurufen.
  2. Kopieren Sie es, und fügen Sie es für einen späteren Schritt in eine Editor-Datei ein.

Ablauf Nr. 1: Einrichten des Dateiuploadflusses

In diesem Abschnitt wird beschrieben, wie Sie den ersten Ablauf des Dateiuploads einrichten. Der erste Workflow wird ausgelöst, wenn ein Blob in einem Azure Storage-Konto hinzugefügt oder geändert wird. Hierbei wird die neue Datei in Azure KI Video Indexer mit einer Rückruf-URL hochgeladen, über die eine Benachrichtigung gesendet wird, nachdem der Indizierungsvorgang abgeschlossen ist.

Die Ablaufschritte sind:

  1. Wenn ein Blob hinzugefügt oder geändert wird (nur Eigenschaften) (nur V2)
  2. Sas-URI nach Pfad erstellen (V2)
  3. HTTP
  4. Hochladen von Videos und Index

Erstelle den Schritt "Wenn ein Blog hinzugefügt oder geändert wird (nur Eigenschaften) (V2)"

  1. Erstellen Sie die Logik-App in derselben Region wie die Azure Video Indexer-Kontoregion (empfohlen, aber nicht erforderlich).

  2. Rufen Sie die Logik-App UploadIndexVideosAppauf.

    1. Wählen Sie als PlantypVerbrauch aus.
    2. Drücken Sie Überprüfen und erstellen>Erstellen.
    3. Sobald die Bereitstellung der Logik-App abgeschlossen ist, suchen Sie im Azure-Portal die neu erstellte Logik-App, und navigieren Sie zu ihr.
    4. Wählen Sie im Abschnitt Einstellungen auf der linken Seite die Registerkarte Identität aus.
    5. Ändern Sie unter Systemseitig zugewiesen den Status von Aus in Ein (dieser Schritt ist für den Fortgang dieses Tutorials wichtig).
    6. Drücken Sie auf Speichern (oben auf der Seite).
    7. Wählen Sie im Bereich auf der linken Seite Logik-App-Designer aus.
    8. Wählen Sie einen Flow Leere Logik-App aus.
    9. Suchen Sie auf der Seite Vorgang auswählen nach „blob“.
    10. Wählen Sie auf der Registerkarte Alle die Komponente Azure Blob Storage aus.
    11. Wählen Sie unter Trigger den Trigger Wenn ein Blob hinzugefügt oder geändert wird (nur Eigenschaften) (V2) aus.

  3. Erstellen Sie einen Trigger, wenn ein Blob hinzugefügt oder geändert wird (nur Eigenschaften) (V2).

  4. Legen Sie die Speicherverbindung auf diese Werte fest:

    Schlüssel Wert
    Verbindungsname < Benennen Sie Ihre Verbindung>.
    Authentifizierungstyp Zugriffsschlüssel
    Name des Azure Storage-Kontos < Name des Speicherkontos, in dem die Mediendateien gespeichert werden sollen>.
    Zugriffsschlüssel für das Azure Storage-Konto So rufen Sie den Zugriffsschlüssel für Ihr Speicherkonto ab: Kopieren Sie im Azure-Portal > mein-speicher > unter Sicherheit + Netzwerkbetrieb>Zugriffsschlüssel> einen der Schlüssel.
    1. Klicken Sie auf Erstellen.
    2. Geben Sie den Blob Storage-Container an, der auf Änderungen überwacht wird.
    Schlüssel Wert
    Speicherkontoname Name des Speicherkontos, in dem Mediendateien gespeichert werden
    Behälter /videos
    1. Wählen Sie Speichern ->

Sas-URI nach Pfad erstellen (V2)

  1. +Neuer Schritt auswählen

  2. Erstelle SAS-URI über Pfadaktion

    1. Wählen Sie die Registerkarte Aktion aus
    2. Suchen Sie nach SAS-URI nach Pfad erstellen (V2), und wählen Sie es aus.
    Schlüssel Wert
    Speicherkontoname < Name des Speicherkontos, in dem Mediendateien gespeichert werden>.
    Blobpfad Wählen Sie unter Dynamischer Inhalt den Pfad zur Dateiliste aus.
    Gruppenrichtlinienbezeichner Behalten Sie den Standardwert bei.
    Berechtigungen Lesen
    Shared Access-Protokoll (wird nach Drücken auf Neuen Parameter hinzufügen angezeigt). HttpsOnly
    1. Wählen Sie Speichern.

  3. Wählen Sie + Neuer Schritt aus.

Erstellen einer HTTP-Aktion

  1. Suchen und erstellen Sie eine HTTP-Aktion mithilfe der Werte in der folgenden Tabelle:

    Schlüssel Wert Notizen
    Methode BEITRAG
    URI (Uniform Resource Identifier) [Zugriffstoken](#generate-an-Access-Token)
    Körper { "permissionType": "Contributor", "scope": "Account" } Sehen Sie sich das Beispiel der REST-Dokumentation an, und achten Sie darauf, die POST-Zeile zu löschen.
    Neuen Parameter hinzufügen Authentifizierung
    1. Füllen Sie die erforderlichen Parameter für die Authentifizierung gemäß der folgenden Tabelle aus:
    Schlüssel Wert
    Authentifizierungstyp Verwaltete Identität
    Verwaltete Identität Systemseitig zugewiesene verwaltete Identität
    Zielgruppe https://management.core.windows.net
    1. Wählen Sie Speichern.

Einrichten von Berechtigungen

  1. Richten Sie die Berechtigungen zwischen der Logik-App und dem Azure AI Video Indexer-Konto ein.

  2. Richten Sie die vom System zugewiesene verwaltete Identität für die Berechtigung für die Azure AI Video Indexer-Ressource ein. Wechseln Sie im Azure-Portal zu Ihrer Azure AI Video Indexer-Ressource/Ihrem Konto.

    1. Gehen Sie auf die linke Seite und wählen Sie Zugangskontrolle aus.
    2. Wählen Sie Hinzufügen>Rollenzuweisung hinzufügen>Mitwirkende>Weiter>Benutzende, Gruppe oder Dienstprinzipal>Mitglieder auswählen aus.
    3. Suchen Sie unter Mitglieder nach dem Namen der Logik-App, die Sie erstellt haben (in diesem Fall ist das UploadIndexVideosApp).
    4. Drücken Sie Auswählen.
    5. Klicken Sie auf Überprüfen + zuweisen.

Erstellen einer Video-Upload und -Index-Aktion

  1. Wählen Sie Video Indexer(V2) aus.

  2. Wählen Sie in Video Indexer(V2) Video hochladen und indizieren aus.

  3. Legen Sie die Verbindung mit dem Videoindexer-Konto mit den Parametern in der folgenden Tabelle fest:

    Schlüssel Wert
    Verbindungsname < Geben Sie einen Namen für die Verbindung> ein, in diesem Fall aviconnection.
    API-Schlüssel Es handelt sich um Ihren persönlichen API-Schlüssel, der unter "Profil " im Entwicklerportal verfügbar ist, da diese Logik-App für Azure Resource Manager-Konten nicht den tatsächlichen API-Schlüssel benötigt, und Sie können einen Dummywert wie 12345 ausfüllen.

    1. Klicken Sie auf Erstellen.

    2. Setzen Sie die Parameter für die Aktion Video hochladen und indizieren ein.

      Tipp

      Wenn die VI-Konto-ID nicht gefunden und nicht in der Dropdownliste enthalten ist, verwenden Sie den benutzerdefinierten Wert.

      Schlüssel Wert
      Standort Speicherort des zugeordneten Azure KI Video Indexer-Kontos.
      Konto-ID Konto-ID des zugeordneten Azure AI Video Indexer-Kontos. Sie finden die Konto-ID auf der Seite Übersicht in Ihrem Konto im Azure-Portal. Oder die Registerkarte "Kontoeinstellungen " links der Azure AI Video Indexer-Website.
      Zugriffstoken Verwenden Sie den Ausdruck body('HTTP')['accessToken'], um das Zugriffstoken im richtigen Format aus dem vorherigen HTTP-Aufruf zu extrahieren.
      Videoname Wählen Sie die Liste der Dateinamen im dynamischen Inhalt der Aktion Wenn ein Blob hinzugefügt oder geändert wird aus.
      Video-URL Wählen Sie Web-Url im dynamischen Inhalt der Aktion SAS-URI nach Pfad erstellen aus.
      Körper Die Standardeinstellung kann übernommen werden.

    3. Wählen Sie Speichern.

Flow Nr. 2: Erstellen einer neuen Logik-App vom Typ Verbrauch

Erstellen Sie den zweiten Flow, Logik-Apps vom Typ „Verbrauch“. Der zweite Workflow wird basierend auf der Rückruf-URL ausgelöst, und die extrahierten Erkenntnisse werden als JSON-Datei in Azure Storage gespeichert.

Die Ablaufschritte sind:

  1. Wenn eine HTTP-Anforderung empfangen wird
  2. HTTP
  3. Videoindex abrufen
  4. Blob erstellen (V2)

Auslöser einrichten

  1. Suchen und wählen Sie Wenn eine HTTP-Anforderung empfangen wird aus.

    Für den Trigger gibt es ein HTTP POST-URL-Feld. Die URL wird erst generiert, nachdem Sie den Fluss gespeichert haben. Die URL wird jedoch letztendlich benötigt.

    Tipp

    Sie kehren später zu der in diesem Schritt erstellten URL zurück.

Erstellen eines Zugriffstokens

Möglicherweise müssen Sie je nach Einrichtung des ersten Zugriffstokens ein weiteres Zugriffstoken generieren. Kopieren Sie es und fügen Sie es in Notepad ein.

  1. Erstellen Sie ein Zugriffstoken.
  2. Wählen Sie Speichern>+ Neuer Schritt aus.

Einrichten zum Abrufen der Video Indexer-Erkenntnisse

  1. Suchen Sie nach Videoindexer.

  2. Wählen Sie in Video Indexer(V2) die Aktion Get Video Index (Videoindex abrufen) aus.

    Legen Sie den Verbindungsnamen fest:

    Schlüssel Wert
    Verbindungsname < Ein Name für die Verbindung>. Beispiel: aviconnection.
    API-Schlüssel Es handelt sich um Ihren persönlichen API-Schlüssel, der unter "Profil" im Entwicklerportal verfügbar ist. Weitere Informationen finden Sie unter Abonnieren der API.

    1. Klicken Sie auf Erstellen.

    2. Setzen Sie die erforderlichen Parameter gemäß der Tabelle ein:

      Schlüssel Wert
      Standort Der Speicherort des Azure AI Video Indexer-Kontos.
      Konto-ID Die Video Indexer-Konto-ID kann von der Seite Übersicht für Ressourcen/Konten im Azure-Portal kopiert werden.
      Video-ID* Fügen Sie als Video-ID den dynamischen Inhalt vom Typ Ausdruck hinzu, und fügen Sie den folgenden Ausdruck ein: triggerOutputs()['queries']['id'].
      Zugriffstoken Wählen Sie im dynamischen Inhalt unter dem Abschnitt JSON-Analyse das accessToken aus, das die Ausgabe der Aktion „JSON-Analyse“ darstellt.

      *Mit diesem Ausdruck wird der Connector angewiesen, die Video-ID aus der Ausgabe Ihres Triggers abzurufen. In diesem Fall ist die Ausgabe Ihres Triggers die Ausgabe von Video hochladen und indizieren in Ihrem ersten Trigger.

    3. Wählen Sie Speichern>+ Neuer Schritt aus.

Erstellen Sie einen Blob, und speichern Sie den JSON-Code mit den Erkenntnissen.

  1. Suchen Sie aus der Gruppe von Aktionen nach Azure-BLOB .

  2. Wählen Sie Blob erstellen (V2) aus.

  3. Legen Sie die Verbindung mit dem BLOB-Speicher fest, in dem die JSON-Insights-Dateien gespeichert werden.

    Schlüssel Wert
    Verbindungsname < Geben Sie einen Namen für die Verbindung ein>.
    Authentifizierungstyp Zugriffsschlüssel
    Name des Azure Storage-Kontos <* Der Name des Speicherkontos, unter dem Einblicke gespeichert werden*>.
    Zugriffsschlüssel für das Azure Storage-Konto Wechseln Sie zum Azure-Portal > mein-speicher > unter Sicherheit + Netzwerkbetrieb>Zugriffsschlüssel > kopieren Sie einen der Schlüssel.
    1. Klicken Sie auf Erstellen.
    2. Legen Sie den Ordner fest, in dem Einblicke gespeichert werden.
    Schlüssel Wert
    Speicherkontoname < Geben Sie den Namen des Speicherkontos ein, der die JSON-Ausgabe enthalten soll (in diesem Tutorial ist es das gleiche wir für das Quellvideo).>
    Ordnerpfad Wählen Sie in der Dropdownliste die /insights aus.
    Blobname Wählen Sie im dynamischen Inhalt im Abschnitt Get Video Index den Eintrag Name aus und fügen Sie _insights.json hinzu. Der Name der Erkenntnis-Datei ist der Videoname und insights.json
    Blob-Dateninhalt Im dynamischen Inhalt, unter dem Abschnitt Get Video Index (Videoindex abrufen), wählen Sie den Body aus.
    1. Wählen Sie Flow speichern aus.

Aktualisieren Sie die Rückruf-URL, damit Sie benachrichtigt werden, wenn ein Indexauftrag abgeschlossen ist.

Nachdem der Workflow gespeichert wurde, wird im Trigger eine HTTP POST-URL erstellt.

  1. Kopieren Sie die URL aus dem Trigger.
  2. Kehren Sie zum ersten Flow zurück, und fügen Sie die URL aus der Aktion Upload video and index (Video hochladen und indizieren) als Parameter für die Rückruf-URL ein.

Achten Sie darauf, dass beide Abläufe gespeichert werden.