Delen via

Gebruiken met een Logic Apps-connector

  • Artikel

Azure AI Video Indexer (VI) REST API ondersteunt zowel server-naar-server- als client-naar-server-communicatie. Met de API kunt u video- en audio-inzichten integreren in uw toepassingslogica.

We ondersteunen Logic Apps - en Power Automate-connectors die compatibel zijn met de Azure AI Video Indexer-API.

U kunt de connectoren gebruiken om aangepaste werkstromen in te stellen waarmee u inzichten doeltreffend kunt indexeren en extraheren uit een grote hoeveelheid video- en audio-bestanden zonder één regel code te schrijven. Door de connectors voor de integratie te gebruiken, krijgt u inzicht in de status van uw werkstroom en kunt u fouten opsporen in de werkstroom.

Inleiding

In het voorbeeld in dit artikel worden logische app-stromen gemaakt. De mogelijkheden van de logische app en Power Automate en hun editors zijn bijna identiek.

De twee stroombenadering, twee stromen die samenwerken, ondersteunen asynchroon uploaden en indexeren van grotere bestanden.

  • De eerste stroom wordt geactiveerd wanneer een blob wordt toegevoegd of gewijzigd in een Azure Storage-account. Het nieuwe bestand wordt geüpload naar Azure AI Video Indexer met een callback-URL om een melding te verzenden zodra de indexeringsbewerking is voltooid.
  • De tweede stroom wordt geactiveerd op basis van de callback-URL en slaat de geëxtraheerde inzichten weer op in een JSON-bestand in Azure Storage.

De logische apps die u in dit artikel maakt, bevatten één stroom per app. In de tweede sectie, Een nieuwe logische app van het typeverbruik maken, wordt uitgelegd hoe u de twee kunt verbinden. De tweede stroom staat alleen en wordt geactiveerd door de eerste.

Wanneer een bestand wordt geüpload en geïndexeerd vanuit de eerste stroom, wordt er een HTTP-aanvraag met de juiste callback-URL verzonden om de tweede stroom te activeren. Vervolgens worden de inzichten opgehaald die worden gegenereerd door Azure AI Video Indexer. In dit voorbeeld wordt de uitvoer van uw indexeringstaak opgeslagen in uw Azure Storage. Het is echter aan u wat u doet met de uitvoer.

Vereisten

  • Als u geen Azure-abonnement hebt, maakt u een gratis Azure-account voordat u begint.
  • Maak een Op ARM gebaseerd Azure AI Video Indexer-account.
  • Een Azure Storage-account maken. Opslagaccounts voor VI moeten een Standaard v2-opslagaccount voor algemeen gebruik zijn. Noteer de toegangssleutel voor uw opslagaccount.
    • Maak twee containers: één om de mediabestanden op te slaan, ten tweede om de inzichten op te slaan die zijn gegenereerd door Azure AI Video Indexer. In dit artikel zijn videos insightsen .

Een toegangstoken genereren

  1. Genereer een toegangstoken met behulp van het generateAccessToken. Druk op Try it om de juiste waarden voor uw account op te halen.
  2. Kopieer en plak deze in Kladblok voor een latere stap.

Stroom 1: De stroom voor het uploaden van bestanden instellen

In deze sectie wordt beschreven hoe u de eerste stroom voor het uploaden van bestanden instelt. De eerste stroom wordt geactiveerd wanneer een blob wordt toegevoegd of gewijzigd in een Azure Storage-account. Het nieuwe bestand wordt geüpload naar Azure AI Video Indexer met een callback-URL om een melding te verzenden zodra de indexeringsbewerking is voltooid.

De stroomstappen zijn:

  1. Wanneer een blob wordt toegevoegd of gewijzigd (alleen eigenschappen) (V2)
  2. SAS-URI maken op pad (V2)
  3. HTTP
  4. Video en index uploaden

