Jobs - Get

服務:

Media Services

API 版本:

2022-07-01

取得工作
取得作業。

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

URI 參數

名稱	位於	必要	類型	Description
accountName	path	True	string	媒體服務帳戶名稱。
jobName	path	True	string	作業名稱。
resourceGroupName	path	True	string	Azure 訂用帳戶內的資源組名。
subscriptionId	path	True	string	Microsoft Azure 訂用帳戶的唯一標識符。
transformName	path	True	string	轉換名稱。
api-version	query	True	string	要與用戶端要求搭配使用的 API 版本。

回應

名稱	類型	Description
200 OK	Job	確定
Other Status Codes	ErrorResponse	詳細的錯誤資訊。

範例

Get a Job by name

範例要求

HTTP

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

Java

/**
 * Samples for Jobs Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/jobs-get-by-name
     * .json
     */
    /**
     * Sample code: Get a Job by name.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getAJobByName(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.jobs().getWithResponse("contosoresources", "contosomedia", "exampleTransform", "job1",
            com.azure.core.util.Context.NONE);
    }
}

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

Python

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

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-media
# USAGE
    python jobsgetbyname.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.jobs.get(
        resource_group_name="contosoresources",
        account_name="contosomedia",
        transform_name="exampleTransform",
        job_name="job1",
    )
    print(response)


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

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

Go

package armmediaservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/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/jobs-get-by-name.json
func ExampleJobsClient_Get() {
	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.NewJobsClient().Get(ctx, "contosoresources", "contosomedia", "exampleTransform", "job1", 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.Job = armmediaservices.Job{
	// 	Name: to.Ptr("job1"),
	// 	Type: to.Ptr("Microsoft.Media/mediaservices/transforms/jobs"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1"),
	// 	Properties: &armmediaservices.JobProperties{
	// 		CorrelationData: map[string]*string{
	// 		},
	// 		Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-06-01T00:00:00.000Z"); return t}()),
	// 		Input: &armmediaservices.JobInputs{
	// 			ODataType: to.Ptr("#Microsoft.Media.JobInputs"),
	// 			Inputs: []armmediaservices.JobInputClassification{
	// 				&armmediaservices.JobInputAsset{
	// 					ODataType: to.Ptr("#Microsoft.Media.JobInputAsset"),
	// 					Files: []*string{
	// 					},
	// 					InputDefinitions: []armmediaservices.InputDefinitionClassification{
	// 					},
	// 					AssetName: to.Ptr("job1-InputAsset"),
	// 			}},
	// 		},
	// 		LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-06-01T00:00:00.000Z"); return t}()),
	// 		Outputs: []armmediaservices.JobOutputClassification{
	// 			&armmediaservices.JobOutputAsset{
	// 				ODataType: to.Ptr("#Microsoft.Media.JobOutputAsset"),
	// 				Label: to.Ptr("example-custom-label"),
	// 				Progress: to.Ptr[int32](0),
	// 				State: to.Ptr(armmediaservices.JobStateQueued),
	// 				AssetName: to.Ptr("job1-OutputAsset"),
	// 		}},
	// 		Priority: to.Ptr(armmediaservices.PriorityLow),
	// 		State: to.Ptr(armmediaservices.JobStateQueued),
	// 	},
	// 	SystemData: &armmediaservices.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-06-01T00:00:00.000Z"); return t}()),
	// 		CreatedBy: to.Ptr("contoso@microsoft.com"),
	// 		CreatedByType: to.Ptr(armmediaservices.CreatedByTypeUser),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-06-01T00:00:00.000Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("contoso@microsoft.com"),
	// 		LastModifiedByType: to.Ptr(armmediaservices.CreatedByTypeUser),
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to Gets a Job.
 *
 * @summary Gets a Job.
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/jobs-get-by-name.json
 */
async function getAJobByName() {
  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 = "exampleTransform";
  const jobName = "job1";
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.jobs.get(resourceGroupName, accountName, transformName, jobName);
  console.log(result);
}

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

dotnet

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

// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Encoding/stable/2022-07-01/examples/jobs-get-by-name.json
// this example is just showing the usage of "Jobs_Get" 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 MediaJobResource created on azure
// for more information of creating MediaJobResource, please refer to the document of MediaJobResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contosoresources";
string accountName = "contosomedia";
string transformName = "exampleTransform";
string jobName = "job1";
ResourceIdentifier mediaJobResourceId = MediaJobResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, transformName, jobName);
MediaJobResource mediaJob = client.GetMediaJobResource(mediaJobResourceId);

// invoke the operation
MediaJobResource result = await mediaJob.GetAsync();

// 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
MediaJobData 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

範例回覆

狀態碼:

200

