Jobs - Create

Создание задания
Создает задание.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}/jobs/{jobName}?api-version=2022-07-01

Параметры URI

Имя В Обязательно Тип Описание
accountName
path True

string

Имя учетной записи Служб мультимедиа.

jobName
path True

string

Имя задания.

resourceGroupName
path True

string

Имя группы ресурсов в подписке Azure.

subscriptionId
path True

string

Уникальный идентификатор подписки Microsoft Azure.

transformName
path True

string

Имя преобразования.

api-version
query True

string

Версия API, которая будет использоваться с клиентским запросом.

Текст запроса

Имя Обязательно Тип Описание
properties.input True JobInput:

Входные данные для задания.

properties.outputs True JobOutput[]:

JobOutputAsset[]

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

properties.correlationData

object

Предоставленные клиентом пары "ключ — значение", которые будут возвращены в событиях состояния Job и JobOutput.

properties.description

string

Необязательное предоставляемое клиентом описание задания.

properties.priority

Priority

Приоритет обработки задания. Задания с более высоким приоритетом обрабатываются раньше, чем задания с низким приоритетом. Если значение не задано, по умолчанию используется значение normal.

Ответы

Имя Тип Описание
201 Created

Job

Создание

Other Status Codes

ErrorResponse

Подробные сведения об ошибке.

Примеры

Create a Job

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/exampleTransform/jobs/job1?api-version=2022-07-01

{
  "properties": {
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputAsset",
      "assetName": "job1-InputAsset"
    },
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "assetName": "job1-OutputAsset"
      }
    ],
    "correlationData": {
      "key1": "value1",
      "Key 2": "Value 2"
    }
  }
}

Sample Response

{
  "name": "job1",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1",
  "type": "Microsoft.Media/mediaservices/transforms/jobs",
  "properties": {
    "created": "2022-10-17T23:14:33.6140749Z",
    "state": "Queued",
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputAsset",
      "files": [],
      "inputDefinitions": [],
      "assetName": "job1-InputAsset"
    },
    "lastModified": "2022-10-17T23:14:33.6140749Z",
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "state": "Queued",
        "progress": 0,
        "label": "BuiltInStandardEncoderPreset_0",
        "assetName": "job1-OutputAsset"
      }
    ],
    "priority": "Normal",
    "correlationData": {
      "key1": "value1",
      "Key 2": "Value 2"
    }
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:33.6140749Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:33.6140749Z"
  }
}

Определения

Имя Описание
AacAudio

Описание параметров кодирования аудио с расширенными аудиокодеками (AAC).

AacAudioProfile

Профиль кодирования, используемый при кодировании звука с помощью AAC.

AbsoluteClipTime

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

AnalysisResolution

Указывает максимальное разрешение, при котором анализируется видео. Поведение по умолчанию — SourceResolution, которое сохраняет входное видео в исходном разрешении при анализе. Использование standardDefinition позволяет изменить размер входных видео до стандартного определения, сохранив при этом соответствующие пропорции. Размер будет изменяться только в том случае, если видео имеет более высокое разрешение. Например, входные данные 1920 x 1080 перед обработкой масштабируются до 640 x 360. Переключение на "StandardDefinition" сократит время, необходимое для обработки видео с высоким разрешением. Это также может снизить затраты на использование этого компонента (см. дополнительные сведения https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Однако лица, которые в конечном итоге слишком малы в видео с измененным размером, могут не быть обнаружены.

AttributeFilter

Тип AttributeFilter, применяемый к TrackAttribute для выбора дорожек.

Audio

Определяет общие свойства для всех звуковых кодеков.

AudioAnalysisMode

Определяет набор выполняемых операций анализа звука. Если этот параметр не указан, будет выбран стандартный AudioAnalysisMode.

AudioAnalyzerPreset

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

AudioOverlay

Описывает свойства наложения звука.

AudioTrackDescriptor

TrackSelection для выбора звуковых дорожек.

BlurType

Тип размытия

BuiltInStandardEncoderPreset

Описывает встроенную предустановку для кодирования входного видео с помощью стандартного кодировщика.

ChannelMapping

Необязательное обозначение для одноканальной аудиодорожки. Можно использовать для объединения дорожек в стерео- или многоканаловую аудиодорожку.

Complexity

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

CopyAudio

Флаг кодека, который указывает кодировщику копировать битовый поток входного аудио.

CopyVideo

Флаг кодека, который указывает кодировщику копировать битовый поток входного видео без повторного кодирования.

createdByType

Тип удостоверения, создавшего ресурс.

DDAudio

Описание параметров кодирования аудиокодека Dolby Digital Audio Codec (AC3). Текущая реализация поддержки Dolby Digital Audio: аудиоканам 1((моно), 2(стерео), 6(5.1side); Частота дискретизации звука: 32K/44,1K/48K Гц; Значения скорости звука, поддерживаемые спецификацией AC3: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 б/с.

Deinterlace

Описание параметров де-чередование.

DeinterlaceMode

Режим деинтерлейки. По умолчанию — AutoPixelAdaptive.

DeinterlaceParity

Четность полей для де-чередования по умолчанию — Auto.

EncoderNamedPreset

Встроенная предустановка, используемая для кодирования видео.

EntropyMode

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

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Сообщение об ошибке

FaceDetectorPreset

Описывает все параметры, используемые при анализе видео, чтобы обнаружить (и при необходимости отредактировать) все присутствующих лица.

FaceRedactorMode

В этом режиме можно выбрать один из следующих параметров: 1) Анализ — только для обнаружения. В этом режиме создается JSON-файл метаданных, помечающий внешний вид лиц на протяжении всего видео. Если это возможно, внешности одного и того же человека назначаются с одинаковым идентификатором. 2) Комбинированный — дополнительно отредактирует (размытие) обнаруженных лиц. 3) Redact — это обеспечивает двухпрохольный процесс, позволяющий выборочно редактировать подмножество обнаруженных лиц. Он принимает файл метаданных из предыдущего прохода анализа, а также исходное видео и выбранное пользователем подмножество идентификаторов, требующих исправления.

Fade

Описывает свойства эффекта затухания, применяемого к входным носителям.

Filters

Описание всех операций фильтрации, таких как де-чередование, поворот и т. д., которые должны быть применены к входным носителям перед кодировкой.

FromAllInputFile

InputDefinition, который просматривает все предоставленные файлы для выбора дорожек, указанных свойством IncludedTracks. Обычно используется с атрибутами AudioTrackByAttribute и VideoTrackByAttribute для выбора одной дорожки в наборе входных файлов.

FromEachInputFile

InputDefinition, который просматривает каждый входной файл, предоставленный для выбора дорожек, указанных свойством IncludedTracks. Обычно используется с атрибутами AudioTrackByAttribute и VideoTrackByAttribute для выбора дорожек из каждого заданного файла.

H264Complexity

Сообщает кодировщику, как выбрать его параметры кодирования. Значение по умолчанию — Balanced.

H264Layer

Описание параметров, используемых при кодировании входного видео в требуемом уровне скорости вывода с помощью видеокодека H.264.

H264RateControlMode

Режим управления скоростью видео

H264Video

Описывает все свойства для кодирования видео с помощью кодека H.264.

H264VideoProfile

В настоящее время поддерживаются базовые показатели, основной, высокий, высокий, высокий422, высокий444. Значение по умолчанию — Auto.

H265Complexity

Сообщает кодировщику, как выбрать его параметры кодирования. Качество обеспечит более высокую степень сжатия, но с более высокими затратами и более длительным временем вычислений. Скорость создает относительно большой файл, но быстрее и экономичнее. Значение по умолчанию — Balanced.

H265Layer

Описание параметров, используемых при кодировании входного видео в требуемом уровне скорости вывода с помощью видеокодека H.265.

H265Video

Описывает все свойства для кодирования видео с помощью кодека H.265.

H265VideoProfile

В настоящее время поддерживается Main. Значение по умолчанию — Auto.

Image

Описание основных свойств для создания эскизов из входного видео

ImageFormat

Описывает свойства выходного файла изображения.

InputFile

InputDefinition для одного файла. Областью выбора TrackSelections является указанный файл.

InsightsType

Определяет тип аналитических сведений, которые служба будет создавать. Допустимые значения: AudioInsightsOnly, VideoInsightsOnly и AllInsights. Значение по умолчанию — AllInsights. Если для этого параметра задано значение AllInsights, а входными данными является только звук, создается только звуковая аналитика. Аналогичным образом, если входные данные являются только видео, создаются только аналитические сведения о видео. Рекомендуется не использовать AudioInsightsOnly, если предполагается, что некоторые входные данные будут только видео. или используйте VideoInsightsOnly, если предполагается, что некоторые входные данные будут только аудио. Ваши задания в таких условиях будут ошибок.

InterleaveOutput

Задает режим чередовки выходных данных для управления хранением звука и видео в формате контейнера. Пример: задайте параметр InterleavedOutput как NonInterleavedOutput, чтобы создавать выходные данные только для аудио и только для видео в отдельных MP4-файлах.

Job

Тип ресурса Job. Ход выполнения и состояние можно получить, опрашив задание или подписавшись на события с помощью EventGrid.

JobError

Сведения об ошибках JobOutput.

JobErrorCategory

Помогает с классификацией ошибок.

JobErrorCode

Код ошибки, описывающий ошибку.

JobErrorDetail

Сведения об ошибках JobOutput.

JobInputAsset

Представляет ресурс для входных данных в задание.

JobInputClip

Представляет входные файлы для задания.

JobInputHttp

Представляет входные данные задания HTTPS.

JobInputs

Описывает список входных данных для задания.

JobInputSequence

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

JobOutputAsset

Представляет ресурс, используемый в качестве JobOutput.

JobRetry

Указывает, что можно повторить задание. Если повторные попытки не увенчались успехом, обратитесь к поддержка Azure через портал Azure.

JobState

Описывает состояние JobOutput.

JpgFormat

Описывает параметры создания эскизов JPEG.

JpgImage

Описывает свойства для создания ряда изображений JPEG из входного видео.

JpgLayer

Описывает параметры для создания изображения JPEG из входного видео.

Mp4Format

Описывает свойства выходного ФАЙЛА ISO MP4.

MultiBitrateFormat

Описывает свойства для создания коллекции файлов с поддержкой GOP с несколькими скоростями. По умолчанию создается один выходной файл для каждого уровня видео, который объединяется со всеми звуками. Точные выходные файлы можно контролировать, указав коллекцию outputFiles.

OutputFile

Представляет созданный выходной файл.

PngFormat

Описывает параметры создания эскизов PNG.

PngImage

Описывает свойства для создания ряда изображений PNG из входного видео.

PngLayer

Описывает параметры для создания изображения в формате PNG из входного видео.

PresetConfigurations

Объект необязательных параметров конфигурации для кодировщика.

Priority

