Transforms - Create Or Update

Служба:

Media Services

Версия API:

2022-07-01

Создание или обновление преобразования
Создает или обновляет новое преобразование.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountName	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.outputs	True	TransformOutput[]	Массив из одного или нескольких наборов выходных данных, созданных преобразованием.
properties.description		string	Подробное описание преобразования (необязательно).

Ответы

Имя	Тип	Описание
200 OK	Transform	ОК
201 Created	Transform	Создание
Other Status Codes	ErrorResponse	Подробные сведения об ошибке.

Примеры

Create or update a Transform

Образец запроса

HTTP

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

{
  "properties": {
    "description": "Example Transform to illustrate create and update.",
    "outputs": [
      {
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  }
}

Java

import com.azure.resourcemanager.mediaservices.models.BuiltInStandardEncoderPreset;
import com.azure.resourcemanager.mediaservices.models.EncoderNamedPreset;
import com.azure.resourcemanager.mediaservices.models.TransformOutput;
import java.util.Arrays;

/** Samples for Transforms CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-create.json
     */
    /**
     * Sample code: Create or update a Transform.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createOrUpdateATransform(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .transforms()
            .define("createdTransform")
            .withExistingMediaService("contosoresources", "contosomedia")
            .withDescription("Example Transform to illustrate create and update.")
            .withOutputs(
                Arrays
                    .asList(
                        new TransformOutput()
                            .withPreset(
                                new BuiltInStandardEncoderPreset()
                                    .withPresetName(EncoderNamedPreset.ADAPTIVE_STREAMING))))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.media import AzureMediaServices

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-media
# USAGE
    python transformscreate.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = AzureMediaServices(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.transforms.create_or_update(
        resource_group_name="contosoresources",
        account_name="contosomedia",
        transform_name="createdTransform",
        parameters={
            "properties": {
                "description": "Example Transform to illustrate create and update.",
                "outputs": [
                    {
                        "preset": {
                            "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
                            "presetName": "AdaptiveStreaming",
                        }
                    }
                ],
            }
        },
    )
    print(response)


# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-create.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armmediaservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mediaservices/armmediaservices/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e7bf3adfa2d5e5cdbb804eec35279501794f461c/specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-create.json
func ExampleTransformsClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmediaservices.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewTransformsClient().CreateOrUpdate(ctx, "contosoresources", "contosomedia", "createdTransform", armmediaservices.Transform{
		Properties: &armmediaservices.TransformProperties{
			Description: to.Ptr("Example Transform to illustrate create and update."),
			Outputs: []*armmediaservices.TransformOutput{
				{
					Preset: &armmediaservices.BuiltInStandardEncoderPreset{
						ODataType:  to.Ptr("#Microsoft.Media.BuiltInStandardEncoderPreset"),
						PresetName: to.Ptr(armmediaservices.EncoderNamedPresetAdaptiveStreaming),
					},
				}},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Transform = armmediaservices.Transform{
	// 	Name: to.Ptr("createdTransform"),
	// 	Type: to.Ptr("Microsoft.Media/mediaservices/transforms"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform"),
	// 	Properties: &armmediaservices.TransformProperties{
	// 		Description: to.Ptr("Example Transform to illustrate create and update."),
	// 		Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:31.766Z"); return t}()),
	// 		LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:31.766Z"); return t}()),
	// 		Outputs: []*armmediaservices.TransformOutput{
	// 			{
	// 				OnError: to.Ptr(armmediaservices.OnErrorTypeStopProcessingJob),
	// 				Preset: &armmediaservices.BuiltInStandardEncoderPreset{
	// 					ODataType: to.Ptr("#Microsoft.Media.BuiltInStandardEncoderPreset"),
	// 					PresetName: to.Ptr(armmediaservices.EncoderNamedPresetAdaptiveStreaming),
	// 				},
	// 				RelativePriority: to.Ptr(armmediaservices.PriorityNormal),
	// 		}},
	// 	},
	// 	SystemData: &armmediaservices.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:31.766Z"); return t}()),
	// 		CreatedBy: to.Ptr("contoso@microsoft.com"),
	// 		CreatedByType: to.Ptr(armmediaservices.CreatedByTypeUser),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2022-10-17T23:14:31.766Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("contoso@microsoft.com"),
	// 		LastModifiedByType: to.Ptr(armmediaservices.CreatedByTypeUser),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { AzureMediaServices } = require("@azure/arm-mediaservices");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates or updates a new Transform.
 *
 * @summary Creates or updates a new Transform.
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-create.json
 */
async function createOrUpdateATransform() {
  const subscriptionId =
    process.env["MEDIASERVICES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MEDIASERVICES_RESOURCE_GROUP"] || "contosoresources";
  const accountName = "contosomedia";
  const transformName = "createdTransform";
  const parameters = {
    description: "Example Transform to illustrate create and update.",
    outputs: [
      {
        preset: {
          odataType: "#Microsoft.Media.BuiltInStandardEncoderPreset",
          presetName: "AdaptiveStreaming",
        },
      },
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.transforms.createOrUpdate(
    resourceGroupName,
    accountName,
    transformName,
    parameters
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Media;
using Azure.ResourceManager.Media.Models;

// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/transforms-create.json
// this example is just showing the usage of "Transforms_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this MediaServicesAccountResource created on azure
// for more information of creating MediaServicesAccountResource, please refer to the document of MediaServicesAccountResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contosoresources";
string accountName = "contosomedia";
ResourceIdentifier mediaServicesAccountResourceId = MediaServicesAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
MediaServicesAccountResource mediaServicesAccount = client.GetMediaServicesAccountResource(mediaServicesAccountResourceId);

// get the collection of this MediaTransformResource
MediaTransformCollection collection = mediaServicesAccount.GetMediaTransforms();

// invoke the operation
string transformName = "createdTransform";
MediaTransformData data = new MediaTransformData()
{
    Description = "Example Transform to illustrate create and update.",
    Outputs =
    {
    new MediaTransformOutput(new BuiltInStandardEncoderPreset(EncoderNamedPreset.AdaptiveStreaming))
    },
};
ArmOperation<MediaTransformResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, transformName, data);
MediaTransformResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MediaTransformData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:

201

{
  "name": "createdTransform",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2022-10-17T23:14:31.7664818Z",
    "description": "Example Transform to illustrate create and update.",
    "lastModified": "2022-10-17T23:14:31.7664818Z",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "Normal",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:31.7664818Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
  }
}

Код состояния:

200

{
  "name": "createdTransform",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
  "type": "Microsoft.Media/mediaservices/transforms",
  "properties": {
    "created": "2022-10-17T23:14:31.7664818Z",
    "description": "Example Transform to illustrate create and update.",
    "lastModified": "2022-10-17T23:14:31.7664818Z",
    "outputs": [
      {
        "onError": "StopProcessingJob",
        "relativePriority": "Normal",
        "preset": {
          "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
          "presetName": "AdaptiveStreaming"
        }
      }
    ]
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-17T23:14:31.7664818Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
  }
}

Определения

Имя	Описание
AacAudio	Описание параметров кодирования звука с расширенными аудиокодеками (AAC).
AacAudioProfile	Профиль кодирования, используемый при кодировании звука с помощью AAC.
AnalysisResolution	Указывает максимальное разрешение, при котором анализируется видео. Поведение по умолчанию — SourceResolution, которое сохраняет входное видео в исходном разрешении при анализе. Использование standardDefinition позволяет изменить размер входных видео до стандартного определения, сохранив при этом соответствующие пропорции. Размер будет изменяться только в том случае, если видео имеет более высокое разрешение. Например, входные данные 1920 x 1080 перед обработкой масштабируются до 640 x 360. Переключение на "StandardDefinition" сократит время, необходимое для обработки видео с высоким разрешением. Это также может снизить затраты на использование этого компонента (см. дополнительные сведения https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). Однако лица, которые в конечном итоге слишком малы в видео с измененным размером, могут не быть обнаружены.
Audio	Определяет общие свойства для всех звуковых кодеков.
AudioAnalysisMode	Определяет набор выполняемых операций анализа звука. Если этот параметр не указан, будет выбран стандартный AudioAnalysisMode.
AudioAnalyzerPreset	Предустановка анализатора звука применяет предопределенный набор операций анализа на основе ИИ, включая транскрибирование речи. В настоящее время она поддерживает обработку содержимого с одной звуковой дорожкой.
AudioOverlay	Описывает свойства наложения звука.
BlurType	Тип размытия
BuiltInStandardEncoderPreset	Описывает встроенную предустановку для кодирования входного видео с помощью стандартного кодировщика.
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 bps.
Deinterlace	Описывает параметры дескриметрирования.
DeinterlaceMode	Режим деинтерлейсинга. Значение по умолчанию — AutoPixelAdaptive.
DeinterlaceParity	Четность полей для де-чередования по умолчанию — Auto.
EncoderNamedPreset	Встроенная предустановка, используемая для кодирования видео.
EntropyMode	Режим энтропии, используемый для этого слоя. Если значение не указано, кодировщик выбирает режим, соответствующий профилю и уровню.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
FaceDetectorPreset	Описывает все параметры, используемые при анализе видео, чтобы обнаружить (и при необходимости отредактировать) все присутствующих лица.
FaceRedactorMode	В этом режиме можно выбрать один из следующих параметров: 1) Анализ — только для обнаружения. В этом режиме создается JSON-файл метаданных, помечающий внешний вид лиц на протяжении всего видео. Если это возможно, внешности одного и того же человека назначаются с одинаковым идентификатором. 2) Комбинированный — дополнительно отредактирует (размытие) обнаруженных лиц. 3) Redact — это обеспечивает двухпрохольный процесс, позволяющий выборочно редактировать подмножество обнаруженных лиц. Он принимает файл метаданных из предыдущего прохода анализа, а также исходное видео и выбранное пользователем подмножество идентификаторов, требующих исправления.
Fade	Описывает свойства эффекта затухания, применяемые к входным носителям.
Filters	Описание всех операций фильтрации, таких как де-чередование, поворот и т. д., которые должны быть применены к входным носителям перед кодировкой.
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	Описывает свойства выходного файла изображения.
InsightsType	Определяет тип аналитических сведений, которые служба будет создавать. Допустимые значения: AudioInsightsOnly, VideoInsightsOnly и AllInsights. Значение по умолчанию — AllInsights. Если для этого параметра задано значение AllInsights, а входными данными является только звук, будут созданы только аналитические сведения о звуке. Аналогичным образом, если входные данные являются только видео, то создаются только аналитические сведения о видео. Рекомендуется не использовать AudioInsightsOnly, если предполагается, что некоторые входные данные будут только видео. или используйте VideoInsightsOnly, если предполагается, что некоторые входные данные будут только звуком. Ваши задания в таких условиях будут ошибок.
InterleaveOutput	Задает режим чередовки выходных данных, чтобы управлять хранением звука и видео в формате контейнера. Пример: задайте interleavedOutput как NonInterleavedOutput, чтобы создавать только аудио и видео выходные данные в отдельных MP4-файлах.
JpgFormat	Описание параметров создания эскизов JPEG.
JpgImage	Описывает свойства для создания ряда изображений JPEG из входного видео.
JpgLayer	Описывает параметры для создания изображения JPEG из входного видео.
Mp4Format	Описывает свойства выходного ISO-файла MP4.
MultiBitrateFormat	Описывает свойства для создания коллекции файлов с поддержкой GOP с многоскоростной скоростью. По умолчанию создается один выходной файл для каждого уровня видео, который объединяется со всеми звуками. Точно созданные выходные файлы можно контролировать, указав коллекцию outputFiles.
OnErrorType	Преобразование может определять несколько выходных данных. Это свойство определяет, что должна делать служба при сбое одного выхода: либо продолжать создавать другие выходные данные, либо останавливать другие выходные данные. Общее состояние задания не будет отражать сбои выходных данных, указанных с помощью ContinueJob. Значение по умолчанию — StopProcessingJob.
OutputFile	Представляет созданный выходной файл.
PngFormat	Описывает параметры создания эскизов PNG.
PngImage	Описывает свойства для создания ряда изображений PNG из входного видео.
PngLayer	Описывает параметры для создания изображения в формате PNG из входного видео.
PresetConfigurations	Объект необязательных параметров конфигурации для кодировщика.
Priority	Задает относительный приоритет TransformOutputs в преобразовании. При этом задается приоритет, который служба использует для обработки TransformOutputs. Приоритет по умолчанию — Обычный.
Rectangle	Описывает свойства прямоугольного окна, применяемого к входному носителю перед его обработкой.
Rotation	Поворот, если таковой имеется, применяется к входной видео перед его кодированием. Значение по умолчанию — Auto
StandardEncoderPreset	Описание всех параметров, используемых при кодировании входного видео с помощью стандартного кодировщика.
StretchMode	Режим изменения размера — изменение размера входного видео в соответствии с требуемыми разрешениями вывода. Значение по умолчанию — AutoSize.
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.
Transform	Преобразование инкапсулирует правила или инструкции для создания требуемых выходных данных из входных носителей, например путем перекодирования или извлечения аналитических сведений. После создания преобразования его можно применить к входным носителям, создав задания.
TransformOutput	Описывает свойства TransformOutput, которые являются правилами, применяемыми при создании требуемых выходных данных.
TransportStreamFormat	Описывает свойства для создания выходных видеофайлов транспортного потока MPEG-2 (ISO/IEC 13818-1).
Video	Описание основных свойств кодирования входного видео.
VideoAnalyzerPreset	Предустановка видеоанализатора, которая извлекает аналитические сведения (расширенные метаданные) из аудио и видео и выводит файл формата JSON.
VideoOverlay	Описывает свойства наложения видео.
VideoSyncMode	Режим синхронизации видео

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.

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

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 секунд входного видео. Если значение не указано, наложение начинается с начала входного видео.

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	Встроенная предустановка, используемая для кодирования видео.

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 bps.

Имя	Тип	Описание
@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	Объект error.

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[]: AudioOverlay[] VideoOverlay[]	Свойства наложения, применяемые к входным видео. Это могут быть наложения звука, изображения или видео.
rotation	Rotation	Поворот, если таковой имеется, применяется к входной видео перед его кодированием. Значение по умолчанию — Auto

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} — строка "Аудио" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в Кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.

