Преобразования и задания в Службах мультимедиа

  • Статья

Логотип Служб мультимедиа версии 3

Предупреждение

Поддержка Служб мультимедиа Azure будет прекращена 30 июня 2024 г. Дополнительные сведения см. в руководстве по прекращению поддержки AMS.

Совет

Хотите создать эскизы, совместить два видео вместе, создать подклип видео или повернуть его (а также выполнить другие действия)? Пример кода для Служб мультимедиа можно найти на странице Примеры.

В этом разделе приводятся сведения о преобразованиях и заданиях, а также о связи между этими сущностями.

Стандартный рабочий процесс

Преобразование похоже на рецепт. Оно позволяет создать набор инструкций один раз (шаг 1) и отправить задания с использованием этой инструкции (шаг 2).

  1. Создайте преобразование.
  2. Отправьте задания в рамках этого преобразования.
  3. Выведите список преобразований.
  4. Удалите преобразование, если не планируете использовать его в будущем.

Пример

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

  1. Определите правило для обработки (набор инструкций). Например, используйте первый кадр видео в качестве эскиза.
  2. Для каждого видео следует сообщить службе:
    1. расположение видео;
    2. место для записи выходных данных (например, эскиза).

Примечание

Свойства преобразования и задания типа Datetime всегда задаются в формате UTC.

Преобразования

Преобразования можно использовать для настройки общих задач кодирования или анализа видеоматериалов. Каждое преобразование описывает набор инструкций (или рабочий процесс задач) для обработки видео- и аудиофайлов. Одно преобразование может применять несколько правил. Например, преобразование может указать, что каждое видео кодируется в MP4-файл с заданной скоростью и что эскиз будет создан из первого кадра видео. Необходимо добавить одну запись TransformOutput для каждого правила, которое требуется включить в преобразование. Используйте предустановки, чтобы указать для преобразования, как должны обрабатываться входные файлы мультимедиа.

Просмотр схемы

В Службах мультимедиа версии 3 предустановки являются строго типизированными сущностями в самом API. Определение схемы для этих объектов можно найти в спецификации Open API (или Swagger). Определения предустановок (например, StandardEncoderPreset) можно также просмотреть в REST API, пакете SDK для .NET (или в другой справочной документации по Службам мультимедиа версии 3).

Создание преобразований

Преобразования можно создавать с помощью REST, CLI или любого из опубликованных пакетов SDK. Так как API Служб мультимедиа версии 3 управляется с помощью Azure Resource Manager, вы можете использовать шаблоны Resource Manager для создания и развертывания преобразований в учетной записи Служб мультимедиа. Управление доступом на основе ролей в Azure можно использовать для блокировки доступа к преобразованиям.

Обновление преобразований

Если необходимо обновить преобразование, используйте операцию Update. Она предназначена для внесения изменений в описание или приоритеты базовой сущности TransformOutputs. После завершения всех выполняемых заданий необходимо выполнить обновления. Если вы хотите перезаписать набор инструкций, нужно создать новое преобразование.

Задания

Задание содержит фактический запрос к Службам мультимедиа, который применяет преобразование к указанному видео- и (или) аудиосодержимому. После создания преобразования можно отправлять задания с помощью API Служб мультимедиа или любого из опубликованных пакетов SDK. Задание указывает такую информацию, как расположение входного и выходного видео. Вы можете указать расположение видео с помощью URL-адресов HTTPS, URL-адресов SAS или ресурсов.

Входные данные задания из HTTPS

Используйте входные данные задания из HTTPS, если содержимое уже доступно по URL-адресу и не нужно хранить исходный файл в Azure (например, импортировать из S3). Этот метод также подходит, если вы используете содержимое в хранилище BLOB-объектов Azure, но нет необходимости, чтобы файл находился в ресурсе. Сейчас этот метод поддерживает только один файл для входных данных.

Ресурс в качестве входных данных задания

Используйте ресурс в качестве входных данных задания, если входное содержимое уже находится в ресурсе или содержимое хранится в локальном файле. Это также удобный вариант, если вы планируете опубликовать входной ресурс для потоковой передачи или загрузки (например, если вы хотите опубликовать MP4-файл для загрузки, но также хотите выполнить преобразование речи в текст или распознавание лиц). Этот метод поддерживает многофайловые ресурсы (например, наборы потоковых передач MBR, которые закодированы локально).

Проверка хода выполнения задания

Ход выполнения и состояние заданий можно получить, отслеживая события с помощью Сетки событий. Дополнительные сведения см. в статье Создание и мониторинг событий Служб мультимедиа Azure с помощью Сетки событий и Azure CLI.

Обновление заданий

Операция Update сущности Job может использоваться для изменения свойств description и priority после отправки задания. Изменение свойства priority вступает в силу только в том случае, если задание все еще находится в очереди. Если задание приступило к обработке или завершено, изменение приоритета не оказывает какого-либо влияния.

Примеры кодирования

См. обширный список примеров кодирования для кодирования.

Справка и поддержка

Вы можете обратиться к Службам мультимедиа с вопросами или следить за нашими обновлениями одним из следующих способов: