Udostępnij za pośrednictwem

Użyj z łącznikiem Logic Apps

Interfejs REST API usługi Azure AI Video Indexer (VI) obsługuje komunikację zarówno między serwerami, jak i między klientem a serwerem. Interfejs API umożliwia integrację szczegółowych informacji wideo i audio z logiką aplikacji.

Obsługujemy konektory Logic Apps i Power Automate, które są zgodne z interfejsem API Azure AI Video Indexer.

Łączniki umożliwiają skonfigurowanie niestandardowych przepływów pracy w celu efektywnego indeksowania i wyodrębniania szczegółowych informacji z dużej ilości plików wideo i audio bez konieczności pisania pojedynczego wiersza kodu. Użycie łączników do integracji zapewnia wgląd w kondycję przepływu pracy i sposób jego debugowania.

Wprowadzenie

Przykład w tym artykule tworzy przepływy logiki aplikacji. Funkcje aplikacji logiki i usługi Power Automate oraz ich edytory są niemal identyczne.

Podejście dwóch przepływów, w którym dwa przepływy współpracują ze sobą, skutecznie obsługuje asynchroniczne przesyłanie i indeksowanie większych plików.

  • Pierwszy przepływ jest wyzwalany po dodaniu lub zmodyfikowaniu obiektu blob na koncie usługi Azure Storage. Przekazuje nowy plik do usługi Azure AI Video Indexer z adresem URL wywołania zwrotnego w celu wysłania powiadomienia po zakończeniu operacji indeksowania.
  • Drugi przepływ wyzwala się na podstawie adresu URL wywołania zwrotnego i zapisuje wyodrębnione informacje z powrotem do pliku JSON w usłudze Azure Storage.

Aplikacje logiki tworzone w tym artykule zawierają jeden przepływ na aplikację. W drugiej sekcji Tworzenie nowej aplikacji logiki typu consumption wyjaśniono, jak połączyć oba. Drugi przepływ działa samodzielnie i jest uruchamiany przez pierwszy.

Gdy plik zostanie załadowany i zaindeksowany z pierwszego przepływu, wysyła żądanie HTTP z poprawnym adresem URL wywołania zwrotnego, aby uruchomić drugi przepływ. Następnie pobiera szczegółowe informacje wygenerowane przez usługę Azure AI Video Indexer. W tym przykładzie dane wyjściowe zadania indeksowania są przechowywane w usłudze Azure Storage. Jednak do Ciebie należy to, co robisz z danymi wyjściowymi.

Wymagania wstępne

  • Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
  • Utwórz konto usługi Azure AI Video Indexer oparte na usłudze Azure Resource Manager.
  • Tworzenie konta usługi Azure Storage. Konta przechowywania dla VI muszą być kontem magazynu ogólnego przeznaczenia w wersji Standardowa v2. Zanotuj klucz dostępu dla konta przechowywania.
    • Utwórz dwa kontenery: jeden do przechowywania plików multimedialnych, drugi do przechowywania szczegółowych informacji generowanych przez usługę Azure AI Video Indexer. W tym artykule kontenery to videos i insights.

Generowanie tokenu dostępu

  1. Wygeneruj token dostępu przy użyciu tokenu generateAccessToken. Naciśnij pozycję Wypróbuj, aby uzyskać poprawne wartości dla konta.
  2. Skopiuj i wklej go do Notatnika, aby wykonać późniejszy krok.

Przepływ nr 1: Konfigurowanie przepływu przekazywania plików

W tej sekcji opisano sposób konfigurowania pierwszego przepływu przekazywania plików. Pierwszy przepływ jest wyzwalany po dodaniu lub zmodyfikowaniu obiektu blob na koncie usługi Azure Storage. Przekazuje nowy plik do usługi Azure AI Video Indexer z adresem URL wywołania zwrotnego w celu wysłania powiadomienia po zakończeniu operacji indeksowania.

Kroki przepływu to:

  1. Po dodaniu lub zmodyfikowaniu bloba (tylko właściwości) (V2)
  2. Utwórz SAS URI według ścieżki (V2)
  3. HTTP
  4. Prześlij wideo i indeks

