Transforms - Create Or Update

참조

Service:: Media Services

API Version:: 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 매개 변수

Name	In(다음 안에)	필수	형식	Description
accountName	path	True	string	Media Services 계정 이름입니다.
resourceGroupName	path	True	string	Azure 구독 내 리소스 그룹의 이름입니다.
subscriptionId	path	True	string	Microsoft Azure 구독의 고유 식별자입니다.
transformName	path	True	string	변환 이름입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다.

요청 본문

Name	필수	형식	Description
properties.outputs	True	TransformOutput[]	변환이 생성해야 하는 하나 이상의 TransformOutputs의 배열입니다.
properties.description		string	변환에 대한 자세한 정보 표시 설명입니다(선택 사항).

응답

Name	형식	Description
200 OK	Transform	정상
201 Created	Transform	생성일
Other Status Codes	ErrorResponse	자세한 오류 정보입니다.

예제

Create or update a Transform

Sample Request

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"
        }
      }
    ]
  }
}

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

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

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

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

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

Sample Response

Status code:: 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"
  }
}

Status code:: 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"
  }
}

정의

Name	Description
AacAudio	AAC(고급 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다.
AacAudioProfile	AAC를 사용하여 오디오를 인코딩할 때 사용할 인코딩 프로필입니다.
AnalysisResolution	비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 또한 이 구성 요소를 사용하는 비용을 줄일 수 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다.
Audio	모든 오디오 코덱에 대한 공통 속성을 정의합니다.
AudioAnalysisMode	수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다.
AudioAnalyzerPreset	Audio Analyzer 사전 설정은 음성 전사를 포함하여 미리 정의된 AI 기반 분석 작업 집합을 적용합니다. 현재 미리 설정은 단일 오디오 트랙을 사용하여 콘텐츠를 처리하도록 지원합니다.
AudioOverlay	오디오 오버레이의 속성을 설명합니다.
BlurType	흐림 효과 유형
BuiltInStandardEncoderPreset	표준 인코더를 사용하여 입력 비디오를 인코딩하기 위한 기본 제공 사전 설정을 설명합니다.
Complexity	속도와 품질 간의 균형을 제어하도록 인코더 설정을 구성할 수 있습니다. 예: 인코딩 속도가 빠르지만 압축 효율성이 낮을 경우 복잡성을 속도로 설정합니다.
CopyAudio	입력 오디오 비트스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다.
CopyVideo	인코더에 다시 인코딩하지 않고 입력 비디오 비트스트림을 복사하도록 지시하는 코덱 플래그입니다.
createdByType	리소스를 만든 ID의 형식입니다.
DDAudio	Dolby AC3(디지털 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다. Dolby Digital Audio 지원에 대한 현재 구현은 1((모노), 2(스테레오), 6(5.1side)의 오디오 채널 번호입니다. 오디오 샘플링 빈도: 32K/44.1K/48KHz; 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 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐리게) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오와 함께 이전 분석 패스의 메타데이터 파일과 수정이 필요한 사용자가 선택한 ID 하위 집합을 가져옵니다.
Fade	입력 미디어에 적용된 페이드 효과의 속성을 설명합니다.
Filters	인코딩하기 전에 입력 미디어에 적용할 인터레이싱 해제, 회전 등과 같은 모든 필터링 작업에 대해 설명합니다.
H264Complexity	인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 기본값은 Balanced입니다.
H264Layer	H.264 비디오 코덱을 사용하여 입력 비디오를 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정을 설명합니다.
H264RateControlMode	비디오 속도 제어 모드
H264Video	H.264 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다.
H264VideoProfile	현재 기준, 기본, 높음, High422, High444를 지원합니다. 기본값은 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 정렬 다중 비트 전송률 파일의 컬렉션을 생성하기 위한 속성에 대해 설명합니다. 기본 동작은 모든 오디오와 함께 muxed되는 각 비디오 계층에 대해 하나의 출력 파일을 생성하는 것입니다. 생성된 정확한 출력 파일은 outputFiles 컬렉션을 지정하여 제어할 수 있습니다.
OnErrorType	변환은 둘 이상의 출력을 정의할 수 있습니다. 이 속성은 한 출력이 실패할 때 서비스가 수행해야 하는 작업을 정의합니다. 다른 출력을 계속 생성하거나 다른 출력을 중지합니다. 전체 작업 상태는 'ContinueJob'으로 지정된 출력의 오류를 반영하지 않습니다. 기본값은 'StopProcessingJob'입니다.
OutputFile	생성된 출력 파일을 나타냅니다.
PngFormat	PNG 썸네일을 생성하기 위한 설정에 대해 설명합니다.
PngImage	입력 비디오에서 일련의 PNG 이미지를 생성하기 위한 속성을 설명합니다.
PngLayer	입력 비디오에서 PNG 이미지를 생성하는 설정을 설명합니다.
PresetConfigurations	인코더에 대한 선택적 구성 설정의 개체입니다.
Priority	Transform 내에서 TransformOutputs의 상대적 우선 순위를 설정합니다. 이렇게 하면 서비스에서 TransformOutputs를 처리하는 데 사용하는 우선 순위가 설정됩니다. 기본 우선 순위는 Normal입니다.
Rectangle	입력 미디어를 처리하기 전에 입력 미디어에 적용된 사각형 창의 속성을 설명합니다.
Rotation	인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다.
StandardEncoderPreset	표준 인코더를 사용하여 입력 비디오를 인코딩할 때 사용할 모든 설정을 설명합니다.
StretchMode	크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.
systemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Transform	변환은 코드 변환 또는 인사이트 추출과 같은 입력 미디어에서 원하는 출력을 생성하기 위한 규칙 또는 지침을 캡슐화합니다. 변환을 만든 후에는 작업을 만들어 입력 미디어에 적용할 수 있습니다.
TransformOutput	원하는 출력을 생성하는 동안 적용할 규칙인 TransformOutput의 속성을 설명합니다.
TransportStreamFormat	MPEG-2 전송 스트림(ISO/IEC 13818-1) 출력 비디오 파일을 생성하기 위한 속성에 대해 설명합니다.
Video	입력 비디오를 인코딩하기 위한 기본 속성에 대해 설명합니다.
VideoAnalyzerPreset	오디오 및 비디오 모두에서 인사이트(풍부한 메타데이터)를 추출하고 JSON 형식 파일을 출력하는 비디오 분석기 사전 설정입니다.
VideoOverlay	비디오 오버레이의 속성을 설명합니다.
VideoSyncMode	비디오 동기화 모드

AacAudio

AAC(고급 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.AacAudio	파생 형식에 대한 판별자입니다.
bitrate	integer	출력 인코딩된 오디오의 비트 전송률(초당 비트)입니다.
channels	integer	오디오의 채널 수입니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
profile	AacAudioProfile	AAC를 사용하여 오디오를 인코딩할 때 사용할 인코딩 프로필입니다.
samplingRate	integer	hertz의 인코딩에 사용할 샘플링 속도입니다.

AacAudioProfile

AAC를 사용하여 오디오를 인코딩할 때 사용할 인코딩 프로필입니다.

Name	형식	Description
AacLc	string	출력 오디오를 AAC-LC(낮은 복잡성 프로필)로 인코딩하도록 지정합니다.
HeAacV1	string	출력 오디오를 HE-AAC v1 프로필로 인코딩하도록 지정합니다.
HeAacV2	string	출력 오디오를 HE-AAC v2 프로필로 인코딩하도록 지정합니다.

AnalysisResolution

비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 또한 이 구성 요소를 사용하는 비용을 줄일 수 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다.

Name	형식	Description
SourceResolution	string
StandardDefinition	string

Audio

모든 오디오 코덱에 대한 공통 속성을 정의합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.Audio	파생 형식에 대한 판별자입니다.
bitrate	integer	출력 인코딩된 오디오의 비트 전송률(초당 비트)입니다.
channels	integer	오디오의 채널 수입니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
samplingRate	integer	Hertz의 인코딩에 사용할 샘플링 속도입니다.

AudioAnalysisMode

수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다.

Name	형식	Description
Basic	string	이 모드는 음성-텍스트 변환 전사 및 VTT 자막/캡션 파일 생성을 수행합니다. 이 모드의 출력에는 키워드, 기록, 타이밍 정보만 포함된 Insights JSON 파일이 포함됩니다. 자동 언어 감지 기능과 화자 분할 기능은 이 모드에 포함되어 있지 않습니다.
Standard	string	기본 모드에 포함된 모든 작업을 수행하고 언어 감지 및 화자 일기화를 추가로 수행합니다.

AudioAnalyzerPreset

Audio Analyzer 사전 설정은 음성 전사를 포함하여 미리 정의된 AI 기반 분석 작업 집합을 적용합니다. 현재 미리 설정은 단일 오디오 트랙을 사용하여 콘텐츠를 처리하도록 지원합니다.

Name	형식	Description
@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

오디오 오버레이의 속성을 설명합니다.

Name	형식	Description
@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

흐림 효과 유형

Name	형식	Description
Black	string	검은색: 차단 필터
Box	string	상자: 디버그 필터, 경계 상자만
High	string	높음: 흐림 효과 필터 혼동
Low	string	낮음: 박스카 흐림 필터
Med	string	메드: 가우시안 흐림 필터

BuiltInStandardEncoderPreset

표준 인코더를 사용하여 입력 비디오를 인코딩하기 위한 기본 제공 사전 설정을 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.BuiltInStandardEncoderPreset	파생 형식에 대한 판별자입니다.
configurations	PresetConfigurations	인코더에 대한 선택적 구성 설정입니다. 구성은 ContentAwareEncoding 및 H265ContentAwareEncoding BuiltInStandardEncoderPreset에 대해서만 지원됩니다.
presetName	EncoderNamedPreset	비디오 인코딩에 사용할 기본 제공 사전 설정입니다.

Complexity

속도와 품질 간의 균형을 제어하도록 인코더 설정을 구성할 수 있습니다. 예: 인코딩 속도가 빠르지만 압축 효율성이 낮을 경우 복잡성을 속도로 설정합니다.

Name	형식	Description
Balanced	string	속도와 품질 간의 균형을 맞추는 설정을 사용하도록 인코더를 구성합니다.
Quality	string	전체 인코딩 시간이 느려지도록 최적화된 설정을 사용하여 더 높은 품질의 출력을 생성하도록 인코더를 구성합니다.
Speed	string	더 빠른 인코딩에 최적화된 설정을 사용하도록 인코더를 구성합니다. 인코딩 시간을 줄이기 위해 품질이 희생됩니다.

CopyAudio

입력 오디오 비트스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.CopyAudio	파생 형식에 대한 판별자입니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

CopyVideo

인코더에 다시 인코딩하지 않고 입력 비디오 비트스트림을 복사하도록 지시하는 코덱 플래그입니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.CopyVideo	파생 형식에 대한 판별자입니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

createdByType

리소스를 만든 ID의 형식입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DDAudio

Dolby AC3(디지털 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다. Dolby Digital Audio 지원에 대한 현재 구현은 1((모노), 2(스테레오), 6(5.1side)의 오디오 채널 번호입니다. 오디오 샘플링 빈도: 32K/44.1K/48KHz; AC3 사양에서 지원하는 오디오 비트 전송률 값: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.

Name	형식	Description
@odata.type	string: #Microsoft.Media.DDAudio	파생 형식에 대한 판별자입니다.
bitrate	integer	출력 인코딩된 오디오의 비트 전송률(초당 비트)입니다.
channels	integer	오디오의 채널 수입니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
samplingRate	integer	Hertz의 인코딩에 사용할 샘플링 속도입니다.

Deinterlace

인터레이스 해제 설정에 대해 설명합니다.

Name	형식	Description
mode	DeinterlaceMode	디인터레이싱 모드입니다. 기본값은 AutoPixelAdaptive입니다.
parity	DeinterlaceParity	인터레이스 해제에 대한 필드 패리티이며 기본값은 Auto입니다.

DeinterlaceMode

디인터레이싱 모드입니다. 기본값은 AutoPixelAdaptive입니다.

Name	형식	Description
AutoPixelAdaptive	string	입력 비디오의 각 프레임에 자동 픽셀 적응형 인터레이싱을 적용합니다.
Off	string	원본 비디오의 인터레이스 해제를 사용하지 않도록 설정합니다.

DeinterlaceParity

인터레이싱을 해제하기 위한 필드 패리티이며, 기본값은 Auto입니다.

Name	형식	Description
Auto	string	필드 순서 자동 검색
BottomFieldFirst	string	입력 비디오의 맨 아래 필드 첫 번째 처리를 적용합니다.
TopFieldFirst	string	입력 비디오의 맨 위 필드 첫 번째 처리를 적용합니다.

EncoderNamedPreset

비디오 인코딩에 사용할 기본 제공 사전 설정입니다.

Name	형식	Description
AACGoodQualityAudio	string	192kbps로 인코딩된 AAC 스테레오 오디오만 포함하는 단일 MP4 파일을 생성합니다.
AdaptiveStreaming	string	H.264 비디오 및 스테레오 AAC 오디오를 사용하여 GOP 정렬 MP4 파일 집합을 생성합니다. 입력, 해상도, 비트 전송률 및 프레임 속도를 기준으로 비트 전송률 사다리를 자동 생성합니다. 자동 생성된 사전 설정은 입력 해상도를 초과하지 않습니다. 예를 들어 입력이 720p일 때 출력은 아무리 높아도 720p로 유지됩니다.
ContentAwareEncoding	string	콘텐츠 인식 인코딩을 사용하여 GOP 맞춤 MP4 세트를 생성합니다. 입력 콘텐츠에 따라 서비스가 입력 콘텐츠의 초기 경량 분석을 수행하고 그 결과를 사용하여 적응 스트리밍으로 전송을 위해 최적 레이어 수, 적합한 비트 전송률 및 해상도 설정을 결정합니다. 이 사전 설정은 출력 파일이 낮은 비트 전송률로 제공되지만 시청자에게 여전히 좋은 경험을 제공하는 품질로 유지되는 낮은 품질 및 중간 품질의 복합 비디오에 특히 효과적입니다. 출력에는 비디오 및 오디오가 인터리브된 MP4 파일이 포함됩니다.
ContentAwareEncodingExperimental	string	콘텐츠 인식 인코딩을 위한 실험적 사전 설정을 노출합니다. 입력 콘텐츠가 있는 경우 서비스는 적응 스트리밍을 통해 배달을 위한 최적의 계층 수, 적절한 비트 전송률 및 해상도 설정을 자동으로 결정하려고 시도합니다. 기본 알고리즘은 시간에 따라 계속 발전합니다. 출력에는 비디오 및 오디오가 인터리브된 MP4 파일이 포함됩니다.
CopyAllBitrateNonInterleaved	string	입력 자산의 모든 동영상 및 오디오 스트림을 인터리브되지 않은 동영상 및 오디오 출력 파일로 복사합니다. 이 사전 설정을 사용하여 기존 자산을 자르거나 GOP(키 프레임) 정렬 MP4 파일 그룹을 스트리밍할 수 있는 자산으로 변환할 수 있습니다.
DDGoodQualityAudio	string	192kbps로 인코딩된 DD(Digital Dolby) 스테레오 오디오만 포함하는 단일 MP4 파일을 생성합니다.
H264MultipleBitrate1080p	string	6000kbps에서 400kbps, 스테레오 AAC 오디오에 이르는 8개의 GOP 정렬 MP4 파일 집합을 생성합니다. 해상도는 1080p에서 시작하여 180p로 내려갑니다.
H264MultipleBitrate720p	string	3400kbps에서 400kbps, 스테레오 AAC 오디오에 이르는 6개의 GOP 정렬 MP4 파일 집합을 생성합니다. 해상도는 720p에서 시작하여 180p로 내려갑니다.
H264MultipleBitrateSD	string	1900kbps에서 400kbps에 이르는 5개의 GOP 정렬 MP4 파일 집합과 스테레오 AAC 오디오를 생성합니다. 해상도는 480p에서 시작하여 240p로 내려갑니다.
H264SingleBitrate1080p	string	비디오가 6750kbps의 H.264 코덱과 1080픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다.
H264SingleBitrate720p	string	비디오가 4500kbps의 H.264 코덱과 720픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다.
H264SingleBitrateSD	string	비디오가 2200kbps의 H.264 코덱과 480픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다.
H265AdaptiveStreaming	string	H.265 비디오 및 스테레오 AAC 오디오가 포함된 GOP 정렬 MP4 파일 집합을 만듭니다. 입력, 해상도, 비트 전송률 및 프레임 속도를 기준으로 비트 전송률 사다리를 자동 생성합니다. 자동 생성된 사전 설정은 입력 해상도를 초과하지 않습니다. 예를 들어 입력이 720p일 때 출력은 아무리 높아도 720p로 유지됩니다.
H265ContentAwareEncoding	string	콘텐츠 인식 인코딩을 사용하여 GOP 맞춤 MP4 세트를 생성합니다. 입력 콘텐츠에 따라 서비스가 입력 콘텐츠의 초기 경량 분석을 수행하고 그 결과를 사용하여 적응 스트리밍으로 전송을 위해 최적 레이어 수, 적합한 비트 전송률 및 해상도 설정을 결정합니다. 이 사전 설정은 출력 파일이 낮은 비트 전송률로 제공되지만 시청자에게 여전히 좋은 경험을 제공하는 품질로 유지되는 낮은 품질 및 중간 품질의 복합 비디오에 특히 효과적입니다. 출력에는 비디오 및 오디오가 인터리브된 MP4 파일이 포함됩니다.
H265SingleBitrate1080p	string	비디오가 3500kbps의 H.265 코덱과 1080픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다.
H265SingleBitrate4K	string	비디오가 9500kbps의 H.265 코덱과 2160픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다.
H265SingleBitrate720p	string	비디오가 1800kbps의 H.265 코덱과 720픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다.

EntropyMode

이 계층에 사용할 엔트로피 모드입니다. 지정하지 않으면 인코더는 프로필 및 수준에 적합한 모드를 선택합니다.

Name	형식	Description
Cabac	string	컨텍스트 CABAC(Adaptive Binary Arithmetic Coder) 엔트로피 인코딩.
Cavlc	string	컨텍스트 CAVLC(적응 변수 길이 코더) 엔트로피 인코딩.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

FaceDetectorPreset

존재하는 모든 얼굴을 감지(선택적으로 수정)하기 위해 비디오를 분석할 때 사용할 모든 설정을 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.FaceDetectorPreset	파생 형식에 대한 판별자입니다.
blurType	BlurType	흐림 유형
experimentalOptions	object	사전 설정 자체에 노출되지 않은 매개 변수에 대한 키 값 쌍을 포함하는 사전
mode	FaceRedactorMode	이 모드는 다음 설정 중에서 선택할 수 있는 기능을 제공합니다. 1) 분석 - 검색 전용입니다. 이 모드는 비디오 전체에서 얼굴의 모양을 표시하는 메타데이터 JSON 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐리게) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오 및 수정이 필요한 사용자가 선택한 ID 하위 집합과 함께 이전 분석 패스의 메타데이터 파일을 가져옵니다.
resolution	AnalysisResolution	비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 이 구성 요소 사용 비용을 줄일 수도 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다.

FaceRedactorMode

이 모드는 다음 설정 중에서 선택할 수 있는 기능을 제공합니다. 1) 분석 - 검색 전용입니다. 이 모드는 비디오 전체에서 얼굴 모양을 표시하는 메타데이터 JSON 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐리게) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오와 함께 이전 분석 패스의 메타데이터 파일과 수정이 필요한 사용자가 선택한 ID 하위 집합을 가져옵니다.

Name	형식	Description
Analyze	string	분석 모드는 얼굴을 감지하고 결과가 포함된 메타데이터 파일을 출력합니다. Redact 모드에서 얼굴이 흐리게 표시되기 전에 메타데이터 파일을 편집할 수 있습니다.
Combined	string	결합 모드는 분석된 얼굴을 편집하는 것이 바람직하지 않을 때 한 단계씩 분석 및 수정 단계를 수행합니다.
Redact	string	수정 모드는 분석 모드에서 메타데이터 파일을 사용하고 찾은 얼굴을 수정합니다.

Fade

입력 미디어에 적용된 페이드 효과의 속성을 설명합니다.

Name	형식	Description
duration	string	비디오의 페이드 효과 기간입니다. 값은 ISO 8601 형식(예: 5초 동안 색을 페이드 인/아웃하는 PT05S) 또는 프레임 수(예: 시작 시간에서 10프레임 페이드하려면 10개) 또는 스트림 기간에 대한 상대 값(예: 스트림 기간의 10%을 페이드하려면 10%)일 수 있습니다.
fadeColor	string	페이드 인/아웃의 색입니다. CSS Level1 색 https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords 또는 RGB/16진수 값(예: rgb(255,0,0), 0xFF0000 또는 #FF0000
start	string	페이드를 시작할 위치의 입력 비디오 위치입니다. 값은 ISO 8601 형식(예: 5초에서 시작할 경우 PT05S), 프레임 수(예: 10번째 프레임에서 시작할 경우 10개) 또는 스트림 기간의 상대값(예: 스트림 기간의 10%에서 시작할 경우 10%)이 될 수 있습니다. 기본값은 0입니다.

Filters

인코딩하기 전에 입력 미디어에 적용할 인터레이싱 해제, 회전 등과 같은 모든 필터링 작업에 대해 설명합니다.

Name	형식	Description
crop	Rectangle	입력 비디오를 자르는 사각형 창의 매개 변수입니다.
deinterlace	Deinterlace	인터레이싱 해제 설정입니다.
fadeIn	Fade	입력 미디어에 적용된 페이드 효과의 속성을 설명합니다.
fadeOut	Fade	입력 미디어에 적용된 페이드 효과의 속성을 설명합니다.
overlays	Overlay[]: AudioOverlay[] VideoOverlay[]	입력 비디오에 적용할 오버레이의 속성입니다. 오디오, 이미지 또는 비디오 오버레이일 수 있습니다.
rotation	Rotation	인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다.

H264Complexity

인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 기본값은 Balanced입니다.

Name	형식	Description
Balanced	string	속도와 품질 간의 균형을 이루는 설정을 사용하도록 인코더에 지시합니다.
Quality	string	전체 인코딩 시간이 느려지도록 더 높은 품질의 출력을 생성하도록 최적화된 설정을 사용하도록 인코더에 지시합니다.
Speed	string	더 빠른 인코딩에 최적화된 설정을 사용하도록 인코더에 지시합니다. 인코딩 시간을 줄이기 위해 품질이 저하됩니다.

H264Layer

H.264 비디오 코덱을 사용하여 입력 비디오를 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정을 설명합니다.

Name	형식	Description
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를 지원합니다. 값은 자동이거나 H.264 프로필과 일치하는 숫자일 수 있습니다. 지정하지 않으면 기본값은 자동이며, 이를 통해 인코더는 이 계층에 적합한 수준을 선택할 수 있습니다.
maxBitrate	integer	VBV 버퍼를 다시 채우기 위해 가정해야 하는 최대 비트 전송률(초당 비트)입니다. 지정하지 않으면 기본적으로 비트 전송률과 동일한 값으로 설정됩니다.
profile	H264VideoProfile	현재 기준, Main, High, High422, High444를 지원합니다. 기본값은 Auto입니다.
referenceFrames	integer	이 레이어를 인코딩할 때 사용할 참조 프레임의 수입니다. 지정하지 않으면 인코더는 인코더 복잡성 설정에 따라 적절한 숫자를 결정합니다.
slices	integer	이 레이어를 인코딩할 때 사용할 조각 수입니다. 지정하지 않으면 기본값은 0입니다. 즉, 인코더는 각 프레임에 단일 조각을 사용합니다.
width	string	이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다.

H264RateControlMode

비디오 속도 제어 모드

Name	형식	Description
ABR	string	대상 비트 전송률에 도달한 ABR(평균 비트 전송률) 모드: 기본 모드입니다.
CBR	string	대상 비트 전송률 주위의 비트 전송률 변형을 강화하는 CBR(상수 비트 전송률) 모드입니다.
CRF	string	일정한 주관적 품질을 대상으로 하는 CRF(상수 비율 비율) 모드입니다.

H264Video

H.264 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.H264Video	파생 형식에 대한 판별자입니다.
complexity	H264Complexity	인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 기본값은 Balanced입니다.
keyFrameInterval	string	두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
layers	H264Layer[]	인코더에서 생성할 출력 H.264 계층의 컬렉션입니다.
rateControlMode	H264RateControlMode	비디오 속도 제어 모드
sceneChangeDetection	boolean	인코더가 장면 변경 시 키 프레임을 삽입해야 하는지 여부입니다. 지정하지 않으면 기본값은 false입니다. 이 플래그는 인코더가 단일 출력 비디오를 생성하도록 구성된 경우에만 true로 설정해야 합니다.
stretchMode	StretchMode	크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.
syncMode	VideoSyncMode	비디오 동기화 모드

H264VideoProfile

현재 기준, 기본, 높음, High422, High444를 지원합니다. 기본값은 Auto입니다.

Name	형식	Description
Auto	string	적절한 H.264 프로필을 자동으로 확인하도록 인코더에 지시합니다.
Baseline	string	기준 프로필
High	string	높은 프로필.
High422	string	높은 4:2:2 프로필.
High444	string	높은 4:4:4 예측 프로필.
Main	string	기본 프로필

H265Complexity

인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 품질은 더 높은 압축 비율을 제공하지만 더 높은 비용과 더 긴 컴퓨팅 시간을 제공합니다. 속도는 비교적 큰 파일을 생성하지만 더 빠르고 경제적입니다. 기본값은 Balanced입니다.

Name	형식	Description
Balanced	string	속도와 품질 간의 균형을 이루는 설정을 사용하도록 인코더에 지시합니다.
Quality	string	전체 인코딩 시간이 느려지도록 더 높은 품질의 출력을 생성하도록 최적화된 설정을 사용하도록 인코더에 지시합니다.
Speed	string	더 빠른 인코딩에 최적화된 설정을 사용하도록 인코더에 지시합니다. 인코딩 시간을 줄이기 위해 품질이 저하됩니다.

H265Layer

H.265 비디오 코덱을 사용하여 입력 비디오를 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정을 설명합니다.

Name	형식	Description
adaptiveBFrame	boolean	이 레이어를 인코딩할 때 적응형 B 프레임을 사용할지 여부를 지정합니다. 지정하지 않으면 비디오 프로필에서 사용을 허용할 때마다 인코더가 켜집니다.
bFrames	integer	이 레이어를 인코딩할 때 사용할 B 프레임의 수입니다. 지정하지 않으면 인코더는 비디오 프로필 및 수준에 따라 적절한 숫자를 선택합니다.
bitrate	integer	이 계층을 생성할 때 입력 비디오를 인코딩할 초당 평균 비트 전송률입니다. 예를 들어 대상 비트 전송률이 3000Kbps 또는 3Mbps이면 이 값이 30000000이어야 합니다. 필수 필드입니다.
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를 지원합니다. 값은 자동이거나 H.265 프로필과 일치하는 숫자일 수 있습니다. 지정하지 않으면 기본값은 자동이며, 이를 통해 인코더는 이 계층에 적합한 수준을 선택할 수 있습니다.
maxBitrate	integer	VBV 버퍼를 다시 채우기 위해 가정해야 하는 최대 비트 전송률(초당 비트)입니다. 지정하지 않으면 기본적으로 비트 전송률과 동일한 값으로 설정됩니다.
profile	H265VideoProfile	현재 Main을 지원합니다. 기본값은 Auto입니다.
referenceFrames	integer	이 레이어를 인코딩할 때 사용할 참조 프레임의 수입니다. 지정하지 않으면 인코더는 인코더 복잡성 설정에 따라 적절한 숫자를 결정합니다.
slices	integer	이 레이어를 인코딩할 때 사용할 조각 수입니다. 지정하지 않으면 기본값은 0입니다. 즉, 인코더는 각 프레임에 단일 조각을 사용합니다.
width	string	이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다.

H265Video

H.265 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.H265Video	파생 형식에 대한 판별자입니다.
complexity	H265Complexity	인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 품질은 더 높은 압축 비율을 제공하지만 더 높은 비용과 더 긴 컴퓨팅 시간을 제공합니다. 속도는 비교적 큰 파일을 생성하지만 더 빠르고 경제적입니다. 기본값은 Balanced입니다.
keyFrameInterval	string	두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 소스 설정을 따릅니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
layers	H265Layer[]	인코더에서 생성할 출력 H.265 계층의 컬렉션입니다.
sceneChangeDetection	boolean	인코더가 장면 변경 시 키 프레임을 삽입해야 하는지 여부를 지정합니다. 지정하지 않으면 기본값은 false입니다. 이 플래그는 인코더가 단일 출력 비디오를 생성하도록 구성된 경우에만 true로 설정해야 합니다.
stretchMode	StretchMode	크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.
syncMode	VideoSyncMode	비디오 동기화 모드

H265VideoProfile

현재 Main을 지원합니다. 기본값은 Auto입니다.

Name	형식	Description
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

입력 비디오에서 썸네일을 생성하기 위한 기본 속성에 대해 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.Image	파생 형식에 대한 판별자입니다.
keyFrameInterval	string	두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
range	string	미리 보기 생성을 중지할 입력 비디오에서 미리 설정된 변환 시작 시간을 기준으로 하는 위치입니다. 값은 ISO 8601 형식(예: 시작 시간에서 5분 30초에 중지하는 PT5M30S) 또는 프레임 수(예: 시작 시 프레임의 300번째 프레임에서 중지하려면 300)일 수 있습니다. 이 값이 1이면 시작 시간에 썸네일 하나만 생성하거나 스트림 기간에 대한 상대 값(예: 시작 시간부터 스트림 기간의 절반에서 중지하는 50%)을 의미합니다. 기본값은 100%로, 스트리밍 끝부분에서 중지함을 의미합니다.
start	string	썸네일 생성을 시작할 위치의 입력 비디오 위치입니다. 값은 ISO 8601 형식(예: 5초에서 시작할 경우 PT05S), 프레임 수(예: 10번째 프레임에서 시작할 경우 10개) 또는 스트림 기간의 상대값(예: 스트림 기간의 10%에서 시작할 경우 10%)이 될 수 있습니다. 또한 인코더가 비디오의 처음 몇 초에서 최상의 썸네일을 선택하고, 단계와 범위에 대한 다른 설정에 관계없이 하나의 썸네일만 생성하도록 지시하는 {Best} 매크로를 지원합니다. 기본값은 {Best} 매크로입니다.
step	string	썸네일이 생성되는 간격입니다. 값은 ISO 8601 형식(예: 5초마다 한 이미지의 경우 PT05S) 또는 프레임 수(예: 30프레임마다 하나의 이미지에 대해 30개) 또는 스트림 기간에 대한 상대 값(예: 스트림 기간의 10%마다 한 이미지의 경우 10%)일 수 있습니다. 참고: 단계 값은 처음 생성된 축소판 그림에 영향을 줍니다. 이는 변환 사전 설정 시작 시간에 지정된 것과 정확히 일치하지 않을 수 있습니다. 이는 시작 시간과 시작 시간의 단계 위치 간에 가장 적합한 썸네일을 첫 번째 출력으로 선택하려고 하는 인코더 때문입니다. 기본값은 10%이므로 스트림의 기간이 길면 처음 생성된 축소판 그림이 시작 시간에 지정된 미리 보기와 멀리 떨어져 있을 수 있습니다. 첫 번째 축소판 그림이 시작 시간에 가깝게 예상되는 경우 Step에 적절한 값을 선택하거나 시작 시간에 썸네일이 하나만 필요한 경우 범위 값을 1로 설정합니다.
stretchMode	StretchMode	크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.
syncMode	VideoSyncMode	비디오 동기화 모드

ImageFormat

출력 이미지 파일의 속성을 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.ImageFormat	파생 형식에 대한 판별자입니다.
filenamePattern	string	출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.

InsightsType

서비스에서 생성하려는 인사이트 유형을 정의합니다. 허용되는 값은 'AudioInsightsOnly', 'VideoInsightsOnly' 및 'AllInsights'입니다. 기본값은 AllInsights입니다. 이를 AllInsights로 설정하고 입력이 오디오 전용인 경우 오디오 인사이트만 생성됩니다. 마찬가지로 입력이 비디오 전용인 경우 비디오 인사이트만 생성됩니다. 일부 입력이 비디오로만 필요한 경우 AudioInsightsOnly를 사용하지 않는 것이 좋습니다. 또는 일부 입력이 오디오 전용일 것으로 예상하는 경우 VideoInsightsOnly를 사용합니다. 이러한 조건에서 작업이 오류 발생합니다.

Name	형식	Description
AllInsights	string	오디오 및 비디오 인사이트를 모두 생성합니다. 오디오 또는 비디오 인사이트가 실패하면 실패합니다.
AudioInsightsOnly	string	오디오 전용 인사이트를 생성합니다. 있는 경우에도 비디오를 무시합니다. 오디오가 없으면 실패합니다.
VideoInsightsOnly	string	비디오 전용 인사이트를 생성합니다. 있는 경우 오디오를 무시합니다. 비디오가 없으면 실패합니다.

InterleaveOutput

오디오 및 비디오가 컨테이너 형식으로 저장되는 방식을 제어하도록 출력의 인터리브 모드를 설정합니다. 예: InterleavedOutput을 NonInterleavedOutput으로 설정하여 별도의 MP4 파일에서 오디오 전용 및 비디오 전용 출력을 생성합니다.

Name	형식	Description
InterleavedOutput	string	출력에는 오디오와 비디오가 모두 포함됩니다.
NonInterleavedOutput	string	출력은 비디오 전용 또는 오디오 전용입니다.

JpgFormat

JPEG 썸네일을 생성하기 위한 설정에 대해 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.JpgFormat	파생 형식에 대한 판별자입니다.
filenamePattern	string	출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.

JpgImage

입력 비디오에서 일련의 JPEG 이미지를 생성하기 위한 속성을 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.JpgImage	파생 형식에 대한 판별자입니다.
keyFrameInterval	string	두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
layers	JpgLayer[]	인코더에서 생성할 출력 JPEG 이미지 계층의 컬렉션입니다.
range	string	미리 보기 생성을 중지할 입력 비디오에서 미리 설정된 변환 시작 시간을 기준으로 하는 위치입니다. 값은 ISO 8601 형식(예: 시작 시간에서 5분 30초에 중지하는 PT5M30S) 또는 프레임 수(예: 시작 시 프레임의 300번째 프레임에서 중지하려면 300)일 수 있습니다. 이 값이 1이면 시작 시간에 썸네일 하나만 생성하거나 스트림 기간에 대한 상대 값(예: 시작 시간부터 스트림 기간의 절반에서 중지하는 50%)을 의미합니다. 기본값은 100%로, 스트리밍 끝부분에서 중지함을 의미합니다.
spriteColumn	integer	썸네일 스프라이트 이미지에 사용되는 열 수를 설정합니다. 행 수가 자동으로 계산되고 스프라이트의 각 썸네일에 대한 좌표 매핑을 사용하여 VTT 파일이 생성됩니다. 참고: 이 값은 양의 정수여야 하며 출력 이미지 해상도가 JPEG 최대 픽셀 해상도 제한인 65535x65535를 초과하지 않도록 적절한 값을 사용하는 것이 좋습니다.
start	string	썸네일 생성을 시작할 위치의 입력 비디오 위치입니다. 값은 ISO 8601 형식(예: 5초에서 시작할 경우 PT05S), 프레임 수(예: 10번째 프레임에서 시작할 경우 10개) 또는 스트림 기간의 상대값(예: 스트림 기간의 10%에서 시작할 경우 10%)이 될 수 있습니다. 또한 인코더가 비디오의 처음 몇 초에서 최상의 썸네일을 선택하고, 단계와 범위에 대한 다른 설정에 관계없이 하나의 썸네일만 생성하도록 지시하는 {Best} 매크로를 지원합니다. 기본값은 {Best} 매크로입니다.
step	string	썸네일이 생성되는 간격입니다. 값은 ISO 8601 형식(예: 5초마다 한 이미지의 경우 PT05S) 또는 프레임 수(예: 30프레임마다 하나의 이미지에 대해 30개) 또는 스트림 기간에 대한 상대 값(예: 스트림 기간의 10%마다 한 이미지의 경우 10%)일 수 있습니다. 참고: 단계 값은 처음 생성된 축소판 그림에 영향을 줍니다. 이는 변환 사전 설정 시작 시간에 지정된 것과 정확히 일치하지 않을 수 있습니다. 이는 시작 시간과 시작 시간의 단계 위치 간에 가장 적합한 썸네일을 첫 번째 출력으로 선택하려고 하는 인코더 때문입니다. 기본값은 10%이므로 스트림의 기간이 길면 처음 생성된 축소판 그림이 시작 시간에 지정된 미리 보기와 멀리 떨어져 있을 수 있습니다. 첫 번째 축소판 그림이 시작 시간에 가깝게 예상되는 경우 Step에 적절한 값을 선택하거나 시작 시간에 썸네일이 하나만 필요한 경우 범위 값을 1로 설정합니다.
stretchMode	StretchMode	크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.
syncMode	VideoSyncMode	비디오 동기화 모드

JpgLayer

입력 비디오에서 JPEG 이미지를 생성하는 설정을 설명합니다.

Name	형식	Description
height	string	이 계층에 대한 출력 비디오의 높이입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 높이가 입력의 절반 정도인 것을 의미합니다.
label	string	다른 비디오 및 오디오 계층을 멀티플렉싱하거나 출력 파일의 이름을 지정하는 데 사용할 수 있는 이 계층의 영숫자 레이블입니다.
quality	integer	JPEG 출력의 압축 품질입니다. 범위는 0-100이고 기본값은 70입니다.
width	string	이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다.

Mp4Format

출력 ISO MP4 파일의 속성을 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.Mp4Format	파생 형식에 대한 판별자입니다.
filenamePattern	string	출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.
outputFiles	OutputFile[]	생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다.

MultiBitrateFormat

GOP 정렬 다중 비트 전송률 파일의 컬렉션을 생성하기 위한 속성에 대해 설명합니다. 기본 동작은 모든 오디오와 함께 muxed되는 각 비디오 계층에 대해 하나의 출력 파일을 생성하는 것입니다. 생성된 정확한 출력 파일은 outputFiles 컬렉션을 지정하여 제어할 수 있습니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.MultiBitrateFormat	파생 형식에 대한 판별자입니다.
filenamePattern	string	출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.
outputFiles	OutputFile[]	생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다.

OnErrorType

변환은 둘 이상의 출력을 정의할 수 있습니다. 이 속성은 한 출력이 실패할 때 서비스가 수행해야 하는 작업을 정의합니다. 다른 출력을 계속 생성하거나 다른 출력을 중지합니다. 전체 작업 상태는 'ContinueJob'으로 지정된 출력의 오류를 반영하지 않습니다. 기본값은 'StopProcessingJob'입니다.

Name	형식	Description
ContinueJob	string	이 TransformOutput이 실패하면 다른 TransformOutput이 계속되도록 허용하도록 서비스에 알릴 수 있습니다.
StopProcessingJob	string	이 TransformOutput이 실패하면 다른 불완전한 TransformOutput을 중지할 수 있음을 서비스에 알릴 수 있습니다.

OutputFile

생성된 출력 파일을 나타냅니다.

Name	형식	Description
labels	string[]	인코더가 비디오 및 오디오를 출력 파일에 멀티플렉싱하는 방법을 설명하는 레이블 목록입니다. 예를 들어 인코더가 v1과 v2 레이블이 있는 두 개의 비디오 레이어와 레이블 a1이 있는 오디오 계층을 생성하는 경우 '[v1, a1]'과 같은 배열은 인코더에게 v1이 나타내는 비디오 트랙과 a1이 나타내는 오디오 트랙이 있는 출력 파일을 생성하도록 지시합니다.

PngFormat

PNG 썸네일을 생성하기 위한 설정에 대해 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.PngFormat	파생 형식에 대한 판별자입니다.
filenamePattern	string	출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - 오디오/비디오 비트 전송률(kbps)입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.

PngImage

입력 비디오에서 일련의 PNG 이미지를 생성하기 위한 속성을 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.PngImage	파생 형식에 대한 판별자입니다.
keyFrameInterval	string	두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
layers	PngLayer[]	인코더에서 생성할 출력 PNG 이미지 계층의 컬렉션입니다.
range	string	미리 보기 생성을 중지할 입력 비디오에서 미리 설정된 변환 시작 시간을 기준으로 하는 위치입니다. 값은 ISO 8601 형식(예: 시작 시간에서 5분 30초에 중지하는 PT5M30S) 또는 프레임 수(예: 시작 시 프레임의 300번째 프레임에서 중지하려면 300)일 수 있습니다. 이 값이 1이면 시작 시간에 썸네일 하나만 생성하거나 스트림 기간에 대한 상대 값(예: 시작 시간부터 스트림 기간의 절반에서 중지하는 50%)을 의미합니다. 기본값은 100%로, 스트리밍 끝부분에서 중지함을 의미합니다.
start	string	썸네일 생성을 시작할 위치의 입력 비디오 위치입니다. 값은 ISO 8601 형식(예: 5초에서 시작할 경우 PT05S), 프레임 수(예: 10번째 프레임에서 시작할 경우 10개) 또는 스트림 기간의 상대값(예: 스트림 기간의 10%에서 시작할 경우 10%)이 될 수 있습니다. 또한 인코더가 비디오의 처음 몇 초에서 최상의 썸네일을 선택하고, 단계와 범위에 대한 다른 설정에 관계없이 하나의 썸네일만 생성하도록 지시하는 {Best} 매크로를 지원합니다. 기본값은 {Best} 매크로입니다.
step	string	썸네일이 생성되는 간격입니다. 값은 ISO 8601 형식(예: 5초마다 한 이미지의 경우 PT05S) 또는 프레임 수(예: 30프레임마다 하나의 이미지에 대해 30개) 또는 스트림 기간에 대한 상대 값(예: 스트림 기간의 10%마다 한 이미지의 경우 10%)일 수 있습니다. 참고: 단계 값은 처음 생성된 축소판 그림에 영향을 줍니다. 이는 변환 사전 설정 시작 시간에 지정된 것과 정확히 일치하지 않을 수 있습니다. 이는 시작 시간과 시작 시간의 단계 위치 간에 가장 적합한 썸네일을 첫 번째 출력으로 선택하려고 하는 인코더 때문입니다. 기본값은 10%이므로 스트림의 기간이 길면 처음 생성된 축소판 그림이 시작 시간에 지정된 미리 보기와 멀리 떨어져 있을 수 있습니다. 첫 번째 축소판 그림이 시작 시간에 가깝게 예상되는 경우 Step에 적절한 값을 선택하거나 시작 시간에 썸네일이 하나만 필요한 경우 범위 값을 1로 설정합니다.
stretchMode	StretchMode	크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.
syncMode	VideoSyncMode	비디오 동기화 모드

PngLayer

입력 비디오에서 PNG 이미지를 생성하는 설정을 설명합니다.

Name	형식	Description
height	string	이 계층에 대한 출력 비디오의 높이입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 높이가 입력의 절반 정도인 것을 의미합니다.
label	string	다른 비디오 및 오디오 계층을 멀티플렉싱하거나 출력 파일의 이름을 지정하는 데 사용할 수 있는 이 계층의 영숫자 레이블입니다.
width	string	이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반 정도인 것을 의미합니다.

PresetConfigurations

인코더에 대한 선택적 구성 설정의 개체입니다.

Name	형식	Description
complexity	Complexity	속도와 품질 간의 균형을 제어하도록 인코더 설정을 구성할 수 있습니다. 예: 인코딩 속도가 빠르지만 압축 효율성이 낮을 경우 복잡성을 속도로 설정합니다.
interleaveOutput	InterleaveOutput	오디오 및 비디오가 컨테이너 형식으로 저장되는 방식을 제어하도록 출력의 인터리브 모드를 설정합니다. 예: InterleavedOutput을 NonInterleavedOutput으로 설정하여 별도의 MP4 파일에서 오디오 전용 및 비디오 전용 출력을 생성합니다.
keyFrameIntervalInSeconds	number	키 프레임 간격(초)입니다. 예: 일부 플레이어의 재생 버퍼링을 줄이려면 KeyFrameIntervalInSeconds를 2로 설정합니다.
maxBitrateBps	integer	초당 최대 비트 전송률(상위 비디오 계층의 임계값)입니다. 예: 복잡성이 높은 콘텐츠에 대해 매우 높은 비트 전송률 출력을 생성하지 않도록 MaxBitrateBps를 6000000으로 설정합니다.
maxHeight	integer	출력 비디오 계층의 최대 높이입니다. 예: MaxHeight를 720으로 설정하여 입력이 4K인 경우에도 최대 720P의 출력 계층을 생성합니다.
maxLayers	integer	출력 비디오 계층의 최대 수입니다. 예: 최대 4개의 출력 계층이 생성되어 인코딩 작업의 전체 비용을 제어하도록 MaxLayers를 4로 설정합니다.
minBitrateBps	integer	최소 비트 전송률(최하위 비디오 계층의 임계값)입니다. 예: MinBitrateBps를 200000으로 설정하여 네트워크 대역폭이 낮은 사용자를 포함하는 하위 계층을 만듭니다.
minHeight	integer	출력 비디오 계층의 최소 높이입니다. 예: MinHeight를 360으로 설정하여 180P와 같은 더 작은 해상도의 출력 계층을 방지합니다.

Priority

Transform 내에서 TransformOutputs의 상대적 우선 순위를 설정합니다. 이렇게 하면 서비스에서 TransformOutputs를 처리하는 데 사용하는 우선 순위가 설정됩니다. 기본 우선 순위는 Normal입니다.

Name	형식	Description
High	string	다른 항목보다 우선해야 하는 TransformOutputs에 사용됩니다.
Low	string	기본 및 높은 우선 순위 TransformOutputs 후에 생성할 수 있는 TransformOutput에 사용됩니다.
Normal	string	기본 우선 순위에서 생성할 수 있는 TransformOutputs에 사용됩니다.

Rectangle

입력 미디어를 처리하기 전에 입력 미디어에 적용된 사각형 창의 속성을 설명합니다.

Name	형식	Description
height	string	사각형 영역의 높이(픽셀)입니다. 절대 픽셀 값(예: 100)이거나 비디오 크기(예: 50%)를 기준으로 할 수 있습니다.
left	string	왼쪽 여백의 픽셀 수입니다. 절대 픽셀 값(예: 100)이거나 비디오 크기(예: 50%)를 기준으로 할 수 있습니다.
top	string	위쪽 여백의 픽셀 수입니다. 절대 픽셀 값(예: 100)이거나 비디오 크기(예: 50%)를 기준으로 할 수 있습니다.
width	string	사각형 영역의 너비(픽셀)입니다. 절대 픽셀 값(예: 100)이거나 비디오 크기(예: 50%)를 기준으로 할 수 있습니다.

Rotation

인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다.

Name	형식	Description
Auto	string	필요에 따라 자동으로 검색 및 회전합니다.
None	string	비디오를 회전하지 마세요. 출력 형식이 지원하는 경우 회전에 대한 메타데이터는 그대로 유지됩니다.
Rotate0	string	비디오를 회전하지 말고 회전에 대한 메타데이터를 제거합니다.
Rotate180	string	시계 방향으로 180도 회전합니다.
Rotate270	string	시계 방향으로 270도 회전합니다.
Rotate90	string	시계 방향으로 90도 회전합니다.

StandardEncoderPreset

표준 인코더를 사용하여 입력 비디오를 인코딩할 때 사용할 모든 설정을 설명합니다.

Name	형식	Description
@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입니다.

Name	형식	Description
AutoFit	string	출력의 활성 비디오 영역이 입력과 동일한 가로 세로 비율을 갖도록 하면서 출력 해상도를 적용하려면 출력(레터박스 또는 기둥 상자 포함)을 채우세요. 예를 들어 입력이 1920x1080이고 인코딩 사전 설정이 1280x1280을 요청하는 경우 출력은 1280x1280으로, 가로 세로 비율이 16:9인 내부 사각형 1280x720과 기둥 상자 영역의 너비가 280픽셀인 1280x1280이 출력됩니다.
AutoSize	string	출력 해상도를 재정의하고 패딩 없이 입력의 표시 가로 세로 비율과 일치하도록 변경합니다. 예를 들어, 입력이 1920x1080이고 인코딩 사전 설정에서 1280x1280을 요청하는 경우 사전 설정의 값이 재정의되고 출력이 1280x720이 되어 16:9의 입력 가로 세로 비율이 유지됩니다.
None	string	입력 비디오의 픽셀 가로 세로 비율 또는 디스플레이 가로 세로 비율을 고려하지 않고 출력 해상도를 엄격하게 준수합니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	UTC(리소스 만들기)의 타임스탬프입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID 유형입니다.

Transform

변환은 코드 변환 또는 인사이트 추출과 같은 입력 미디어에서 원하는 출력을 생성하기 위한 규칙 또는 지침을 캡슐화합니다. 변환을 만든 후에는 작업을 만들어 입력 미디어에 적용할 수 있습니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	리소스의 이름입니다.
properties.created	string	변환이 생성될 때 UTC 날짜 및 시간은 'YYYY-MM-DDThh:mm:ssZ' 형식입니다.
properties.description	string	변환에 대한 자세한 정보 표시 설명입니다(선택 사항).
properties.lastModified	string	변환이 마지막으로 업데이트될 때 UTC 날짜 및 시간은 'YYYY-MM-DDThh:mm:ssZ' 형식입니다.
properties.outputs	TransformOutput[]	변환이 생성해야 하는 하나 이상의 TransformOutputs의 배열입니다.
systemData	systemData	이 리소스와 관련된 시스템 메타데이터입니다.
type	string	리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

TransformOutput

원하는 출력을 생성하는 동안 적용할 규칙인 TransformOutput의 속성을 설명합니다.

Name	형식	Description
onError	OnErrorType	변환은 둘 이상의 출력을 정의할 수 있습니다. 이 속성은 한 출력이 실패할 때 서비스가 수행해야 하는 작업을 정의합니다. 다른 출력을 계속 생성하거나 다른 출력을 중지합니다. 전체 작업 상태는 'ContinueJob'으로 지정된 출력의 오류를 반영하지 않습니다. 기본값은 'StopProcessingJob'입니다.
preset	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	원본 파일에서 인사이트를 수정, 변환 또는 추출하여 출력을 생성하는 데 사용할 작업을 설명하는 사전 설정입니다.
relativePriority	Priority	Transform 내에서 TransformOutputs의 상대적 우선 순위를 설정합니다. 이렇게 하면 서비스에서 TransformOutputs를 처리하는 데 사용하는 우선 순위가 설정됩니다. 기본 우선 순위는 Normal입니다.

TransportStreamFormat

MPEG-2 전송 스트림(ISO/IEC 13818-1) 출력 비디오 파일을 생성하기 위한 속성에 대해 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.TransportStreamFormat	파생 형식에 대한 판별자입니다.
filenamePattern	string	출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.
outputFiles	OutputFile[]	생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다.

Video

입력 비디오를 인코딩하기 위한 기본 속성에 대해 설명합니다.

Name	형식	Description
@odata.type	string: #Microsoft.Media.Video	파생 형식에 대한 판별자입니다.
keyFrameInterval	string	두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 소스 설정을 따릅니다.
label	string	코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.
stretchMode	StretchMode	크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.
syncMode	VideoSyncMode	비디오 동기화 모드

VideoAnalyzerPreset

오디오 및 비디오 모두에서 인사이트(풍부한 메타데이터)를 추출하고 JSON 형식 파일을 출력하는 비디오 분석기 사전 설정입니다.

Name	형식	Description
@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

비디오 오버레이의 속성을 설명합니다.

Name	형식	Description
@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

비디오 동기화 모드

Name	형식	Description
Auto	string	기본 메서드입니다. muxer 기능에 따라 Cfr과 Vfr 중에서 선택합니다. 출력 형식 MP4의 경우 기본 모드는 Cfr입니다.
Cfr	string	입력 프레임은 요청된 상수 프레임 속도를 정확하게 달성하기 위해 필요에 따라 반복 및/또는 삭제됩니다. 출력 프레임 속도가 지정된 값으로 명시적으로 설정된 경우 권장됩니다.
Passthrough	string	프레임의 프레젠테이션 타임스탬프는 입력 파일에서 출력 파일 작성기로 전달됩니다. 입력 원본에 가변 프레임 속도가 있고 GOP 경계가 정렬된 출력에서 적응 스트리밍을 위해 여러 계층을 생성하려고 할 때 권장됩니다. 참고: 입력의 두 개 이상의 프레임에 중복 타임스탬프가 있는 경우 출력도 동일한 동작을 갖습니다.
Vfr	string	통과 모드와 비슷하지만 입력에 중복 타임스탬프가 있는 프레임이 있는 경우 하나의 프레임만 출력으로 전달되고 다른 프레임은 삭제됩니다. 출력 프레임 수가 입력 프레임 수와 같을 것으로 예상되는 경우 권장됩니다. 예를 들어 출력은 입력에 대해 PSNR과 같은 품질 메트릭을 계산하는 데 사용됩니다.