{
  "name": "job1",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1",
  "type": "Microsoft.Media/mediaservices/transforms/jobs",
  "properties": {
    "created": "2021-06-01T00:00:00Z",
    "state": "Queued",
    "input": {
      "@odata.type": "#Microsoft.Media.JobInputs",
      "inputs": [
        {
          "@odata.type": "#Microsoft.Media.JobInputAsset",
          "files": [],
          "inputDefinitions": [],
          "assetName": "job1-InputAsset"
        }
      ]
    },
    "lastModified": "2021-06-01T00:00:00Z",
    "outputs": [
      {
        "@odata.type": "#Microsoft.Media.JobOutputAsset",
        "state": "Queued",
        "progress": 0,
        "label": "example-custom-label",
        "assetName": "job1-OutputAsset"
      }
    ],
    "priority": "Low",
    "correlationData": {}
  },
  "systemData": {
    "createdBy": "contoso@microsoft.com",
    "createdByType": "User",
    "createdAt": "2021-06-01T00:00:00Z",
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-06-01T00:00:00Z"
  }
}

定義

名稱	Description
AacAudio	描述進階音訊編解碼器 (AAC) 音訊編碼設定。
AacAudioProfile	使用 AAC 編碼音訊時要使用的編碼設定檔。
AbsoluteClipTime	將剪輯時間指定為媒體檔案中的絕對時間位置。 絕對時間可以根據媒體檔案是否從零的時間戳開始，指向不同的位置。
AnalysisResolution	指定分析視訊的最大解析度。 默認行為是 “SourceResolution”，這會在分析時保留輸入視訊的原始解析度。 使用 「StandardDefinition」 會將輸入影片的大小調整為標準定義，同時保留適當的外觀比例。 只有在視訊解析度較高時，才會重設大小。 例如，在處理之前，1920x1080 輸入會調整為 640x360。 切換至 「StandardDefinition」 可減少處理高解析度視訊所需的時間。 它也可能會降低使用此元件的成本， (請參閱 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics 以取得詳細數據) 。 不過，在重設大小的視訊中，最後太小的臉部可能無法偵測到。
AttributeFilter	要套用至 TrackAttribute 的 AttributeFilter 類型，以便選取曲目。
Audio	定義所有音訊編解碼器的通用屬性。
AudioAnalysisMode	決定要執行的音訊分析作業集。 如果未指定，則會選擇標準 AudioAnalysisMode。
AudioAnalyzerPreset	音訊分析器預設會套用一組預先定義的 AI 分析作業，包括語音轉譯。 此預設目前支援處理具有單一音訊播放軌的內容。
AudioOverlay	描述音訊重疊的屬性。
AudioTrackDescriptor	選取音訊播放軌的 TrackSelection。
BlurType	模糊類型
BuiltInStandardEncoderPreset	描述使用標準編碼器編碼輸入視訊的內建預設值。
ChannelMapping	單一通道音訊播放軌的選擇性指定。 可用來將曲目合併成立體或多聲道音訊播放軌。
Complexity	可讓您設定編碼器設定，以控制速度與品質之間的平衡。 範例：將複雜度設定為速度，以加快編碼速度，但壓縮效率較低。
CopyAudio	編解碼器旗標，告知編碼器複製輸入音訊位流。
CopyVideo	編解碼器旗標，告知編碼器複製輸入視訊位流，而不需重新編碼。
createdByType	建立資源的身分識別類型。
DDAudio	描述 Dolby Digital Audio Codec (AC3) 音訊編碼設定。 Dolby Digital Audio 支援的目前實作包括：1 ( (單聲道號碼) 、2 個 (立體) 、6 (5.1 側) ;音訊取樣頻率速率：32K/44.1K/48K Hz;AC3 規格的音訊比特率值支援：32000、40000、48000、56000、64000、80000、80000、 96000、112000、128000 、160000、192000、224000、256000、320000、384000、448000、512000、576000、640000 bps。
Deinterlace	描述取消交錯設定。
DeinterlaceMode	取消交錯模式。 默認為 AutoPixelAdaptive。
DeinterlaceParity	取消交錯的欄位同位，預設為 Auto。
EncoderNamedPreset	用於編碼視訊的內建預設。
EntropyMode	要用於此層的 Entropy 模式。 如果未指定，編碼器會選擇適合配置檔和層級的模式。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
FaceDetectorPreset	描述分析影片時要使用的所有設定，以偵測 (，並選擇性地) 所有臉部呈現。
FaceRedactorMode	此模式可讓您選擇下列設定：1) 分析 - 僅供偵測。此模式會產生元數據 JSON 檔案，以標示整個影片中臉部的外觀。可能的話，同一個人的外觀會指派相同的標識碼。2 個) 合併 - (模糊) 偵測到的臉部。 3) 修訂 - 這可啟用 2 階段程式，允許選擇性修訂偵測到的臉部子集。它會從先前的分析階段擷取元數據檔案，以及來源影片，以及需要修訂的用戶選取標識子集。
Fade	描述套用至輸入媒體的淡出效果屬性。
Filters	描述在編碼之前套用至輸入媒體的所有篩選作業，例如取消交錯、旋轉等。
FromAllInputFile	InputDefinition，可查看提供給選取 IncludedTracks 屬性所指定之曲目的所有檔案。 通常與 AudioTrackByAttribute 和 VideoTrackByAttribute 搭配使用，以允許跨一組輸入檔案選取單一播放軌。
FromEachInputFile	InputDefinition，查看提供給選取 IncludedTracks 屬性所指定之曲目的每個輸入檔。 通常與 AudioTrackByAttribute 和 VideoTrackByAttribute 搭配使用，以從指定的每個檔案中選取曲目。
H264Complexity	告知編碼器如何選擇其編碼設定。 默認值為 [平衡]。
H264Layer	描述使用 H.264 視訊編解碼器將輸入視訊編碼成所需輸出比特率層時所使用的設定。
H264RateControlMode	視訊速率控制模式
H264Video	描述使用 H.264 編解碼器編碼視訊的所有屬性。
H264VideoProfile	我們目前支持比較基準、主要、高、高422、High444。 預設值為 Auto。
H265Complexity	告知編碼器如何選擇其編碼設定。 品質會提供較高的壓縮率，但成本較高且計算時間較長。 速度會產生相對較大的檔案，但較快速且更經濟。 默認值為 [平衡]。
H265Layer	描述使用 H.265 視訊編解碼器，將輸入視訊編碼成所需的輸出比特率層時所要使用的設定。
H265Video	描述使用 H.265 編解碼器編碼視訊的所有屬性。
H265VideoProfile	我們目前支援Main。 預設值為 Auto。
Image	描述從輸入影片產生縮圖的基本屬性
ImageFormat	描述輸出圖像檔的屬性。
InputFile	單一檔案的 InputDefinition。 TrackSelections 的範圍設定為指定的檔案。
InsightsType	定義您想要服務產生的深入解析類型。 允許的值為 'AudioInsightsOnly'、'VideoInsightsOnly' 和 'AllInsights'。 預設值為 AllInsights。 如果您將此設定為 AllInsights，且輸入只是音訊，則只會產生音訊深入解析。 同樣地，如果輸入只是視訊，則只會產生影片深入解析。 如果您預期某些輸入只是視訊，建議您不要使用 AudioInsightsOnly;或如果您預期某些輸入只是音訊，請使用 VideoInsightsOnly。 這類情況下的作業會發生錯誤。
InterleaveOutput	設定輸出的交錯模式，以控制音訊和視訊如何以容器格式儲存。 範例：將 InterleavedOutput 設定為 NonInterleavedOutput，以在不同的 MP4 檔案中產生僅限音訊和僅限視訊輸出。
Job	作業資源類型。 您可以藉由輪詢 Job 或使用 EventGrid 訂閱事件來取得進度和狀態。
JobError	JobOutput 錯誤的詳細數據。
JobErrorCategory	協助分類錯誤。
JobErrorCode	描述錯誤的錯誤碼。
JobErrorDetail	JobOutput 錯誤的詳細數據。
JobInputAsset	表示輸入作業的資產。
JobInputClip	表示作業的輸入檔。
JobInputHttp	表示 HTTPS 作業輸入。
JobInputs	描述作業的輸入清單。
JobInputSequence	Sequence 包含一份已排序的 Clip 清單，其中每個剪輯都是 JobInput。 Sequence 會被視為單一輸入。
JobOutputAsset	表示做為 JobOutput 的資產。
JobRetry	表示可能重試作業。 如果重試失敗，請透過 Azure 入口網站連絡 Azure 支援。
JobState	描述 JobOutput 的狀態。
JpgFormat	描述產生 JPEG 縮圖的設定。
JpgImage	描述從輸入影片產生一系列 JPEG 影像的屬性。
JpgLayer	描述從輸入影片產生 JPEG 影像的設定。
Mp4Format	描述輸出 ISO MP4 檔案的屬性。
MultiBitrateFormat	描述產生 GOP 對齊多比特率檔案集合的屬性。 默認行為是為每個視訊層產生一個輸出檔案，這些輸出檔會與所有音訊一起多任務處理。 您可以藉由指定 outputFiles 集合來控制產生的確切輸出檔案。
OutputFile	表示產生的輸出檔。
PngFormat	描述產生 PNG 縮圖的設定。
PngImage	描述從輸入影片產生一系列 PNG 影像的屬性。
PngLayer	描述從輸入影片產生 PNG 影像的設定。
PresetConfigurations	編碼器選擇性組態設定的物件。
Priority	設定 TransformOutputs 在 Transform 中的相對優先順序。 這會設定服務用於處理 TransformOutputs 的優先順序。 默認優先順序為 Normal。
Rectangle	描述在處理矩形視窗之前套用至輸入媒體的屬性。
Rotation	如果有任何旋轉，則會在編碼之前套用至輸入視訊。 預設值為 Auto
SelectAudioTrackByAttribute	藉由指定屬性和屬性篩選，從輸入中選取音訊播放軌。
SelectAudioTrackById	藉由指定曲目標識符，從輸入中選取音訊播放軌。
SelectVideoTrackByAttribute	藉由指定屬性和屬性篩選，從輸入中選取視訊播放軌。
SelectVideoTrackById	藉由指定播放軌標識碼，從輸入中選取視訊播放軌。
StandardEncoderPreset	描述使用標準編碼器編碼輸入視訊時要使用的所有設定。
StretchMode	重設大小模式 - 輸入視訊的大小如何調整，以符合所需的輸出解析度 () 。 預設值為 AutoSize
systemData	與建立和上次修改資源相關的元數據。
TrackAttribute	用來篩選追蹤依據的 TrackAttribute。
TransportStreamFormat	描述產生 MPEG-2 傳輸數據流的屬性， (ISO/IEC 13818-1) 輸出視訊檔案 (s) 。
UtcClipTime	將剪輯時間指定為媒體檔案中的 Utc 時間位置。 Utc 時間可以根據媒體檔案是否從零的時間戳開始，指向不同的位置。
Video	描述編碼輸入影片的基本屬性。
VideoAnalyzerPreset	影片分析器預設，可從音訊和視訊擷取 (豐富的元數據) ，並輸出 JSON 格式檔案。
VideoOverlay	描述視訊重疊的屬性。
VideoSyncMode	視訊同步模式
VideoTrackDescriptor	選取視訊播放軌的 TrackSelection。

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 設定檔。

