Sdílet prostřednictvím

Použití s konektorem Logic Apps

  • Článek

Rozhraní REST API služby Azure AI Video Indexer (VI) podporuje komunikaci mezi servery i klientem a serverem. Rozhraní API umožňuje integrovat video a zvukové přehledy do logiky vaší aplikace.

Podporujeme konektory Logic Apps a Power Automate , které jsou kompatibilní s rozhraním API Azure AI Video Indexeru.

Pomocí konektorů můžete nastavit vlastní pracovní postupy, které efektivně indexují a extrahují přehledy z velkého množství videosouborů a zvukových souborů, aniž byste museli psát jediný řádek kódu. Použití konektorů pro integraci vám poskytne přehled o stavu pracovního postupu a o způsobu, jak ho ladit.

Úvod

Příklad v tomto článku vytvoří toky aplikace logiky. Možnosti aplikace logiky a Power Automate a jejich editory jsou téměř stejné.

Dva toky, dva toky, které spolupracují, podporují asynchronní nahrávání a indexování větších souborů.

  • První tok se aktivuje při přidání nebo změně objektu blob v účtu služby Azure Storage. Nahraje nový soubor do Azure AI Video Indexeru s adresou URL zpětného volání, aby po dokončení operace indexování odeslal oznámení.
  • Druhý tok se aktivuje na základě adresy URL zpětného volání a uloží extrahované přehledy zpět do souboru JSON ve službě Azure Storage.

Aplikace logiky, které vytvoříte v tomto článku, obsahují jeden tok na aplikaci. Druhá část: Vytvoření nové aplikace logiky s využitím typu vysvětluje, jak tyto dvě aplikace propojit. Druhý tok stojí sám a aktivuje se prvním tokem.

Když se soubor nahraje a indexuje z prvního toku, odešle požadavek HTTP se správnou adresou URL zpětného volání, která aktivuje druhý tok. Pak načte přehledy vygenerované službou Azure AI Video Indexer. V tomto příkladu uloží výstup úlohy indexování ve službě Azure Storage. Je ale na vás, co s výstupem děláte.

Požadavky

  • Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure, než začnete.
  • Vytvořte účet Azure AI Video Indexer založený na ARM.
  • Vytvořit účet služby Azure Storage Účty úložiště pro VI musí být účtem úložiště úrovně Standard pro obecné účely verze 2. Poznamenejte si přístupový klíč pro váš účet úložiště.
    • Vytvořte dva kontejnery: jeden pro ukládání mediálních souborů, druhý pro ukládání přehledů vygenerovaných službou Azure AI Video Indexer. V tomto článku jsou videos kontejnery a insights.

Vygenerování přístupového tokenu

  1. Vygenerujte přístupový token pomocí generateAccessTokenu. Stiskněte try it to get the correct values for your account.
  2. Zkopírujte ho a vložte ho do Poznámkového bloku pro pozdější krok.

Tok č. 1: Nastavení toku nahrávání souborů

Tato část popisuje, jak nastavit první, nahrání souboru, tok. První tok se aktivuje při přidání nebo změně objektu blob v účtu služby Azure Storage. Nahraje nový soubor do Azure AI Video Indexeru s adresou URL zpětného volání, aby po dokončení operace indexování odeslal oznámení.

Postup toku:

  1. Při přidání nebo změně objektu blob (pouze vlastnosti) (V2)
  2. Vytvoření identifikátoru URI SAS podle cesty (V2)
  3. HTTP
  4. Nahrání videa a indexu

Vytvoření kroku Při přidání nebo změně blogu (pouze vlastnosti)(V2)

  1. Vytvořte aplikaci logiky ve stejné oblasti jako oblast účtu Azure Video Indexeru (doporučeno, ale nevyžaduje se).

  2. Volání aplikace UploadIndexVideosApplogiky .

    1. Vyberte Consumption pro typ plánu.
    2. Stiskněte zkontrolovat a vytvořit ->Vytvořit.
    3. Po dokončení nasazení aplikace logiky na webu Azure Portal vyhledejte a přejděte do nově vytvořené aplikace logiky.
    4. V části Nastavení vyberte na panelu na levé straně kartu Identita.
    5. V části Přiřazený systém změňte stav z Vypnuto na Zapnuto (krok je důležitý pro pozdější použití v tomto kurzu).
    6. Stiskněte uložit (v horní části stránky).
    7. V podokně vlevo vyberte kartu Návrhář aplikace logiky.
    8. Vyberte prázdný tok aplikace logiky.
    9. V okně Zvolit operaci vyhledejte "blob".
    10. Na kartě Vše zvolte komponentu Azure Blob Storage.
    11. V části Triggery vyberte trigger Při přidání nebo změně objektu blob (pouze vlastnosti) (v2).

  3. Vytvoření triggeru Při přidání nebo změně objektu blob (pouze vlastnosti) (V2)

  4. Nastavte připojení úložiště k těmto hodnotám:

    Key Hodnota
    Název připojení <Pojmenujte připojení>.
    Authentication type Přístupová klávesa
    Název účtu služby Azure Storage <Název účtu úložiště, kam se budou ukládat> mediální soubory.
    Přístupový klíč účtu služby Azure Storage Přístupový klíč účtu úložiště získáte tak, že na webu Azure Portal –> my-storage –> v části Zabezpečení + sítě –> Přístupové klíče –> zkopírujte jeden z těchto klíčů.
    1. Vyberte Vytvořit.
    2. Zadejte kontejner úložiště objektů blob, který se monitoruje pro změny.
    Key Hodnota
    Název účtu úložiště Název účtu úložiště, ve kterém jsou uložené mediální soubory
    Kontejner /videos
    1. Vyberte Uložit –>

