Freigeben über

Verwenden mit einem Logic Apps-Connector

  • Artikel

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-Flüsse erstellt. Die Funktionen "Logic App" und "Power Automate" und ihre Editoren sind nahezu identisch.

Der zwei Flussansatz, zwei Flüsse, die zusammenarbeiten, unterstützen das asynchrone Hochladen und Indizieren größerer Dateien effektiv.

  • 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 in der Erstellung einer neuen Logik-App vom Typ "Verbrauch" erläutert, 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 KI Video Indexer generierten Erkenntnisse abgerufen. In diesem Beispiel wird die Ausgabe Ihres Indizierungsauftrags auf Ihrer Azure Storage-Instanz gespeichert. Was Sie mit der Ausgabe tun, bleibt Ihnen überlassen.

Voraussetzungen

  • Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Azure-Konto , bevor Sie beginnen.
  • Erstellen Sie ein ARM-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 ihn, und fügen Sie ihn für einen späteren Schritt in Editor ein.

Ablauf Nr. 1: Einrichten des Dateiuploadflusses

In diesem Abschnitt wird beschrieben, wie Sie den ersten Dateiupload, den Fluss 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

Erstellen des Schritts zum Hinzufügen oder Ändern eines Blogs (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 Plantyp Verbrauch 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 aus 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 dem Blatt 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>.
    Authentication type 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-Speichercontainer an, der auf Änderungen überwacht wird.
    Schlüssel Wert
    Speicherkontoname Name des Speicherkontos, in dem Mediendateien gespeichert werden
    Container /videos
    1. Wählen Sie "Speichern" aus –>

Sas-URI nach Pfad erstellen (V2)

  1. +Neuer Schritt auswählen

  2. Erstellen des SAS-URI nach 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
    Method POST
    URI [Zugriffstoken](#generate-an-Access-Token)
    Text { "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
    Authentication type 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. Wählen Sie auf der Registerkarte auf der linken Seite Zugriffssteuerung aus.
    2. Wählen Sie Hinzufügen >Rollenzuweisung hinzufügen >Mitwirkender >Weiter >Benutzer, 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 Upload-Video- und Indexaktion

  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 Dies ist Ihr persönlicher API-Schlüssel, der unter "Profil " im Entwicklerportal verfügbar ist, da diese Logik-App für ARM-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
      Location Speicherort des zugeordneten Azure AI Video Indexer-Kontos.
      Account ID Konto-ID des zugeordneten Azure AI Video Indexer-Kontos. Sie finden Sie Konto-ID auf der Seite Übersicht Ihres Kontos im Azure-Portal. Oder die Registerkarte "Kontoeinstellungen " links der Azure AI Video Indexer-Website.
      Access Token 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.
      Text Die Standardeinstellung kann übernommen werden.

    3. Wählen Sie Speichern.

Ablauf Nr. 2: Erstellen einer neuen Logik-App des Typverbrauchs

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. Beim Empfang einer HTTP-Anforderung
  2. HTTP
  3. Videoindex abrufen
  4. Blob erstellen (V2)

Einrichten des Triggers

  1. Suchen Und wählen Sie aus , wann eine HTTP-Anforderung empfangen wird.

    Für den Trigger gibt es ein HTTP POST-URL-Feld. Die URL wird erst generiert, nachdem Sie Ihren Workflow gespeichert haben. Sie benötigen die URL dann später aber noch.

    Tipp

    Wir kommen später wieder auf die in diesem Schritt erstellte URL zurück.

Erstellen eines Zugriffstokens

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

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

Einrichten von Insights zum Abrufen von Videoindexern

  1. Suchen nach „Video Indexer“.

  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 Dies ist Ihr persönlicher 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
      Location Der Speicherort des Azure AI Video Indexer-Kontos.
      Account 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'].
      Access Token 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 Upload video and index (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 in der Gruppe der Aktionen nach „Azure-Blob“.

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

  3. Legen Sie die Verbindung auf den Blobspeicher fest, in dem die JSON-Insights-Dateien gespeichert werden sollen.

    Schlüssel Wert
    Verbindungsname <Geben Sie einen Namen für die Verbindung ein>.
    Authentication type Zugriffsschlüssel
    Name des Azure Storage-Kontos <* Der Name des Speicherkontos, in dem die Erkenntnisse gespeichert werden sollen*>.
    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 Erkenntnisse gespeichert werden sollen.
    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 unter dem Abschnitt Get Video Index (Videoindex abrufen) Name aus, und fügen Sie _insights.json hinzu. Der Dateiname der Erkenntnisse ist dann der Name des Videos plus „insights.json“.
    Blobinhalt Wählen Sie im dynamischen Inhalt unter dem Abschnitt Get Video Index (Videoindex abrufen) den Textkörper 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 Flows gespeichert werden.