Jobs - Create
建立作業
建立作業。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}/jobs/{jobName}?api-version=2022-07-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
account
|
path | True |
string |
媒體服務帳戶名稱。 |
job
|
path | True |
string |
作業名稱。 |
resource
|
path | True |
string |
Azure 訂用帳戶內的資源組名。 |
subscription
|
path | True |
string |
Microsoft Azure 訂用帳戶的唯一標識符。 |
transform
|
path | True |
string |
轉換名稱。 |
api-version
|
query | True |
string |
要與用戶端要求搭配使用的 API 版本。 |
要求本文
名稱 | 必要 | 類型 | Description |
---|---|---|---|
properties.input | True | JobInput: |
作業輸入。 |
properties.outputs | True | JobOutput[]: |
作業的輸出。 |
properties.correlationData |
object |
客戶提供的索引鍵、值組,將會在Job和 JobOutput 狀態事件中傳回。 |
|
properties.description |
string |
選擇性的客戶提供作業描述。 |
|
properties.priority |
處理作業時應依循的優先順序。 先處理優先順序較高的作業,再處理優先順序較低的工作。 如果沒有設定,預設值為一般。 |
回應
名稱 | 類型 | Description |
---|---|---|
201 Created |
建立時間 |
|
Other Status Codes |
詳細的錯誤資訊。 |
範例
Create a Job
範例要求
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/exampleTransform/jobs/job1?api-version=2022-07-01
{
"properties": {
"input": {
"@odata.type": "#Microsoft.Media.JobInputAsset",
"assetName": "job1-InputAsset"
},
"outputs": [
{
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"assetName": "job1-OutputAsset"
}
],
"correlationData": {
"key1": "value1",
"Key 2": "Value 2"
}
}
}
範例回覆
{
"name": "job1",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1",
"type": "Microsoft.Media/mediaservices/transforms/jobs",
"properties": {
"created": "2022-10-17T23:14:33.6140749Z",
"state": "Queued",
"input": {
"@odata.type": "#Microsoft.Media.JobInputAsset",
"files": [],
"inputDefinitions": [],
"assetName": "job1-InputAsset"
},
"lastModified": "2022-10-17T23:14:33.6140749Z",
"outputs": [
{
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"state": "Queued",
"progress": 0,
"label": "BuiltInStandardEncoderPreset_0",
"assetName": "job1-OutputAsset"
}
],
"priority": "Normal",
"correlationData": {
"key1": "value1",
"Key 2": "Value 2"
}
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:33.6140749Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:33.6140749Z"
}
}
定義
名稱 | Description |
---|---|
Aac |
描述進階音訊編解碼器 (AAC) 音訊編碼設定。 |
Aac |
使用 AAC 編碼音訊時要使用的編碼設定檔。 |
Absolute |
將剪輯時間指定為媒體檔案中的絕對時間位置。 絕對時間可以根據媒體檔案是否從零的時間戳開始,指向不同的位置。 |
Analysis |
指定分析影片的最大解析度。 默認行為是 “SourceResolution”,這會在分析時保持輸入視訊的原始解析度。 使用 「StandardDefinition」 會將輸入影片調整為標準定義,同時保留適當的外觀比例。 只有在視訊解析度較高時,才會重設大小。 例如,在處理之前,會將 1920x1080 輸入調整為 640x360。 切換至 「StandardDefinition」 可減少處理高解析度視訊所需的時間。 它也可能會降低使用此元件的成本, (請參閱 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics 以取得詳細數據) 。 不過,在重設大小的視訊中,最終太小的臉部可能無法偵測到。 |
Attribute |
要套用至 TrackAttribute 的 AttributeFilter 類型,以便選取曲目。 |
Audio |
定義所有音訊編解碼器的通用屬性。 |
Audio |
決定要執行的音訊分析作業集。 如果未指定,則會選擇標準 AudioAnalysisMode。 |
Audio |
音訊分析器預設會套用一組預先定義的 AI 型分析作業,包括語音轉譯。 此預設目前支援處理具有單一音訊播放軌的內容。 |
Audio |
描述音訊重疊的屬性。 |
Audio |
選取音訊播放軌的 TrackSelection。 |
Blur |
模糊類型 |
Built |
描述使用標準編碼器編碼輸入視訊的內建預設。 |
Channel |
單一通道音訊播放軌的選擇性指定。 可用來將曲目合併成立體或多聲道音訊播放軌。 |
Complexity |
可讓您設定編碼器設定,以控制速度與品質之間的平衡。 範例:將複雜度設定為速度,以加快編碼速度,但壓縮效率較低。 |
Copy |
編解碼器旗標,告知編碼器複製輸入音訊位流。 |
Copy |
編解碼器旗標,告知編碼器複製輸入視訊位流,而不需重新編碼。 |
created |
建立資源的身分識別類型。 |
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 |
描述取消交錯設定。 |
Deinterlace |
取消交錯模式。 默認為 AutoPixelAdaptive。 |
Deinterlace |
取消交錯的欄位同位,預設為 Auto。 |
Encoder |
用來編碼影片的內建預設。 |
Entropy |
要用於此層的 Entropy 模式。 如果未指定,編碼器會選擇適合配置檔和層級的模式。 |
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
Face |
描述分析影片時要使用的所有設定,以偵測 (,並選擇性地) 所有臉部呈現。 |
Face |
此模式可讓您選擇下列設定:1) 分析 - 僅供偵測。此模式會產生元數據 JSON 檔案,以標記整個影片中臉部的外觀。可能的話,相同人員的外觀會指派相同的標識碼。2 個) 合併 - 此外, (模糊) 偵測到的人臉。 3) Redact - 這可啟用 2 次程式,允許選擇性修訂偵測到臉部子集。它會取用先前分析階段的元數據檔案,以及來源影片,以及需要修訂的用戶選取標識符子集。 |
Fade |
描述套用至輸入媒體的淡出效果屬性。 |
Filters |
描述在編碼之前套用至輸入媒體的所有篩選作業,例如取消交錯、旋轉等。 |
From |
InputDefinition,可查看提供給選取 IncludedTracks 屬性所指定之曲目的所有檔案。 通常與 AudioTrackByAttribute 和 VideoTrackByAttribute 搭配使用,以允許跨一組輸入檔案選取單一播放軌。 |
From |
InputDefinition,查看提供給選取 IncludedTracks 屬性所指定之曲目的每個輸入檔。 通常與 AudioTrackByAttribute 和 VideoTrackByAttribute 搭配使用,以從指定的每個檔案中選取曲目。 |
H264Complexity |
告知編碼器如何選擇其編碼設定。 默認值為 [平衡]。 |
H264Layer |
描述使用 H.264 視訊編解碼器將輸入視訊編碼成所需輸出比特率層時所使用的設定。 |
H264Rate |
視訊速率控制模式 |
H264Video |
描述使用 H.264 編解碼器編碼視訊的所有屬性。 |
H264Video |
我們目前支持比較基準、主要、高、高422、High444。 預設值為 Auto。 |
H265Complexity |
告知編碼器如何選擇其編碼設定。 品質會提供較高的壓縮率,但成本較高且計算時間較長。 速度會產生相對較大的檔案,但較快速且更經濟。 默認值為 [平衡]。 |
H265Layer |
描述使用 H.265 視訊編解碼器,將輸入視訊編碼成所需的輸出比特率層時所要使用的設定。 |
H265Video |
描述使用 H.265 編解碼器編碼視訊的所有屬性。 |
H265Video |
我們目前支援Main。 預設值為 Auto。 |
Image |
描述從輸入影片產生縮圖的基本屬性 |
Image |
描述輸出圖像檔的屬性。 |
Input |
單一檔案的 InputDefinition。 TrackSelections 的範圍設定為指定的檔案。 |
Insights |
定義您想要服務產生的深入解析類型。 允許的值為 'AudioInsightsOnly'、'VideoInsightsOnly' 和 'AllInsights'。 預設值為 AllInsights。 如果您將此設定為 AllInsights,且輸入只是音訊,則只會產生音訊深入解析。 同樣地,如果輸入只是視訊,則只會產生影片深入解析。 如果您預期某些輸入只是視訊,建議您不要使用 AudioInsightsOnly;或如果您預期某些輸入只是音訊,請使用 VideoInsightsOnly。 這類情況下的作業會發生錯誤。 |
Interleave |
設定輸出的交錯模式,以控制音訊和視訊如何以容器格式儲存。 範例:將 InterleavedOutput 設定為 NonInterleavedOutput,以在不同的 MP4 檔案中產生僅限音訊和僅限視訊輸出。 |
Job |
作業資源類型。 您可以藉由輪詢 Job 或使用 EventGrid 訂閱事件來取得進度和狀態。 |
Job |
JobOutput 錯誤的詳細數據。 |
Job |
協助分類錯誤。 |
Job |
描述錯誤的錯誤碼。 |
Job |
JobOutput 錯誤的詳細數據。 |
Job |
表示輸入作業的資產。 |
Job |
表示作業的輸入檔。 |
Job |
表示 HTTPS 作業輸入。 |
Job |
描述作業的輸入清單。 |
Job |
Sequence 包含一份已排序的 Clip 清單,其中每個剪輯都是 JobInput。 Sequence 會被視為單一輸入。 |
Job |
表示做為 JobOutput 的資產。 |
Job |
表示可能重試作業。 如果重試失敗,請透過 Azure 入口網站連絡 Azure 支援。 |
Job |
描述 JobOutput 的狀態。 |
Jpg |
描述產生 JPEG 縮圖的設定。 |
Jpg |
描述從輸入影片產生一系列 JPEG 影像的屬性。 |
Jpg |
描述從輸入影片產生 JPEG 影像的設定。 |
Mp4Format |
描述輸出 ISO MP4 檔案的屬性。 |
Multi |
描述產生 GOP 對齊多比特率檔案集合的屬性。 默認行為是為每個視訊層產生一個輸出檔案,這些輸出檔會與所有音訊一起多任務處理。 您可以藉由指定 outputFiles 集合來控制產生的確切輸出檔案。 |
Output |
表示產生的輸出檔案。 |
Png |
描述產生 PNG 縮圖的設定。 |
Png |
描述從輸入影片產生一系列 PNG 影像的屬性。 |
Png |
描述從輸入影片產生 PNG 影像的設定。 |
Preset |
編碼器選擇性組態設定的物件。 |
Priority |
設定 TransformOutputs 在 Transform 中的相對優先順序。 這會設定服務用於處理 TransformOutputs 的優先順序。 默認優先順序為 Normal。 |
Rectangle |
描述在處理矩形視窗之前套用至輸入媒體的屬性。 |
Rotation |
如果有任何旋轉,則會在編碼之前套用至輸入視訊。 預設值為 Auto |
Select |
藉由指定屬性和屬性篩選,從輸入中選取音訊播放軌。 |
Select |
藉由指定曲目標識符,從輸入中選取音訊播放軌。 |
Select |
藉由指定屬性和屬性篩選,從輸入中選取視訊播放軌。 |
Select |
藉由指定播放軌標識碼,從輸入中選取視訊播放軌。 |
Standard |
描述使用標準編碼器編碼輸入視訊時要使用的所有設定。 |
Stretch |
重設大小模式 - 輸入視訊的大小如何調整,以符合所需的輸出解析度 () 。 預設值為 AutoSize |
system |
與建立和上次修改資源相關的元數據。 |
Track |
用來篩選追蹤依據的 TrackAttribute。 |
Transport |
描述產生 MPEG-2 傳輸數據流的屬性, (ISO/IEC 13818-1) 輸出視訊檔案 (s) 。 |
Utc |
將剪輯時間指定為媒體檔案中的 Utc 時間位置。 Utc 時間可以根據媒體檔案是否從零的時間戳開始,指向不同的位置。 |
Video |
描述編碼輸入影片的基本屬性。 |
Video |
影片分析器預設會從音訊和視訊擷取深入解析 (豐富的元數據) ,並輸出 JSON 格式檔案。 |
Video |
描述視訊重疊的屬性。 |
Video |
視訊同步模式 |
Video |
選取視訊播放軌的 TrackSelection。 |
AacAudio
描述進階音訊編解碼器 (AAC) 音訊編碼設定。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
bitrate |
integer |
輸出編碼音訊的每秒位比特率。 |
channels |
integer |
音訊中的通道數目。 |
label |
string |
編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。 |
profile |
使用 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. |
衍生類型的鑒別子。 |
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. |
衍生型別的辨別子。 |
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. |
衍生型別的辨別子。 |
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。 |
AudioOverlay
描述音訊重疊的屬性。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
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. |
衍生類型的鑒別子。 |
channelMapping |
單一通道音訊播放軌的選擇性指定。 可用來將曲目結合成立體聲或多聲道音訊播放軌。 |
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. |
衍生型別的辨別子。 |
configurations |
編碼器的選擇性組態設定。 只有 ContentAwareEncoding 和 H265ContentAwareEncoding BuiltInStandardEncoderPreset 才支持設定。 |
|
presetName |
用來編碼影片的內建預設。 |
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. |
衍生型別的辨別子。 |
label |
string |
編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。 |
CopyVideo
編解碼器旗標,告知編碼器複製輸入視訊位流,而不需重新編碼。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
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. |
衍生型別的辨別子。 |
bitrate |
integer |
輸出編碼音訊的每秒位比特率。 |
channels |
integer |
音訊中的通道數目。 |
label |
string |
編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。 |
samplingRate |
integer |
要用於以 hertz 編碼的取樣率。 |
Deinterlace
描述取消交錯設定。
名稱 | 類型 | Description |
---|---|---|
mode |
取消交錯模式。 默認為 AutoPixelAdaptive。 |
|
parity |
取消交錯的欄位同位,預設為 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 |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細資料。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
錯誤物件。 |
FaceDetectorPreset
描述分析影片時要使用的所有設定,以偵測 (,並選擇性地) 所有臉部呈現。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
blurType |
模糊類型 |
|
experimentalOptions |
object |
字典,其中包含預設本身未公開之參數的索引鍵值組 |
mode |
此模式可讓您選擇下列設定:1) 分析 - 僅供偵測。此模式會產生元數據 JSON 檔案,以標記整個影片中臉部的外觀。可能的話,相同人員的外觀會指派相同的標識碼。2 個) 合併 - 此外, (模糊) 偵測到的人臉。 3) Redact - 這可啟用 2 次程式,允許選擇性修訂偵測到臉部子集。它會取用先前分析階段的元數據檔案,以及來源影片,以及需要修訂的用戶選取標識符子集。 |
|
resolution |
指定分析視訊的最大解析度。 默認行為是 “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 |
用來裁剪輸入視訊之矩形視窗的參數。 |
|
deinterlace |
取消交錯設定。 |
|
fadeIn |
描述套用至輸入媒體的淡化效果屬性。 |
|
fadeOut |
描述套用至輸入媒體的淡化效果屬性。 |
|
overlays | Overlay[]: |
要套用至輸入視訊的重疊屬性。 這些可能是音訊、影像或視訊重疊。 |
rotation |
如果有任何旋轉,則會在編碼之前套用至輸入視訊。 預設值為 Auto |
FromAllInputFile
InputDefinition,可查看提供給選取 IncludedTracks 屬性所指定之曲目的所有檔案。 通常與 AudioTrackByAttribute 和 VideoTrackByAttribute 搭配使用,以允許跨一組輸入檔案選取單一播放軌。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
includedTracks | TrackDescriptor[]: |
TrackDescriptors 的清單,定義輸入中的曲目元數據和選取範圍。 |
FromEachInputFile
InputDefinition,查看提供給選取 IncludedTracks 屬性所指定之曲目的每個輸入檔。 通常與 AudioTrackByAttribute 和 VideoTrackByAttribute 搭配使用,以從指定的每個檔案中選取曲目。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
includedTracks | TrackDescriptor[]: |
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 |
要用於此層的 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 |
我們目前支持比較基準、主要、高、高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. |
衍生型別的辨別子。 |
complexity |
告知編碼器如何選擇其編碼設定。 默認值為 [平衡]。 |
|
keyFrameInterval |
string |
兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5, 20] 秒中應為非零。 預設值為 PT2S (2 秒) 。 請注意,如果已設定 VideoSyncMode.Passthrough,則會忽略此設定,其中 KeyFrameInterval 值會遵循輸入來源設定。 |
label |
string |
編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。 |
layers |
要由編碼器產生的輸出 H.264 層集合。 |
|
rateControlMode |
視訊速率控制模式 |
|
sceneChangeDetection |
boolean |
編碼器是否應該在場景變更插入主要畫面格。 如果未指定,則預設值為 false。 只有當編碼器設定為產生單一輸出視訊時,此旗標才應設定為 true。 |
stretchMode |
重設大小模式 - 輸入視訊的大小如何調整,以符合所需的輸出解析度 () 。 預設值為 AutoSize |
|
syncMode |
視訊同步模式 |
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 |
我們目前支援Main。 預設值為 Auto。 |
|
referenceFrames |
integer |
編碼此圖層時要使用的參考框架數目。 如果未指定,編碼器會根據編碼器複雜度設定來決定適當的數位。 |
slices |
integer |
編碼此圖層時要使用的配量數目。 如果未指定,預設值為零,這表示編碼器會針對每個畫面使用單一配量。 |
width |
string |
此圖層的輸出視訊寬度。 此值可以是以圖元為單位的絕對 () 或以百分比) 相對 (。 例如,50% 表示輸出視訊的寬度與輸入的一半圖元相同。 |
H265Video
描述使用 H.265 編解碼器編碼視訊的所有屬性。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
complexity |
告知編碼器如何選擇其編碼設定。 品質會提供較高的壓縮比率,但成本較高且計算時間較長。 速度會產生相對較大的檔案,但速度較快且更經濟。 默認值為 [平衡]。 |
|
keyFrameInterval |
string |
兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5, 20] 秒中應為非零。 預設值為 PT2S (2 秒) 。 請注意,如果已設定 VideoSyncMode.Passthrough,則會忽略此設定,其中 KeyFrameInterval 值會遵循輸入來源設定。 |
label |
string |
編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。 |
layers |
要由編碼器產生的輸出 H.265 層集合。 |
|
sceneChangeDetection |
boolean |
指定編碼器是否應該在場景變更插入主要畫面格。 如果未指定,則預設值為 false。 只有當編碼器設定為產生單一輸出視訊時,此旗標才應設定為 true。 |
stretchMode |
重設大小模式 - 輸入視訊的大小如何調整,以符合所需的輸出解析度 () 。 預設值為 AutoSize |
|
syncMode |
視訊同步模式 |
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. |
衍生型別的辨別子。 |
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 |
重設大小模式 - 輸入視訊的大小如何調整,以符合所需的輸出解析度 () 。 預設值為 AutoSize |
|
syncMode |
視訊同步模式 |
ImageFormat
描述輸出圖像檔的屬性。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
filenamePattern |
string |
用於建立輸出檔案的檔案命名模式。 檔名支援下列宏:{Basename} - 將使用輸入視訊檔名稱的擴充宏。 如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元,則會使用輸入視訊檔案的基底名稱。 如果輸入視訊檔案的基底名稱長度超過 32 個字元,則基底名稱會截斷為總長度的前 32 個字元。 {Extension} - 此格式的適當延伸模組。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。 僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊數據流號碼, (從 1 開始) 。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。 不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。 任何未取代的宏都會從檔名折迭和移除。 |
InputFile
單一檔案的 InputDefinition。 TrackSelections 的範圍設定為指定的檔案。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
filename |
string |
這個輸入定義所套用的檔名。 |
includedTracks | TrackDescriptor[]: |
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: |
作業輸入。 |
properties.lastModified |
string |
客戶上次更新作業的 UTC 日期和時間,格式為 'YYYY-MM-DDThh:mm:ssZ'。 |
properties.outputs | JobOutput[]: |
作業的輸出。 |
properties.priority |
處理作業時應依循的優先順序。 先處理優先順序較高的作業,再處理優先順序較低的工作。 如果沒有設定,預設值為一般。 |
|
properties.startTime |
string |
此作業開始處理的 UTC 日期和時間。 |
properties.state |
作業的目前狀態。 |
|
systemData |
與此資源相關的系統元數據。 |
|
type |
string |
資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts” |
JobError
JobOutput 錯誤的詳細數據。
名稱 | 類型 | Description |
---|---|---|
category |
協助分類錯誤。 |
|
code |
描述錯誤的錯誤碼。 |
|
details |
導致此錯誤之特定錯誤的詳細數據陣列。 |
|
message |
string |
錯誤的人類可讀語言相依表示法。 |
retry |
表示可能重試作業。 如果重試失敗,請透過 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. |
衍生類型的鑒別子。 |
assetName |
string |
輸入資產的名稱。 |
end | ClipTime: |
定義輸入媒體的時間軸上結束處理的時間點。 預設為輸入媒體的結尾。 |
files |
string[] |
檔案清單。 JobInputHttp 的必要專案。 每個字元最多 4000 個字元。 服務回應中不會傳回查詢字串,以防止敏感數據暴露。 |
inputDefinitions | InputDefinition[]: |
定義 InputDefinitions 的清單。 針對每個 InputDefinition,它會定義追蹤選取專案和相關元數據的清單。 |
label |
string |
指派給 JobInputClip 的標籤,用於滿足轉換中使用的參考。 例如,您可以撰寫轉換,以擷取具有標籤 'xyz' 的影像檔案,並在編碼之前將其套用為輸入視訊的重疊。 提交作業時,只有其中一個 JobInputs 應該是圖像檔案,而且應該有標籤 'xyz'。 |
start | ClipTime: |
定義輸入媒體的時間軸上開始處理的時間點。 默認為輸入媒體的開頭。 |
JobInputClip
表示作業的輸入檔。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
end | ClipTime: |
定義輸入媒體的時間軸上結束處理的時間點。 預設為輸入媒體的結尾。 |
files |
string[] |
檔案清單。 JobInputHttp 的必要專案。 每個字元最多 4000 個字元。 服務回應中不會傳回查詢字串,以防止敏感數據暴露。 |
inputDefinitions | InputDefinition[]: |
定義 InputDefinitions 的清單。 針對每個 InputDefinition,它會定義追蹤選取專案和相關元數據的清單。 |
label |
string |
指派給 JobInputClip 的標籤,用於滿足轉換中使用的參考。 例如,您可以撰寫轉換,以擷取具有標籤 'xyz' 的影像檔案,並在編碼之前將其套用為輸入視訊的重疊。 提交作業時,只有其中一個 JobInputs 應該是圖像檔案,而且應該有標籤 'xyz'。 |
start | ClipTime: |
定義輸入媒體的時間軸上開始處理的時間點。 默認為輸入媒體的開頭。 |
JobInputHttp
表示 HTTPS 作業輸入。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
baseUri |
string |
HTTPS 作業輸入的基底 URI。 它會與提供的檔名串連。 如果未指定任何基底 URI,則會假設提供的檔案清單為完整 URI。 長度上限為 4000 個字元。 服務回應中不會傳回查詢字串,以防止敏感數據暴露。 |
end | ClipTime: |
定義輸入媒體的時間軸上結束處理的時間點。 預設為輸入媒體的結尾。 |
files |
string[] |
檔案清單。 JobInputHttp 的必要專案。 每個字元最多 4000 個字元。 服務回應中不會傳回查詢字串,以防止敏感數據暴露。 |
inputDefinitions | InputDefinition[]: |
定義 InputDefinitions 的清單。 針對每個 InputDefinition,它會定義追蹤選取專案和相關元數據的清單。 |
label |
string |
指派給 JobInputClip 的標籤,用於滿足轉換中使用的參考。 例如,您可以撰寫轉換,以擷取具有標籤 'xyz' 的影像檔案,並在編碼之前將其套用為輸入視訊的重疊。 提交作業時,只有其中一個 JobInputs 應該是圖像檔案,而且應該有標籤 'xyz'。 |
start | ClipTime: |
定義輸入媒體的時間軸上開始處理的時間點。 默認為輸入媒體的開頭。 |
JobInputs
描述作業的輸入清單。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
inputs | JobInput[]: |
工作的輸入清單。 |
JobInputSequence
Sequence 包含一份已排序的 Clip 清單,其中每個剪輯都是 JobInput。 Sequence 會被視為單一輸入。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
inputs | JobInputClip[]: |
構成時程表的 JobInputs。 |
JobOutputAsset
表示做為 JobOutput 的資產。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
assetName |
string |
輸出資產的名稱。 |
endTime |
string |
這個作業輸出完成處理的UTC日期和時間。 |
error |
如果 JobOutput 處於 Error 狀態,則會包含錯誤的詳細數據。 |
|
label |
string |
指派給 JobOutput 的標籤,以協助唯一識別它。 當您的 Transform 有一個以上的 TransformOutput 時,您的 Job 會有一個以上的 JobOutput 時,這會很有用。 在這種情況下,當您提交作業時,將會以與 Transform 中的 TransformOutputs 相同的順序新增兩個或多個 JobOutputs。 接著,當您透過事件或 GET 要求擷取作業時,您可以使用標籤輕鬆地識別 JobOutput。 如果未提供標籤,則會使用預設值 『{presetName}_{outputIndex}』,其中預設名稱是對應 TransformOutput 中預設的名稱,而輸出索引是 Job 內此 JobOutput 的相對索引。 請注意,此索引與其 TransformOutput 內對應的 TransformOutput 的相對索引相同。 |
presetOverride | Preset: |
默認,用來覆寫對應轉換輸出中的預設。 |
progress |
integer |
如果 JobOutput 處於處理狀態,這包含作業完成百分比。 此值是估計值,並非用來預測作業完成時間。 若要判斷 JobOutput 是否完成,請使用 State 屬性。 |
startTime |
string |
這個作業輸出開始處理的UTC日期和時間。 |
state |
描述 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. |
衍生型別的辨別子。 |
filenamePattern |
string |
用於建立輸出檔案的檔案命名模式。 檔名支援下列宏:{Basename} - 將使用輸入視訊檔名稱的擴充宏。 如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元,則會使用輸入視訊檔案的基底名稱。 如果輸入視訊檔案的基底名稱長度超過 32 個字元,則基底名稱會截斷為總長度的前 32 個字元。 {Extension} - 此格式的適當延伸模組。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。 僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊數據流號碼, (從 1 開始) 。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。 不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。 任何未取代的宏都會從檔名折迭和移除。 |
JpgImage
描述從輸入影片產生一系列 JPEG 影像的屬性。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
keyFrameInterval |
string |
兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5, 20] 秒中應為非零。 預設值為 PT2S (2 秒) 。 請注意,如果已設定 VideoSyncMode.Passthrough,則會忽略此設定,其中 KeyFrameInterval 值會遵循輸入來源設定。 |
label |
string |
編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。 |
layers |
Jpg |
要由編碼器產生的輸出 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 |
重設大小模式 - 輸入視訊的大小如何調整,以符合所需的輸出解析度 () 。 預設值為 AutoSize |
|
syncMode |
視訊同步模式 |
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. |
衍生型別的辨別子。 |
filenamePattern |
string |
用於建立輸出檔案的檔案命名模式。 檔名支援下列宏:{Basename} - 將使用輸入視訊檔名稱的擴充宏。 如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元,則會使用輸入視訊檔案的基底名稱。 如果輸入視訊檔案的基底名稱長度超過 32 個字元,則基底名稱會截斷為總長度的前 32 個字元。 {Extension} - 此格式的適當延伸模組。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。 僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊數據流號碼, (從 1 開始) 。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。 不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。 任何未取代的宏都會從檔名折迭和移除。 |
outputFiles |
要產生的輸出檔案清單。 清單中的每個專案都是一組要一起多任務處理的音訊和視訊圖層標籤。 |
MultiBitrateFormat
描述產生 GOP 對齊多比特率檔案集合的屬性。 默認行為是為每個視訊層產生一個輸出檔案,這些輸出檔會與所有音訊一起多任務處理。 您可以藉由指定 outputFiles 集合來控制產生的確切輸出檔案。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
filenamePattern |
string |
用於建立輸出檔案的檔案命名模式。 檔名支援下列宏:{Basename} - 將使用輸入視訊檔名稱的擴充宏。 如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元,則會使用輸入視訊檔案的基底名稱。 如果輸入視訊檔案的基底名稱長度超過 32 個字元,則基底名稱會截斷為總長度的前 32 個字元。 {Extension} - 此格式的適當延伸模組。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。 僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊數據流號碼, (從 1 開始) 。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。 不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。 任何未取代的宏都會從檔名折迭和移除。 |
outputFiles |
要產生的輸出檔案清單。 清單中的每個專案都是一組要一起多任務處理的音訊和視訊圖層標籤。 |
OutputFile
表示產生的輸出檔案。
名稱 | 類型 | Description |
---|---|---|
labels |
string[] |
描述編碼器如何將視訊和音訊多任務處理到輸出檔案的標籤清單。 例如,如果編碼器產生兩個具有 v1 和 v2 卷標的視訊層,以及一個具有卷標 a1 的音訊層,則類似 '[v1, a1]' 的數位會告知編碼器產生輸出檔案,其中包含 v1 所代表的視訊播放軌和 a1 所代表的音訊播放軌。 |
PngFormat
描述產生 PNG 縮圖的設定。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
filenamePattern |
string |
用於建立輸出檔案的檔案命名模式。 檔名支援下列宏:{Basename} - 將使用輸入視訊檔名稱的擴充宏。 如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元,則會使用輸入視訊檔案的基底名稱。 如果輸入視訊檔案的基底名稱長度超過 32 個字元,則基底名稱會截斷為總長度的前 32 個字元。 {Extension} - 此格式的適當延伸模組。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。 僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊數據流號碼, (從 1 開始) 。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。 不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。 任何未取代的宏都會從檔名折迭和移除。 |
PngImage
描述從輸入影片產生一系列 PNG 影像的屬性。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
keyFrameInterval |
string |
兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5, 20] 秒中應為非零。 預設值為 PT2S (2 秒) 。 請注意,如果已設定 VideoSyncMode.Passthrough,則會忽略此設定,其中 KeyFrameInterval 值會遵循輸入來源設定。 |
label |
string |
編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。 |
layers |
Png |
要由編碼器產生的輸出 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 |
重設大小模式 - 輸入視訊的大小如何調整,以符合所需的輸出解析度 () 。 預設值為 AutoSize |
|
syncMode |
視訊同步模式 |
PngLayer
描述從輸入影片產生 PNG 影像的設定。
名稱 | 類型 | Description |
---|---|---|
height |
string |
此圖層的輸出視訊高度。 此值可以是以圖元為單位的絕對 () 或以百分比) 相對 (。 例如,50% 表示輸出視訊的高度為輸入的一半圖元。 |
label |
string |
此圖層的英數位元標籤,可用於多任務處理不同的視訊和音訊層,或用於命名輸出檔案。 |
width |
string |
此圖層的輸出視訊寬度。 此值可以是以圖元為單位的絕對 () 或以百分比) 相對 (。 例如,50% 表示輸出視訊的寬度與輸入的一半圖元相同。 |
PresetConfigurations
編碼器選擇性組態設定的物件。
名稱 | 類型 | Description |
---|---|---|
complexity |
可讓您設定編碼器設定,以控制速度與品質之間的平衡。 範例:將 [複雜度] 設定為 [速度],以加快編碼速度,但壓縮效率較低。 |
|
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. |
衍生類型的鑒別子。 |
attribute |
用來篩選追蹤依據的 TrackAttribute。 |
|
channelMapping |
單一通道音訊播放軌的選擇性指定。 可用來將曲目結合成立體聲或多聲道音訊播放軌。 |
|
filter |
要套用至 TrackAttribute 的 AttributeFilter 類型,以便選取曲目。 |
|
filterValue |
string |
篩選追蹤依據的值。 只有在針對 Filter 屬性指定 AttributeFilter.ValueEquals 時才使用。 |
SelectAudioTrackById
藉由指定曲目標識符,從輸入中選取音訊播放軌。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
channelMapping |
單一通道音訊播放軌的選擇性指定。 可用來將曲目結合成立體聲或多聲道音訊播放軌。 |
|
trackId |
integer |
追蹤要選取的標識碼 |
SelectVideoTrackByAttribute
藉由指定屬性和屬性篩選,從輸入中選取視訊播放軌。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
attribute |
用來篩選追蹤依據的 TrackAttribute。 |
|
filter |
要套用至 TrackAttribute 的 AttributeFilter 類型,以便選取曲目。 |
|
filterValue |
string |
篩選追蹤依據的值。 只有在針對 Filter 屬性指定 AttributeFilter.ValueEquals 時才使用。 針對 TrackAttribute.Bitrate,這應該是每秒位的整數值, (例如:『1500000』) 。 視訊播放軌不支援 TrackAttribute.Language。 |
SelectVideoTrackById
藉由指定播放軌標識碼,從輸入中選取視訊播放軌。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
trackId |
integer |
追蹤要選取的標識碼 |
StandardEncoderPreset
描述使用標準編碼器編碼輸入視訊時要使用的所有設定。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
codecs | Codec[]: |
編碼輸入視訊時要使用的編解碼器清單。 |
experimentalOptions |
object |
字典,其中包含預設本身未公開之參數的索引鍵值組 |
filters |
編碼之前套用至輸入媒體的一或多個篩選作業。 |
|
formats | Format[]: |
編碼器要產生的輸出清單。 |
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 |
建立資源的身分識別類型。 |
|
lastModifiedAt |
string |
上次修改的資源時間戳 (UTC) |
lastModifiedBy |
string |
上次修改資源的身分識別。 |
lastModifiedByType |
上次修改資源的身分識別類型。 |
TrackAttribute
用來篩選追蹤依據的 TrackAttribute。
名稱 | 類型 | Description |
---|---|---|
Bitrate |
string |
追蹤的比特率。 |
Language |
string |
追蹤的語言。 |
TransportStreamFormat
描述產生 MPEG-2 傳輸數據流的屬性, (ISO/IEC 13818-1) 輸出視訊檔案 (s) 。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
filenamePattern |
string |
用於建立輸出檔案的檔案命名模式。 檔名支援下列宏:{Basename} - 將使用輸入視訊檔名稱的擴充宏。 如果輸入視訊檔案的基底名稱 (不包含檔案後綴) 長度小於 32 個字元,則會使用輸入視訊檔案的基底名稱。 如果輸入視訊檔案的基底名稱長度超過 32 個字元,則基底名稱會截斷為總長度的前 32 個字元。 {Extension} - 此格式的適當延伸模組。 {Label} - 指派給編解碼器/圖層的標籤。 {Index} - 縮圖的唯一索引。 僅適用於縮圖。 {AudioStream} - 字串 “Audio” 加上音訊數據流號碼, (從 1 開始) 。 {比特率} - 以 kbps 為單位的音訊/視訊比特率。 不適用於縮圖。 {Codec} - 音訊/視訊編解碼器的類型。 {Resolution} - 視訊解析度。 任何未取代的宏都會從檔名折迭和移除。 |
outputFiles |
要產生的輸出檔案清單。 清單中的每個專案都是一組要一起多任務處理的音訊和視訊圖層標籤。 |
UtcClipTime
將剪輯時間指定為媒體檔案中的 Utc 時間位置。 Utc 時間可以根據媒體檔案是否從零的時間戳開始,指向不同的位置。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
time |
string |
以 Utc 時間為基礎的輸入媒體時間軸上的時間位置。 |
Video
描述編碼輸入影片的基本屬性。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
keyFrameInterval |
string |
兩個主要畫面格之間的距離。 值在 ISO 8601 格式所指定的範圍 [0.5, 20] 秒中應為非零。 預設值為 PT2S (2 秒) 。 請注意,如果已設定 VideoSyncMode.Passthrough,則會忽略此設定,其中 KeyFrameInterval 值會遵循輸入來源設定。 |
label |
string |
編解碼器的選擇性標籤。 標籤可用來控制多任務處理行為。 |
stretchMode |
重設大小模式 - 輸入視訊的大小如何調整,以符合所需的輸出解析度 () 。 預設值為 AutoSize |
|
syncMode |
視訊同步模式 |
VideoAnalyzerPreset
影片分析器預設會從音訊和視訊擷取深入解析 (豐富的元數據) ,並輸出 JSON 格式檔案。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生型別的辨別子。 |
audioLanguage |
string |
使用 'language tag-region' 的 BCP-47 格式輸入中音訊承載的語言 (例如:'en-US') 。 如果您知道內容的語言,建議您指定它。 必須明確指定 AudioAnalysisMode::Basic 的語言,因為自動語言偵測未包含在基本模式中。 如果未指定語言或將語言設為 Null,自動語言偵測會選擇偵測到的第一種語言,並使用選取的語言處理整個檔案。 目前不支援在偵測到第一個語言後,動態地切換語言。 自動偵測最適合使用可清楚辨識語音的音訊錄製。 如果自動偵測找不到語言,轉譯會回復為 'en-US'。」這裡提供支援的語言清單: https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
字典,其中包含預設本身未公開之參數的索引鍵值組 |
insightsToExtract |
定義您想要服務產生之深入解析的類型。 允許的值是 『AudioInsightsOnly』、『VideoInsightsOnly』和 『AllInsights』。 預設值為 AllInsights。 如果您將此設定為 AllInsights,而且輸入只是音訊,則只會產生音訊深入解析。 同樣地,如果輸入只是視訊,則只會產生影片深入解析。 如果您預期某些輸入只是視訊,建議您不要使用 AudioInsightsOnly;或如果您預期某些輸入只是音訊,請使用 VideoInsightsOnly。 這類情況下的作業會發生錯誤。 |
|
mode |
決定要執行的音訊分析作業集。 如果未指定,則會選擇標準 AudioAnalysisMode。 |
VideoOverlay
描述視訊重疊的屬性。
名稱 | 類型 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
衍生類型的鑒別子。 |
audioGainLevel |
number |
重疊中的音訊增益等級。 此值應位於 [0, 1.0] 範圍內。 預設值為 1.0。 |
cropRectangle |
用來裁剪重疊影像或視訊的選擇性矩形視窗。 |
|
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 |
套用重疊之輸入視訊中的位置。 |
|
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. |
衍生類型的鑒別子。 |