Поделиться через

Использование с соединителем Logic Apps

API REST Azure AI Video Indexer (VI) поддерживает обмен данными как между серверами, так и между клиентом и сервером. API позволяет интегрировать видео и звуковую аналитику в логику приложения.

Мы поддерживаем коннекторы Logic Apps и Power Automate, совместимые с API индексатора видео Azure.

С помощью этих соединителей можно настроить пользовательские рабочие процессы для эффективного индексирования и извлечения полезных сведений из большого количества файлов видео и аудио без написания кода. Использование соединителей для интеграции обеспечивает видимость работоспособности рабочего процесса и способ ее отладки.

Введение

В этом примере создаются потоки Logic App. Возможности приложения логики и Power Automate и их редакторы практически идентичны.

Двухпоточный подход с потоками, работающими вместе, эффективно поддерживает асинхронную загрузку и индексирование больших файлов.

  • Первый поток активируется при добавлении или изменении BLOB в учётной записи службы хранения Azure. Он отправляет новый файл в Индексатор видео Azure AI с URL-адресом обратного вызова, чтобы отправить уведомление после завершения операции индексирования.
  • Второй поток активируется запросом на URL-адрес обратного вызова и сохраняет извлеченные полезные данные обратно в JSON-файл, размещенный в службе хранилища Azure.

Приложения логики, создаваемые в этой статье, содержат один поток для каждого приложения. Второй раздел, создание нового логического приложения типа "потребление", объясняет, как соединить эти два элемента. Второй поток стоит в одиночку и активируется первым.

Когда файл отправляется и индексируется из первого потока, он отправляет HTTP-запрос с правильным URL-адресом обратного вызова, чтобы активировать второй поток. Затем он извлекает аналитические сведения, созданные индексатором видео Azure AI. В этом примере он сохраняет выходные данные задания индексирования в службе хранилища Azure. Однако, решать вам, как поступить с результатами.

Предварительные условия

  • Если у вас нет подписки на Azure, создайте бесплатную учетную запись Azure перед началом.
  • Создайте учетную запись индексатора видео на основе Azure Resource Manager.
  • Создайте учетную запись Службы хранилища Azure. Учетные записи хранения для VI должны быть универсальной учетной записью хранения версии 2 уровня стандартный. Сохраните ключ доступа к учетной записи хранения.
    • Создайте два контейнера: один для хранения файлов мультимедиа, второй для хранения аналитических сведений, созданных индексатором видео Azure AI. В этой статье контейнеры являются videos и insights.

Генерация токена доступа

  1. Создайте маркер доступа с помощью generateAccessToken. Нажмите клавишу TRY , чтобы получить правильные значения для вашей учетной записи.
  2. Скопируйте и вставьте его в Блокнот для последующего шага.

Поток #1. Настройка потока отправки файлов

В этом разделе описывается настройка первого потока загрузки файлов. Первый поток активируется при добавлении или изменении BLOB в учётной записи службы хранения Azure. Он отправляет новый файл в Индексатор видео Azure AI с URL-адресом обратного вызова, чтобы отправить уведомление после завершения операции индексирования.

Этапы потока:

  1. При добавлении или изменении большого двоичного объекта (только свойств) (версия 2)
  2. Создание URI SAS по пути (V2)
  3. HTTP
  4. Отправка видео и индекс

Создайте шаг "Когда блог добавляется или изменяется (только свойства)(V2)"

  1. Создайте Logic App в том же регионе, что и регион учетной записи Azure Video Indexer (рекомендуется, но не обязательно).

  2. Вызовите логическое приложение UploadIndexVideosApp.

    1. Выберите Потребление для типа плана.
    2. Нажмите Рецензирование + Создать ->Создать.
    3. После завершения развертывания приложения логики на портале Azure, поиске и переходе к созданному приложению логики.
    4. В разделе "Настройки" на панели слева выберите вкладку "Идентификация".
    5. В разделе Назначаемое системой измените Статус с Отключено на Включено (этот шаг важен для последующих шагов в этом руководстве).
    6. Нажмите кнопку "Сохранить " (в верхней части страницы).
    7. Выберите вкладку Дизайнер Logic Apps в панели слева.
    8. Выберите поток пустого приложения логики.
    9. Найдите "БОЛЬШОЙ двоичный объект" на странице "Выбор операции ".
    10. На вкладке "Все" выберите компонент Хранилище BLOB-объектов Azure.
    11. В разделе «Триггеры» выберите триггер «Когда блоб добавляется или изменяется (только свойства) (версия 2)».

  3. Создайте триггер "Когда объект добавлен или изменен (только свойства)" (V2).

  4. Задайте для подключения к хранилищу следующие значения:

    Ключ Значение
    Имя подключения < Присвойте подключению> имя.
    Тип аутентификации Ключ доступа
    имя учетной записи службы хранилища Azure < Имя учетной записи хранения, в которой будут храниться> файлы мультимедиа.
    ключ доступа к учетной записи хранилища Azure Чтобы получить ключ доступа вашей учетной записи хранения: на портале Azure -> my-storage -> в разделе Безопасность + сеть ->Ключи доступа -> скопируйте один из ключей.
    1. Нажмите кнопку создания.
    2. Укажите контейнер хранилища BLOB, который отслеживается на предмет изменений.
    Ключ Значение
    Имя учетной записи хранилища Имя учетной записи хранения, в которой хранятся файлы мультимедиа
    Контейнер /videos
    1. Нажмите кнопку " Сохранить ">

