Dela via

Använda med en Logic Apps-anslutningsapp

  • Artikel

REST API för Azure AI Video Indexer (VI) stöder både server-till-server- och klient-till-server-kommunikation. Med API:et kan du integrera video- och ljudinsikter i din programlogik.

Vi stöder Logic Apps - och Power Automate-anslutningsappar som är kompatibla med Azure AI Video Indexer API.

Du kan använda anslutningsapparna för att konfigurera anpassade arbetsflöden för att effektivt indexeras och extrahera insikter från en stor mängd video- och ljudfiler, utan att skriva en enda kodrad. Genom att använda anslutningsapparna för integreringen kan du se hälsotillståndet för arbetsflödet och ett sätt att felsöka det.

Introduktion

Exemplet i den här artikeln skapar Logic App-flöden. Funktionerna Logic App och Power Automate och deras redigerare är nästan identiska.

Den två flödesmetoden, två flöden som fungerar tillsammans, stöder asynkron uppladdning och indexering av större filer effektivt.

  • Det första flödet utlöses när en blob läggs till eller ändras i ett Azure Storage-konto. Den laddar upp den nya filen till Azure AI Video Indexer med en motringnings-URL för att skicka ett meddelande när indexeringsåtgärden är klar.
  • Det andra flödet utlöses baserat på återanrops-URL:en och sparar de extraherade insikterna tillbaka till en JSON-fil i Azure Storage.

De logikappar som du skapar i den här artikeln innehåller ett flöde per app. I det andra avsnittet, Skapa en ny logikapp av typen förbrukning , förklaras hur du ansluter de två. Det andra flödet står ensamt och utlöses av det första.

När en fil laddas upp och indexeras från det första flödet skickar den en HTTP-begäran med rätt motringnings-URL för att utlösa det andra flödet. Sedan hämtar den de insikter som genereras av Azure AI Video Indexer. I det här exemplet lagras utdata från indexeringsjobbet i Azure Storage. Det är dock upp till dig vad du gör med utdata.

Förutsättningar

  • Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
  • Skapa ett ARM-baserat Azure AI Video Indexer-konto.
  • skapa ett Azure Storage-konto Lagringskonton för VI måste vara ett standardlagringskonto för generell användning v2. Anteckna åtkomstnyckeln för ditt Lagringskonto.
    • Skapa två containrar: en för att lagra mediefilerna, för det andra för att lagra de insikter som genereras av Azure AI Video Indexer. I den här artikeln är videos containrarna och insights.

Generera en åtkomsttoken

  1. Generera en åtkomsttoken med hjälp av generateAccessToken. Tryck på Prova för att hämta rätt värden för ditt konto.
  2. Kopiera och klistra in den i Anteckningar för ett senare steg.

Flöde nr 1: Konfigurera filuppladdningsflödet

I det här avsnittet beskrivs hur du konfigurerar den första filuppladdningen, flödet. Det första flödet utlöses när en blob läggs till eller ändras i ett Azure Storage-konto. Den laddar upp den nya filen till Azure AI Video Indexer med en motringnings-URL för att skicka ett meddelande när indexeringsåtgärden är klar.

Flödesstegen är:

  1. När en blob läggs till eller ändras (endast egenskaper) (V2)
  2. Skapa SAS-URI efter sökväg (V2)
  3. HTTP
  4. Ladda upp video och index

Skapa steget När en blogg läggs till eller ändras (endast egenskaper)(V2)

  1. Skapa logikappen i samma region som Azure Video Indexer-kontoregionen (rekommenderas men krävs inte).

  2. Anropa logikappen UploadIndexVideosApp.

    1. Välj Förbrukning som plantyp.
    2. Tryck på Granska + Skapa ->Skapa.
    3. När distributionen av logikappen är klar söker du i Azure-portalen och navigerar till den nyligen skapade logikappen.
    4. Under avsnittet Inställningar väljer du fliken Identitet på den vänstra sidans panel.
    5. Under Systemtilldelat ändrar du Status från Av till På (steget är viktigt för senare i den här självstudien).
    6. Tryck på Spara (överst på sidan).
    7. Välj fliken Logikappdesigner i fönstret till vänster.
    8. Välj ett tomt logic app-flöde .
    9. Sök efter "blob" på bladet Välj en åtgärd .
    10. På fliken Alla väljer du Azure Blob Storage-komponenten .
    11. Under Utlösare väljer du utlösaren När en blob läggs till eller ändras (endast egenskaper) (V2).

  3. Skapa en Utlösare för När en blob läggs till eller ändras (endast egenskaper) (V2).

  4. Ange lagringsanslutningen till följande värden:

    Tangent Värde
    Anslutningens namn <Namnge anslutningen>.
    Authentication type Snabbtangent
    Namn på Azure Storage-konto <Lagringskontonamn där mediefiler ska lagras>.
    Åtkomstnyckel för Azure Storage-konto Så här hämtar du åtkomstnyckeln för ditt lagringskonto: i Azure-portalen –> my-storage –> under Säkerhet + nätverk –> Åtkomstnycklar –> kopierar du en av nycklarna.
    1. Välj Skapa.
    2. Ange den bloblagringscontainer som övervakas för ändringar.
    Tangent Värde
    Lagringskontonamn Lagringskontonamn där mediefiler lagras
    Container /videos
    1. Välj Spara –>