Задает относительный приоритет TransformOutputs в преобразовании. При этом задается приоритет, который служба использует для обработки TransformOutputs. Приоритет по умолчанию — Обычный.

Rectangle

Описывает свойства прямоугольного окна, применяемого к входному носителю перед его обработкой.

Rotation

Поворот, если таковой имеется, применяется к входной видео перед его кодированием. Значение по умолчанию — Auto

SelectAudioTrackByAttribute

Выберите звуковые дорожки из входных данных, указав атрибут и фильтр атрибутов.

SelectAudioTrackById

Выберите звуковые дорожки из входных данных, указав идентификатор дорожки.

SelectVideoTrackByAttribute

Выберите видеодорожки из входных данных, указав атрибут и фильтр атрибутов.

SelectVideoTrackById

Выберите видеодорожки из входных данных, указав идентификатор дорожки.

StandardEncoderPreset

Описание всех параметров, используемых при кодировании входного видео с помощью стандартного кодировщика.

StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

TrackAttribute

Атрибут TrackAttribute для фильтрации дорожек.

TransportStreamFormat

Описывает свойства для создания выходных видеофайлов транспортного потока MPEG-2 (ISO/IEC 13818-1).

UtcClipTime

Указывает время клипа в формате UTC в файле мультимедиа. Время в формате UTC может указывать на другую позицию в зависимости от того, начинается ли файл мультимедиа с нулевой метки времени.

Video

Описание основных свойств для кодирования входного видео.

VideoAnalyzerPreset

Предустановка видеоанализатора, которая извлекает аналитические сведения (расширенные метаданные) из аудио и видео и выводит файл формата JSON.

VideoOverlay

Описывает свойства наложения видео.

VideoSyncMode

Режим синхронизации видео

VideoTrackDescriptor

TrackSelection для выбора видеодорожек.

AacAudio

Описание параметров кодирования аудио с расширенными аудиокодеками (AAC).

Имя Тип Описание
@odata.type string:

#Microsoft.Media.AacAudio

Дискриминатор для производных типов.

bitrate

integer

Скорость (в битах в секунду) выходного закодированного звука.

channels

integer

Количество каналов в аудио.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

profile

AacAudioProfile

Профиль кодирования, используемый при кодировании звука с помощью AAC.

samplingRate

integer

Частота выборки, используемая для кодирования в hertz.

AacAudioProfile

Профиль кодирования, используемый при кодировании звука с помощью AAC.

Имя Тип Описание
AacLc

string

Указывает, что выходной звук должен быть закодирован в профиль низкой сложности AAC (AAC-LC).

HeAacV1

string

Указывает, что выходной звук должен быть закодирован в профиль HE-AAC версии 1.

HeAacV2

string

Указывает, что выходной звук должен быть закодирован в профиль HE-AAC версии 2.

AbsoluteClipTime

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

Имя Тип Описание
@odata.type string:

#Microsoft.Media.AbsoluteClipTime

Дискриминатор для производных типов.

time

string

Позиция времени на временная шкала входного носителя. Обычно он указывается как ISO8601 период. Например, PT30S в течение 30 секунд.

AnalysisResolution

Указывает максимальное разрешение, при котором анализируется видео. Поведение по умолчанию — SourceResolution, которое сохраняет входное видео в исходном разрешении при анализе. Использование standardDefinition позволяет изменить размер входных видео до стандартного определения, сохранив при этом соответствующие пропорции. Размер будет изменяться только в том случае, если видео имеет более высокое разрешение. Например, входные данные 1920 x 1080 перед обработкой масштабируются до 640 x 360. Переключение на "StandardDefinition" сократит время, необходимое для обработки видео с высоким разрешением. Это также может снизить затраты на использование этого компонента (см. дополнительные сведения https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Однако лица, которые в конечном итоге слишком малы в видео с измененным размером, могут не быть обнаружены.

Имя Тип Описание
SourceResolution

string

StandardDefinition

string

AttributeFilter

Тип AttributeFilter, применяемый к TrackAttribute для выбора дорожек.

Имя Тип Описание
All

string

Все треки будут включены.

Bottom

string

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

Top

string

Первая дорожка будет включена при сортировке атрибута в порядке убывания. Обычно используется для выбора наибольшей скорости.

ValueEquals

string

Будут включены все дорожки с атрибутом, равным заданному значению.

Audio

Определяет общие свойства для всех звуковых кодеков.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.Audio

Дискриминатор для производных типов.

bitrate

integer

Скорость (в битах в секунду) выходного закодированного звука.

channels

integer

Количество каналов в аудио.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

samplingRate

integer

Частота выборки, используемая для кодирования в hertz.

AudioAnalysisMode

Определяет набор выполняемых операций анализа звука. Если этот параметр не указан, будет выбран стандартный AudioAnalysisMode.

Имя Тип Описание
Basic

string

Этот режим выполняет преобразование речи в текст и создание файла субтитира/заголовка. Выходные данные этого режима включают в себя файл JSON Insights, содержащий только ключевые слова, транскрипцию и сведения о времени. Автоматическое распознавание языка и диаризация говорящего в этом режиме не выполняются.

Standard

string

Выполняет все операции, входящие в базовый режим, дополнительно выполняя определение языка и диаризацию говорящего.

AudioAnalyzerPreset

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

Имя Тип Описание
@odata.type string:

#Microsoft.Media.AudioAnalyzerPreset

Дискриминатор для производных типов.

audioLanguage

string

Язык для полезных данных аудио во входных данных с использованием формата BCP-47 "language tag-region" (например, "en-US"). Если вы знаете язык содержимого, рекомендуется указать его. Язык должен быть явно указан для AudioAnalysisMode::Basic, так как автоматическое определение языка не включается в базовый режим. Если язык не указан или имеет значение NULL, функция автоматического распознавания языка выберет первый обнаруженный язык и обработает весь файл, используя этот язык. Сейчас она не поддерживает динамическое переключение между языками после распознавания первого языка. Автоматическое обнаружение лучше всего работает с аудиозаписями с четко различимой речью. Если автоматическому обнаружению не удается найти язык, транскрибирование будет откатиться на en-US". Список поддерживаемых языков доступен здесь: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

Словарь, содержащий пары "ключ-значение" для параметров, не предоставленных в самой предустановке

mode

AudioAnalysisMode

Определяет набор выполняемых операций анализа звука. Если этот параметр не указан, будет выбран стандартный AudioAnalysisMode.

AudioOverlay

Описывает свойства наложения звука.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.AudioOverlay

Дискриминатор для производных типов.

audioGainLevel

number

Уровень увеличения звука в наложении. Значение должно находиться в диапазоне [0, 1,0]. Значение по умолчанию — 1.0.

end

string

Конечная позиция со ссылкой на входное видео, на котором заканчивается наложение. Значение должно быть в формате ISO 8601. Например, PT30S, чтобы завершить наложение на 30 секунд входного видео. Если значение не указано или значение больше длительности входного видео, наложение будет применяться до конца входного видео, если длительность носителя наложения больше длительности входного видео, в противном случае наложение будет длиться столько же, сколько и длительность наложения.

fadeInDuration

string

Продолжительность, в течение которой наложение исчезает на входном видео. Значение должно быть в формате длительности ISO 8601. Если не указано, поведение по умолчанию будет не исчезать (то же, что и PT0S).

fadeOutDuration

string

Длительность, в течение которой наложение исчезает из входного видео. Значение должно быть в формате длительности ISO 8601. Если значение не указано, поведение по умолчанию будет не исчезать (то же, что и PT0S).

inputLabel

string

Метка входных данных задания, которая будет использоваться в качестве наложения. Входные данные должны указывать ровно один файл. Можно указать файл изображения в формате JPG, PNG, GIF или BMP, звуковой файл (например, файл WAV, MP3, WMA или M4A) или видеофайл. Полный список поддерживаемых форматов звуковых и видеофайлов см https://aka.ms/mesformats . в этой статье.

start

string

Начальная позиция со ссылкой на входное видео, с которого начинается наложение. Значение должно быть в формате ISO 8601. Например, PT05S, чтобы начать наложение в 5 секунд входного видео. Если значение не указано, наложение начинается с начала входного видео.

AudioTrackDescriptor

TrackSelection для выбора звуковых дорожек.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.AudioTrackDescriptor

Дискриминатор для производных типов.

channelMapping

ChannelMapping

Необязательное обозначение для одноканальной аудиодорожки. Можно использовать для объединения дорожек в стерео- или многоканаловую аудиодорожку.

BlurType

Тип размытия

Имя Тип Описание
Black

string

Черное: черный фильтр

Box

string

Box: фильтр отладки, только ограничивающий прямоугольник

High

string

Высокий: запутать фильтр размытия

Low

string

Низкий: фильтр размытия коробки автомобиля

Med

string

Med: Фильтр размытия гауссов

BuiltInStandardEncoderPreset

Описывает встроенную предустановку для кодирования входного видео с помощью стандартного кодировщика.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.BuiltInStandardEncoderPreset

Дискриминатор для производных типов.

configurations

PresetConfigurations

Необязательные параметры конфигурации для кодировщика. Конфигурации поддерживаются только для ContentAwareEncoding и H265ContentAwareEncoding BuiltInStandardEncoderPreset.

presetName

EncoderNamedPreset

Встроенная предустановка, используемая для кодирования видео.

ChannelMapping

Необязательное обозначение для одноканальной аудиодорожки. Можно использовать для объединения дорожек в стерео- или многоканаловую аудиодорожку.

Имя Тип Описание
BackLeft

string

Обратный левый канал. Иногда называют левым окружающим каналом.

BackRight

string

Обратный правый канал. Иногда называют правым окружающим каналом.

Center

string

Центральный канал.

FrontLeft

string

Передний левый канал.

FrontRight

string

Передний правый канал.

LowFrequencyEffects

string

Канал низкочастотных эффектов. Иногда называется сабвуфером.

StereoLeft

string

Левый стереоканал. Иногда называется Down Mix Left.

StereoRight

string

Правый стереоканал. Иногда называется Down Mix Right.

Complexity

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

Имя Тип Описание
Balanced

string

Настраивает кодировщик для использования параметров, которые обеспечивают баланс между скоростью и качеством.

Quality

string

Настраивает кодировщик для использования параметров, оптимизированных для получения выходных данных более высокого качества за счет более медленного общего времени кодирования.

Speed

string

Настраивает кодировщик для использования параметров, оптимизированных для ускорения кодирования. Качество жертвуется для уменьшения времени кодирования.

CopyAudio

Флаг кодека, который указывает кодировщику копировать битовый поток входного аудио.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.CopyAudio

Дискриминатор для производных типов.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

CopyVideo

Флаг кодека, который указывает кодировщику копировать битовый поток входного видео без повторного кодирования.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.CopyVideo

Дискриминатор для производных типов.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

createdByType

Тип удостоверения, создавшего ресурс.

Имя Тип Описание
Application

string

Key

string

ManagedIdentity

string

User

string

DDAudio

Описание параметров кодирования аудиокодека Dolby Digital Audio Codec (AC3). Текущая реализация поддержки Dolby Digital Audio: аудиоканам 1((моно), 2(стерео), 6(5.1side); Частота дискретизации звука: 32K/44,1K/48K Гц; Значения скорости звука, поддерживаемые спецификацией AC3: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 б/с.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.DDAudio

Дискриминатор для производных типов.

bitrate

integer

Скорость (в битах в секунду) выходного закодированного звука.

channels

integer

Количество каналов в аудио.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

samplingRate

integer

Частота выборки, используемая для кодирования в hertz.

Deinterlace

Описание параметров де-чередование.

Имя Тип Описание
mode

DeinterlaceMode

Режим деинтерлейки. По умолчанию — AutoPixelAdaptive.

parity

DeinterlaceParity

Четность полей для де-чередования по умолчанию — Auto.

DeinterlaceMode

Режим деинтерлейки. По умолчанию — AutoPixelAdaptive.

Имя Тип Описание
AutoPixelAdaptive

string

Примените автоматическое адаптивное распыление пикселей к каждому кадру во входном видео.

Off

string

Отключает де-чередование исходного видео.

DeinterlaceParity

Четность полей для де-чередования по умолчанию — Auto.

Имя Тип Описание
Auto

string

Автоматическое определение порядка полей

BottomFieldFirst

string

Сначала примените нижнее поле для обработки входного видео.

TopFieldFirst

string

Сначала примените верхнее поле для обработки входного видео.

EncoderNamedPreset

Встроенная предустановка, используемая для кодирования видео.

Имя Тип Описание
AACGoodQualityAudio

string

Создает один MP4-файл, содержащий только стереофонический звук AAC, закодированный со скоростью 192 кбит/с.

AdaptiveStreaming

string

Создает набор MP4-файлов, выровненных по GOP, с видео H.264 и стереофонический звук AAC. Автоматическое создание поразрядной лестницы на основе разрешения входных данных, битовой скорости и частоты кадров. Созданная автоматически предустановка никогда не превышает разрешение и скорость входных данных. Например, если входные данные — 720p, выходные данные будут 720p или хуже.

ContentAwareEncoding

string

Она создает набор GOP-файлов формата MP4, используя кодировку с учетом содержимого. Учитывая любое входное содержимое, служба выполняет исходный упрощенный анализ входного содержимого и использует результаты для определения оптимального количества слоев, соответствующие параметры скорости и разрешения для доставки с помощью адаптивной потоковой передачи. Эта предустановка особенно эффективна для видеороликов с низким и средним уровнем сложности, где выходные файлы будут иметь более низкую скорость, но с приемлемым качеством изображения для просмотра. Выходные данные будут содержать файлы MP4 с чередованием видео и аудио.

ContentAwareEncodingExperimental

string

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

CopyAllBitrateNonInterleaved

string

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

DDGoodQualityAudio

string

Создает один MP4-файл, содержащий только стереофонический звук DD (Digital Dolby), закодированный со скоростью 192 кбит/с.

H264MultipleBitrate1080p

string

Создает набор из 8 MP4-файлов, выровненных по GOP, от 6000 до 400 кбит/с, а также стереофонический звук AAC. Разрешение начинается с 1080p и опускается до 180p.

H264MultipleBitrate720p

string

Создает набор из 6 MP4-файлов, выровненных по GOP, от 3400 до 400 кбит/с, а также стереофонический звук AAC. Разрешение начинается с 720p и опускается до 180p.

H264MultipleBitrateSD

string

Создает набор из 5 MP4-файлов, выровненных по GOP, в диапазоне от 1900 кбит/с до 400 кбит/с, а также стереофонический звук AAC. Разрешение начинается с 480p и опускается до 240p.

H264SingleBitrate1080p

string

Создает MP4-файл, в котором видео кодируется с помощью кодека H.264 со скоростью 6750 кбит/с и высотой изображения 1080 пикселей, а стереофонический звук кодек AAC-LC со скоростью 128 кбит/с.

H264SingleBitrate720p

string

Создает MP4-файл, в котором видео кодируется с помощью кодека H.264 со скоростью 4500 кбит/с и высотой изображения 720 пикселей, а стереофонический звук закодирован с помощью кодека AAC-LC со скоростью 128 кбит/с.

H264SingleBitrateSD

string

Создает MP4-файл, в котором видео кодируется с помощью кодека H.264 со скоростью 2200 кбит/с и высотой изображения 480 пикселей, а стереофонический звук закодирован с помощью кодека AAC-LC со скоростью 128 кбит/с.

H265AdaptiveStreaming

string

Создает набор MP4-файлов с одинаковыми группами GOP, используя H.265 для видео и стерео AAC для аудио. Автоматическое создание поразрядной лестницы на основе разрешения входных данных, битовой скорости и частоты кадров. Созданная автоматически предустановка никогда не превышает разрешение и скорость входных данных. Например, если входные данные — 720p, выходные данные будут 720p или хуже.

H265ContentAwareEncoding

string

Она создает набор GOP-файлов формата MP4, используя кодировку с учетом содержимого. Учитывая любое входное содержимое, служба выполняет исходный упрощенный анализ входного содержимого и использует результаты для определения оптимального количества слоев, соответствующие параметры скорости и разрешения для доставки с помощью адаптивной потоковой передачи. Эта предустановка особенно эффективна для видеороликов с низким и средним уровнем сложности, где выходные файлы будут иметь более низкую скорость, но с приемлемым качеством изображения для просмотра. Выходные данные будут содержать файлы MP4 с чередованием видео и аудио.

H265SingleBitrate1080p

string

Создает MP4-файл, в котором видео кодируется с помощью кодека H.265 со скоростью 3500 кбит/с и высотой изображения 1080 пикселей, а стереофонический звук кодек AAC-LC со скоростью 128 кбит/с.

H265SingleBitrate4K

string

Создает MP4-файл, в котором видео кодируется с помощью кодека H.265 со скоростью 9500 кбит/с и высотой изображения 2160 пикселей, а стереофонический звук кодек AAC-LC со скоростью 128 кбит/с.

H265SingleBitrate720p

string

Создает MP4-файл, в котором видео кодируется с помощью кодека H.265 со скоростью 1800 кбит/с и высотой изображения 720 пикселей, а стереофонический звук закодирован с помощью кодека AAC-LC со скоростью 128 кбит/с.

EntropyMode

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

Имя Тип Описание
Cabac

string

Кодирование энтропии адаптивного двоичного арифметического кодера (CABAC).

Cavlc

string

Кодирование энтропии контекстного адаптивного кодировщика переменной длины (CAVLC).

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

FaceDetectorPreset

Описывает все параметры, используемые при анализе видео, чтобы обнаружить (и при необходимости отредактировать) все присутствующих лица.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.FaceDetectorPreset

Дискриминатор для производных типов.

blurType

BlurType

Тип размытия

experimentalOptions

object

Словарь, содержащий пары "ключ-значение" для параметров, не предоставленных в самой предустановке

mode

FaceRedactorMode

В этом режиме можно выбрать один из следующих параметров: 1) Анализ — только для обнаружения. В этом режиме создается JSON-файл метаданных, помечающий внешний вид лиц на протяжении всего видео. Если это возможно, внешности одного и того же человека назначаются с одинаковым идентификатором. 2) Комбинированный — дополнительно отредактирует (размытие) обнаруженных лиц. 3) Redact — это обеспечивает двухпрохольный процесс, позволяющий выборочно редактировать подмножество обнаруженных лиц. Он принимает файл метаданных из предыдущего прохода анализа, а также исходное видео и выбранное пользователем подмножество идентификаторов, требующих исправления.