Utwórz krok Po dodaniu lub zmodyfikowaniu bloga (tylko właściwości)(wersja 2)

  1. Utwórz Logic App w tym samym regionie co konto Azure Video Indexer (zalecane, ale nie wymagane).

  2. Wywołaj aplikację logiki UploadIndexVideosApp.

    1. Wybierz Zużycie jako Typ planu.
    2. Naciśnij Przejrzyj i utwórz ->Utwórz.
    3. Po zakończeniu wdrażania Logic App, w portalu Azure wyszukaj i przejdź do nowo utworzonego Logic App.
    4. W sekcji Ustawienia w panelu po lewej stronie wybierz kartę Tożsamość.
    5. Pod Przypisane przez system, zmień Stan z Wyłączone na Włączone (krok jest ważny w dalszej części tego samouczka).
    6. Naciśnij przycisk Zapisz (w górnej części strony).
    7. Wybierz kartę Projektant aplikacji Logic w lewym panelu.
    8. Wybierz przepływ Blank Logic App.
    9. Wyszukaj ciąg "blob" na stronie Wybieranie operacji .
    10. Na karcie Wszystkie wybierz składnik Azure Blob Storage.
    11. W obszarze Wyzwalacze wybierz wyzwalacz Po dodaniu lub zmodyfikowaniu obiektu blob (tylko właściwości) (wersja 2).

  3. Utwórz wyzwalacz Po dodaniu lub zmodyfikowaniu obiektu blob (tylko właściwości) (wersja 2).

  4. Ustaw połączenie magazynu na następujące wartości:

    Klucz Wartość
    Nazwa połączenia < Nazwij połączenie>.
    Typ uwierzytelniania Klawisz dostępu
    Nazwa konta usługi Azure Storage < Nazwa konta magazynu, w którym będą przechowywane> pliki multimedialne.
    Klucz dostępu do konta usługi Azure Storage Aby uzyskać klucz dostępu konta magazynu: w witrynie Azure Portal — my-storage —> w obszarze > —> dostępu — skopiuj jeden z kluczy.>
    1. Wybierz pozycję Utwórz.
    2. Określ kontener magazynu obiektów blob monitorowany pod kątem zmian.
    Klucz Wartość
    Nazwa konta magazynu Nazwa konta magazynowego, w którym przechowywane są pliki multimedialne
    Kontener /videos
    1. Wybierz pozycję Zapisz —>

Utwórz SAS URI według ścieżki (V2)

  1. Wybierz pozycję +Nowy krok

  2. Utwórz URI sygnatury dostępu współdzielonego według akcji ścieżki.

    1. Wybierz kartę Akcja .
    2. Wyszukaj i wybierz pozycję Utwórz SAS URI według ścieżki (V2).
    Klucz Wartość
    Nazwa konta magazynu < Nazwa konta magazynu, w którym przechowywane są pliki> multimedialne.
    Ścieżka obiektu blob W obszarze Zawartość dynamiczna wybierz pozycję Lista plików Ścieżka
    Identyfikator zasad grupy Pozostaw wartość domyślną.
    Uprawnienia Przeczytaj
    Protokół dostępu współdzielonego (pojawia się po naciśnięciu przycisku Dodaj nowy parametr) HttpsOnly
    1. Wybierz pozycję Zapisz.

  3. Wybierz pozycję +Nowy krok.