InsightsType

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

Имя	Тип	Описание
AllInsights	string	Создайте аналитику звука и видео. Сбой при сбое аналитики звука или видео.
AudioInsightsOnly	string	Создание аналитических сведений только для аудио. Пропускать видео, даже если оно присутствует. Сбой, если звук отсутствует.
VideoInsightsOnly	string	Создание аналитических сведений только для видео. Пропускать звук, если он присутствует. Сбой, если видео отсутствует.

InterleaveOutput

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

Имя	Тип	Описание
InterleavedOutput	string	Выходные данные включают как аудио, так и видео.
NonInterleavedOutput	string	Выходные данные доступны только для видео или только для аудио.

JpgFormat

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

Имя	Тип	Описание
@odata.type	string: #Microsoft.Media.JpgFormat	Дискриминатор для производных типов.
filenamePattern	string	Шаблон именования файлов, используемый для создания выходных файлов. В имени файла поддерживаются следующие макросы: {Basename} — макрос расширения, который будет использовать имя входного видеофайла. Если базовое имя (суффикс файла не включен) входного видеофайла длиной менее 32 символов, будет использоваться базовое имя входных видеофайлов. Если длина базового имени входного видеофайла превышает 32 символа, базовое имя усекается до первых 32 символов общей длины. {Extension} — соответствующее расширение для этого формата. {Label} — метка, назначенная кодеку или уровню. {Index} — уникальный индекс для эскизов. Применимо только к эскизам. {AudioStream} — строка "Аудио" плюс номер аудиопотока (начинается с 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} — строка "Аудио" плюс номер аудиопотока (начинается с 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} — строка "Аудио" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в Кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.
outputFiles	OutputFile[]	Список выходных файлов для создания. Каждая запись в списке представляет собой набор меток уровня звука и видео, которые необходимо объединить вместе.