De stap Wanneer een blog wordt toegevoegd of gewijzigd (alleen eigenschappen)(V2)

  1. Maak de logische app in dezelfde regio als de Azure Video Indexer-accountregio (aanbevolen maar niet vereist).

  2. Roep de logische app UploadIndexVideosAppaan.

    1. Selecteer Verbruik voor abonnementstype.
    2. Druk op Review + Create ->Create.
    3. Zodra de implementatie van de logische app is voltooid, zoekt u in Azure Portal naar de zojuist gemaakte logische app en gaat u naar de zojuist gemaakte logische app.
    4. Selecteer onder de sectie Instellingen in het deelvenster aan de linkerkant het tabblad Identiteit .
    5. Wijzig onder Systeem toegewezen de status van Uit naar Aan (de stap is belangrijk voor later in deze zelfstudie).
    6. Druk op Opslaan (boven aan de pagina).
    7. Selecteer het tabblad Ontwerpfunctie voor logische apps in het deelvenster aan de linkerkant.
    8. Kies een lege logische app-stroom .
    9. Zoek op de blade Een bewerking kiezen naar 'blob'.
    10. Kies op het tabblad Alles het Azure Blob Storage-onderdeel .
    11. Selecteer onder Triggers de trigger Wanneer een blob wordt toegevoegd of gewijzigd (alleen eigenschappen) (V2).

  3. Maak een trigger Wanneer een blob wordt toegevoegd of gewijzigd (alleen eigenschappen) (V2).

  4. Stel de opslagverbinding in op deze waarden:

    Sleutel Weergegeven als
    Verbindingsnaam <Geef uw verbinding> een naam.
    Authentication type Toegangssleutel
    Azure Storage-accountnaam <Opslagaccountnaam waar mediabestanden worden opgeslagen>.
    Toegangssleutel voor Azure Storage-account Om toegangssleutel van uw opslagaccount op te halen: kopieer een van de sleutels in Azure Portal -> mijn opslag -> onder Beveiliging en netwerken -> Toegangssleutels.>
    1. Selecteer Maken.
    2. Geef de blobopslagcontainer op die wordt bewaakt op wijzigingen.
    Sleutel Weergegeven als
    Naam van het opslagaccount Opslagaccountnaam waarin mediabestanden worden opgeslagen
    Container /videos
    1. Opslaan selecteren ->

SAS-URI maken op pad (V2)

  1. Selecteer + Nieuwe stap.

  2. Maak een SAS-URI op padactie.

    1. Selecteer het tabblad Actie .
    2. Zoek en selecteer SAS-URI maken op pad (V2).
    Sleutel Weergegeven als
    Naam van het opslagaccount <De naam van het opslagaccount waar mediabestanden zijn opgeslagen>.
    Blobpad Selecteer Onder Dynamische inhoud de optie Lijst met bestandspaden
    Id van groepsbeleid Laat de standaardwaarde staan.
    Machtigingen Lezen
    Shared Access-protocol (wordt weergegeven nadat u op Nieuwe parameter toevoegen hebt gedrukt) HttpsOnly
    1. Selecteer Opslaan.

  3. Selecteer +Nieuwe stap.

