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 參數

名稱	位於	必要	類型	Description
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 版本。

要求本文

名稱	必要	類型	Description
properties.outputs	True	TransformOutput[]	一個或多個轉換應該產生的 TransformOutputs 陣列。
properties.description		string	轉換的詳細描述 (選擇性)。

回應

名稱	類型	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"
  }
}

定義

名稱	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	音訊分析器預設會套用一組預先定義的 AI 型分析作業，包括語音轉譯。此預設目前支援處理具有單一音訊播放軌的內容。
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 Hz;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	取消交錯的欄位同位，預設為 [自動]。
EncoderNamedPreset	用來編碼影片的內建預設。
EntropyMode	要用於此層的 Entropy 模式。如果未指定，編碼器會選擇適合配置檔和層級的模式。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
FaceDetectorPreset	描述分析視訊時要使用的所有設定，以偵測 (，並選擇性地) 所有臉部出現。
FaceRedactorMode	此模式可讓您選擇下列設定：1) 分析 - 僅供偵測。此模式會產生元數據 JSON 檔案，以標記整個影片中臉部的外觀。可能的話，相同人員的外觀會指派相同的標識碼。2 個) 合併 - 此外， (模糊) 偵測到的人臉。 3) Redact - 這可啟用 2 次程式，允許選擇性修訂偵測到臉部子集。它會取用先前分析階段的元數據檔案，以及來源影片，以及需要修訂的用戶選取標識符子集。
Fade	描述套用至輸入媒體的淡化效果屬性。
Filters	描述所有篩選作業，例如在編碼之前套用至輸入媒體的反交錯、旋轉等。
H264Complexity	告知編碼器如何選擇其編碼設定。默認值為 [平衡]。
H264Layer	描述使用 H.264 視訊編解碼器，將輸入視訊編碼成所需輸出比特率層時要使用的設定。
H264RateControlMode	視訊速率控制模式
H264Video	描述使用 H.264 編解碼器編碼視訊的所有屬性。
H264VideoProfile	我們目前支持比較基準、主要、高、高422、High444。預設值為 Auto。
H265Complexity	告知編碼器如何選擇其編碼設定。品質會提供較高的壓縮比率，但成本較高且計算時間較長。速度會產生相對較大的檔案，但速度較快且更經濟。默認值為 [平衡]。
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 在 Transform 內的相對優先順序。這會設定服務用於處理 TransformOutputs 的優先順序。默認優先順序為 Normal。
Rectangle	描述在處理矩形視窗之前套用至輸入媒體的屬性。
Rotation	如果有任何旋轉，則會在編碼之前套用至輸入視訊。預設值為 Auto
StandardEncoderPreset	描述使用標準編碼器編碼輸入視訊時要使用的所有設定。
StretchMode	重設大小模式 - 輸入視訊的大小如何調整，以符合所需的輸出解析度 () 。預設值為 AutoSize
systemData	與建立和上次修改資源相關的元數據。
Transform	轉換會封裝從輸入媒體產生所需輸出的規則或指示，例如轉碼或擷取見解。建立轉換之後，即可藉由建立作業來套用至輸入媒體。
TransformOutput	描述 TransformOutput 的屬性，這是產生所需輸出時要套用的規則。
TransportStreamFormat	描述產生 MPEG-2 傳輸數據流的屬性， (ISO/IEC 13818-1) 輸出視訊檔案 (s) 。
Video	描述編碼輸入視訊的基本屬性。
VideoAnalyzerPreset	影片分析器預設會從音訊和視訊擷取深入解析 (豐富的元數據) ，並輸出 JSON 格式檔案。
VideoOverlay	描述視訊重疊的屬性。
VideoSyncMode	視訊同步模式

AacAudio