OnErrorType

Преобразование может определять несколько выходных данных. Это свойство определяет, что должна делать служба при сбое одного выхода: либо продолжать создавать другие выходные данные, либо останавливать другие выходные данные. Общее состояние задания не будет отражать сбои выходных данных, указанных с помощью ContinueJob. Значение по умолчанию — StopProcessingJob.

Имя	Тип	Описание
ContinueJob	string	Сообщает службе, что в случае сбоя transformOutput разрешите любому другому параметру TransformOutput продолжить работу.
StopProcessingJob	string	Сообщает службе, что в случае сбоя transformOutput можно остановить любые другие неполные transformOutputs.

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} — строка "Аудио" плюс номер аудиопотока (начинается с 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 градусов по часовой стрелке.

StandardEncoderPreset

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

Имя	Тип	Описание
@odata.type	string: #Microsoft.Media.StandardEncoderPreset	Дискриминатор для производных типов.
codecs	Codec[]: AacAudio[] Audio[] CopyAudio[] CopyVideo[] DDAudio[] H264Video[] H265Video[] Image[] JpgImage[] PngImage[] Video[]	Список кодеков, используемых при кодировании входного видео.
experimentalOptions	object	Словарь, содержащий пары "ключ-значение" для параметров, не предоставленных в самой предустановке
filters	Filters	Одна или несколько операций фильтрации, которые применяются к входным носителям перед кодировкой.
formats	Format[]: ImageFormat[] JpgFormat[] Mp4Format[] MultiBitrateFormat[] PngFormat[] TransportStreamFormat[]	Список выходных данных, создаваемых кодировщиком.

StretchMode

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

Имя	Тип	Описание
AutoFit	string	Заполните выходные данные (с помощью поля "Буквы" или "Столбик"), чтобы учитывать разрешение выходных данных, при этом убедитесь, что активная область видео в выходных данных имеет то же соотношение сторон, что и входные данные. Например, если входные данные равны 1920 x 1080, а предустановка кодировки запрашивает 1280x1280, то выходные данные будут иметь размер 1280x1280, который содержит внутренний прямоугольник 1280x720 с пропорциями 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	Тип удостоверения, которое последним изменял ресурс.

Transform

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

Имя	Тип	Описание
id	string	Полный идентификатор ресурса. Например: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Имя ресурса.
properties.created	string	Дата и время создания преобразования в формате YYYY-MM-DDThh:mm:ssZ (UTC).
properties.description	string	Подробное описание преобразования (необязательно).
properties.lastModified	string	Дата и время последнего обновления преобразования в формате YYYY-MM-DDThh:mm:ssZ (UTC).
properties.outputs	TransformOutput[]	Массив из одного или нескольких наборов выходных данных, созданных преобразованием.
systemData	systemData	Системные метаданные, относящиеся к этому ресурсу.
type	string	Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts.

TransformOutput

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

Имя	Тип	Описание
onError	OnErrorType	Преобразование может определять несколько выходных данных. Это свойство определяет, что должна делать служба при сбое одного выхода: либо продолжать создавать другие выходные данные, либо останавливать другие выходные данные. Общее состояние задания не будет отражать сбои выходных данных, указанных с помощью ContinueJob. Значение по умолчанию — StopProcessingJob.
preset	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	Предустановка, описывающая операции, которые будут использоваться для изменения, перекодирования или извлечения аналитических сведений из исходного файла для создания выходных данных.
relativePriority	Priority	Задает относительный приоритет TransformOutputs в преобразовании. При этом задается приоритет, который служба использует для обработки TransformOutputs. Приоритет по умолчанию — Обычный.

TransportStreamFormat

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

Имя	Тип	Описание
@odata.type	string: #Microsoft.Media.TransportStreamFormat	Дискриминатор для производных типов.
filenamePattern	string	Шаблон именования файлов, используемый для создания выходных файлов. В имени файла поддерживаются следующие макросы: {Basename} — макрос расширения, который будет использовать имя входного видеофайла. Если базовое имя (суффикс файла не включен) входного видеофайла длиной менее 32 символов, будет использоваться базовое имя входных видеофайлов. Если длина базового имени входного видеофайла превышает 32 символа, базовое имя усекается до первых 32 символов общей длины. {Extension} — соответствующее расширение для этого формата. {Label} — метка, назначенная кодеку или уровню. {Index} — уникальный индекс для эскизов. Применимо только к эскизам. {AudioStream} — строка "Аудио" плюс номер аудиопотока (начинается с 1). {Bitrate} — скорость звука и видео в Кбит/с. Неприменимо к эскизам. {Codec} — тип аудио- и видеокодека. {Resolution} — разрешение видео. Все неподписанные макросы будут свернуты и удалены из имени файла.
outputFiles	OutputFile[]	Список выходных файлов для создания. Каждая запись в списке представляет собой набор меток уровня звука и видео, которые необходимо объединить вместе.

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, на основе входных данных.