AbsoluteClipTime

將剪輯時間指定為媒體檔案中的絕對時間位置。 絕對時間可以根據媒體檔案是否從零的時間戳開始，指向不同的位置。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.AbsoluteClipTime	衍生類型的鑒別子。
time	string	輸入媒體時間軸上的時間位置。 它通常會指定為ISO8601期間。 例如 PT30S 30 秒。

AnalysisResolution

指定分析視訊的最大解析度。 默認行為是 “SourceResolution”，這會在分析時保留輸入視訊的原始解析度。 使用 「StandardDefinition」 會將輸入影片的大小調整為標準定義，同時保留適當的外觀比例。 只有在視訊解析度較高時，才會重設大小。 例如，在處理之前，1920x1080 輸入會調整為 640x360。 切換至 「StandardDefinition」 可減少處理高解析度視訊所需的時間。 它也可能會降低使用此元件的成本， (請參閱 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics 以取得詳細數據) 。 不過，在重設大小的視訊中，最後太小的臉部可能無法偵測到。

名稱	類型	Description
SourceResolution	string
StandardDefinition	string

AttributeFilter

要套用至 TrackAttribute 的 AttributeFilter 類型，以便選取曲目。

名稱	類型	Description
All	string	將會包含所有曲目。
Bottom	string	當屬性以遞增順序排序時，將會包含第一個追蹤。 通常用來選取最小比特率。
Top	string	當屬性以遞減順序排序時，將會包含第一個追蹤。 通常用來選取最大的比特率。
ValueEquals	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 秒。 如果未指定重疊，則從輸入視訊的開頭開始。