resolution

AnalysisResolution

Указывает максимальное разрешение, при котором анализируется видео. Поведение по умолчанию — SourceResolution, которое сохраняет входное видео в исходном разрешении при анализе. Использование standardDefinition позволяет изменить размер входных видео до стандартного определения, сохранив при этом соответствующие пропорции. Размер будет изменяться только в том случае, если видео имеет более высокое разрешение. Например, входные данные 1920 x 1080 перед обработкой масштабируются до 640 x 360. Переключение на "StandardDefinition" сократит время, необходимое для обработки видео с высоким разрешением. Это также может снизить затраты на использование этого компонента (см. дополнительные сведения https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Однако лица, которые в конечном итоге слишком малы в видео с измененным размером, могут не быть обнаружены.

FaceRedactorMode

В этом режиме можно выбрать один из следующих параметров: 1) Анализ — только для обнаружения. В этом режиме создается JSON-файл метаданных, помечающий внешний вид лиц на протяжении всего видео. Если это возможно, внешности одного и того же человека назначаются с одинаковым идентификатором. 2) Комбинированный — дополнительно отредактирует (размытие) обнаруженных лиц. 3) Redact — это обеспечивает двухпрохольный процесс, позволяющий выборочно редактировать подмножество обнаруженных лиц. Он принимает файл метаданных из предыдущего прохода анализа, а также исходное видео и выбранное пользователем подмножество идентификаторов, требующих исправления.

Имя Тип Описание
Analyze

string

Режим анализа обнаруживает лица и выводит файл метаданных с результатами. Позволяет редактировать файл метаданных до размытия лиц в режиме redact.

Combined

string

Комбинированный режим выполняет шаги Анализ и Отредактировать за один проход, когда редактирование проанализированных лиц не требуется.

Redact

string

Режим redact использует файл метаданных из режима анализа и редактирует найденные лица.

Fade

Описывает свойства эффекта затухания, применяемого к входным носителям.

Имя Тип Описание
duration

string

Продолжительность эффекта исчезания в видео. Значение может быть в формате ISO 8601 (например, PT05S, чтобы цвет исчез в течение 5 секунд) или число кадров (например, 10 до исчезания 10 кадров от времени начала) или относительное значение к длительности потока (например, 10 % для исчезания 10 % длительности потока).

fadeColor

string

Цвет для затухания. Он может быть в цветах https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords CSS Level1 или RGB/шестнадцатеричном значении, например rgb(255,0,0), 0xFF0000 или #FF0000

start

string

Позиция во входном видео, с которого следует начать, исчезает. Значение может быть в формате ISO 8601 (например, PT05S начнет процесс на 5 секундах), в количестве кадров (например, значение 10 начнет захват на 10-м кадре) или в относительном значении по отношению к продолжительности потоковой передачи (например 10 % начнет процесс на 10 % длительности передачи). Значение по умолчанию — 0.

Filters

Описание всех операций фильтрации, таких как де-чередование, поворот и т. д., которые должны быть применены к входным носителям перед кодировкой.

Имя Тип Описание
crop

Rectangle

Параметры прямоугольного окна, с помощью которого требуется обрезать входное видео.

deinterlace

Deinterlace