Een HTTP-actie maken

  1. Zoek en maak een HTTP-actie met behulp van de waarden in de volgende tabel:

    Sleutel Weergegeven als Opmerkingen
    Wijze POST
    URI [Toegangstoken](#generate-een-toegangstoken)
    Hoofdtekst { "permissionType": "Contributor", "scope": "Account" } Zie het VOORBEELD van het REST-document en zorg ervoor dat u de POST-regel verwijdert.
    Nieuwe parameter toevoegen Verificatie
    1. Vul de vereiste parameters voor verificatie in volgens de volgende tabel:
    Sleutel Weergegeven als
    Authentication type Beheerde identiteit
    Beheerde identiteit Door het systeem toegewezen beheerde identiteit
    Doelgroep https://management.core.windows.net
    1. Selecteer Opslaan.

Machtigingen instellen

  1. Stel de machtigingen in tussen de logische app en het Azure AI Video Indexer-account.

  2. Stel door het systeem toegewezen beheerde identiteit in voor machtigingen voor azure AI Video Indexer-resource. Ga in Azure Portal naar uw Azure AI Video Indexer-resource/-account.

    1. Selecteer op de blade aan de linkerkant het toegangsbeheer.
    2. Selecteer Toevoegen ->Roltoewijzing toevoegen ->Inzender -Volgende ->>Gebruiker, groep of service-principal ->+Leden selecteren.
    3. Zoek onder Leden naar de logic apps-naam die u hebt gemaakt (in dit geval UploadIndexVideosApp).
    4. Druk op Selecteren.
    5. Druk op Beoordelen + toewijzen.

Een video- en indexactie uploaden maken

  1. Selecteer Video Indexer(V2).

  2. Selecteer Video en index uploaden in Video Indexer(V2).

  3. Stel de verbinding met het Video Indexer-account in met de parameters in de volgende tabel:

    Sleutel Weergegeven als
    Verbindingsnaam <Voer in dit geval aviconnectioneen naam in voor de verbinding.>
    API key Dit is uw persoonlijke API-sleutel, die beschikbaar is onder Profiel in de ontwikkelaarsportal , omdat deze logische app is bedoeld voor ARM-accounts, hebben we de werkelijke API-sleutel niet nodig en kunt u een dummywaarde invullen, zoals 12345

    1. Selecteer Maken.

    2. Vul de parameters voor video- en indexactie uploaden in.

      Tip

      Als de VI-account-id niet kan worden gevonden en niet in de vervolgkeuzelijst staat, gebruikt u de aangepaste waarde.

      Sleutel Weergegeven als
      Locatie Locatie van het gekoppelde Azure AI Video Indexer-account.
      Rekening-ID Account-id van het gekoppelde Azure AI Video Indexer-account. U vindt de account-id op de overzichtspagina van uw account in Azure Portal. Of het tabblad Accountinstellingen , links van de Website van Azure AI Video Indexer.
      Toegangstoken Gebruik de body('HTTP')['accessToken'] expressie om het toegangstoken in de juiste indeling uit de vorige HTTP-aanroep te extraheren.
      Naam van video Selecteer Lijst met bestandsnamen in de dynamische inhoud van Wanneer een blob wordt toegevoegd of gewijzigd .
      URL van video Selecteer web-URL in de dynamische inhoud van SAS-URI maken per padactie .
      Hoofdtekst Kan standaard worden ingesteld.

    3. Selecteer Opslaan.

Flow 2: Een nieuwe logische app van typeverbruik maken

Maak de tweede stroom, Logic Apps van het typeverbruik. De tweede stroom wordt geactiveerd op basis van de callback-URL en slaat de geëxtraheerde inzichten weer op in een JSON-bestand in Azure Storage.

De stroomstappen zijn:

  1. Wanneer een HTTP-aanvraag is ontvangen
  2. HTTP
  3. Video-index ophalen
  4. Blob maken (V2)

De trigger instellen

  1. Zoek en selecteer de optie Wanneer een HTTP-aanvraag wordt ontvangen.

    Voor de trigger is er een HTTP POST-URL-veld. De URL wordt pas gegenereerd nadat u de stroom hebt opgeslagen. U hebt de URL echter uiteindelijk nodig.

    Tip

    We komen terug naar de URL die in deze stap is gemaakt.

Een toegangstoken genereren

Mogelijk moet u een ander toegangstoken genereren, afhankelijk van hoe u het eerste token instelt. Kopieer en plak deze in Kladblok.

  1. Een toegangstoken genereren.
  2. Selecteer Opslaan -> + Nieuwe stap.

Inzichten ophalen in Video Indexer instellen

  1. Zoek naar 'Video Indexer'.

  2. Selecteer in Video Indexer(V2) de actie Video-index ophalen.

    Stel de verbindingsnaam in:

    Sleutel Weergegeven als
    Verbindingsnaam <Een naam voor verbinding>. Bijvoorbeeld: aviconnection.
    API key Dit is uw persoonlijke API-sleutel, die beschikbaar is onder Profiel in de ontwikkelaarsportal. Zie Abonneren op de API voor meer informatie.

    1. Selecteer Maken.

    2. Vul de vereiste parameters in volgens de tabel:

      Sleutel Weergegeven als
      Locatie De locatie van het Azure AI Video Indexer-account.
      Rekening-ID De Video Indexer-account-id kan worden gekopieerd van de pagina Overzicht van resources/accounts in Azure Portal.
      Video-id* Voor Video-id voegt u dynamische inhoud van het type Expressie toe en plaatst u de volgende expressie: triggerOutputs()['query's']['id'].
      Toegangstoken Selecteer in de dynamische inhoud onder de sectie JSON Parseren het accessToken dat de uitvoer is van de JSON-actie parseren.

      *Deze expressie vertelt de connecter om de video-id op te halen uit de uitvoer van uw trigger. In dit geval is de uitvoer van uw trigger de uitvoer van video en index uploaden in uw eerste trigger.

    3. Selecteer Opslaan -> + Nieuwe stap.

Maak een blob en sla de inzichten JSON op.

  1. Zoek in de groep acties naar 'Azure Blob'.

  2. Selecteer Blob maken(V2).

  3. Stel de verbinding in met de blobopslag waarmee de JSON Insights-bestanden worden opgeslagen.

    Sleutel Weergegeven als
    Verbindingsnaam <Voer een verbindingsnaam> in.
    Authentication type Toegangssleutel
    Azure Storage-accountnaam <* De naam van het opslagaccount waarin inzichten worden opgeslagen*>.
    Toegangssleutel voor Azure Storage-account Ga naar Azure Portal-> mijn-opslag-> onder Beveiliging en netwerken -> Toegangssleutels -> kopieer een van de sleutels.
    1. Selecteer Maken.
    2. Stel de map in waarin inzichten worden opgeslagen.
    Sleutel Weergegeven als
    Naam van het opslagaccount <Voer de naam van het opslagaccount in die de JSON-uitvoer zou bevatten (in deze zelfstudie is hetzelfde als de bronvideo).>
    Folder path Selecteer in de vervolgkeuzelijst de optie /insights
    Blobnaam Selecteer in de dynamische inhoud onder de sectie Video index ophalen de optie Naam en toevoegen _insights.json, de naam van het inzichtenbestand is de naam van de video + insights.json
    Blobinhoud Selecteer in de dynamische inhoud onder de sectie Video-index ophalen de hoofdtekst.
    1. Selecteer Stroom opslaan.

Werk de callback-URL bij om een melding te ontvangen wanneer een indextaak is voltooid.

Zodra de stroom is opgeslagen, wordt er een HTTP POST-URL gemaakt in de trigger.

  1. Kopieer de URL van de trigger.
  2. Ga terug naar de eerste stroom en plak de URL in de actie Video uploaden en indexeren voor de parameter Callback-URL.

Zorg ervoor dat beide stromen zijn opgeslagen.