AudioTrackDescriptor

選取音訊播放軌的 TrackSelection。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.AudioTrackDescriptor	衍生類型的鑒別子。
channelMapping	ChannelMapping	單一通道音訊播放軌的選擇性指定。 可用來將曲目結合成立體聲或多聲道音訊播放軌。

BlurType

模糊類型

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

BuiltInStandardEncoderPreset

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

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

ChannelMapping

單一通道音訊播放軌的選擇性指定。 可用來將曲目合併成立體或多聲道音訊播放軌。

名稱	類型	Description
BackLeft	string	回溯通道。 有時稱為左周框通道。
BackRight	string	右上通道。 有時稱為右周範圍通道。
Center	string	中心通道。
FrontLeft	string	左方通道。
FrontRight	string	右方通道。
LowFrequencyEffects	string	低頻率效果通道。 有時稱為 subwoofer。
StereoLeft	string	左立體聲道。 有時稱為「向下混合左」。
StereoRight	string	右方立體聲道。 有時稱為「向下混合右」。

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.1 側) ;音訊取樣頻率速率：32K/44.1K/48K Hz;AC3 規格的音訊比特率值支援：32000、40000、48000、56000、64000、80000、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

取消交錯的欄位同位，預設為 Auto。

名稱	類型	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	錯誤物件。

FaceDetectorPreset

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

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

FaceRedactorMode

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

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

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

FromAllInputFile

InputDefinition，可查看提供給選取 IncludedTracks 屬性所指定之曲目的所有檔案。 通常與 AudioTrackByAttribute 和 VideoTrackByAttribute 搭配使用，以允許跨一組輸入檔案選取單一播放軌。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.FromAllInputFile	衍生類型的鑒別子。
includedTracks	TrackDescriptor[]: AudioTrackDescriptor[] SelectAudioTrackByAttribute[] SelectAudioTrackById[] SelectVideoTrackByAttribute[] SelectVideoTrackById[] VideoTrackDescriptor[]	TrackDescriptors 的清單，定義輸入中的曲目元數據和選取範圍。

FromEachInputFile

