Używanie z łącznikiem usługi Logic Apps

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

Obsługujemy łączniki usługi Logic Apps i Power Automate zgodne z interfejsem API usługi 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 aplikacji logiki. Funkcje aplikacji logiki i usługi Power Automate oraz ich edytory są niemal identyczne.

Dwa podejście przepływu, dwa przepływy, które współpracują ze sobą, obsługują asynchroniczne przekazywanie i indeksowanie większych plików skutecznie.

• 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 jest wyzwalany na podstawie adresu URL wywołania zwrotnego i zapisuje wyodrębnione szczegółowe 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 użycia typu wyjaśniono, jak nawiązać połączenie z nimi. Drugi przepływ jest sam i jest wyzwalany przez pierwszy.

Gdy plik zostanie przekazany i zaindeksowany z pierwszego przepływu, wysyła żądanie HTTP z poprawnym adresem URL wywołania zwrotnego w celu wyzwolenia drugiego przepływu. Następnie pobierze szczegółowe informacje wygenerowane przez usługę Azure AI Video Indexer. W tym przykładzie dane wyjściowe zadania indeksowania będą 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 ARM.
• Tworzenie konta usługi Azure Storage. Konta magazynu dla vi muszą być kontem magazynu ogólnego przeznaczenia w warstwie Standardowa w wersji 2. Zanotuj klucz dostępu dla konta magazynu.
  • 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 obiektu blob (tylko właściwości) (wersja 2)
2. Tworzenie identyfikatora URI sygnatury dostępu współdzielonego według ścieżki (wersja 2)
3. HTTP
4. Przekazywanie wideo i indeksu

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

1. Utwórz aplikację logiki w tym samym regionie co region konta usługi Azure Video Indexer (zalecane, ale nie jest to wymagane).