Параметры размежений.

fadeIn

Fade

Описывает свойства эффекта затухания, применяемого к входным носителям.

fadeOut

Fade

Описывает свойства эффекта затухания, применяемого к входным носителям.

overlays Overlay[]:

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

rotation

Rotation

Поворот, если таковой имеется, применяется к входной видео перед его кодированием. Значение по умолчанию — Auto

FromAllInputFile

InputDefinition, который просматривает все предоставленные файлы для выбора дорожек, указанных свойством IncludedTracks. Обычно используется с атрибутами AudioTrackByAttribute и VideoTrackByAttribute для выбора одной дорожки в наборе входных файлов.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.FromAllInputFile

Дискриминатор для производных типов.

includedTracks TrackDescriptor[]:

Список элементов TrackDescriptor, определяющих метаданные и выбор дорожек во входных данных.

FromEachInputFile

InputDefinition, который просматривает каждый входной файл, предоставленный для выбора дорожек, указанных свойством IncludedTracks. Обычно используется с атрибутами AudioTrackByAttribute и VideoTrackByAttribute для выбора дорожек из каждого заданного файла.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.FromEachInputFile

Дискриминатор для производных типов.

includedTracks TrackDescriptor[]:

Список элементов TrackDescriptor, определяющих метаданные и выбор дорожек во входных данных.

H264Complexity

Сообщает кодировщику, как выбрать его параметры кодирования. Значение по умолчанию — Balanced.

Имя Тип Описание
Balanced

string

Указывает кодировщику использовать параметры, обеспечивающие баланс между скоростью и качеством.

Quality

string

Указывает кодировщику использовать параметры, оптимизированные для получения выходных данных более высокого качества за счет более медленного общего времени кодирования.

Speed

string

Указывает кодировщику использовать параметры, оптимизированные для ускорения кодирования. Качество жертвуется, чтобы уменьшить время кодирования.

H264Layer

Описание параметров, используемых при кодировании входного видео в требуемом уровне скорости вывода с помощью видеокодека H.264.

Имя Тип Описание
adaptiveBFrame

boolean

Указывает, следует ли использовать адаптивные B-кадры при кодировании этого слоя. Если кодировщик не указан, он будет включаться всякий раз, когда видеопрофилю разрешено его использование.

bFrames

integer

Количество B-кадров, используемых при кодировании этого слоя. Если не указано, кодировщик выбирает соответствующее число на основе видеопрофиля и уровня.

bitrate

integer

Средняя скорость в битах в секунду, с которой кодируется входное видео при создании этого слоя. Это поле является обязательным.

bufferWindow

string

Длина окна буфера VBV. Значение должно быть в формате ISO 8601. Значение должно находиться в диапазоне [0,1–100] секунд. Значение по умолчанию — 5 секунд (например, PT5S).

crf

number

Значение CRF, используемое при кодировании этого слоя. Этот параметр вступает в силу, если параметр RateControlMode видеокодека установлен в режиме CRF. Диапазон значений CRF находится в диапазоне от 0 до 51, где меньшее значение приведет к повышению качества за счет более высоких размеров файлов. Более высокие значения означают большее сжатие, но в какой-то момент будет замечено снижение качества. Значение по умолчанию — 23.

entropyMode

EntropyMode

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

frameRate

string

Частота кадров (в кадрах в секунду), с которой кодируется этот слой. Значение может быть в виде M/N, где M и N являются целыми числами (например, 30000/1001), или в виде числа (например, 30 или 29,97). Кодировщик применяет ограничения на разрешенную частоту кадров в зависимости от профиля и уровня. Если он не указан, кодировщик будет использовать ту же частоту кадров, что и входное видео.

height

string

Высота выходного видео для этого слоя. Значение может быть абсолютным (в пикселях) или относительным (в процентах). Например, значение 50 % означает, что высота выходного видео вдвое меньше, чем входные данные.

label

string

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

level

string

В настоящее время поддерживается уровень до 6.2. Значением может быть Auto или число, соответствующее профилю H.264. Если значение не указано, значение по умолчанию — Auto, что позволяет кодировщику выбрать уровень, подходящий для этого слоя.

maxBitrate

integer

Максимальная скорость (в битах в секунду), при которой предполагается заполнение буфера VBV. Если значение не указано, по умолчанию используется то же значение, что и скорость.

profile

H264VideoProfile

В настоящее время поддерживаются базовые показатели, основной, высокий, Высокий, Высокий422, Высокий444. Значение по умолчанию — Auto.

referenceFrames

integer

Количество опорных кадров, используемых при кодировании этого слоя. Если не указано, кодировщик определяет соответствующее число на основе параметра сложности кодировщика.

slices

integer

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

width

string

Ширина выходного видео для этого слоя. Значение может быть абсолютным (в пикселях) или относительным (в процентах). Например, 50 % означает, что выходное видео имеет половину ширины пикселей, чем входные данные.

H264RateControlMode

Режим управления скоростью видео

Имя Тип Описание
ABR

string

Режим средней скорости (ABR), который достигает целевой скорости: режим по умолчанию.

CBR

string

Режим постоянной скорости (CBR), который ужесточает колебания скорости вокруг целевой скорости.

CRF

string

Режим постоянного коэффициента скорости (CRF), предназначенный для постоянного субъективного качества.

H264Video

Описывает все свойства для кодирования видео с помощью кодека H.264.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.H264Video

Дискриминатор для производных типов.

complexity

H264Complexity

Сообщает кодировщику, как выбрать его параметры кодирования. Значение по умолчанию — Balanced.

keyFrameInterval

string

Расстояние между двумя ключевыми кадрами. Значение должно быть ненулевым в диапазоне [0,5, 20] секунд, указанном в формате ISO 8601. Значение по умолчанию — 2 секунды (PT2S). Обратите внимание, что этот параметр игнорируется, если задан параметр VideoSyncMode.Passthrough, где значение KeyFrameInterval будет следовать за параметром источника входных данных.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

layers

H264Layer[]

Коллекция выходных слоев H.264, создаваемых кодировщиком.

rateControlMode

H264RateControlMode

Режим управления скоростью видео

sceneChangeDetection

boolean

Указывает, должен ли кодировщик вставлять ключевые кадры при изменении сцены. Если значение не указано, значение по умолчанию — false. Этот флаг должен иметь значение true только в том случае, если кодировщик настроен для создания одного выходного видео.

stretchMode

StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize.

syncMode

VideoSyncMode

Режим синхронизации видео

H264VideoProfile

В настоящее время поддерживаются базовые показатели, основной, высокий, высокий, высокий422, высокий444. Значение по умолчанию — Auto.

Имя Тип Описание
Auto

string

Указывает кодировщику автоматически определить соответствующий профиль H.264.

Baseline

string

Базовый профиль

High

string

Высокий профиль.

High422

string

Высокий профиль 4:2:2.

High444

string

Прогнозный профиль высокого уровня 4:4:4.

Main

string

Основной профиль

H265Complexity

Сообщает кодировщику, как выбрать его параметры кодирования. Качество обеспечит более высокую степень сжатия, но с более высокими затратами и более длительным временем вычислений. Скорость создает относительно большой файл, но быстрее и экономичнее. Значение по умолчанию — Balanced.

Имя Тип Описание
Balanced

string

Указывает кодировщику использовать параметры, обеспечивающие баланс между скоростью и качеством.

Quality

string

Указывает кодировщику использовать параметры, оптимизированные для получения выходных данных более высокого качества за счет более медленного общего времени кодирования.

Speed

string

Указывает кодировщику использовать параметры, оптимизированные для ускорения кодирования. Качество жертвуется для уменьшения времени кодирования.

H265Layer

Описание параметров, используемых при кодировании входного видео в требуемом уровне скорости вывода с помощью видеокодека H.265.

Имя Тип Описание
adaptiveBFrame

boolean

Указывает, следует ли использовать адаптивные B-кадры при кодировании этого слоя. Если кодировщик не указан, он будет включаться всякий раз, когда видеопрофилю разрешено его использование.

bFrames

integer

Количество B-кадров, используемых при кодировании этого слоя. Если не указано, кодировщик выбирает соответствующее число на основе видеопрофиля и уровня.

bitrate

integer

Средняя скорость в битах в секунду, с которой кодируется входное видео при создании этого слоя. Например, целевая скорость 3000 Кбит/с или 3 Мбит/с означает, что это значение должно быть 3000000 Это обязательное поле.

bufferWindow

string

Длина окна буфера VBV. Значение должно быть в формате ISO 8601. Значение должно находиться в диапазоне [0,1–100] секунд. Значение по умолчанию — 5 секунд (например, PT5S).

crf

number

Значение CRF, используемое при кодировании этого слоя. Этот параметр вступает в силу, если параметр RateControlMode видеокодека установлен в режиме CRF. Диапазон значений CRF находится в диапазоне от 0 до 51, где меньшее значение приведет к повышению качества за счет более высоких размеров файлов. Более высокие значения означают большее сжатие, но в какой-то момент будет замечено снижение качества. Значение по умолчанию — 28.

frameRate

string

Частота кадров (в кадрах в секунду), с которой кодируется этот слой. Значение может быть в виде M/N, где M и N являются целыми числами (например, 30000/1001), или в виде числа (например, 30 или 29,97). Кодировщик применяет ограничения на разрешенную частоту кадров в зависимости от профиля и уровня. Если он не указан, кодировщик будет использовать ту же частоту кадров, что и входное видео.

height

string

Высота выходного видео для этого слоя. Значение может быть абсолютным (в пикселях) или относительным (в процентах). Например, значение 50 % означает, что высота выходного видео вдвое меньше, чем входные данные.

label

string

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

level

string

В настоящее время поддерживается уровень до 6.2. Это может быть значение Auto или число, соответствующее профилю H.265. Если значение не указано, значение по умолчанию — Auto, что позволяет кодировщику выбрать уровень, соответствующий этому слою.

maxBitrate

integer

Максимальная скорость (в битах в секунду), при которой предполагается заполнение буфера VBV. Если значение не указано, по умолчанию используется то же значение, что и скорость.

profile

H265VideoProfile

В настоящее время поддерживается Main. Значение по умолчанию — Auto.

referenceFrames

integer

Количество опорных кадров, используемых при кодировании этого слоя. Если не указано, кодировщик определяет соответствующее число на основе параметра сложности кодировщика.

slices

integer

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

width

string

Ширина выходного видео для этого слоя. Значение может быть абсолютным (в пикселях) или относительным (в процентах). Например, 50 % означает, что выходное видео имеет половину ширины пикселей, чем входные данные.

H265Video

Описывает все свойства для кодирования видео с помощью кодека H.265.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.H265Video

Дискриминатор для производных типов.

complexity

H265Complexity

Сообщает кодировщику, как выбрать его параметры кодирования. Качество обеспечит более высокую степень сжатия, но с более высокими затратами и более длительным временем вычислений. Скорость создает относительно большой файл, но быстрее и экономичнее. Значение по умолчанию — Balanced.