InputDefinition，查看提供給選取 IncludedTracks 屬性所指定之曲目的每個輸入檔。 通常與 AudioTrackByAttribute 和 VideoTrackByAttribute 搭配使用，以從指定的每個檔案中選取曲目。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.FromEachInputFile	衍生類型的鑒別子。
includedTracks	TrackDescriptor[]: AudioTrackDescriptor[] SelectAudioTrackByAttribute[] SelectAudioTrackById[] SelectVideoTrackByAttribute[] SelectVideoTrackById[] VideoTrackDescriptor[]	TrackDescriptors 的清單，定義輸入中的曲目元數據和選取範圍。

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 配置檔的數位。 如果未指定，預設值為 Auto，可讓編碼器選擇適合此層的層級。
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	兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5， 20] 秒中應為非零。 預設值為 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	兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5， 20] 秒中應為非零。 預設值為 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	兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5， 20] 秒中應為非零。 預設值為 PT2S (2 秒) 。 請注意，如果已設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。
range	string	相對於轉換輸入視訊中預設開始時間的位置，要停止產生縮圖。 此值可以是 ISO 8601 格式 (例如，PT5M30S從開始時間) 停止 5 分鐘和 30 秒，或畫面計數 (例如，300 表示在開始時間從畫面格的第 300 個畫面停止。如果此值為 1，表示只在開始時間產生一個縮圖) ，或數據流持續時間的相對值 (例如，50% 會從開始時間停止一半的數據流持續時間) 。 預設值為 100%，即停止在串流結尾。
start	string	輸入視訊中要開始產生縮圖的位置。 此值可以是 ISO 8601 格式 (例如，PT05S 即從第 5 秒開始)，或畫面計數 (例如，10 即從第 10 格畫面開始)，或串流持續時間的相對值 (例如，10% 即從 10% 的串流持續時間開始)。 同時支援巨集 {Best}，其會指示編碼器從視訊前幾秒選取最佳縮圖，而且無論間隔和範圍的其他設定為何，都只產生一張縮圖。 預設值為巨集 {Best}。
step	string	產生縮圖的間隔。 此值可以是 ISO 8601 格式 (例如，每 5 秒) 一個影像一個 PT05S，或每 30 個畫面 30 個畫面) 一個影像的畫面 (計數，或是每 30 個畫面) 的相對 (值，例如，每 10% 的一個影像一個影像) 。 注意：步驟值會影響第一個產生的縮圖，這可能不是在轉換預設開始時間指定的縮圖。 這是因為編碼器會嘗試在開始時間和步驟位置之間選取最佳縮圖作為第一個輸出。 由於預設值為 10%，表示如果數據流有很長的持續時間，則第一個產生的縮圖可能遠於開始時間指定的縮圖。 如果第一個縮圖預期接近開始時間，請嘗試選取 [步驟] 的合理值，或在開始時間只需要一個縮圖時，將 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} - 視訊解析度。 任何未取代的宏都會從檔名折迭和移除。

InputFile

單一檔案的 InputDefinition。 TrackSelections 的範圍設定為指定的檔案。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.InputFile	衍生類型的鑒別子。
filename	string	這個輸入定義所套用的檔名。
includedTracks	TrackDescriptor[]: AudioTrackDescriptor[] SelectAudioTrackByAttribute[] SelectAudioTrackById[] SelectVideoTrackByAttribute[] SelectVideoTrackById[] VideoTrackDescriptor[]	TrackDescriptors 的清單，定義輸入中的曲目元數據和選取範圍。

InsightsType

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

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

InterleaveOutput

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

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

Job

作業資源類型。 您可以藉由輪詢 Job 或使用 EventGrid 訂閱事件來取得進度和狀態。

名稱	類型	Description
id	string	資源的完整資源識別碼。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	資源的名稱
properties.correlationData	object	客戶提供的索引鍵、值組，將會在Job和 JobOutput 狀態事件中傳回。
properties.created	string	客戶建立作業的 UTC 日期和時間，格式為 『YYYY-MM-DDThh：mm：ssZ』。
properties.description	string	選擇性的客戶提供作業描述。
properties.endTime	string	此作業完成處理的 UTC 日期和時間。
properties.input	JobInput: JobInputAsset JobInputClip JobInputHttp JobInputSequence JobInputs	作業輸入。
properties.lastModified	string	客戶上次更新作業的 UTC 日期和時間，格式為 'YYYY-MM-DDThh：mm：ssZ'。
properties.outputs	JobOutput[]: JobOutputAsset[]	作業的輸出。
properties.priority	Priority	處理作業時應依循的優先順序。 先處理優先順序較高的作業，再處理優先順序較低的工作。 如果沒有設定，預設值為一般。
properties.startTime	string	此作業開始處理的 UTC 日期和時間。
properties.state	JobState	作業的目前狀態。
systemData	systemData	與此資源相關的系統元數據。
type	string	資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

JobError

JobOutput 錯誤的詳細數據。

名稱	類型	Description
category	JobErrorCategory	協助分類錯誤。
code	JobErrorCode	描述錯誤的錯誤碼。
details	JobErrorDetail[]	導致此錯誤之特定錯誤的詳細數據陣列。
message	string	錯誤的人類可讀語言相依表示法。
retry	JobRetry	表示可能重試作業。 如果重試失敗，請透過 Azure 入口網站連絡 Azure 支援。

JobErrorCategory

協助分類錯誤。