描述 AAC) 音訊編碼設定 (進階音訊編解碼器。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.AacAudio	衍生類型的鑒別子。
bitrate	integer	輸出編碼音訊的每秒位比特率。
channels	integer	音訊中的通道數目。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
profile	AacAudioProfile	使用 AAC 編碼音訊時要使用的編碼設定檔。
samplingRate	integer	用於以 hertz 編碼的取樣率。

AacAudioProfile

使用 AAC 編碼音訊時要使用的編碼設定檔。

名稱	類型	Description
AacLc	string	指定要將輸出音訊編碼為 AAC 低複雜度設定檔， (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 以取得詳細數據) 。不過，在重設大小的視訊中，最終太小的臉部可能無法偵測到。

名稱	類型	Description
SourceResolution	string
StandardDefinition	string

Audio

定義所有音訊編解碼器的通用屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.Audio	衍生類型的鑒別子。
bitrate	integer	輸出編碼音訊的每秒位比特率。
channels	integer	音訊中的通道數目。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
samplingRate	integer	用於以 hertz 編碼的取樣率。

AudioAnalysisMode

決定要執行的音訊分析作業集。如果未指定，則會選擇標準 AudioAnalysisMode。

名稱	類型	Description
Basic	string	此模式會針對 VTT 翻譯字幕/原文檔案進行語音轉換文字的謄寫與產生。此模式的輸出包含 Insights JSON 檔案，該檔案只包含關鍵字、謄寫和計時資訊。此模式不包含自動語言偵測和說話者自動分段標記。
Standard	string	執行基本模式中包含的所有作業，同時執行語言偵測和說話者聽寫。

AudioAnalyzerPreset

音訊分析器預設會套用一組預先定義的 AI 型分析作業，包括語音轉譯。此預設目前支援處理具有單一音訊播放軌的內容。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.AudioAnalyzerPreset	衍生型別的辨別子。
audioLanguage	string	使用 'language tag-region' 的 BCP-47 格式輸入中音訊承載的語言 (例如：'en-US') 。如果您知道內容的語言，建議您指定它。必須明確指定 AudioAnalysisMode：：Basic 的語言，因為自動語言偵測未包含在基本模式中。如果未指定語言或將語言設為 Null，自動語言偵測會選擇偵測到的第一種語言，並使用選取的語言處理整個檔案。目前不支援在偵測到第一個語言後，動態地切換語言。自動偵測最適合使用可清楚辨識語音的音訊錄製。如果自動偵測找不到語言，轉譯會回復為 'en-US'。」這裡提供支援的語言清單： https://go.microsoft.com/fwlink/?linkid=2109463
experimentalOptions	object	字典，其中包含預設本身未公開之參數的索引鍵值組
mode	AudioAnalysisMode	決定要執行的音訊分析作業集。如果未指定，則會選擇標準 AudioAnalysisMode。

AudioOverlay

描述音訊重疊的屬性。

名稱	類型	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

模糊類型

名稱	類型	Description
Black	string	黑色：封鎖篩選
Box	string	Box：偵錯篩選條件，僅限周框方塊
High	string	高：混淆模糊篩選
Low	string	低：Box-car blur filter
Med	string	Med：Gaussian 模糊篩選

BuiltInStandardEncoderPreset

描述使用標準編碼器編碼輸入視訊的內建預設。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.BuiltInStandardEncoderPreset	衍生型別的辨別子。
configurations	PresetConfigurations	編碼器的選擇性組態設定。只有 ContentAwareEncoding 和 H265ContentAwareEncoding BuiltInStandardEncoderPreset 才支持設定。
presetName	EncoderNamedPreset	用來編碼影片的內建預設。

Complexity

可讓您設定編碼器設定，以控制速度與品質之間的平衡。範例：將複雜度設定為速度，以加快編碼速度，但壓縮效率較低。

名稱	類型	Description
Balanced	string	設定編碼器以使用達到速度和品質平衡的設定。
Quality	string	將編碼器設定為使用優化設定，以產生較高的品質輸出，代價是整體編碼時間較慢。
Speed	string	將編碼器設定為使用優化以加快編碼速度的設定。質量會犧牲以減少編碼時間。

CopyAudio

編解碼器旗標，告知編碼器複製輸入音訊位流。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.CopyAudio	衍生類型的鑒別子。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。

CopyVideo

編解碼器旗標，可告知編碼器在不重新編碼的情況下複製輸入視訊位流。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.CopyVideo	衍生類型的鑒別子。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。

createdByType

建立資源的身分識別類型。

名稱	類型	Description
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 Hz;AC3 規格的音訊比特率值支援：32000、40000、48000、56000、64000、80000、 96000、112000、128000、160000、192000、224000、256000、320000、384000、448000、512000、576000、640000 bps。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.DDAudio	衍生類型的鑒別子。
bitrate	integer	輸出編碼音訊的每秒位比特率。
channels	integer	音訊中的通道數目。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
samplingRate	integer	用於以 hertz 編碼的取樣率。

Deinterlace

描述取消交錯設定。

名稱	類型	Description
mode	DeinterlaceMode	取消交錯模式。默認為 AutoPixelAdaptive。
parity	DeinterlaceParity	取消交錯的欄位同位，預設為 Auto。

DeinterlaceMode

反交錯模式。默認為 AutoPixelAdaptive。

名稱	類型	Description
AutoPixelAdaptive	string	在輸入視訊中的每個畫面上套用自動圖元自適性反交錯。
Off	string	停用來源視訊的反交錯。

DeinterlaceParity

取消交錯的欄位同位，預設為 [自動]。

名稱	類型	Description
Auto	string	自動偵測欄位的順序
BottomFieldFirst	string	套用底部欄位第一次處理輸入視訊。
TopFieldFirst	string	套用最上層欄位第一次處理輸入視訊。

EncoderNamedPreset

用來編碼影片的內建預設。

名稱	類型	Description
AACGoodQualityAudio	string	產生只包含以 192 kbps 編碼的 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	產生只包含 DD (Digital Dolby) 以 192 kbps 編碼的立體音訊的單一 MP4 檔案。
H264MultipleBitrate1080p	string	產生一組 8 個 GOP 對齊的 MP4 檔案，範圍從 6000 kbps 到 400 kbps，以及立體 AAC 音訊。解析度從 1080p 開始，並向下移至 180p。
H264MultipleBitrate720p	string	產生一組 6 個 GOP 對齊的 MP4 檔案，範圍從 3400 kbps 到 400 kbps，以及立體 AAC 音訊。解析度從 720p 開始，並向下移至 180p。
H264MultipleBitrateSD	string	產生一組 5 個 GOP 對齊的 MP4 檔案，範圍從 1900 kbps 到 400 kbps，以及立體 AAC 音訊。解析度從 480p 開始，並向下移至 240p。
H264SingleBitrate1080p	string	產生 MP4 檔案，其中視訊以 H.264 編解碼器編碼為 6750 kbps，圖片高度為 1080 像素，並以 AAC-LC 編解碼器編碼為 128 kbps 的立體音訊。
H264SingleBitrate720p	string	產生 MP4 檔案，其中視訊以 H.264 編解碼器編碼為 4500 kbps，圖片高度為 720 像素，並以 AAC-LC 編解碼器編碼為 128 kbps 的立體音訊。
H264SingleBitrateSD	string	產生 MP4 檔案，其中視訊以 H.264 編解碼器編碼為 2200 kbps，圖片高度為 480 像素，並以 AAC-LC 編解碼器編碼為 128 kbps 的立體音訊。
H265AdaptiveStreaming	string	產生一組符合 GOP 的 MP4 檔案，其中包含 H.265 視訊和立體聲 AAC 音訊。根據輸入解析度、位元速率和畫面播放速率自動產生位元速率階梯。自動產生的預設值絕對不會超過輸入解析度。例如，如果輸入是 720p，則輸出最多維持在 720p。
H265ContentAwareEncoding	string	使用內容感知編碼來產生一組符合 GOP 的 MP4。指定輸入內容時，服務會對輸入的內容執行初始的輕量分析，然後將其結果用於決定最適合自適性串流傳遞的圖層數、適當的位元速率及解析度設定。此預設特別適用於中低複雜度的影片，雖然輸出檔案位元速率較低，但品質仍足以讓觀眾享受良好的體驗。輸出會包含視訊和音訊交錯的 MP4 檔案。
H265SingleBitrate1080p	string	產生 MP4 檔案，其中視訊以 H.265 編解碼器編碼為 3500 kbps，且圖片高度為 1080 像素，並以 AAC-LC 編解碼器編碼為 128 kbps 的立體音訊。
H265SingleBitrate4K	string	產生 MP4 檔案，其中視訊以 H.265 編解碼器編碼為 9500 kbps，圖片高度為 2160 圖元，並以 AAC-LC 編解碼器編碼為 128 kbps 的立體音訊。
H265SingleBitrate720p	string	產生 MP4 檔案，其中視訊以 H.265 編解碼器編碼為 1800 kbps，圖片高度為 720 像素，並以 AAC-LC 編解碼器編碼為 128 kbps 的立體音訊。

EntropyMode

要用於此層的 Entropy 模式。如果未指定，編碼器會選擇適合配置檔和層級的模式。

名稱	類型	Description
Cabac	string	內容調適型二進位算術編解碼器 (CABAC) entropy 編碼。
Cavlc	string	內容調適型可變長度編解碼器 (CAVLC) entropy 編碼。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細資料。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

FaceDetectorPreset

描述分析視訊時要使用的所有設定，以偵測 (，並選擇性地) 所有臉部出現。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.FaceDetectorPreset	衍生型別的辨別子。
blurType	BlurType	模糊類型
experimentalOptions	object	字典，其中包含預設本身未公開之參數的索引鍵值組
mode	FaceRedactorMode	此模式可讓您選擇下列設定：1) 分析 - 僅供偵測。此模式會產生元數據 JSON 檔案，以標記整個影片中臉部的外觀。可能的話，相同人員的外觀會指派相同的標識碼。2 個) 合併 - 此外， (模糊) 偵測到的人臉。 3) Redact - 這可啟用 2 次程式，允許選擇性修訂偵測到臉部子集。它會取用先前分析階段的元數據檔案，以及來源影片，以及需要修訂的用戶選取標識符子集。
resolution	AnalysisResolution	指定分析影片的最大解析度。默認行為是 “SourceResolution”，這會在分析時保持輸入視訊的原始解析度。使用「StandardDefinition」會將輸入影片調整為標準定義，同時保留適當的外觀比例。只有在視訊解析度較高時，才會重設大小。例如，在處理之前，會將 1920x1080 輸入調整為 640x360。切換至「StandardDefinition」可減少處理高解析度視訊所需的時間。它也可能會降低使用此元件的成本， (請參閱 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics 以取得詳細數據) 。不過，在重設大小的視訊中，最終太小的臉部可能無法偵測到。