keyFrameInterval

string

Расстояние между двумя ключевыми кадрами. Значение должно быть ненулевым в диапазоне [0,5, 20] секунд, указанном в формате ISO 8601. Значение по умолчанию — 2 секунды (PT2S). Обратите внимание, что этот параметр игнорируется, если задан параметр VideoSyncMode.Passthrough, где значение KeyFrameInterval будет следовать за параметром источника входных данных.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

layers

H265Layer[]

Коллекция выходных слоев H.265, создаваемых кодировщиком.

sceneChangeDetection

boolean

Указывает, должен ли кодировщик вставлять ключевые кадры при изменении сцены. Если значение не указано, значение по умолчанию — false. Этот флаг должен иметь значение true только в том случае, если кодировщик настроен для создания одного выходного видео.

stretchMode

StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize.

syncMode

VideoSyncMode

Режим синхронизации видео

H265VideoProfile

В настоящее время поддерживается Main. Значение по умолчанию — Auto.

Имя Тип Описание
Auto

string

Указывает кодировщику автоматически определить соответствующий профиль H.265.

Main

string

Основной профиль (https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier)

Main10

string

Основной профиль 10 (https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10)

Image

Описание основных свойств для создания эскизов из входного видео

Имя Тип Описание
@odata.type string:

#Microsoft.Media.Image

Дискриминатор для производных типов.

keyFrameInterval

string

Расстояние между двумя ключевыми кадрами. Значение должно быть ненулевым в диапазоне [0,5, 20] секунд, указанном в формате ISO 8601. Значение по умолчанию — 2 секунды (PT2S). Обратите внимание, что этот параметр игнорируется, если задан параметр VideoSyncMode.Passthrough, где значение KeyFrameInterval будет следовать за параметром источника входных данных.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

range

string

Позиция относительно предустановленного времени начала преобразования во входном видео, при котором прекращается создание эскизов. Значение может быть в формате ISO 8601 (например, PT5M30S остановиться на 5 минутах и 30 секундах с момента начала) или число кадров (например, 300, чтобы остановиться на 300-м кадре от кадра во время начала). Если это значение равно 1, это означает создание только одного эскиза во время начала или относительное значение длительности потока (например, 50 % для остановки на половине длительности потока с момента начала). Значение по умолчанию — 100 %, значит, остановка будет в конце потоковой передачи.

start

string

Позиция во входном видео, с которого начинается создание эскизов. Значение может быть в формате ISO 8601 (например, PT05S начнет процесс на 5 секундах), в количестве кадров (например, значение 10 начнет захват на 10-м кадре) или в относительном значении по отношению к продолжительности потоковой передачи (например 10 % начнет процесс на 10 % длительности передачи). Также поддерживается макрос {Best}, который указывает кодирующему устройству выбрать лучший эскиз из первых нескольких секунд видео и создать только один эскиз независимо от других настроек, установленных для параметров шага и диапазона. Значение по умолчанию — макрос {Best}.

step

string

Интервалы, с которыми создаются эскизы. Значение может быть в формате ISO 8601 (например, PT05S для одного изображения каждые 5 секунд), число кадров (например, 30 для одного изображения каждые 30 кадров) или относительное значение длительности потока (например, 10 % для одного изображения каждые 10 % от длительности потока). Примечание. Значение шага повлияет на первый созданный эскиз, который может отличаться от указанного в предустановленное время начала преобразования. Это связано с тем, что кодировщик пытается выбрать лучший эскиз между временем начала и положением шага от времени начала в качестве первого выходных данных. Так как значение по умолчанию равно 10 %, это означает, что если поток имеет длинную длительность, первый созданный эскиз может находиться далеко от указанного во время запуска. Попробуйте выбрать разумное значение для шага, если ожидается, что первый эскиз близок к времени начала, или задайте значение Range равным 1, если во время начала требуется только один эскиз.

stretchMode

StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize.

syncMode

VideoSyncMode

Режим синхронизации видео

ImageFormat

Описывает свойства выходного файла изображения.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.ImageFormat

Дискриминатор для производных типов.

filenamePattern

string

Шаблон именования файлов, используемый для создания выходных файлов. В имени файла поддерживаются следующие макросы: {Basename} — макрос расширения, который будет использовать имя входного видеофайла. Если базовое имя (суффикс файла не включен) входного видеофайла длиной менее 32 символов, будет использоваться базовое имя входных видеофайлов. Если длина базового имени входного видеофайла превышает 32 символа, базовое имя усекается до первых 32 символов общей длины. {Extension} — соответствующее расширение для этого формата. {Label} — метка, назначенная кодеку или уровню. {Index} — уникальный индекс для эскизов. Применимо только к эскизам. {AudioStream} — строка "Audio" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.

InputFile

InputDefinition для одного файла. Областью выбора TrackSelections является указанный файл.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.InputFile

Дискриминатор для производных типов.

filename

string

Имя файла, к которому применяется это определение входных данных.

includedTracks TrackDescriptor[]:

Список элементов TrackDescriptor, определяющих метаданные и выбор дорожек во входных данных.

InsightsType

Определяет тип аналитических сведений, которые служба будет создавать. Допустимые значения: AudioInsightsOnly, VideoInsightsOnly и AllInsights. Значение по умолчанию — AllInsights. Если для этого параметра задано значение AllInsights, а входными данными является только звук, создается только звуковая аналитика. Аналогичным образом, если входные данные являются только видео, создаются только аналитические сведения о видео. Рекомендуется не использовать AudioInsightsOnly, если предполагается, что некоторые входные данные будут только видео. или используйте VideoInsightsOnly, если предполагается, что некоторые входные данные будут только аудио. Ваши задания в таких условиях будут ошибок.

Имя Тип Описание
AllInsights

string

Создайте аналитику звука и видео. Сбой при сбое аналитики звука или видео.

AudioInsightsOnly

string

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

VideoInsightsOnly

string

Создавайте аналитические сведения только для видео. Игнорируйте звук, если он присутствует. Сбой, если видео отсутствует.

InterleaveOutput

Задает режим чередовки выходных данных для управления хранением звука и видео в формате контейнера. Пример: задайте параметр InterleavedOutput как NonInterleavedOutput, чтобы создавать выходные данные только для аудио и только для видео в отдельных MP4-файлах.

Имя Тип Описание
InterleavedOutput

string

Выходные данные включают как аудио, так и видео.

NonInterleavedOutput

string

Выходные данные доступны только для видео или только для аудио.

Job

Тип ресурса Job. Ход выполнения и состояние можно получить, опрашив задание или подписавшись на события с помощью EventGrid.

Имя Тип Описание
id

string

Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Имя ресурса.

properties.correlationData

object

Предоставленные клиентом пары "ключ" и "значение", которые будут возвращены в событиях состояния Job и JobOutput.

properties.created

string

Дата и время создания задания в формате UTC в формате ГГГГ-ММ-ДДЧЧч:мм:ссЗ.

properties.description

string

Необязательное предоставляемое клиентом описание задания.

properties.endTime

string

Дата и время завершения обработки задания в формате UTC.

properties.input JobInput:

Входные данные для задания.

properties.lastModified

string

Дата и время последнего обновления задания в формате UTC в формате ГГГГ-ММ-ДДЧЧч:мм:ссЗ.

properties.outputs JobOutput[]:

JobOutputAsset[]

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

properties.priority

Priority

Приоритет обработки задания. Задания с более высоким приоритетом обрабатываются раньше, чем задания с низким приоритетом. Если значение не задано, по умолчанию используется значение normal.

properties.startTime

string

Дата и время начала обработки задания в формате UTC.

properties.state

JobState

Текущее состояние задания.

systemData

systemData

Системные метаданные, относящиеся к этому ресурсу.

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

JobError

Сведения об ошибках JobOutput.

Имя Тип Описание
category

JobErrorCategory

Помогает с классификацией ошибок.

code

JobErrorCode

Код ошибки, описывающий ошибку.

details

JobErrorDetail[]

Массив сведений о конкретных ошибках, которые привели к этой сообщаемой ошибке.

message

string

Удобочитаемое представление ошибки, зависящей от языка.

retry

JobRetry

Указывает, что можно повторить задание. Если повторные попытки не увенчались успехом, обратитесь к поддержка Azure через портал Azure.

JobErrorCategory

Помогает с классификацией ошибок.

Имя Тип Описание
Account

string

Ошибка связана со сведениями об учетной записи.

Configuration

string

Ошибка связана с конфигурацией.

Content

string

Ошибка связана с данными во входных файлах.

Download

string

Ошибка связана с загрузкой.

Service

string

Ошибка связана со службой.

Upload

string

Ошибка связана с отправкой.

JobErrorCode

Код ошибки, описывающий ошибку.

Имя Тип Описание
ConfigurationUnsupported

string

Возникла проблема с сочетанием входных файлов и примененных параметров конфигурации, исправлением параметров конфигурации и повторным повтором с теми же входными данными или изменением входных данных в соответствии с конфигурацией.

ContentMalformed

string

Возникла проблема с входным содержимым (например, с нулевыми файлами или поврежденными или недеодируемыми файлами) проверка входных файлов.

ContentUnsupported

string

Возникла проблема с форматом входных данных (недопустимый файл мультимедиа или неподдерживаемый файл или кодек), проверка допустимость входных файлов.

DownloadNotAccessible

string

При попытке скачать входные файлы были недоступны, проверка доступность источника.

DownloadTransientError

string

При попытке скачать входные файлы возникла проблема во время передачи (служба хранилища, ошибки сети), см. подробные сведения и проверка источнике.

IdentityUnsupported

string

Произошла ошибка при проверке удостоверения учетной записи. Проверьте и исправьте конфигурации удостоверений и повторите попытку. В случае неудачи обратитесь в службу поддержки.

ServiceError

string

Неустранимая ошибка службы, обратитесь в службу поддержки.

ServiceTransientError

string

Временная ошибка. Повторите попытку. Если повторная попытка не выполнена, обратитесь в службу поддержки.

UploadNotAccessible

string

При попытке отправить выходные файлы назначение было недоступно, проверка доступность назначения.

UploadTransientError

string

При попытке отправить выходные файлы во время передачи возникла проблема (служба хранилища, сетевые ошибки). См. подробные сведения и проверка назначения.

JobErrorDetail

Сведения об ошибках JobOutput.

Имя Тип Описание
code

string

Код, описывающий сведения об ошибке.

message

string

Удобочитаемое представление ошибки.

JobInputAsset

Представляет ресурс для входных данных в задание.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.JobInputAsset

Дискриминатор для производных типов.

assetName

string

Имя входного ресурса.

end ClipTime:

Определяет точку на временная шкала входного носителя, в которой завершится обработка. Значение по умолчанию — конец входного носителя.