名稱	類型	Description
Account	string	此錯誤與帳戶信息有關。
Configuration	string	錯誤與組態相關。
Content	string	此錯誤與輸入檔中的數據有關。
Download	string	錯誤與下載相關。
Service	string	錯誤與服務相關。
Upload	string	錯誤與上傳相關。

JobErrorCode

描述錯誤的錯誤碼。

名稱	類型	Description
ConfigurationUnsupported	string	輸入檔案和套用的組態設定組合發生問題、修正組態設定，然後使用相同的輸入重試，或變更輸入以符合組態。
ContentMalformed	string	例如，輸入內容 (發生問題：零位元節檔案，或) 損毀/無法譯碼的檔案，請檢查輸入檔。
ContentUnsupported	string	輸入格式 (無效的媒體檔案或不支援的檔案/編解碼器) 發生問題，請檢查輸入檔的有效性。
DownloadNotAccessible	string	嘗試下載輸入檔案時，無法存取檔案，請檢查來源的可用性。
DownloadTransientError	string	嘗試下載輸入檔案時，傳輸 (記憶體服務期間發生問題、網路錯誤) ，請參閱詳細數據並檢查您的來源。
IdentityUnsupported	string	驗證帳戶身分識別時發生錯誤。 檢查並修正身分識別組態，然後重試。 如果失敗，請連絡支持人員。
ServiceError	string	嚴重服務錯誤，請連絡支持人員。
ServiceTransientError	string	暫時性錯誤，請重試，如果重試失敗，請連絡支持人員。
UploadNotAccessible	string	嘗試上傳輸出檔案時，無法連線到目的地，請檢查目的地的可用性。
UploadTransientError	string	嘗試上傳輸出檔案時，傳輸 (記憶體服務期間發生問題、網路錯誤) ，請參閱詳細數據並檢查目的地。

JobErrorDetail

JobOutput 錯誤的詳細數據。

名稱	類型	Description
code	string	描述錯誤詳細數據的程序代碼。
message	string	人類看得懂的錯誤表示法。

JobInputAsset

表示輸入作業的資產。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.JobInputAsset	衍生類型的鑒別子。
assetName	string	輸入資產的名稱。
end	ClipTime: AbsoluteClipTime UtcClipTime	定義輸入媒體的時間軸上結束處理的時間點。 預設為輸入媒體的結尾。
files	string[]	檔案清單。 JobInputHttp 的必要專案。 每個字元最多 4000 個字元。 服務回應中不會傳回查詢字串，以防止敏感數據暴露。
inputDefinitions	InputDefinition[]: FromAllInputFile[] FromEachInputFile[] InputFile[]	定義 InputDefinitions 的清單。 針對每個 InputDefinition，它會定義追蹤選取專案和相關元數據的清單。
label	string	指派給 JobInputClip 的標籤，用於滿足轉換中使用的參考。 例如，您可以撰寫轉換，以擷取具有標籤 'xyz' 的影像檔案，並在編碼之前將其套用為輸入視訊的重疊。 提交作業時，只有其中一個 JobInputs 應該是圖像檔案，而且應該有標籤 'xyz'。
start	ClipTime: AbsoluteClipTime UtcClipTime	定義輸入媒體的時間軸上開始處理的時間點。 默認為輸入媒體的開頭。

JobInputClip

表示作業的輸入檔。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.JobInputClip	衍生類型的鑒別子。
end	ClipTime: AbsoluteClipTime UtcClipTime	定義輸入媒體的時間軸上結束處理的時間點。 預設為輸入媒體的結尾。
files	string[]	檔案清單。 JobInputHttp 的必要專案。 每個字元最多 4000 個字元。 服務回應中不會傳回查詢字串，以防止敏感數據暴露。
inputDefinitions	InputDefinition[]: FromAllInputFile[] FromEachInputFile[] InputFile[]	定義 InputDefinitions 的清單。 針對每個 InputDefinition，它會定義追蹤選取專案和相關元數據的清單。
label	string	指派給 JobInputClip 的標籤，用於滿足轉換中使用的參考。 例如，您可以撰寫轉換，以擷取具有標籤 'xyz' 的影像檔案，並在編碼之前將其套用為輸入視訊的重疊。 提交作業時，只有其中一個 JobInputs 應該是圖像檔案，而且應該有標籤 'xyz'。
start	ClipTime: AbsoluteClipTime UtcClipTime	定義輸入媒體的時間軸上開始處理的時間點。 默認為輸入媒體的開頭。

JobInputHttp