FaceRedactorMode

此模式可讓您選擇下列設定：1) 分析 - 僅供偵測。此模式會產生元數據 JSON 檔案，以標記整個影片中臉部的外觀。可能的話，相同人員的外觀會指派相同的標識碼。2 個) 合併 - 此外， (模糊) 偵測到的人臉。 3) Redact - 這可啟用 2 次程式，允許選擇性修訂偵測到臉部子集。它會取用先前分析階段的元數據檔案，以及來源影片，以及需要修訂的用戶選取標識符子集。

名稱	類型	Description
Analyze	string	分析模式會偵測臉部，並輸出具有結果的元數據檔案。允許編輯元數據檔案，然後臉部會以 Redact 模式模糊。
Combined	string	合併模式會在編輯分析臉部時，在一次中執行 [分析和修訂] 步驟。
Redact	string	Redact 模式會取用分析模式中的元數據檔案，並修訂找到的臉部。

Fade

描述套用至輸入媒體的淡化效果屬性。

名稱	類型	Description
duration	string	影片中淡出效果的持續時間。此值可以是 ISO 8601 格式 (例如，PT05S 在 5 秒) 期間淡入/淡出色彩，或畫面格計數 (例如，10 個從開始時間淡出 10 個畫面格) ，或串流持續時間的相對值 (例如，10% 淡出 10% 的數據流持續時間)
fadeColor	string	淡入/輸出的色彩。它可以在 CSS Level1 色彩 https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords 或 RGB/十六進位值上：例如：rgb (255,0,0,0) 、0xFF0000或 #FF0000
start	string	輸入視訊中要從何處開始淡出的位置。此值可以是 ISO 8601 格式 (例如，PT05S 即從第 5 秒開始)，或畫面計數 (例如，10 即從第 10 格畫面開始)，或串流持續時間的相對值 (例如，10% 即從 10% 的串流持續時間開始)。預設值為 0

Filters

描述所有篩選作業，例如在編碼之前套用至輸入媒體的反交錯、旋轉等。

名稱	類型	Description
crop	Rectangle	用來裁剪輸入視訊之矩形視窗的參數。
deinterlace	Deinterlace	取消交錯設定。
fadeIn	Fade	描述套用至輸入媒體的淡出效果屬性。
fadeOut	Fade	描述套用至輸入媒體的淡出效果屬性。
overlays	Overlay[]: AudioOverlay[] VideoOverlay[]	要套用至輸入視訊之重疊的屬性。這些可能是音訊、影像或視訊重疊。
rotation	Rotation	如果有任何旋轉，則會在編碼之前套用至輸入視訊。預設值為 Auto

H264Complexity

告知編碼器如何選擇其編碼設定。默認值為 [平衡]。

名稱	類型	Description
Balanced	string	告知編碼器使用可達到速度和品質平衡的設定。
Quality	string	告知編碼器使用優化以產生高品質輸出的設定，代價是整體編碼時間較慢。
Speed	string	告知編碼器使用優化以加快編碼速度的設定。質量會犧牲以減少編碼時間。

H264Layer

描述使用 H.264 視訊編解碼器，將輸入視訊編碼成所需輸出比特率層時要使用的設定。