files

string[]

Список файлов. Требуется для JobInputHttp. Не более 4000 символов каждый. Строки запроса не возвращаются в ответах службы, чтобы предотвратить раскрытие конфиденциальных данных.

inputDefinitions InputDefinition[]:

Определяет список InputDefinitions. Для каждого inputDefinition он определяет список выбранных дорожек и связанных метаданных.

label

string

Метка, назначенная jobInputClip, которая используется для соответствия ссылке, используемой в преобразовании. Например, преобразование можно создать таким образом, чтобы получить файл изображения с меткой "xyz" и применить его в качестве наложения на входном видео перед его кодированием. При отправке задания в качестве файла изображения должен быть только один из jobInputs, который должен иметь метку "xyz".

start ClipTime:

Определяет точку на временная шкала входного носителя, с которой начнется обработка. Значение по умолчанию — начало входного носителя.

JobInputClip

Представляет входные файлы для задания.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.JobInputClip

Дискриминатор для производных типов.

end ClipTime:

Определяет точку на временная шкала входного носителя, в которой завершится обработка. Значение по умолчанию — конец входного носителя.

files

string[]

Список файлов. Требуется для JobInputHttp. Не более 4000 символов каждый. Строки запроса не возвращаются в ответах службы, чтобы предотвратить раскрытие конфиденциальных данных.

inputDefinitions InputDefinition[]:

Определяет список InputDefinitions. Для каждого inputDefinition он определяет список выбранных дорожек и связанных метаданных.

label

string

Метка, назначенная jobInputClip, которая используется для соответствия ссылке, используемой в преобразовании. Например, преобразование можно создать таким образом, чтобы получить файл изображения с меткой "xyz" и применить его в качестве наложения на входном видео перед его кодированием. При отправке задания в качестве файла изображения должен быть только один из jobInputs, который должен иметь метку "xyz".

start ClipTime:

Определяет точку на временная шкала входного носителя, с которой начнется обработка. Значение по умолчанию — начало входного носителя.

JobInputHttp

Представляет входные данные задания HTTPS.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.JobInputHttp

Дискриминатор для производных типов.

baseUri

string

Базовый URI для входных данных задания HTTPS. Он будет сцеплен с указанными именами файлов. Если базовый URI не указан, то предоставленный список файлов считается полным URI. Максимальная длина 4000 символов. Строки запроса не будут возвращены в ответах службы, чтобы предотвратить раскрытие конфиденциальных данных.

end ClipTime:

Определяет точку на временная шкала входного носителя, в которой завершится обработка. Значение по умолчанию — конец входного носителя.

files

string[]

Список файлов. Требуется для JobInputHttp. Не более 4000 символов каждый. Строки запроса не возвращаются в ответах службы, чтобы предотвратить раскрытие конфиденциальных данных.

inputDefinitions InputDefinition[]:

Определяет список InputDefinitions. Для каждого inputDefinition он определяет список выбранных дорожек и связанных метаданных.

label

string

Метка, назначенная jobInputClip, которая используется для соответствия ссылке, используемой в преобразовании. Например, преобразование можно создать таким образом, чтобы получить файл изображения с меткой "xyz" и применить его в качестве наложения на входном видео перед его кодированием. При отправке задания в качестве файла изображения должен быть только один из jobInputs, который должен иметь метку "xyz".

start ClipTime:

Определяет точку на временная шкала входного носителя, с которой начнется обработка. Значение по умолчанию — начало входного носителя.

JobInputs

Описывает список входных данных для задания.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.JobInputs

Дискриминатор для производных типов.

inputs JobInput[]:

Список входных данных для задания.

JobInputSequence

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

Имя Тип Описание
@odata.type string:

#Microsoft.Media.JobInputSequence

Дискриминатор для производных типов.

inputs JobInputClip[]:

JobInputs, составляющие временная шкала.

JobOutputAsset

Представляет ресурс, используемый в качестве JobOutput.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.JobOutputAsset

Дискриминатор для производных типов.

assetName

string

Имя выходного ресурса.

endTime

string

Дата и время окончания обработки выходных данных задания в формате UTC.

error

JobError

Если jobOutput находится в состоянии Ошибка, он содержит сведения об ошибке.

label

string

Метка, назначенная JobOutput для уникальной идентификации. Это полезно, если в преобразовании имеется несколько TransformOutput, а задание содержит несколько JobOutput. В таких случаях при отправке задания вы добавите два или более JobOutputs в том же порядке, что и TransformOutputs в преобразовании. Затем при извлечении задания с помощью событий или запроса GET можно использовать метку , чтобы легко идентифицировать JobOutput. Если метка не указана, будет использоваться значение по умолчанию "{presetName}_{outputIndex}", где имя предустановки — это имя предустановки в соответствующем transformOutput, а выходной индекс — относительный индекс этого jobOutput в задании. Обратите внимание, что этот индекс совпадает с относительным индексом соответствующего transformOutput в преобразовании.

presetOverride Preset:

Предустановка, используемая для переопределения предустановки в соответствующих выходных данных преобразования.

progress

integer

Если JobOutput находится в состоянии Обработки, он содержит процент завершения задания. Это значение является оценкой и не предназначено для прогнозирования времени завершения задания. Чтобы определить, завершен ли jobOutput, используйте свойство State.

startTime

string

Дата и время начала обработки выходных данных задания в формате UTC.

state

JobState

Описывает состояние JobOutput.

JobRetry

Указывает, что можно повторить задание. Если повторные попытки не увенчались успехом, обратитесь к поддержка Azure через портал Azure.

Имя Тип Описание
DoNotRetry

string

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

MayRetry

string

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

JobState

Описывает состояние JobOutput.

Имя Тип Описание
Canceled

string

Задание отменено. Это конечное состояние для задания.

Canceling

string

Задание находится в процессе отмены. Это временное состояние задания.

Error

string

В задании произошла ошибка. Это конечное состояние для задания.

Finished

string

Задание завершено. Это конечное состояние для задания.

Processing

string

Выполняется обработка задания. Это временное состояние задания.

Queued

string

Задание находится в состоянии очереди и ожидает, пока ресурсы станут доступными. Промежуточное состояние.

Scheduled

string

Задание запланировано для выполнения в доступном ресурсе. Это временное состояние между состоянием постановки в очередь и состоянием обработки.

JpgFormat

Описывает параметры создания эскизов JPEG.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.JpgFormat

Дискриминатор для производных типов.

filenamePattern

string

Шаблон именования файлов, используемый для создания выходных файлов. В имени файла поддерживаются следующие макросы: {Basename} — макрос расширения, который будет использовать имя входного видеофайла. Если базовое имя (суффикс файла не включен) входного видеофайла длиной менее 32 символов, будет использоваться базовое имя входных видеофайлов. Если длина базового имени входного видеофайла превышает 32 символа, базовое имя усекается до первых 32 символов общей длины. {Extension} — соответствующее расширение для этого формата. {Label} — метка, назначенная кодеку или уровню. {Index} — уникальный индекс для эскизов. Применимо только к эскизам. {AudioStream} — строка "Audio" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.

JpgImage

Описывает свойства для создания ряда изображений JPEG из входного видео.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.JpgImage

Дискриминатор для производных типов.

keyFrameInterval

string

Расстояние между двумя ключевыми кадрами. Значение должно быть ненулевым в диапазоне [0,5, 20] секунд, указанном в формате ISO 8601. Значение по умолчанию — 2 секунды (PT2S). Обратите внимание, что этот параметр игнорируется, если задан параметр VideoSyncMode.Passthrough, где значение KeyFrameInterval будет следовать за параметром источника входных данных.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

layers

JpgLayer[]

Коллекция выходных слоев изображений JPEG, создаваемых кодировщиком.

range

string

Позиция относительно предустановленного времени начала преобразования во входном видео, при котором прекращается создание эскизов. Значение может быть в формате ISO 8601 (например, PT5M30S остановиться на 5 минутах и 30 секундах с момента начала) или число кадров (например, 300, чтобы остановиться на 300-м кадре от кадра во время начала). Если это значение равно 1, это означает создание только одного эскиза во время начала или относительное значение длительности потока (например, 50 % для остановки на половине длительности потока с момента начала). Значение по умолчанию — 100 %, значит, остановка будет в конце потоковой передачи.

spriteColumn

integer

Задает количество столбцов, используемых в изображении эскиза спрайта. Количество строк вычисляется автоматически, и создается VTT-файл с сопоставлениями координат для каждого эскиза в спрайте. Примечание. Это значение должно быть положительным целым числом, и рекомендуется правильное значение, чтобы разрешение выходного изображения не выходит за пределы максимального разрешения пикселей JPEG 65535x65535.

start

string

Позиция во входном видео, с которого начинается создание эскизов. Значение может быть в формате ISO 8601 (например, PT05S начнет процесс на 5 секундах), в количестве кадров (например, значение 10 начнет захват на 10-м кадре) или в относительном значении по отношению к продолжительности потоковой передачи (например 10 % начнет процесс на 10 % длительности передачи). Также поддерживается макрос {Best}, который указывает кодирующему устройству выбрать лучший эскиз из первых нескольких секунд видео и создать только один эскиз независимо от других настроек, установленных для параметров шага и диапазона. Значение по умолчанию — макрос {Best}.

step

string

Интервалы, с которыми создаются эскизы. Значение может быть в формате ISO 8601 (например, PT05S для одного изображения каждые 5 секунд), число кадров (например, 30 для одного изображения каждые 30 кадров) или относительное значение длительности потока (например, 10 % для одного изображения каждые 10 % от длительности потока). Примечание. Значение шага повлияет на первый созданный эскиз, который может отличаться от указанного в предустановленное время начала преобразования. Это связано с тем, что кодировщик пытается выбрать лучший эскиз между временем начала и положением шага от времени начала в качестве первого выходных данных. Так как значение по умолчанию равно 10 %, это означает, что если поток имеет длинную длительность, первый созданный эскиз может находиться далеко от указанного во время запуска. Попробуйте выбрать разумное значение для шага, если ожидается, что первый эскиз близок к времени начала, или задайте значение Range равным 1, если во время начала требуется только один эскиз.

stretchMode

StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize.

syncMode

VideoSyncMode

Режим синхронизации видео

JpgLayer

Описывает параметры для создания изображения JPEG из входного видео.

Имя Тип Описание
height

string

Высота выходного видео для этого слоя. Значение может быть абсолютным (в пикселях) или относительным (в процентах). Например, значение 50 % означает, что высота выходного видео вдвое меньше, чем входные данные.

label

string

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

quality

integer

Качество сжатия выходных данных JPEG. Диапазон от 0 до 100, а значение по умолчанию — 70.

width

string

Ширина выходного видео для этого слоя. Значение может быть абсолютным (в пикселях) или относительным (в процентах). Например, 50 % означает, что выходное видео имеет половину ширины пикселей, чем входные данные.