表示 HTTPS 作業輸入。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.JobInputHttp	衍生類型的鑒別子。
baseUri	string	HTTPS 作業輸入的基底 URI。 它會與提供的檔名串連。 如果未指定任何基底 URI，則會假設提供的檔案清單為完整 URI。 長度上限為 4000 個字元。 服務回應中不會傳回查詢字串，以防止敏感數據暴露。
end	ClipTime: AbsoluteClipTime UtcClipTime	定義輸入媒體的時間軸上結束處理的時間點。 預設為輸入媒體的結尾。
files	string[]	檔案清單。 JobInputHttp 的必要專案。 每個字元最多 4000 個字元。 服務回應中不會傳回查詢字串，以防止敏感數據暴露。
inputDefinitions	InputDefinition[]: FromAllInputFile[] FromEachInputFile[] InputFile[]	定義 InputDefinitions 的清單。 針對每個 InputDefinition，它會定義追蹤選取專案和相關元數據的清單。
label	string	指派給 JobInputClip 的標籤，用於滿足轉換中使用的參考。 例如，您可以撰寫轉換，以擷取具有標籤 'xyz' 的影像檔案，並在編碼之前將其套用為輸入視訊的重疊。 提交作業時，只有其中一個 JobInputs 應該是圖像檔案，而且應該有標籤 'xyz'。
start	ClipTime: AbsoluteClipTime UtcClipTime	定義輸入媒體的時間軸上開始處理的時間點。 默認為輸入媒體的開頭。

JobInputs

描述作業的輸入清單。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.JobInputs	衍生類型的鑒別子。
inputs	JobInput[]: JobInputAsset[] JobInputClip[] JobInputHttp[] JobInputSequence[] JobInputs[]	工作的輸入清單。

JobInputSequence

Sequence 包含一份已排序的 Clip 清單，其中每個剪輯都是 JobInput。 Sequence 會被視為單一輸入。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.JobInputSequence	衍生類型的鑒別子。
inputs	JobInputClip[]: JobInputAsset[] JobInputHttp[]	構成時程表的 JobInputs。

JobOutputAsset

表示做為 JobOutput 的資產。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.JobOutputAsset	衍生類型的鑒別子。
assetName	string	輸出資產的名稱。
endTime	string	這個作業輸出完成處理的UTC日期和時間。
error	JobError	如果 JobOutput 處於 Error 狀態，則會包含錯誤的詳細數據。
label	string	指派給 JobOutput 的標籤，以協助唯一識別它。 當您的 Transform 有一個以上的 TransformOutput 時，您的 Job 會有一個以上的 JobOutput 時，這會很有用。 在這種情況下，當您提交作業時，將會以與 Transform 中的 TransformOutputs 相同的順序新增兩個或多個 JobOutputs。 接著，當您透過事件或 GET 要求擷取作業時，您可以使用標籤輕鬆地識別 JobOutput。 如果未提供標籤，則會使用預設值 『{presetName}_{outputIndex}』，其中預設名稱是對應 TransformOutput 中預設的名稱，而輸出索引是 Job 內此 JobOutput 的相對索引。 請注意，此索引與其 TransformOutput 內對應的 TransformOutput 的相對索引相同。
presetOverride	Preset: AudioAnalyzerPreset BuiltInStandardEncoderPreset FaceDetectorPreset StandardEncoderPreset VideoAnalyzerPreset	默認，用來覆寫對應轉換輸出中的預設。
progress	integer	如果 JobOutput 處於處理狀態，這包含作業完成百分比。 此值是估計值，並非用來預測作業完成時間。 若要判斷 JobOutput 是否完成，請使用 State 屬性。
startTime	string	這個作業輸出開始處理的UTC日期和時間。
state	JobState	描述 JobOutput 的狀態。

JobRetry

表示可能重試作業。 如果重試失敗，請透過 Azure 入口網站連絡 Azure 支援。

名稱	類型	Description
DoNotRetry	string	問題必須經過調查，然後在基礎問題修正後重新提交作業或重試。
MayRetry	string	問題可能會在等候一段時間后解決，並重新提交相同的作業。

JobState

描述 JobOutput 的狀態。