Tworzenie akcji HTTP

  1. Wyszukaj i utwórz akcję HTTP przy użyciu wartości w poniższej tabeli:

    Klucz Wartość Uwagi
    Metoda POST
    Identyfikator URI [Token dostępu](#wygeneruj-token-dostępu)
    Ciało { "permissionType": "Contributor", "scope": "Account" } Zapoznaj się z przykładem dokumentu REST, upewnij się, że usunięto wiersz POST .
    Dodaj nowy parametr Uwierzytelnianie
    1. Wypełnij wymagane parametry uwierzytelniania zgodnie z następującą tabelą:
    Klucz Wartość
    Typ uwierzytelniania Tożsamość zarządzana
    Tożsamość zarządzana Tożsamość zarządzana przypisana przez system
    Odbiorcy https://management.core.windows.net
    1. Wybierz pozycję Zapisz.

Konfigurowanie uprawnień

  1. Skonfiguruj uprawnienia między aplikacją logiki a kontem usługi Azure AI Video Indexer.

  2. Skonfiguruj tożsamość zarządzaną przypisaną przez system w celu nadania uprawnień do zasobu Azure AI Video Indexer. W witrynie Azure Portal przejdź do zasobu/konta usługi Azure AI Video Indexer.

    1. Na lewej stronie i wybierz pozycję Kontrola dostępu.
    2. Wybierz pozycję Dodaj -Dodaj przypisanie roli ->Współautor -Dalej ->Użytkownik, grupa lub jednostka usługi -+>Wybierz członków.>
    3. W obszarze Członkowie wyszukaj utworzoną nazwę usługi Logic Apps (w tym przypadku UploadIndexVideosApp).
    4. Naciśnij Wybierz.
    5. Naciśnij Przejrzyj + przypisz.

Stwórz akcję Przekaż wideo i indeksowanie

  1. Wybierz pozycję Video Indexer(V2).

  2. W usłudze Video Indexer (wersja 2) wybierz pozycję Prześlij wideo i indeksuj.

  3. Ustaw połączenie z kontem usługi Video Indexer z parametrami w poniższej tabeli:

    Klucz Wartość
    Nazwa połączenia < Wprowadź nazwę połączenia>, w tym przypadku aviconnection.
    Klucz interfejsu API Jest to osobisty klucz interfejsu API, który jest dostępny w Profilu w portalu dla deweloperów. Ponieważ ta aplikacja logiki jest przeznaczona dla kont usługi Azure Resource Manager, nie potrzebujemy rzeczywistego klucza interfejsu API, więc możesz wprowadzić przykładową wartość, taką jak 12345.

    1. Wybierz pozycję Utwórz.

    2. Uzupełnij parametry akcji Przekaż wideo i indeks.

      Napiwek

      Jeśli nie można odnaleźć identyfikatora konta VI i nie znajduje się na liście rozwijanej, użyj wartości niestandardowej.

      Klucz Wartość
      Lokalizacja Lokalizacja skojarzonego konta usługi Azure AI Video Indexer.
      Identyfikator konta Identyfikator konta skojarzonego konta usługi Azure AI Video Indexer. Identyfikator konta można znaleźć na stronie Przegląd konta w witrynie Azure Portal. Lub zakładka Ustawienia konta po lewej stronie witryny internetowej Azure AI Video Indexer.
      Token dostępu Użyj wyrażenia , body('HTTP')['accessToken'] aby wyodrębnić token dostępu w odpowiednim formacie z poprzedniego wywołania HTTP.
      Nazwa wideo Wybierz pozycję Lista plików Nazwa z zawartości dynamicznej Po dodaniu lub zmodyfikowaniu akcji obiektu blob.
      Adres URL wideo Wybierz adres URL z dynamicznej zawartości akcji Utwórz URI SAS według ścieżki.
      Ciało Może być pozostawiony jako domyślny.

    3. Wybierz pozycję Zapisz.

Przepływ nr 2: Utwórz nową aplikację logiczną typu konsumpcyjnego

Utwórz drugi przepływ typu consumption w usłudze Logic Apps. Drugi przepływ wyzwala się na podstawie adresu URL wywołania zwrotnego i zapisuje wyodrębnione informacje z powrotem do pliku JSON w usłudze Azure Storage.

Kroki przepływu to:

  1. Po odebraniu żądania HTTP
  2. HTTP
  3. Uzyskaj indeks wideo
  4. Utwórz obiekt blob (wersja 2)

Konfigurowanie wyzwalacza

  1. Wyszukaj i wybierz Po odebraniu żądania HTTP.

    W przypadku wyzwalacza znajduje się pole adresu URL POST protokołu HTTP. Adres URL zostanie wygenerowany dopiero po zapisaniu przepływu. Jednak ostatecznie potrzebny jest adres URL.

    Napiwek

    Później wrócisz do adresu URL utworzonego w tym kroku.

Generowanie tokenu dostępu

Może być konieczne wygenerowanie innego tokenu dostępu w zależności od sposobu konfigurowania pierwszego tokenu. Skopiuj i wklej go do Notatnika.

  1. Generowanie tokenu dostępu.
  2. Wybierz pozycję Zapisz ->+ Nowy krok.

Konfigurowanie analizy usługi Video Indexer

  1. Wyszukaj usługę Video Indexer.

  2. W usłudze Video Indexer (wersja 2) wybierz akcję Pobierz indeks wideo.

    Ustaw nazwę połączenia:

    Klucz Wartość
    Nazwa połączenia < Nazwa połączenia>. Na przykład aviconnection.
    Klucz interfejsu API Jest to osobisty klucz interfejsu API, który jest dostępny w obszarze Profil w portalu deweloperów. Aby uzyskać więcej informacji, zobacz Subskrypcja interfejsu API.

    1. Wybierz pozycję Utwórz.

    2. Wypełnij wymagane parametry zgodnie z tabelą:

      Klucz Wartość
      Lokalizacja Lokalizacja konta usługi Azure AI Video Indexer.
      Identyfikator konta Identyfikator konta usługi Video Indexer można skopiować ze strony przeglądu zasobu/konta w portalu Azure.
      Identyfikator wideo* W przypadku identyfikatora wideo dodaj zawartość dynamiczną typu Expression i umieść w następującym wyrażeniu: triggerOutputs()['queries']['id'].
      Token dostępu Z zawartości dynamicznej, pod sekcją Analizowanie JSON, wybierz accessToken, który jest wynikiem akcji Analizowania JSON.

      *To wyrażenie informuje łącznik o pobraniu identyfikatora wideo z danych wyjściowych wyzwalacza. W tym przypadku dane wyjściowe twojego wyzwalacza to dane wyjściowe z przekazywania wideo i indeksowania w twoim pierwszym wyzwalaczu.

    3. Wybierz pozycję Zapisz ->+ Nowy krok.

Utwórz obiekt blob i zapisz JSON z danymi analitycznymi.

  1. Wyszukaj Azure blob w grupie działań.

  2. Wybierz pozycję Utwórz obiekt blob(V2).

  3. Ustaw połączenie z magazynem obiektów blob, który przechowuje pliki szczegółowych informacji JSON.

    Klucz Wartość
    Nazwa połączenia < Wprowadź nazwę> połączenia.
    Typ uwierzytelniania Klawisz dostępu
    Nazwa konta usługi Azure Storage <* Nazwa konta magazynowego, w którym są przechowywane dane analityczne*>.
    Klucz dostępu do konta usługi Azure Storage Przejdź do witryny Azure Portal —> my-storage —> w obszarze Zabezpieczenia i sieć —> klucze dostępu —> skopiuj jeden z kluczy.
    1. Wybierz pozycję Utwórz.
    2. Ustaw folder, w którym są przechowywane szczegółowe informacje.
    Klucz Wartość
    Nazwa konta magazynu < Wprowadź nazwę konta magazynowego, które będzie zawierać dane wyjściowe JSON (w tym samouczku jest taka sama jak wideo źródłowego).>
    Ścieżka do folderu Z listy rozwijanej wybierz /insights
    Nazwa obiektu blob Z zawartości dynamicznej w sekcji Pobierz indeks wideo wybierz pozycję Nazwa i dodaj ._insights.json Nazwa pliku szczegółowych informacji to nazwa wideo i insights.json
    Zawartość obiektu blob W zawartości dynamicznej, w sekcji Pobierz indeks wideo, wybierz Treść.
    1. Wybierz Zapisz przepływ.

Zaktualizuj adres URL zwrotnego wywołania, aby otrzymywać powiadomienia, gdy zakończono zadanie indeksowania.

Po zapisaniu przepływu w wyzwalaczu zostanie utworzony adres URL HTTP POST.

  1. Skopiuj adres URL z wyzwalacza.
  2. Wróć do pierwszego przepływu pracy i wklej adres URL w akcji Prześlij wideo i indeks dla parametru Adres URL wywołania zwrotnego.

Upewnij się, że oba przepływy zostały zapisane.