Mp4Format

Описывает свойства выходного ФАЙЛА ISO MP4.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.Mp4Format

Дискриминатор для производных типов.

filenamePattern

string

Шаблон именования файлов, используемый для создания выходных файлов. В имени файла поддерживаются следующие макросы: {Basename} — макрос расширения, который будет использовать имя входного видеофайла. Если базовое имя (суффикс файла не включен) входного видеофайла длиной менее 32 символов, будет использоваться базовое имя входных видеофайлов. Если длина базового имени входного видеофайла превышает 32 символа, базовое имя усекается до первых 32 символов общей длины. {Extension} — соответствующее расширение для этого формата. {Label} — метка, назначенная кодеку или уровню. {Index} — уникальный индекс для эскизов. Применимо только к эскизам. {AudioStream} — строка "Audio" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.

outputFiles

OutputFile[]

Список выходных файлов для создания. Каждая запись в списке представляет собой набор меток аудио- и видеослойков, которые необходимо объединить вместе.

MultiBitrateFormat

Описывает свойства для создания коллекции файлов с поддержкой GOP с несколькими скоростями. По умолчанию создается один выходной файл для каждого уровня видео, который объединяется со всеми звуками. Точные выходные файлы можно контролировать, указав коллекцию outputFiles.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.MultiBitrateFormat

Дискриминатор для производных типов.

filenamePattern

string

Шаблон именования файлов, используемый для создания выходных файлов. В имени файла поддерживаются следующие макросы: {Basename} — макрос расширения, который будет использовать имя входного видеофайла. Если базовое имя (суффикс файла не включен) входного видеофайла длиной менее 32 символов, будет использоваться базовое имя входных видеофайлов. Если длина базового имени входного видеофайла превышает 32 символа, базовое имя усекается до первых 32 символов общей длины. {Extension} — соответствующее расширение для этого формата. {Label} — метка, назначенная кодеку или уровню. {Index} — уникальный индекс для эскизов. Применимо только к эскизам. {AudioStream} — строка "Audio" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.

outputFiles

OutputFile[]

Список выходных файлов для создания. Каждая запись в списке представляет собой набор меток аудио- и видеослойков, которые необходимо объединить вместе.

OutputFile

Представляет созданный выходной файл.

Имя Тип Описание
labels

string[]

Список меток, описывающих, как кодировщик должен мультиплексировать видео и звук в выходной файл. Например, если кодировщик создает два слоя видео с метками v1 и v2 и один звуковой слой с меткой a1, то такой массив, как "[v1, a1]" указывает кодировщику создать выходной файл с видеодорожкой, представленной версией 1, и звуковой дорожкой, представленной a1.

PngFormat

Описывает параметры создания эскизов PNG.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.PngFormat

Дискриминатор для производных типов.

filenamePattern

string

Шаблон именования файлов, используемый для создания выходных файлов. В имени файла поддерживаются следующие макросы: {Basename} — макрос расширения, который будет использовать имя входного видеофайла. Если базовое имя (суффикс файла не включен) входного видеофайла длиной менее 32 символов, будет использоваться базовое имя входных видеофайлов. Если длина базового имени входного видеофайла превышает 32 символа, базовое имя усекается до первых 32 символов общей длины. {Extension} — соответствующее расширение для этого формата. {Label} — метка, назначенная кодеку или уровню. {Index} — уникальный индекс для эскизов. Применимо только к эскизам. {AudioStream} — строка "Audio" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.

PngImage

Описывает свойства для создания ряда изображений PNG из входного видео.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.PngImage

Дискриминатор для производных типов.

keyFrameInterval

string

Расстояние между двумя ключевыми кадрами. Значение должно быть ненулевым в диапазоне [0,5, 20] секунд, указанном в формате ISO 8601. Значение по умолчанию — 2 секунды (PT2S). Обратите внимание, что этот параметр игнорируется, если задан параметр VideoSyncMode.Passthrough, где значение KeyFrameInterval будет следовать за параметром источника входных данных.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

layers

PngLayer[]

Коллекция выходных слоев изображений PNG, создаваемых кодировщиком.

range

string

Позиция относительно предустановленного времени начала преобразования во входном видео, при котором прекращается создание эскизов. Значение может быть в формате ISO 8601 (например, PT5M30S остановиться на 5 минутах и 30 секундах с момента начала) или число кадров (например, 300, чтобы остановиться на 300-м кадре от кадра во время начала). Если это значение равно 1, это означает создание только одного эскиза во время начала или относительное значение длительности потока (например, 50 % для остановки на половине длительности потока с момента начала). Значение по умолчанию — 100 %, значит, остановка будет в конце потоковой передачи.

start

string

Позиция во входном видео, с которого начинается создание эскизов. Значение может быть в формате ISO 8601 (например, PT05S начнет процесс на 5 секундах), в количестве кадров (например, значение 10 начнет захват на 10-м кадре) или в относительном значении по отношению к продолжительности потоковой передачи (например 10 % начнет процесс на 10 % длительности передачи). Также поддерживается макрос {Best}, который указывает кодирующему устройству выбрать лучший эскиз из первых нескольких секунд видео и создать только один эскиз независимо от других настроек, установленных для параметров шага и диапазона. Значение по умолчанию — макрос {Best}.

step

string

Интервалы, с которыми создаются эскизы. Значение может быть в формате ISO 8601 (например, PT05S для одного изображения каждые 5 секунд), число кадров (например, 30 для одного изображения каждые 30 кадров) или относительное значение длительности потока (например, 10 % для одного изображения каждые 10 % от длительности потока). Примечание. Значение шага повлияет на первый созданный эскиз, который может отличаться от указанного в предустановленное время начала преобразования. Это связано с тем, что кодировщик пытается выбрать лучший эскиз между временем начала и положением шага от времени начала в качестве первого выходных данных. Так как значение по умолчанию равно 10 %, это означает, что если поток имеет длинную длительность, первый созданный эскиз может находиться далеко от указанного во время запуска. Попробуйте выбрать разумное значение для шага, если ожидается, что первый эскиз близок к времени начала, или задайте значение Range равным 1, если во время начала требуется только один эскиз.

stretchMode

StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize.

syncMode

VideoSyncMode

Режим синхронизации видео

PngLayer

Описывает параметры для создания изображения в формате PNG из входного видео.

Имя Тип Описание
height

string

Высота выходного видео для этого слоя. Значение может быть абсолютным (в пикселях) или относительным (в процентах). Например, значение 50 % означает, что высота выходного видео вдвое меньше, чем входные данные.

label

string

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

width

string

Ширина выходного видео для этого слоя. Значение может быть абсолютным (в пикселях) или относительным (в процентах). Например, 50 % означает, что выходное видео имеет половину ширины пикселей, чем входные данные.

PresetConfigurations

Объект необязательных параметров конфигурации для кодировщика.

Имя Тип Описание
complexity

Complexity

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

interleaveOutput

InterleaveOutput

Задает режим чередовки выходных данных для управления хранением звука и видео в формате контейнера. Пример: задайте параметр InterleavedOutput как NonInterleavedOutput, чтобы создавать выходные данные только для аудио и только для видео в отдельных MP4-файлах.

keyFrameIntervalInSeconds

number

Интервал ключевого кадра в секундах. Пример: задайте для KeyFrameIntervalInSeconds значение 2, чтобы уменьшить буферизацию воспроизведения для некоторых проигрывателей.

maxBitrateBps

integer

Максимальная скорость в битах в секунду (пороговое значение для верхнего уровня видео). Пример: задайте значение MaxBitrateBps равным 6000000, чтобы избежать создания выходных данных с очень высокой скоростью для содержимого с высокой сложностью.

maxHeight

integer

Максимальная высота слоев выходного видео. Пример: задайте для MaxHeight значение 720, чтобы создать выходные слои до 720P, даже если входные данные равны 4 КБ.

maxLayers

integer

Максимальное количество слоев выходного видео. Пример: задайте для MaxLayers значение 4, чтобы обеспечить не более 4 выходных слоев для управления общей стоимостью задания кодирования.

minBitrateBps

integer

Минимальная скорость в битах в секунду (пороговое значение для нижнего уровня видео). Пример: задайте для Параметра MinBitrateBps значение 200000, чтобы иметь нижний слой, охватывающий пользователей с низкой пропускной способностью сети.

minHeight

integer

Минимальная высота слоев выходного видео. Пример: задайте для MinHeight значение 360, чтобы избежать выходных слоев с меньшим разрешением, например 180P.

Priority

Задает относительный приоритет TransformOutputs в преобразовании. При этом задается приоритет, который служба использует для обработки TransformOutputs. Приоритет по умолчанию — Обычный.

Имя Тип Описание
High

string

Используется для TransformOutputs, которые должны иметь приоритет над другими.

Low

string

Используется для TransformOutputs, которые могут быть созданы после преобразования TransformOutputs с обычным и высоким приоритетом.

Normal

string

Используется для transformOutputs, которые могут быть созданы с приоритетом "Обычный".

Rectangle

Описывает свойства прямоугольного окна, применяемого к входному носителю перед его обработкой.

Имя Тип Описание
height

string

Высота прямоугольной области в пикселях. Это может быть абсолютное значение пикселя (например, 100) или относительно размера видео (например, 50 %).

left

string

Количество пикселей от левого поля. Это может быть абсолютное значение пикселя (например, 100) или относительно размера видео (например, 50 %).

top

string

Количество пикселей от верхнего поля. Это может быть абсолютное значение пикселя (например, 100) или относительно размера видео (например, 50 %).

width

string

Ширина прямоугольной области в пикселях. Это может быть абсолютное значение пикселя (например, 100) или относительно размера видео (например, 50 %).

Rotation

Поворот, если таковой имеется, применяется к входной видео перед его кодированием. Значение по умолчанию — Auto

Имя Тип Описание
Auto

string

Автоматическое обнаружение и поворот при необходимости.

None

string

Не поворачивайте видео. Если формат вывода поддерживает его, все метаданные о повороте сохраняются без изменений.

Rotate0

string

Не поворачивайте видео, но удалите все метаданные о повороте.

Rotate180

string

Поворот на 180 градусов по часовой стрелке.

Rotate270

string

Поворот на 270 градусов по часовой стрелке.

Rotate90

string

Повернуть на 90 градусов по часовой стрелке.

SelectAudioTrackByAttribute

Выберите звуковые дорожки из входных данных, указав атрибут и фильтр атрибутов.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.SelectAudioTrackByAttribute

Дискриминатор для производных типов.

attribute

TrackAttribute

Атрибут TrackAttribute для фильтрации дорожек.

channelMapping

ChannelMapping

Необязательное обозначение для одноканальной аудиодорожки. Можно использовать для объединения дорожек в стерео- или многоканаловую аудиодорожку.

filter

AttributeFilter

Тип AttributeFilter, применяемый к TrackAttribute для выбора дорожек.