Создание URI SAS по пути (V2)

  1. Выберите +Создать шаг.

  2. Создайте SAS URI на основе действия пути.

    1. Перейдите на вкладку "Действие ".
    2. Найдите и выберите Create SAS URI by path (V2).
    Ключ Значение
    Имя учетной записи хранилища < Имя учетной записи хранения, в которой хранятся> файлы мультимедиа.
    Путь к Blob В разделе Динамическое содержимое выберите Список путей файлов
    Идентификатор групповой политики Оставьте значение по умолчанию.
    Разрешения Прочитайте
    Протокол общего доступа (отображается после нажатия клавиши Add new parameter) HttpsOnly
    1. Выберите Сохранить.

  3. Выберите + Новый шаг.

Создание действия HTTP

  1. Выполните поиск и создайте действие HTTP с помощью значений в следующей таблице:

    Ключ Значение Примечания.
    Способ ПОМЕСТИТЬ
    УРИ [Токен доступа](#сгенерировать-токен-доступа)
    Тело { "permissionType": "Contributor", "scope": "Account" } Ознакомьтесь с примером документации REST, не забудьте удалить строку POST.
    Добавление нового параметра Аутентификация
    1. Заполните необходимые параметры для проверки подлинности в соответствии со следующей таблицей:
    Ключ Значение
    Тип аутентификации Управляемое удостоверение
    Идентификация с управлением доступом Системное управляемое удостоверение
    Аудитория https://management.core.windows.net
    1. Выберите Сохранить.

Настройка разрешений

  1. Настройте разрешения между приложением логики и учетной записью индексатора видео Azure AI.

  2. Настройте системное управляемое удостоверение для предоставления разрешений на ресурсе Индексатора видео в Azure AI. На портале Azure перейдите к ресурсу или учетной записи вашего индексатора видео в Azure AI.

    1. На левой странице выберите Управление доступом.
    2. Выберите Добавить ->Добавить назначение роли ->Соавтор ->Далее ->Пользователь, группа или основной участник службы ->+Выбрать участников.
    3. В разделе "Члены" найдите созданное вами имя Logic Apps (в данном случае UploadIndexVideosApp).
    4. Нажмите кнопку Выбрать.
    5. Нажмите кнопку "Рецензирование и назначение".

Создать действие загрузки видео и индексации

  1. Выберите Индексатор видео (V2).

  2. В индексаторе видео (V2) выберите "Отправить видео" и "Индекс".

  3. Задайте подключение к учетной записи Индексатора видео с параметрами в следующей таблице:

    Ключ Значение
    Имя подключения < Введите имя подключения> в данном случае aviconnection.
    Ключ API Это ваш личный ключ API, который доступен в разделе "Профиль " на портале разработчика , так как это приложение логики предназначено для учетных записей Azure Resource Manager, нам не нужен фактический ключ API, и вы можете заполнить фиктивное значение, например 12345.

    1. Нажмите кнопку создания.

    2. Заполните параметры действия "Отправить видео" и "Индекс".

      Совет

      Если идентификатор учетной записи VI не найден и не находится в раскрывающемся списке, используйте настраиваемое значение.

      Ключ Значение
      Расположение Расположение связанной учетной записи индексатора видео Azure AI.
      Код счета Идентификатор учетной записи связанной с Индексатором видео Azure AI. Идентификатор учетной записи можно найти в странице обзора в учетной записи, в портале Azure. Или вкладка "Параметры учетной записи" слева от веб-сайта Индексатора видео Azure AI.
      Маркер доступа Используйте выражение body('HTTP')['accessToken'] для извлечения маркера доступа в нужном формате из предыдущего HTTP-вызова.
      Имя видео Выберите название списка файлов из динамического содержимого действия “Когда большой двоичный объект добавляется или изменяется”.
      URL-адрес видео Выберите веб-URL из динамического содержимого действия Создать URI SAS по пути.
      Тело Можно оставить как по умолчанию.

    3. Выберите Сохранить.

Поток 2. Создание нового приложения логики потребления типов

Создайте второй поток, Logic Apps типа потребления. Второй поток активируется запросом на URL-адрес обратного вызова и сохраняет извлеченные полезные данные обратно в JSON-файл, размещенный в службе хранилища Azure.

Этапы потока:

  1. При получении HTTP-запроса
  2. HTTP
  3. Получение индекса видео
  4. Создать blob (версия 2)

Настройка триггера

  1. Найдите и выберите параметр "При получении HTTP-запроса".

    Для триггера есть поле URL-адреса HTTP POST. URL-адрес не будет создан до тех пор, пока не сохраните поток. Однако в конечном итоге потребуется URL-адрес.

    Совет

    Позже вы вернеесь к URL-адресу, созданному на этом шаге.

Генерация токена доступа

Возможно, вам потребуется создать другой маркер доступа в зависимости от способа настройки первого. Скопируйте и вставьте его в Блокнот.

  1. Создайте маркер доступа.
  2. Нажмите Сохранить ->+ Новый шаг.

Настроить аналитические возможности Video Indexer

  1. Найдите индексатор видео.

  2. В индексаторе видео (V2) выберите действие "Получить индекс видео".

    Задайте имя подключения:

    Ключ Значение
    Имя подключения < Имя подключения>. Например, aviconnection.
    Ключ API Это ваш личный ключ API, который доступен в разделе "Профиль " на портале разработчика. Дополнительные сведения см. в разделе "Подписка на API".

    1. Нажмите кнопку создания.

    2. Заполните необходимые параметры в соответствии с таблицей:

      Ключ Значение
      Расположение Расположение учетной записи индексатора видео Azure AI.
      Код счета Идентификатор учетной записи индексатора видео можно скопировать на странице Обзор ресурса или учетной записи в портале Azure.
      Идентификатор видео* Для идентификатора видео добавьте динамическое содержимое типа Expression и введите следующее выражение: triggerOutputs()['queries']['id'].
      Маркер доступа В динамическом содержимом в разделе 'Разбор JSON' выберите accessToken, который является результатом действия 'Разбор JSON'.

      *Это выражение передает коннектору команду получить идентификатор видео из выходных данных триггера. В этом случае выходные данные триггера — это выходные данные видео и индекс в первом триггере.

    3. Нажмите Сохранить ->+ Новый шаг.

Создайте облако и сохраните JSON с выводами.

  1. Найдите блоб Azure в группе действий.

  2. Выберите Создать Blob(V2).

  3. Установите подключение к хранилищу BLOB-объектов, в котором хранятся аналитические файлы JSON.

    Ключ Значение
    Имя подключения < Введите имя> подключения.
    Тип аутентификации Ключ доступа
    имя учетной записи службы хранилища Azure <* Имя учетной записи хранения, в которой хранятся аналитические сведения*>.
    ключ доступа к хранилищу Azure Перейдите к портал Azure-> my-storage-> в разделе "Безопасность + сеть -> ключи доступа" —> скопируйте один из ключей.
    1. Нажмите кнопку создания.
    2. Задайте папку, в которой хранятся аналитические сведения.
    Ключ Значение
    Имя учетной записи хранилища < Введите имя учетной записи хранения, которая будет содержать выходные данные JSON (в этом руководстве совпадает с исходным видео).>
    Путь к папке В раскрывающемся списке выберите /insights
    Имя blob-объекта В динамическом содержимом в разделе "Получить индекс видео " выберите "Имя " и "Добавить _insights.json". Имя файла аналитики — это имя видео и insights.json
    Содержимое BLOB-объекта Из динамического контента, под разделом Получить индекс видео, выберите Заголовок.
    1. Выберите "Сохранить поток".

Обновите URL-адрес обратного вызова, чтобы получить уведомление о завершении задания по индексированию.

При сохранении потока в триггере создается URL-адрес HTTP POST.

  1. Скопируйте этот URL-адрес из триггера.
  2. Вернитесь к первому потоку и вставьте URL-адрес в действие Загрузки видео и индекса для параметра URL-адреса обратного вызова.

Убедитесь, что оба потока сохранены.