名稱	類型	Description
Canceled	string	已取消作業。 這是作業的最終狀態。
Canceling	string	正在取消作業。 這是作業的暫時性狀態。
Error	string	作業發生錯誤。 這是作業的最終狀態。
Finished	string	作業已完成。 這是作業的最終狀態。
Processing	string	作業正在處理。 這是作業的暫時性狀態。
Queued	string	作業處於佇列狀態，等候資源可供使用。 這是個暫時性狀態。
Scheduled	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	兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5， 20] 秒中應為非零。 預設值為 PT2S (2 秒) 。 請注意，如果已設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。
layers	JpgLayer[]	要由編碼器產生的輸出 JPEG 影像層集合。
range	string	相對於轉換輸入視訊中預設開始時間的位置，要停止產生縮圖。 此值可以是 ISO 8601 格式 (例如，PT5M30S從開始時間) 停止 5 分鐘和 30 秒，或畫面計數 (例如，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%，表示如果數據流有很長的持續時間，則第一個產生的縮圖可能遠於開始時間指定的縮圖。 如果第一個縮圖預期接近開始時間，請嘗試選取 [步驟] 的合理值，或在開始時間只需要一個縮圖時，將 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[]	要產生的輸出檔案清單。 清單中的每個專案都是一組要一起多任務處理的音訊和視訊圖層標籤。

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	兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5， 20] 秒中應為非零。 預設值為 PT2S (2 秒) 。 請注意，如果已設定 VideoSyncMode.Passthrough，則會忽略此設定，其中 KeyFrameInterval 值會遵循輸入來源設定。
label	string	編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。
layers	PngLayer[]	要由編碼器產生的輸出 PNG 影像層集合。
range	string	相對於轉換輸入視訊中預設開始時間的位置，要停止產生縮圖。 此值可以是 ISO 8601 格式 (例如，PT5M30S從開始時間) 停止 5 分鐘和 30 秒，或畫面計數 (例如，300 表示在開始時間從畫面格的第 300 個畫面停止。如果此值為 1，表示只在開始時間產生一個縮圖) ，或數據流持續時間的相對值 (例如，50% 會從開始時間停止一半的數據流持續時間) 。 預設值為 100%，即停止在串流結尾。
start	string	輸入視訊中要開始產生縮圖的位置。 此值可以是 ISO 8601 格式 (例如，PT05S 即從第 5 秒開始)，或畫面計數 (例如，10 即從第 10 格畫面開始)，或串流持續時間的相對值 (例如，10% 即從 10% 的串流持續時間開始)。 同時支援巨集 {Best}，其會指示編碼器從視訊前幾秒選取最佳縮圖，而且無論間隔和範圍的其他設定為何，都只產生一張縮圖。 預設值為巨集 {Best}。
step	string	產生縮圖的間隔。 此值可以是 ISO 8601 格式 (例如，每 5 秒) 一個影像一個 PT05S，或每 30 個畫面 30 個畫面) 一個影像的畫面 (計數，或是每 30 個畫面) 的相對 (值，例如，每 10% 的一個影像一個影像) 。 注意：步驟值會影響第一個產生的縮圖，這可能不是在轉換預設開始時間指定的縮圖。 這是因為編碼器會嘗試在開始時間和步驟位置之間選取最佳縮圖作為第一個輸出。 由於預設值為 10%，表示如果數據流有很長的持續時間，則第一個產生的縮圖可能遠於開始時間指定的縮圖。 如果第一個縮圖預期接近開始時間，請嘗試選取 [步驟] 的合理值，或在開始時間只需要一個縮圖時，將 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	用於應該優先於其他人的 TransformOutput。
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 度。

SelectAudioTrackByAttribute

藉由指定屬性和屬性篩選，從輸入中選取音訊播放軌。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.SelectAudioTrackByAttribute	衍生類型的鑒別子。
attribute	TrackAttribute	用來篩選追蹤依據的 TrackAttribute。
channelMapping	ChannelMapping	單一通道音訊播放軌的選擇性指定。 可用來將曲目結合成立體聲或多聲道音訊播放軌。
filter	AttributeFilter	要套用至 TrackAttribute 的 AttributeFilter 類型，以便選取曲目。
filterValue	string	篩選追蹤依據的值。 只有在針對 Filter 屬性指定 AttributeFilter.ValueEquals 時才使用。

SelectAudioTrackById

藉由指定曲目標識符，從輸入中選取音訊播放軌。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.SelectAudioTrackById	衍生類型的鑒別子。
channelMapping	ChannelMapping	單一通道音訊播放軌的選擇性指定。 可用來將曲目結合成立體聲或多聲道音訊播放軌。
trackId	integer	追蹤要選取的標識碼

SelectVideoTrackByAttribute

藉由指定屬性和屬性篩選，從輸入中選取視訊播放軌。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.SelectVideoTrackByAttribute	衍生類型的鑒別子。
attribute	TrackAttribute	用來篩選追蹤依據的 TrackAttribute。
filter	AttributeFilter	要套用至 TrackAttribute 的 AttributeFilter 類型，以便選取曲目。
filterValue	string	篩選追蹤依據的值。 只有在針對 Filter 屬性指定 AttributeFilter.ValueEquals 時才使用。 針對 TrackAttribute.Bitrate，這應該是每秒位的整數值， (例如：『1500000』) 。 視訊播放軌不支援 TrackAttribute.Language。

SelectVideoTrackById

藉由指定播放軌標識碼，從輸入中選取視訊播放軌。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.SelectVideoTrackById	衍生類型的鑒別子。
trackId	integer	追蹤要選取的標識碼

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	上次修改資源的身分識別類型。

TrackAttribute

用來篩選追蹤依據的 TrackAttribute。

名稱	類型	Description
Bitrate	string	追蹤的比特率。
Language	string	追蹤的語言。

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[]	要產生的輸出檔案清單。 清單中的每個專案都是一組要一起多任務處理的音訊和視訊圖層標籤。

UtcClipTime

將剪輯時間指定為媒體檔案中的 Utc 時間位置。 Utc 時間可以根據媒體檔案是否從零的時間戳開始，指向不同的位置。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.UtcClipTime	衍生類型的鑒別子。
time	string	以 Utc 時間為基礎的輸入媒體時間軸上的時間位置。

Video

描述編碼輸入影片的基本屬性。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.Video	衍生型別的辨別子。
keyFrameInterval	string	兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5， 20] 秒中應為非零。 預設值為 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 之類的品質計量

VideoTrackDescriptor

選取視訊播放軌的 TrackSelection。

名稱	類型	Description
@odata.type	string: #Microsoft.Media.VideoTrackDescriptor	衍生類型的鑒別子。