2. Wywołaj aplikację UploadIndexVideosApplogiki .

   1. Wybierz pozycję Zużycie dla pozycji Typ planu.
   2. Naciśnij pozycję Przejrzyj i utwórz -> Utwórz.
   3. Po zakończeniu wdrażania aplikacji logiki w witrynie Azure Portal wyszukaj i przejdź do nowo utworzonej aplikacji logiki.
   4. W sekcji Ustawienia w panelu po lewej stronie wybierz kartę Tożsamość.
   5. W obszarze Przypisany system zmień wartość Stan z Wyłączone na Wł . (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 logiki w okienku po lewej stronie.
   8. Wybierz pusty przepływ aplikacji logiki.
   9. Wyszukaj ciąg "blob" w bloku Wybierz operację .
   10. Na karcie Wszystkie wybierz składnik Usługi 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:

   Key	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 Zabezpieczenia i sieć —> klucze dostępu —> skopiuj jeden z kluczy.>

   1. Wybierz pozycję Utwórz.
   2. Określ kontener magazynu obiektów blob monitorowany pod kątem zmian.

   Key	Wartość
   Nazwa konta magazynu	Nazwa konta magazynu, w którym są przechowywane pliki multimedialne
   Kontener	/videos

   1. Wybierz pozycję Zapisz —>

Tworzenie identyfikatora URI sygnatury dostępu współdzielonego według ścieżki (wersja 2)

1. Wybierz pozycję +Nowy krok

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

   1. Wybierz kartę Akcja .
   2. Wyszukaj i wybierz pozycję Utwórz identyfikator URI sygnatury dostępu współdzielonego według ścieżki (V2).

   Key	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:

   Key	Wartość	Uwagi
   Method	POST
   Identyfikator URI	[Token dostępu](#generate token dostępu)
   Treść	{ "permissionType": "Contributor", "scope": "Account" }	Zapoznaj się z przykładem dokumentu REST, upewnij się, że usunięto wiersz POST .
   Dodaj nowy parametr	Authentication

   1. Wypełnij wymagane parametry uwierzytelniania zgodnie z następującą tabelą:

   Key	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 pod kątem uprawnień do zasobu usługi Azure AI Video Indexer. W witrynie Azure Portal przejdź do zasobu/konta usługi Azure AI Video Indexer.

   1. W bloku po lewej stronie 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 pozycję Wybierz.
   5. Naciśnij pozycję Przejrzyj i przypisz.

Tworzenie akcji Przekaż wideo i indeks

1. Wybierz pozycję Video Indexer(V2).

2. W usłudze Video Indexer (wersja 2) wybierz pozycję Przekaż wideo i indeks.

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

   Key	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 obszarze Profil w portalu dla deweloperów, ponieważ ta aplikacja logiki jest dla kont usługi ARM nie potrzebujemy rzeczywistego klucza interfejsu API i możesz wypełnić fikcyjną wartość, taką jak 12345

   1. Wybierz pozycję Utwórz.

   2. Wypeł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.

      Key	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. Możesz też karty Ustawienia konta po lewej stronie witryny internetowej usługi 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 pozycję Internetowy adres URL z dynamicznej zawartości akcji Utwórz identyfikator URI sygnatury dostępu współdzielonego według ścieżki .
      Treść	Może być pozostawiony jako domyślny.

   3. Wybierz pozycję Zapisz.

Przepływ nr 2: Tworzenie nowej aplikacji logiki o użyciu typu

Utwórz drugi przepływ usługi Logic Apps o użyciu typu. Drugi przepływ jest wyzwalany na podstawie adresu URL wywołania zwrotnego i zapisuje wyodrębnione szczegółowe informacje z powrotem do pliku JSON w usłudze Azure Storage.

Kroki przepływu to:

1. Po odebraniu żądania HTTP
2. HTTP
3. Pobieranie indeksu wideo
4. Tworzenie obiektu blob (wersja 2)

Konfigurowanie wyzwalacza

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

   W przypadku wyzwalacza istnieje pole adresu URL POST protokołu HTTP. Adres URL nie zostanie wygenerowany dopiero po zapisaniu przepływu; jednak adres URL będzie potrzebny w końcu.

   Napiwek

   Wrócimy 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 funkcji Uzyskiwanie szczegółowych informacji usługi Video Indexer

1. Wyszukaj ciąg "Video Indexer".

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

   Ustaw nazwę połączenia:

   Key	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 Subskrybowanie interfejsu API.

   1. Wybierz pozycję Utwórz.

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

      Key	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 witrynie Azure Portal.
      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 w sekcji Analizowanie kodu JSON wybierz wartość accessToken , która jest wynikiem akcji analizowania kodu JSON.

      *To wyrażenie informuje łącznik o pobraniu identyfikatora wideo z danych wyjściowych wyzwalacza. W takim przypadku dane wyjściowe wyzwalacza będą danymi wyjściowymi przekazywania wideo i indeksu w pierwszym wyzwalaczu.

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

Utwórz obiekt blob i zapisz szczegółowe dane JSON.

1. Wyszukaj ciąg "Azure Blob" z grupy akcji.

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

3. Ustaw połączenie z magazynem obiektów blob, które będą przechowywać pliki szczegółowych informacji JSON.

   Key	Wartość
   Nazwa połączenia	<Wprowadź nazwę> połączenia.
   Typ uwierzytelniania	Klawisz dostępu
   Nazwa konta usługi Azure Storage	<* Nazwa konta magazynu, w którym będą przechowywane szczegółowe informacje*>.
   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 będą przechowywane szczegółowe informacje.

   Key	Wartość
   Nazwa konta magazynu	<Wprowadź nazwę konta magazynu, która będzie zawierać dane wyjściowe JSON (w tym samouczku jest taka sama jak źródłowa wideo).>
   Folder path	Z listy rozwijanej wybierz ikonę /insights
   Nazwa obiektu blob	Z zawartości dynamicznej w sekcji Pobierz indeks wideo wybierz pozycję Nazwa i dodaj _insights.jsonnazwę pliku szczegółowych informacji będzie nazwą wideo i insights.json
   Zawartość obiektu blob	W zawartości dynamicznej w sekcji Pobierz indeks wideo wybierz pozycję Treść.

   1. Wybierz pozycję Zapisz przepływ.

Zaktualizuj adres URL wywołania zwrotnego, aby otrzymywać powiadomienia po zakończeniu zadania indeksu.

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

1. Skopiuj adres URL z wyzwalacza.
2. Wróć do pierwszego przepływu i wklej adres URL w akcji Przekaż wideo i indeks dla parametru Adresu URL wywołania zwrotnego.

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