Skapa SAS-URI efter sökväg (V2)

  1. Välj + Nytt steg

  2. Skapa SAS-URI efter sökvägsåtgärd.

    1. Välj fliken Åtgärd .
    2. Sök efter och välj Skapa SAS-URI efter sökväg (V2)..
    Tangent Värde
    Lagringskontonamn <Lagringskontots namn där mediefiler lagras>.
    Blobsökväg Under Dynamiskt innehåll väljer du Sökvägslista för filer
    Grupprincipidentifierare Behåll standardvärdet.
    Behörigheter Läs
    Protokoll för delad åtkomst (visas när du har tryckt på Lägg till ny parameter) HttpsOnly
    1. Välj Spara.

  3. Välj +Nytt steg.

Skapa en HTTP-åtgärd

  1. Sök efter och skapa en HTTP-åtgärd med hjälp av värdena i följande tabell:

    Tangent Värde Kommentar
    Metod POST
    URI [Åtkomsttoken] (#generate-an-access-token)
    Brödtext { "permissionType": "Contributor", "scope": "Account" } Se REST-dokumentexemplet och se till att ta bort POST-raden.
    Lägg till ny parameter Autentisering
    1. Fyll i de obligatoriska parametrarna för autentisering enligt följande tabell:
    Tangent Värde
    Authentication type Hanterade identiteter
    Hanterad identitet Systemtilldelad hanterad identitet
    Målgrupp https://management.core.windows.net
    1. Välj Spara.

Konfigurera behörigheter

  1. Konfigurera behörigheterna mellan logikappen och Azure AI Video Indexer-kontot.

  2. Konfigurera systemtilldelad hanterad identitet för behörighet på Azure AI Video Indexer-resurs. I Azure-portalen går du till din Azure AI Video Indexer-resurs/-konto.

    1. På bladet till vänster väljer du Åtkomstkontroll.
    2. Välj Lägg till ->Lägg till rolltilldelning ->Deltagare ->Nästa ->Användare, grupp eller tjänstens huvudnamn ->+Välj medlemmar.
    3. Under Medlemmar söker du efter det Logic Apps-namn som du skapade (i det här fallet UploadIndexVideosApp).
    4. Tryck på Välj.
    5. Tryck på Granska + tilldela.

Skapa en åtgärd för att ladda upp video och index

  1. Välj Video Indexer(V2).

  2. Från Video Indexer(V2) väljer du Ladda upp video och index.

  3. Ange anslutningen till Video Indexer-kontot med parametrarna i följande tabell:

    Tangent Värde
    Anslutningens namn <Ange ett namn för anslutningen>, i det här fallet aviconnection.
    API key Det här är din personliga API-nyckel, som är tillgänglig under Profil i utvecklarportalen Eftersom den här logikappen är för ARM-konton behöver vi inte den faktiska API-nyckeln och du kan fylla i ett dummy-värde som 12345

    1. Välj Skapa.

    2. Fyll i åtgärdsparametrarna Ladda upp video och index .

      Dricks

      Om VI-konto-ID:t inte kan hittas och inte finns i listrutan använder du det anpassade värdet.

      Tangent Värde
      Plats Plats för det associerade Azure AI Video Indexer-kontot.
      Konto-ID Konto-ID för det associerade Azure AI Video Indexer-kontot. Du hittar konto-ID :t på sidan Översikt för ditt konto i Azure-portalen. Eller fliken Kontoinställningar till vänster om webbplatsen för Azure AI Video Indexer.
      Åtkomsttoken Använd uttrycket body('HTTP')['accessToken'] för att extrahera åtkomsttoken i rätt format från föregående HTTP-anrop.
      Videonamn Välj Lista över filnamn från det dynamiska innehållet i När en blob läggs till eller ändras .
      Video-URL Välj Webb-URL från det dynamiska innehållet i åtgärden Skapa SAS-URI efter sökväg .
      Brödtext Kan lämnas som standard.

    3. Välj Spara.

Flöde nr 2: Skapa en ny logikapp av typen förbrukning

Skapa det andra flödet, Logic Apps av typen consumption. Det andra flödet utlöses baserat på återanrops-URL:en och sparar de extraherade insikterna tillbaka till en JSON-fil i Azure Storage.

Flödesstegen är:

  1. När en HTTP-begäran tas emot
  2. HTTP
  3. Hämta videoindex
  4. Skapa blob (V2)

Konfigurera utlösaren

  1. Sök efter och välj När en HTTP-begäran tas emot.

    För utlösaren finns ett HTTP POST URL-fält. URL:en genereras inte förrän du har sparat flödet. Du behöver dock URL:en så småningom.

    Dricks

    Vi kommer tillbaka till den URL som skapades i det här steget.

Generera en åtkomsttoken

Du kan behöva generera en annan åtkomsttoken beroende på hur du konfigurerar den första. Kopiera och klistra in den i Anteckningar.

  1. Generera en åtkomsttoken.
  2. Välj Spara ->+ Nytt steg.

Konfigurera Hämta Video Indexer-insikter

  1. Sök efter "Video Indexer".

  2. Från Video Indexer(V2) väljer du åtgärden Hämta videoindex .

    Ange anslutningsnamnet:

    Tangent Värde
    Anslutningens namn <Ett namn på anslutningen>. Exempel: aviconnection
    API key Det här är din personliga API-nyckel som är tillgänglig under Profil på utvecklarportalen. Mer information finns i Prenumerera på API:et.

    1. Välj Skapa.

    2. Fyll i de obligatoriska parametrarna enligt tabellen:

      Tangent Värde
      Plats Platsen för Azure AI Video Indexer-kontot.
      Konto-ID Video Indexer-konto-ID:t kan kopieras från resurs-/kontoöversiktssidan i Azure-portalen.
      Video-ID* För Video-ID lägger du till dynamiskt innehåll av typen Uttryck och lägger till följande uttryck: triggerOutputs()['queries']['id'].
      Åtkomsttoken Från det dynamiska innehållet går du till avsnittet Parsa JSON och väljer den accessToken som är utdata för åtgärden parsa JSON.

      *Det här uttrycket instruerar anslutaren att hämta video-ID:t från utdata från utlösaren. I det här fallet är utdata från utlösaren utdata från Ladda upp video och index i din första utlösare.

    3. Välj Spara ->+ Nytt steg.

Skapa en blob och lagra insikternas JSON.

  1. Sök efter "Azure blob" från gruppen med åtgärder.

  2. Välj Skapa blob(V2).

  3. Ange anslutningen till bloblagringen som lagrar JSON Insights-filerna.

    Tangent Värde
    Anslutningens namn <Ange ett anslutningsnamn>.
    Authentication type Snabbtangent
    Namn på Azure Storage-konto <* Namnet på lagringskontot där insikter lagras*>.
    Åtkomstnyckel för Azure Storage-konto Gå till Azure-portalen –> my-storage –> under Säkerhet + nätverk –> Åtkomstnycklar –> kopiera en av nycklarna.
    1. Välj Skapa.
    2. Ange den mapp där insikter ska lagras.
    Tangent Värde
    Lagringskontonamn <Ange namnet på lagringskontot som skulle innehålla JSON-utdata (i den här självstudien är samma som källvideon).>
    Folder path I listrutan väljer du /insights
    Blobnamn I det dynamiska innehållet går du till avsnittet Hämta videoindex och väljer Namn och lägger till _insights.json. Filnamnet för insights blir videonamnet + insights.json
    Blobinnehåll I det dynamiska innehållet går du till avsnittet Hämta videoindex och väljer brödtexten.
    1. Välj Spara flöde.

Uppdatera återanrops-URL:en för att få ett meddelande när ett indexjobb har slutförts.

När flödet har sparats skapas en HTTP POST-URL i utlösaren.

  1. Kopiera URL:en från utlösaren.
  2. Gå tillbaka till det första flödet och klistra in URL:en i åtgärden Ladda upp video och index för parametern Motringnings-URL.

Kontrollera att båda flödena sparas.