filterValue

string

Значение для фильтрации дорожек. Используется только при указании AttributeFilter.ValueEquals для свойства Filter.

SelectAudioTrackById

Выберите звуковые дорожки из входных данных, указав идентификатор дорожки.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.SelectAudioTrackById

Дискриминатор для производных типов.

channelMapping

ChannelMapping

Необязательное обозначение для одноканальной аудиодорожки. Можно использовать для объединения дорожек в стерео- или многоканаловую аудиодорожку.

trackId

integer

Идентификатор отслеживания для выбора

SelectVideoTrackByAttribute

Выберите видеодорожки из входных данных, указав атрибут и фильтр атрибутов.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.SelectVideoTrackByAttribute

Дискриминатор для производных типов.

attribute

TrackAttribute

Атрибут TrackAttribute для фильтрации дорожек.

filter

AttributeFilter

Тип AttributeFilter, применяемый к TrackAttribute для выбора дорожек.

filterValue

string

Значение для фильтрации дорожек. Используется только при указании AttributeFilter.ValueEquals для свойства Filter. Для TrackAttribute.Bitrate это должно быть целочисленное значение в битах в секунду (например, 1500000). TrackAttribute.Language не поддерживается для видеодорожек.

SelectVideoTrackById

Выберите видеодорожки из входных данных, указав идентификатор дорожки.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.SelectVideoTrackById

Дискриминатор для производных типов.

trackId

integer

Идентификатор отслеживания для выбора

StandardEncoderPreset

Описание всех параметров, используемых при кодировании входного видео с помощью стандартного кодировщика.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.StandardEncoderPreset

Дискриминатор для производных типов.

codecs Codec[]:

Список кодеков, используемых при кодировании входного видео.

experimentalOptions

object

Словарь, содержащий пары "ключ-значение" для параметров, не предоставленных в самой предустановке

filters

Filters

Одна или несколько операций фильтрации, которые применяются к входным носителям перед кодировкой.

formats Format[]:

Список выходных данных, создаваемых кодировщиком.

StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize.

Имя Тип Описание
AutoFit

string

Закрепите выходные данные (с помощью почтового ящика или столба) в соответствии с разрешением выходных данных, гарантируя, что активная область видео в выходных данных имеет тот же пропорции, что и входные данные. Например, если входные данные — 1920 x 1080 и предустановка кодирования запрашивает 1280 x 1280, то выходные данные будут иметь размер 1280 x 1280, который содержит внутренний прямоугольник 1280 x 720 с пропорциями 16:9 и области столба шириной 280 пикселей слева и справа.

AutoSize

string

Переопределите разрешение выходных данных и измените его в соответствии с пропорциями отображения входных данных без заполнения. Например, если разрешение исходного видео составляет 1920×1080, а в предустановках кодирования задано 1280×1280, предустановленное значение будет изменено, а разрешение выходного видео составит 1280×720, что соответствует пропорциям входного видео, равным 16:9.

None

string

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

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Удостоверение, которое в последний раз изменял ресурс.

lastModifiedByType

createdByType

Тип удостоверения, изменяющего ресурс в последний раз.

TrackAttribute

Атрибут TrackAttribute для фильтрации дорожек.

Имя Тип Описание
Bitrate

string

Скорость дорожки.

Language

string

Язык дорожки.

TransportStreamFormat

Описывает свойства для создания выходных видеофайлов транспортного потока MPEG-2 (ISO/IEC 13818-1).

Имя Тип Описание
@odata.type string:

#Microsoft.Media.TransportStreamFormat

Дискриминатор для производных типов.

filenamePattern

string

Шаблон именования файлов, используемый для создания выходных файлов. В имени файла поддерживаются следующие макросы: {Basename} — макрос расширения, который будет использовать имя входного видеофайла. Если базовое имя (суффикс файла не включен) входного видеофайла длиной менее 32 символов, будет использоваться базовое имя входных видеофайлов. Если длина базового имени входного видеофайла превышает 32 символа, базовое имя усекается до первых 32 символов общей длины. {Extension} — соответствующее расширение для этого формата. {Label} — метка, назначенная кодеку или уровню. {Index} — уникальный индекс для эскизов. Применимо только к эскизам. {AudioStream} — строка "Audio" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.

outputFiles

OutputFile[]

Список выходных файлов для создания. Каждая запись в списке представляет собой набор меток аудио- и видеослойков, которые необходимо объединить вместе.

UtcClipTime

Указывает время клипа в формате UTC в файле мультимедиа. Время в формате UTC может указывать на другую позицию в зависимости от того, начинается ли файл мультимедиа с нулевой метки времени.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.UtcClipTime

Дискриминатор для производных типов.

time

string

Позиция времени на временная шкала входного носителя в зависимости от времени в формате UTC.

Video

Описание основных свойств для кодирования входного видео.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.Video

Дискриминатор для производных типов.

keyFrameInterval

string

Расстояние между двумя ключевыми кадрами. Значение должно быть ненулевым в диапазоне [0,5, 20] секунд, указанном в формате ISO 8601. Значение по умолчанию — 2 секунды (PT2S). Обратите внимание, что этот параметр игнорируется, если задан параметр VideoSyncMode.Passthrough, где значение KeyFrameInterval будет следовать за параметром источника входных данных.

label

string

Необязательная метка для кодека. Метку можно использовать для управления поведением мультиплексирования.

stretchMode

StretchMode

Режим изменения размера — изменение размера входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — AutoSize.

syncMode

VideoSyncMode

Режим синхронизации видео

VideoAnalyzerPreset

Предустановка видеоанализатора, которая извлекает аналитические сведения (расширенные метаданные) из аудио и видео и выводит файл формата JSON.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.VideoAnalyzerPreset

Дискриминатор для производных типов.

audioLanguage

string

Язык для полезных данных аудио во входных данных с использованием формата BCP-47 "language tag-region" (например, "en-US"). Если вы знаете язык содержимого, рекомендуется указать его. Язык должен быть явно указан для AudioAnalysisMode::Basic, так как автоматическое определение языка не включается в базовый режим. Если язык не указан или имеет значение NULL, функция автоматического распознавания языка выберет первый обнаруженный язык и обработает весь файл, используя этот язык. Сейчас она не поддерживает динамическое переключение между языками после распознавания первого языка. Автоматическое обнаружение лучше всего работает с аудиозаписями с четко различимой речью. Если автоматическому обнаружению не удается найти язык, транскрибирование будет откатиться на en-US". Список поддерживаемых языков доступен здесь: https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

Словарь, содержащий пары "ключ-значение" для параметров, не предоставленных в самой предустановке

insightsToExtract

InsightsType

Определяет тип аналитических сведений, которые служба будет создавать. Допустимые значения: AudioInsightsOnly, VideoInsightsOnly и AllInsights. Значение по умолчанию — AllInsights. Если для этого параметра задано значение AllInsights, а входными данными является только звук, создается только звуковая аналитика. Аналогичным образом, если входные данные являются только видео, создаются только аналитические сведения о видео. Рекомендуется не использовать AudioInsightsOnly, если предполагается, что некоторые входные данные будут только видео. или используйте VideoInsightsOnly, если предполагается, что некоторые входные данные будут только аудио. Ваши задания в таких условиях будут ошибок.

mode

AudioAnalysisMode

Определяет набор выполняемых операций анализа звука. Если этот параметр не указан, будет выбран стандартный AudioAnalysisMode.

VideoOverlay

Описывает свойства наложения видео.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.VideoOverlay

Дискриминатор для производных типов.

audioGainLevel

number

Уровень увеличения звука в наложении. Значение должно находиться в диапазоне [0, 1,0]. Значение по умолчанию — 1.0.

cropRectangle

Rectangle

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

end

string

Конечная позиция со ссылкой на входное видео, на котором заканчивается наложение. Значение должно быть в формате ISO 8601. Например, PT30S, чтобы завершить наложение на 30 секунд входного видео. Если значение не указано или значение больше длительности входного видео, наложение будет применяться до конца входного видео, если длительность носителя наложения больше длительности входного видео, в противном случае наложение будет длиться столько же, сколько и длительность наложения.

fadeInDuration

string

Продолжительность, в течение которой наложение исчезает на входном видео. Значение должно быть в формате длительности ISO 8601. Если не указано, поведение по умолчанию будет не исчезать (то же, что и PT0S).

fadeOutDuration

string

Длительность, в течение которой наложение исчезает из входного видео. Значение должно быть в формате длительности ISO 8601. Если значение не указано, поведение по умолчанию будет не исчезать (то же, что и PT0S).

inputLabel

string

Метка входных данных задания, которая будет использоваться в качестве наложения. Входные данные должны указывать ровно один файл. Можно указать файл изображения в формате JPG, PNG, GIF или BMP, звуковой файл (например, файл WAV, MP3, WMA или M4A) или видеофайл. Полный список поддерживаемых форматов звуковых и видеофайлов см https://aka.ms/mesformats . в этой статье.

opacity

number

Непрозрачность наложения. Это значение в диапазоне [0–1,0]. Значение по умолчанию — 1.0, что означает, что наложение непрозрачно.

position

Rectangle

Расположение во входном видео, к которому применяется наложение.

start

string

Начальная позиция со ссылкой на входное видео, с которого начинается наложение. Значение должно быть в формате ISO 8601. Например, PT05S, чтобы начать наложение в 5 секунд входного видео. Если значение не указано, наложение начинается с начала входного видео.

VideoSyncMode

Режим синхронизации видео

Имя Тип Описание
Auto

string

Это метод по умолчанию. Выбор между Cfr и Vfr в зависимости от возможностей мультиплексера. Для выходного формата MP4 по умолчанию используется режим Cfr.

Cfr

string

Входные кадры будут повторяться и /или удаляться по мере необходимости для достижения точной постоянной частоты кадров. Рекомендуется, если частота кадров вывода явно задана по указанному значению

Passthrough

string

Метки времени презентации на кадрах передаются из входного файла в модуль записи выходного файла. Рекомендуется, если источник входных данных имеет переменную частоту кадров и пытается создать несколько слоев для адаптивной потоковой передачи в выходных данных, имеющих выровненные границы GOP. Примечание. Если два или более кадров во входных данных имеют повторяющиеся метки времени, то выходные данные также будут иметь то же поведение.

Vfr

string

Аналогично режиму сквозной передачи, но если входные данные имеют кадры с повторяющимися метками времени, то только один кадр передается в выходные данные, а другие удаляются. Рекомендуется, если ожидается, что количество выходных кадров равно количеству входных кадров. Например, выходные данные используются для вычисления метрики качества, такой как PSNR, на основе входных данных.

VideoTrackDescriptor

TrackSelection для выбора видеодорожек.

Имя Тип Описание
@odata.type string:

#Microsoft.Media.VideoTrackDescriptor

Дискриминатор для производных типов.