名稱	類型	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	要用於此層的 Entropy 模式。如果未指定，編碼器會選擇適合配置檔和層級的模式。
frameRate	string	幀速率 (每秒) 要編碼此層的畫面格速率。值可以是 M/N 的形式，其中 M 和 N 是整數 (例如 30000/1001) ，或以數位 (的形式) 。例如，30 或 29.97) 。編碼器會根據配置檔和層級，對允許的幀速率強制執行條件約束。如果未指定，編碼器會使用與輸入視訊相同的幀速率。
height	string	此圖層的輸出視訊高度。此值可以是圖元) 的絕對 (，或以百分比) 表示的相對 (。例如，50% 表示輸出視訊的高度為一半的圖元，與輸入相同。
label	string	這個圖層的英數位元標籤，可用於多任務處理不同的視訊和音訊層，或用於命名輸出檔案。
level	string	我們目前支援最高層級 6.2。此值可以是 Auto，或符合 H.264 配置檔的數位。如果未指定，預設值為 [自動]，可讓編碼器選擇適合此圖層的 [層級]。
maxBitrate	integer	每秒) 位的最大比特率 (，VBV 緩衝區應假設為重新填滿。如果未指定，則預設為與比特率相同的值。
profile	H264VideoProfile	我們目前支持比較基準、主要、高、高422、High444。預設值為 Auto。
referenceFrames	integer	編碼這個圖層時要使用的參考框架數目。如果未指定，編碼器會根據編碼器複雜度設定來決定適當的數位。
slices	integer	編碼此圖層時要使用的配量數目。如果未指定，預設值為零，這表示編碼器會針對每個畫面使用單一配量。
width	string	此圖層的輸出視訊寬度。此值可以是圖元) 的絕對 (，或以百分比) 表示的相對 (。例如，50% 表示輸出視訊的寬度與輸入的一半圖元相同。

H264RateControlMode

視訊速率控制模式

名稱	類型	Description
ABR	string	達到目標比特率的平均比特率 (ABR) 模式：預設模式。
CBR	string	固定比特率 (CBR) 模式，以強化目標比特率的比特率變化。
CRF	string	固定速率因數 (CRF) 模式，以固定的主體質量為目標。

H264Video

描述使用 H.264 編解碼器編碼視訊的所有屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.H264Video	衍生類型的鑒別子。
complexity	H264Complexity	告知編碼器如何選擇其編碼設定。默認值為 [平衡]。
keyFrameInterval	string	兩個主要畫面格之間的距離。此值應為 [0.5， 20] 秒範圍內的非零，以 ISO 8601 格式指定。預設值為 PT2S (2 秒) 。請注意，如果設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
layers	H264Layer[]	要由編碼器產生的輸出 H.264 層集合。
rateControlMode	H264RateControlMode	視訊速率控制模式
sceneChangeDetection	boolean	編碼器是否應該在場景變更插入主要畫面格。如果未指定，則預設值為 false。只有當編碼器設定為產生單一輸出視訊時，才應將此旗標設定為 true。
stretchMode	StretchMode	重設大小模式 - 輸入視訊的大小如何調整，以符合所需的輸出解析度 () 。預設值為 AutoSize
syncMode	VideoSyncMode	視訊同步模式

H264VideoProfile

我們目前支持比較基準、主要、高、高422、High444。預設值為 Auto。

名稱	類型	Description
Auto	string	告知編碼器自動判斷適當的 H.264 配置檔。
Baseline	string	基準配置檔
High	string	高配置檔。
High422	string	高 4：2：2 配置檔。
High444	string	高 4：4：4 預測配置檔。
Main	string	主要配置檔

H265Complexity

告知編碼器如何選擇其編碼設定。品質會提供較高的壓縮比率，但成本較高且計算時間較長。速度會產生相對較大的檔案，但速度較快且更經濟。默認值為 [平衡]。

名稱	類型	Description
Balanced	string	告知編碼器使用可達到速度與品質平衡的設定。
Quality	string	告知編碼器使用優化設定，以產生較高的質量輸出，而代價是整體編碼時間較慢。
Speed	string	告知編碼器使用優化以加快編碼速度的設定。質量會犧牲以減少編碼時間。

H265Layer

描述使用 H.265 視訊編解碼器將輸入視訊編碼成所需輸出比特率層時所使用的設定。

名稱	類型	Description
adaptiveBFrame	boolean	指定編碼此層時是否要使用調適型 B 畫面格。如果未指定，編碼器會在視訊配置檔允許其使用時開啟。
bFrames	integer	編碼此圖層時要使用的 B 框架數目。如果未指定，編碼器會根據視訊配置檔和層級選擇適當的數位。
bitrate	integer	產生此層時，每秒要編碼輸入視訊的平均比特率。例如：目標比特率為 3000Kbps 或 3Mbps 表示此值應為 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 配置檔的數位。如果未指定，預設值為 [自動]，可讓編碼器選擇適合此圖層的 [層級]。
maxBitrate	integer	每秒) 位的最大比特率 (，VBV 緩衝區應假設為重新填滿。如果未指定，則預設為與比特率相同的值。
profile	H265VideoProfile	我們目前支援Main。預設值為 Auto。
referenceFrames	integer	編碼這個圖層時要使用的參考框架數目。如果未指定，編碼器會根據編碼器複雜度設定來決定適當的數位。
slices	integer	編碼此圖層時要使用的配量數目。如果未指定，預設值為零，這表示編碼器會針對每個畫面使用單一配量。
width	string	此圖層的輸出視訊寬度。此值可以是圖元) 的絕對 (，或以百分比) 表示的相對 (。例如，50% 表示輸出視訊的寬度與輸入的一半圖元相同。

H265Video

描述使用 H.265 編解碼器編碼視訊的所有屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.H265Video	衍生類型的鑒別子。
complexity	H265Complexity	告知編碼器如何選擇其編碼設定。品質會提供較高的壓縮率，但成本較高且計算時間較長。速度會產生相對較大的檔案，但較快速且更經濟。默認值為 [平衡]。
keyFrameInterval	string	兩個主要畫面格之間的距離。此值應為 [0.5， 20] 秒範圍內的非零，以 ISO 8601 格式指定。預設值為 PT2S (2 秒) 。請注意，如果設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
layers	H265Layer[]	要由編碼器產生的輸出 H.265 層集合。
sceneChangeDetection	boolean	指定編碼器是否應該在場景變更插入主要畫面格。如果未指定，則預設值為 false。只有當編碼器設定為產生單一輸出視訊時，才應將此旗標設定為 true。
stretchMode	StretchMode	重設大小模式 - 輸入視訊的大小如何調整，以符合所需的輸出解析度 () 。預設值為 AutoSize
syncMode	VideoSyncMode	視訊同步模式

H265VideoProfile

我們目前支援Main。預設值為 Auto。

名稱	類型	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

描述從輸入影片產生縮圖的基本屬性

名稱	類型	Description
@odata.type	string: #Microsoft.Media.Image	衍生類型的鑒別子。
keyFrameInterval	string	兩個主要畫面格之間的距離。此值應為 [0.5， 20] 秒範圍內的非零，以 ISO 8601 格式指定。預設值為 PT2S (2 秒) 。請注意，如果設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
range	string	相對於轉換輸入視訊中預設開始時間的位置，要停止產生縮圖。值可以是 ISO 8601 格式 (例如，PT5M30S從開始時間) 停止 5 分鐘和 30 秒，或 (300 個畫面計數，例如，300 會從開始時間從畫面格的第 300 個畫面停止。如果此值為 1，則表示只在開始時間產生一個縮圖) ，或數據流持續時間的相對值 (例如，50% 會停止在開始時間的一半數據流持續時間) 。預設值為 100%，即停止在串流結尾。
start	string	輸入視訊中要開始產生縮圖的位置。此值可以是 ISO 8601 格式 (例如，PT05S 即從第 5 秒開始)，或畫面計數 (例如，10 即從第 10 格畫面開始)，或串流持續時間的相對值 (例如，10% 即從 10% 的串流持續時間開始)。同時支援巨集 {Best}，其會指示編碼器從視訊前幾秒選取最佳縮圖，而且無論間隔和範圍的其他設定為何，都只產生一張縮圖。預設值為巨集 {Best}。
step	string	產生縮圖的間隔。此值可以是 ISO 8601 格式 (例如，每 5 秒一個影像 PT05S) 一個影像，或每 30 個畫面格 (30 個影像的畫面計數，或每個 30 個畫面格) 的相對值，例如，每 10% 的數據流 (持續時間為 10% 的影像) 。注意：步驟值會影響第一個產生的縮圖，這可能不是轉換默認開始時間所指定的縮圖。這是因為編碼器會嘗試在開始時間與從開始時間的步驟位置之間選取最佳縮圖作為第一個輸出。由於預設值為 10%，這表示如果數據流持續時間很長，則第一個產生的縮圖可能遠於開始時間指定的縮圖。如果第一個縮圖預期接近開始時間，請嘗試為 Step 選取合理的值，或在開始時間只需要一個縮圖時，將 Range 值設定為 1。
stretchMode	StretchMode	重設大小模式 - 輸入視訊的大小如何調整，以符合所需的輸出解析度 () 。預設值為 AutoSize
syncMode	VideoSyncMode	視訊同步模式

ImageFormat

描述輸出圖像檔的屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.ImageFormat	衍生類型的鑒別子。
filenamePattern	string	用於建立輸出檔案的檔案命名模式。檔名支援下列宏： {Basename} - 將使用輸入視訊檔名稱的擴充宏。如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元，則會使用輸入視訊檔案的基底名稱。如果輸入視訊檔案的基底名稱長度超過 32 個字元，基底名稱會以總長度截斷為前 32 個字元。 {Extension} - 此格式的適當擴充功能。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊串流號碼， (從 1) 開始。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。任何未取代的宏都會從檔名折迭和移除。

InsightsType

定義您想要服務產生之深入解析的類型。允許的值為 'AudioInsightsOnly'、'VideoInsightsOnly' 和 'AllInsights'。預設值為 AllInsights。如果您將此設定為 AllInsights，且輸入只是音訊，則只會產生音訊深入解析。同樣地，如果輸入只是視訊，則只會產生影片深入解析。如果您預期某些輸入只是視訊，建議您不要使用 AudioInsightsOnly;或如果您預期某些輸入只是音訊，請使用 VideoInsightsOnly。這類情況下的作業會發生錯誤。

名稱	類型	Description
AllInsights	string	產生音訊和視訊深入解析。如果音訊或視訊深入解析失敗，則失敗。
AudioInsightsOnly	string	僅產生音訊見解。即使存在，仍忽略視訊。如果沒有任何音訊存在，則失敗。
VideoInsightsOnly	string	僅產生影片深入解析。如果存在，請忽略音訊。如果沒有影片存在，就會失敗。

InterleaveOutput

設定輸出的交錯模式，以控制音訊和視訊如何以容器格式儲存。範例：將 InterleavedOutput 設定為 NonInterleavedOutput，以在不同的 MP4 檔案中產生僅限音訊和僅限視訊輸出。

名稱	類型	Description
InterleavedOutput	string	輸出同時包含音訊和視訊。
NonInterleavedOutput	string	輸出為僅限視訊或僅限音訊。

JpgFormat

描述產生 JPEG 縮圖的設定。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.JpgFormat	衍生類型的鑒別子。
filenamePattern	string	用於建立輸出檔案的檔案命名模式。檔名支援下列宏： {Basename} - 將使用輸入視訊檔名稱的擴充宏。如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元，則會使用輸入視訊檔案的基底名稱。如果輸入視訊檔案的基底名稱長度超過 32 個字元，基底名稱會以總長度截斷為前 32 個字元。 {Extension} - 此格式的適當擴充功能。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊串流號碼， (從 1) 開始。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。任何未取代的宏都會從檔名折迭和移除。

JpgImage

描述從輸入影片產生一系列 JPEG 影像的屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.JpgImage	衍生類型的鑒別子。
keyFrameInterval	string	兩個主要畫面格之間的距離。此值應為 [0.5， 20] 秒範圍內的非零，以 ISO 8601 格式指定。預設值為 PT2S (2 秒) 。請注意，如果設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
layers	JpgLayer[]	要由編碼器產生的輸出 JPEG 影像層集合。
range	string	相對於轉換輸入視訊中預設開始時間的位置，要停止產生縮圖。值可以是 ISO 8601 格式 (例如，PT5M30S從開始時間) 停止 5 分鐘和 30 秒，或 (300 個畫面計數，例如，300 會從開始時間從畫面格的第 300 個畫面停止。如果此值為 1，則表示只在開始時間產生一個縮圖) ，或數據流持續時間的相對值 (例如，50% 會停止在開始時間的一半數據流持續時間) 。預設值為 100%，即停止在串流結尾。
spriteColumn	integer	設定縮圖 Sprite 影像中使用的數據行數目。系統會自動計算數據列數目，併產生 VTT 檔案，其中包含 Sprite 中每個縮圖的座標對應。注意：此值應該是正整數，且建議使用適當的值，以便輸出影像解析度不會超過 JPEG 最大像素解析度限制 65535x65535。
start	string	輸入視訊中要開始產生縮圖的位置。此值可以是 ISO 8601 格式 (例如，PT05S 即從第 5 秒開始)，或畫面計數 (例如，10 即從第 10 格畫面開始)，或串流持續時間的相對值 (例如，10% 即從 10% 的串流持續時間開始)。同時支援巨集 {Best}，其會指示編碼器從視訊前幾秒選取最佳縮圖，而且無論間隔和範圍的其他設定為何，都只產生一張縮圖。預設值為巨集 {Best}。
step	string	產生縮圖的間隔。此值可以是 ISO 8601 格式 (例如，每 5 秒一個影像 PT05S) 一個影像，或每 30 個畫面格 (30 個影像的畫面計數，或每個 30 個畫面格) 的相對值，例如，每 10% 的數據流 (持續時間為 10% 的影像) 。注意：步驟值會影響第一個產生的縮圖，這可能不是轉換默認開始時間所指定的縮圖。這是因為編碼器會嘗試在開始時間與從開始時間的步驟位置之間選取最佳縮圖作為第一個輸出。由於預設值為 10%，這表示如果數據流持續時間很長，則第一個產生的縮圖可能遠於開始時間指定的縮圖。如果第一個縮圖預期接近開始時間，請嘗試為 Step 選取合理的值，或在開始時間只需要一個縮圖時，將 Range 值設定為 1。
stretchMode	StretchMode	重設大小模式 - 輸入視訊的大小如何調整，以符合所需的輸出解析度 () 。預設值為 AutoSize
syncMode	VideoSyncMode	視訊同步模式

JpgLayer

描述從輸入影片產生 JPEG 影像的設定。

名稱	類型	Description
height	string	此圖層的輸出視訊高度。此值可以是圖元) 的絕對 (，或以百分比) 表示的相對 (。例如，50% 表示輸出視訊的高度為一半的圖元，與輸入相同。
label	string	這個圖層的英數位元標籤，可用於多任務處理不同的視訊和音訊層，或用於命名輸出檔案。
quality	integer	JPEG 輸出的壓縮品質。範圍介於 0-100 之間，預設值為 70。
width	string	此圖層的輸出視訊寬度。此值可以是圖元) 的絕對 (，或以百分比) 表示的相對 (。例如，50% 表示輸出視訊的寬度與輸入的一半圖元相同。

Mp4Format

描述輸出 ISO MP4 檔案的屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.Mp4Format	衍生類型的鑒別子。
filenamePattern	string	用於建立輸出檔案的檔案命名模式。檔名支援下列宏： {Basename} - 將使用輸入視訊檔名稱的擴充宏。如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元，則會使用輸入視訊檔案的基底名稱。如果輸入視訊檔案的基底名稱長度超過 32 個字元，基底名稱會以總長度截斷為前 32 個字元。 {Extension} - 此格式的適當擴充功能。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊串流號碼， (從 1) 開始。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。任何未取代的宏都會從檔名折迭和移除。
outputFiles	OutputFile[]	要產生的輸出檔案清單。清單中的每個專案都是一組要一起多任務處理的音訊和視訊層標籤。

MultiBitrateFormat

描述產生 GOP 對齊多比特率檔案集合的屬性。默認行為是為每個視訊層產生一個輸出檔案，其會與所有音訊一起多任務處理。您可以藉由指定 outputFiles 集合來控制產生的確切輸出檔案。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.MultiBitrateFormat	衍生類型的鑒別子。
filenamePattern	string	用於建立輸出檔案的檔案命名模式。檔名支援下列宏： {Basename} - 將使用輸入視訊檔名稱的擴充宏。如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元，則會使用輸入視訊檔案的基底名稱。如果輸入視訊檔案的基底名稱長度超過 32 個字元，基底名稱會以總長度截斷為前 32 個字元。 {Extension} - 此格式的適當擴充功能。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊串流號碼， (從 1) 開始。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。任何未取代的宏都會從檔名折迭和移除。
outputFiles	OutputFile[]	要產生的輸出檔案清單。清單中的每個專案都是一組要一起多任務處理的音訊和視訊層標籤。

OnErrorType

轉換可以定義多個輸出。此屬性會定義當一個輸出失敗時，服務應該執行的動作 - 繼續產生其他輸出，或停止其他輸出。整體作業狀態不會反映以『ContinueJob』指定的輸出失敗。預設值為『StopProcessingJob』。

名稱	類型	Description
ContinueJob	string	告知服務，如果此 TransformOutput 失敗，則允許任何其他 TransformOutput 繼續。
StopProcessingJob	string	告知服務，如果此 TransformOutput 失敗，則可以停止任何其他不完整的 TransformOutput。

OutputFile

表示產生的輸出檔案。

名稱	類型	Description
labels	string[]	描述編碼器如何將視訊和音訊多任務處理到輸出檔案的標籤清單。例如，如果編碼器產生兩個具有 v1 和 v2 卷標的視訊層，以及一個具有卷標 a1 的音訊層，則類似 '[v1， a1]' 的數位會告知編碼器產生輸出檔案，其中包含 v1 所代表的視訊播放軌和 a1 所代表的音訊播放軌。

PngFormat

描述產生 PNG 縮圖的設定。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.PngFormat	衍生類型的鑒別子。
filenamePattern	string	用於建立輸出檔案的檔案命名模式。檔名支援下列宏：{Basename} - 將使用輸入視訊檔名稱的擴充宏。如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元，則會使用輸入視訊檔案的基底名稱。如果輸入視訊檔案的基底名稱長度超過 32 個字元，則基底名稱會截斷為總長度的前 32 個字元。 {Extension} - 此格式的適當延伸模組。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊數據流號碼， (從 1 開始) 。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。任何未取代的宏都會從檔名折迭和移除。

PngImage

描述從輸入視訊產生一系列 PNG 影像的屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.PngImage	衍生類型的鑒別子。
keyFrameInterval	string	兩個主要畫面格之間的距離。此值應為 [0.5， 20] 秒範圍內的非零，以 ISO 8601 格式指定。預設值為 PT2S (2 秒) 。請注意，如果設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
layers	PngLayer[]	要由編碼器產生的輸出 PNG 影像層集合。
range	string	相對於轉換輸入視訊中預設開始時間的位置，要停止產生縮圖。值可以是 ISO 8601 格式 (例如，PT5M30S從開始時間) 停止 5 分鐘和 30 秒，或 (300 個畫面計數，例如，300 會從開始時間從畫面格的第 300 個畫面停止。如果此值為 1，則表示只在開始時間產生一個縮圖) ，或數據流持續時間的相對值 (例如，50% 會停止在開始時間的一半數據流持續時間) 。預設值為 100%，即停止在串流結尾。
start	string	輸入視訊中要開始產生縮圖的位置。此值可以是 ISO 8601 格式 (例如，PT05S 即從第 5 秒開始)，或畫面計數 (例如，10 即從第 10 格畫面開始)，或串流持續時間的相對值 (例如，10% 即從 10% 的串流持續時間開始)。同時支援巨集 {Best}，其會指示編碼器從視訊前幾秒選取最佳縮圖，而且無論間隔和範圍的其他設定為何，都只產生一張縮圖。預設值為巨集 {Best}。
step	string	產生縮圖的間隔。此值可以是 ISO 8601 格式 (例如，每 5 秒一個影像 PT05S) 一個影像，或每 30 個畫面格 (30 個影像的畫面計數，或每個 30 個畫面格) 的相對值，例如，每 10% 的數據流 (持續時間為 10% 的影像) 。注意：步驟值會影響第一個產生的縮圖，這可能不是轉換默認開始時間所指定的縮圖。這是因為編碼器會嘗試在開始時間與從開始時間的步驟位置之間選取最佳縮圖作為第一個輸出。由於預設值為 10%，這表示如果數據流持續時間很長，則第一個產生的縮圖可能遠於開始時間指定的縮圖。如果第一個縮圖預期接近開始時間，請嘗試為 Step 選取合理的值，或在開始時間只需要一個縮圖時，將 Range 值設定為 1。
stretchMode	StretchMode	重設大小模式 - 輸入視訊的大小如何調整，以符合所需的輸出解析度 () 。預設值為 AutoSize
syncMode	VideoSyncMode	視訊同步模式

PngLayer

描述從輸入影片產生 PNG 影像的設定。

名稱	類型	Description
height	string	此圖層的輸出視訊高度。此值可以是圖元) 的絕對 (，或以百分比) 表示的相對 (。例如，50% 表示輸出視訊的高度為一半的圖元，與輸入相同。
label	string	這個圖層的英數位元標籤，可用於多任務處理不同的視訊和音訊層，或用於命名輸出檔案。
width	string	此圖層的輸出視訊寬度。此值可以是圖元) 的絕對 (，或以百分比) 表示的相對 (。例如，50% 表示輸出視訊的寬度與輸入的一半圖元相同。

PresetConfigurations

編碼器選擇性組態設定的物件。

名稱	類型	Description
complexity	Complexity	可讓您設定編碼器設定，以控制速度與品質之間的平衡。範例：將 [複雜度] 設定為 [速度]，以加快編碼速度，但壓縮效率較低。
interleaveOutput	InterleaveOutput	設定輸出的交錯模式，以控制音訊和視訊如何以容器格式儲存。範例：將 InterleavedOutput 設定為 NonInterleavedOutput，以在不同的 MP4 檔案中產生僅限音訊和僅限視訊的輸出。
keyFrameIntervalInSeconds	number	主要畫面格間隔，以秒為單位。範例：將 KeyFrameIntervalInSeconds 設定為 2，以減少某些播放機的播放緩沖。
maxBitrateBps	integer	最上層視訊層) 的每秒比特率上限 (閾值。範例：將 MaxBitrateBps 設定為 6000000，以避免針對高度複雜度的內容產生非常高的比特率輸出。
maxHeight	integer	輸出視訊圖層的最大高度。範例：將 MaxHeight 設定為 720，以產生最多 720P 的輸出層，即使輸入為 4K 也一樣。
maxLayers	integer	輸出視訊圖層的最大數目。範例：將 MaxLayers 設定為 4，以確保最多會產生 4 個輸出層，以控制編碼作業的整體成本。
minBitrateBps	integer	下層視訊層) 的每秒比特率下限 (閾值。範例：將MinBitrateBps設定為200000，讓底層涵蓋低網路頻寬的使用者。
minHeight	integer	輸出視訊圖層的最低高度。範例：將MinHeight設定為360，以避免輸出層級較小的解析度，例如180P。

Priority

設定 TransformOutputs 在 Transform 內的相對優先順序。這會設定服務用於處理 TransformOutputs 的優先順序。默認優先順序為 Normal。

名稱	類型	Description
High	string	用於應該優先於其他人的 TransformOutputs。
Low	string	用於可在 Normal 和 High 優先順序 TransformOutputs 之後產生的 TransformOutputs。
Normal	string	用於可以正常優先順序產生的 TransformOutputs。

Rectangle

描述在處理矩形視窗之前套用至輸入媒體的屬性。

名稱	類型	Description
height	string	矩形區域的高度，以像素為單位。這可以是絕對圖元值 (例如 100) ，或相對於視訊 (的大小，例如 50%) 。
left	string	左邊界的像素數目。這可以是絕對圖元值 (例如 100) ，或相對於視訊 (的大小，例如 50%) 。
top	string	上邊界的像素數目。這可以是絕對圖元值 (例如 100) ，或相對於視訊 (的大小，例如 50%) 。
width	string	矩形區域的寬度，以像素為單位。這可以是絕對圖元值 (例如 100) ，或相對於視訊 (的大小，例如 50%) 。

Rotation

如果有任何旋轉，則會在編碼之前套用至輸入視訊。預設值為 Auto

名稱	類型	Description
Auto	string	視需要自動偵測並輪替。
None	string	請勿旋轉視訊。如果輸出格式支援它，任何有關旋轉的元數據都會保持不變。
Rotate0	string	請勿旋轉視訊，但移除有關旋轉的任何元數據。
Rotate180	string	順時針旋轉 180 度。
Rotate270	string	順時針旋轉 270 度。
Rotate90	string	順時針旋轉 90 度。

StandardEncoderPreset

描述使用標準編碼器編碼輸入視訊時要使用的所有設定。

名稱	類型	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

名稱	類型	Description
AutoFit	string	將輸出 (與信箱或柱子方塊) 以接受輸出解析度，同時確保輸出中的使用中視訊區域與輸入的外觀比例相同。例如，如果輸入為 1920x1080，且編碼預設會要求 1280x1280，則輸出會位於 1280x1280，其中包含 1280x720 的內部矩形，其外觀比例為 16：9，而柱形方塊區域在左邊和右邊為 280 像素寬。
AutoSize	string	覆寫輸出解析度，並將它變更為符合輸入的顯示外觀比例，而不需填補。比方說，如果輸入是 1920x1080，但編碼預設要求 1280x1280，則預設值會遭到覆寫，而輸出將會是 1280x720 (保留 16:9 的輸入外觀比例)。
None	string	嚴格遵守輸出解析度，而不考慮輸入視訊的像素外觀比例或顯示外觀比例。

systemData

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string	資源建立的時間戳 (UTC) 。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string	上次修改的資源時間戳 (UTC)
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

Transform

轉換會封裝從輸入媒體產生所需輸出的規則或指示，例如轉碼或擷取見解。建立轉換之後，即可藉由建立作業來套用至輸入媒體。

名稱	類型	Description
id	string	資源的完整資源識別碼。 Ex - /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 的屬性，這是產生所需輸出時要套用的規則。

名稱	類型	Description
onError	OnErrorType	轉換可以定義多個輸出。此屬性會定義當一個輸出失敗時，服務應該執行的動作 - 繼續產生其他輸出，或停止其他輸出。整體作業狀態不會反映以『ContinueJob』指定的輸出失敗。預設值為『StopProcessingJob』。
preset	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	默認，描述將用來修改、轉碼或從來源檔案擷取見解的作業，以產生輸出。
relativePriority	Priority	設定 TransformOutputs 在 Transform 內的相對優先順序。這會設定服務用於處理 TransformOutputs 的優先順序。默認優先順序為 Normal。

TransportStreamFormat

描述產生 MPEG-2 傳輸數據流的屬性， (ISO/IEC 13818-1) 輸出視訊檔案 (s) 。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.TransportStreamFormat	衍生類型的鑒別子。
filenamePattern	string	用於建立輸出檔案的檔案命名模式。檔名支援下列宏： {Basename} - 將使用輸入視訊檔名稱的擴充宏。如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元，則會使用輸入視訊檔案的基底名稱。如果輸入視訊檔案的基底名稱長度超過 32 個字元，基底名稱會以總長度截斷為前 32 個字元。 {Extension} - 此格式的適當擴充功能。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊串流號碼， (從 1) 開始。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。任何未取代的宏都會從檔名折迭和移除。
outputFiles	OutputFile[]	要產生的輸出檔案清單。清單中的每個專案都是一組要一起多任務處理的音訊和視訊層標籤。

Video

描述編碼輸入視訊的基本屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.Video	衍生類型的鑒別子。
keyFrameInterval	string	兩個主要畫面格之間的距離。此值應為 [0.5， 20] 秒範圍內的非零，以 ISO 8601 格式指定。預設值為 PT2S (2 秒) 。請注意，如果設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。標籤可用來控制多任務處理行為。
stretchMode	StretchMode	重設大小模式 - 輸入視訊的大小如何調整，以符合所需的輸出解析度 () 。預設值為 AutoSize
syncMode	VideoSyncMode	視訊同步模式

VideoAnalyzerPreset

影片分析器預設會從音訊和視訊擷取深入解析 (豐富的元數據) ，並輸出 JSON 格式檔案。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.VideoAnalyzerPreset	衍生型別的辨別子。
audioLanguage	string	使用 'language tag-region' 的 BCP-47 格式輸入中音訊承載的語言 (例如：'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

描述視訊重疊的屬性。

名稱	類型	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

視訊同步模式

名稱	類型	Description
Auto	string	這是預設方法。根據多任務器功能，選擇 Cfr 和 Vfr。針對輸出格式 MP4，預設模式為 Cfr。
Cfr	string	輸入畫面會視需要重複和/或卸除，以達到要求的固定幀速率。當輸出幀速率明確設定為指定值時，建議使用
Passthrough	string	畫面格上的簡報時間戳會從輸入檔傳遞至輸出檔案寫入器。當輸入來源具有可變幀速率，並嘗試在輸出中產生多層以調整串流，且輸出中具有對齊 GOP 界限時，建議使用。注意：如果輸入中的兩個以上的畫面有重複的時間戳，則輸出也會有相同的行為
Vfr	string	類似於傳遞模式，但如果輸入具有重複時間戳的畫面，則只有一個畫面會傳遞至輸出，而其他畫面則會卸除。當輸出畫面數目預期等於輸入畫面數時，建議使用。例如，輸出是用來根據輸入計算品質計量，例如 PSNR