Vytvoření identifikátoru URI SAS podle cesty (V2)

  1. Vyberte +Nový krok.

  2. Vytvoření identifikátoru URI SAS podle akce cesty

    1. Vyberte kartu Akce.
    2. Vyhledejte a vyberte Vytvořit identifikátor URI SAS podle cesty (V2).
    Key Hodnota
    Název účtu úložiště <Název účtu úložiště, ve kterém jsou uložené> mediální soubory.
    Cesta k objektu blob V části Dynamický obsah vyberte Seznam cest k souborům.
    Identifikátor zásad skupiny Nechte zadanou výchozí hodnotu.
    Oprávnění Přečíst
    Sdílený přístupový protokol (zobrazí se po stisknutí tlačítka Přidat nový parametr) HttpsOnly
    1. Zvolte Uložit.

  3. Vyberte +Nový krok.

Vytvoření akce HTTP

  1. Pomocí hodnot v následující tabulce vyhledejte a vytvořte akci HTTP :

    Key Hodnota Notes
    metoda POST
    Identifikátor URI [Přístupový token](#generate přístupový token)
    Text { "permissionType": "Contributor", "scope": "Account" } Podívejte se na příklad dokumentu REST a nezapomeňte odstranit řádek POST .
    Přidat nový parametr Authentication
    1. Vyplňte požadované parametry pro ověřování podle následující tabulky:
    Key Hodnota
    Authentication type Spravovaná identita
    Spravovaná identita Spravovaná identita přiřazená systémem
    Cílová skupina https://management.core.windows.net
    1. Zvolte Uložit.

Nastavení oprávnění

  1. Nastavte oprávnění mezi aplikací logiky a účtem Azure AI Video Indexeru.

  2. Nastavte spravovanou identitu přiřazenou systémem pro oprávnění k prostředku Azure AI Video Indexer. Na webu Azure Portal přejděte k prostředku nebo účtu Azure AI Video Indexeru.

    1. V levém okně a vyberte Řízení přístupu.
    2. Vyberte Přidat ->Přidat přiřazení role -Přispěvatel ->Další ->>Uživatel, skupina nebo instanční objekt ->+Vybrat členy.
    3. V části Členové vyhledejte název Logic Apps, který jste vytvořili (v tomto případě UploadIndexVideosApp).
    4. Stiskněte vybrat.
    5. Stiskněte Tlačítko Zkontrolovat a přiřadit.

Vytvoření akce nahrání videa a indexu

  1. Vyberte Video Indexer(V2).

  2. V video indexeru (V2) vyberte Nahrát video a index.

  3. Nastavte připojení k účtu Video Indexeru s parametry v následující tabulce:

    Key Hodnota
    Název připojení <Zadejte název připojení>, v tomto případě aviconnection.
    Klíč rozhraní API Toto je váš osobní klíč rozhraní API, který je k dispozici v části Profil na portálu pro vývojáře, protože tato aplikace logiky je pro účty ARM, nepotřebujeme skutečný klíč rozhraní API a můžete vyplnit fiktivní hodnotu, jako je 12345.

    1. Vyberte Vytvořit.

    2. Vyplňte parametry akce Nahrát video a index .

      Tip

      Pokud se ID účtu VI nenašlo a není v rozevíracím seznamu, použijte vlastní hodnotu.

      Key Hodnota
      Umístění Umístění přidruženého účtu Azure AI Video Indexeru
      ID účtu ID účtu přidruženého účtu Azure AI Video Indexeru ID účtu najdete na stránce Přehled vašeho účtu na webu Azure Portal. Nebo na kartě Nastavení účtu vlevo od webu Azure AI Video Indexer.
      Token přístupu Pomocí výrazu body('HTTP')['accessToken'] extrahujte přístupový token ve správném formátu z předchozího volání HTTP.
      Název videa Vyberte Seznam názvů souborů z dynamického obsahu akce Při přidání nebo změně objektu blob.
      Adresa URL videa Vyberte webovou adresu URL z dynamického obsahu akce Vytvořit identifikátor URI SAS podle cesty .
      Text Ve výchozím nastavení je možné ponechat výchozí nastavení.

    3. Zvolte Uložit.

Flow č. 2: Vytvoření nové aplikace logiky s využitím typu

Vytvořte druhý tok, Logic Apps typu consumption. Druhý tok se aktivuje na základě adresy URL zpětného volání a uloží extrahované přehledy zpět do souboru JSON ve službě Azure Storage.

Postup toku:

  1. Při přijetí požadavku HTTP
  2. HTTP
  3. Získání indexu videa
  4. Vytvoření objektu blob (V2)

Nastavení triggeru

  1. Vyhledejte a vyberte Při přijetí požadavku HTTP.

    Pro trigger existuje pole adresy URL HTTP POST. Adresa URL se nevygeneruje, dokud tok neuložíte. Ale nakonec budete potřebovat adresu URL.

    Tip

    Vrátíme se k adrese URL vytvořené v tomto kroku.

Vygenerování přístupového tokenu

V závislosti na tom, jak nastavíte první přístupový token, může být potřeba vygenerovat další přístupový token. Zkopírujte ho a vložte ho do Poznámkového bloku.

  1. Vygenerujte přístupový token.
  2. Vyberte Uložit ->+ Nový krok.

Nastavení získání přehledů Video Indexeru

  1. Vyhledejte "Video Indexer".

  2. V aplikaci Video Indexer(V2) vyberte akci Získat index videa.

    Nastavte název připojení:

    Key Hodnota
    Název připojení <Název připojení>. Například aviconnection.
    Klíč rozhraní API Toto je váš osobní klíč rozhraní API, který je k dispozici v části Profil na portálu pro vývojáře. Další informace najdete v tématu Přihlášení k odběru rozhraní API.

    1. Vyberte Vytvořit.

    2. Vyplňte požadované parametry podle tabulky:

      Key Hodnota
      Umístění Umístění účtu Azure AI Video Indexer.
      ID účtu ID účtu Video Indexeru je možné zkopírovat ze stránky Přehled prostředku nebo účtu na webu Azure Portal.
      ID videa* Pro ID videa přidejte dynamický obsah typu Výraz a vložte ho do následujícího výrazu: triggerOutputs()['queries']['id'].
      Token přístupu V dynamickém obsahu v části Parsovat JSON vyberte accessToken , který je výstupem akce parsovat JSON.

      *Tento výraz říká connecteru, aby získal ID videa z výstupu triggeru. V tomto případě bude výstupem triggeru výstup nahrání videa a indexu v prvním triggeru.

    3. Vyberte Uložit ->+ Nový krok.

Vytvořte objekt blob a uložte JSON přehledů.

  1. Vyhledejte "Objekt blob Azure" ze skupiny akcí.

  2. Vyberte Vytvořit objekt blob(V2).a0>

  3. Nastavte připojení k úložišti objektů blob, do kterého se budou ukládat soubory přehledů JSON.

    Key Hodnota
    Název připojení <Zadejte název> připojení.
    Authentication type Přístupová klávesa
    Název účtu služby Azure Storage <* Název účtu úložiště, kde se budou ukládat přehledy*>.
    Přístupový klíč účtu služby Azure Storage Přejděte na Web Azure Portal –> my-storage –> v části Zabezpečení + sítě –> Přístupové klíče –> zkopírujte jeden z těchto klíčů.
    1. Vyberte Vytvořit.
    2. Nastavte složku, ve které se budou ukládat přehledy.
    Key Hodnota
    Název účtu úložiště <Zadejte název účtu úložiště, který by obsahoval výstup JSON (v tomto kurzu je stejný jako zdrojové video).>
    Folder path V rozevíracím seznamu vyberte tlačítko /insights
    Název objektu blob Z dynamického obsahu v části Získat index videa vyberte Název a přidejte _insights.jsonnázev souboru přehledů bude název videa + insights.json
    Obsah objektu blob V dynamickém obsahu v části Získat index videa vyberte text.
    1. Vyberte Uložit tok.

Aktualizujte adresu URL zpětného volání, aby se po dokončení úlohy indexu dostávala oznámení.

Po uložení toku se v triggeru vytvoří adresa URL HTTP POST.

  1. Zkopírujte adresu URL z triggeru.
  2. Vraťte se k prvnímu toku a vložte adresu URL do akce Nahrát video a index pro parametr adresa URL zpětného volání.

Ujistěte se, že jsou oba toky uložené.