az ams transform output

管理 Azure 媒體服務帳戶的轉換輸出。

命令

名稱	Description	類型	狀態
az ams transform output add	將輸出新增至現有的轉換。	Core	GA
az ams transform output remove	從現有的轉換中移除輸出。	Core	GA

az ams transform output add

編輯

將輸出新增至現有的轉換。

az ams transform output add --preset
                            [--account-name]
                            [--audio-analysis-mode]
                            [--audio-language]
                            [--blur-type]
                            [--face-detector-mode]
                            [--ids]
                            [--insights-to-extract {AllInsights, AudioInsightsOnly, VideoInsightsOnly}]
                            [--name]
                            [--on-error {ContinueJob, StopProcessingJob}]
                            [--relative-priority {High, Low, Normal}]
                            [--resolution]
                            [--resource-group]
                            [--subscription]
                            [--video-analysis-mode]

範例

從 JSON 檔案新增具有自訂標準編碼器預設的輸出。

az ams transform output add -a myAmsAccount -n transformName -g myResourceGroup --preset "C:\MyPresets\CustomPreset.json"

使用 VideoAnalyzer 預設新增輸出，es-ES 為音訊語言，且僅使用音訊深入解析。

az ams transform output add -a myAmsAccount -n transformName -g myResourceGroup --preset VideoAnalyzer --audio-language es-ES --insights-to-extract AudioInsightsOnly

必要參數

--preset

默認，描述將用來修改、轉碼或從來源檔案擷取深入解析以產生轉換輸出的作業。允許的值：H264SingleBitrateSD、H264SingleBitrate720p、H264SingleBitrate1080p、AdaptiveStreaming、AACGoodQualityAudio、ContentAwareEncodingExperimental、ContentAwareEncoding、CopyAllBitrateNonInterleaved、H264MultipleBitrate1080p、 H264MultipleBitrate720p、H264MultipleBitrateSD、H265ContentAwareEncoding、H265AdaptiveStreaming、H265SingleBitrate720p、H265SingleBitrate1080p、H265SingleBitrate4K、AudioAnalyzer、VideoAnalyzer、FaceDetector。除了允許的值，您也可以將路徑傳遞至自定義標準編碼器預設 JSON 檔案。如需用來建置自定義預設之設定的進一步詳細數據，請參閱 https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-name -a

Azure 媒體服務帳戶的名稱。

屬性	值
Parameter group:	Resource Id Arguments

--audio-analysis-mode

決定要執行的音訊分析作業集。如果未指定，則會選擇標準 AudioAnalysisMode。允許的值：標準、基本。

屬性	值
Parameter group:	Audio/Video Analyzer Arguments

--audio-language

輸入中音訊承載的語言，使用「語言標記區域」的 BCP-47 格式（例如：en-US）。如果未指定，則會採用自動語言偵測。此功能目前支援英文、中文、法文、德文、義大利文、日文、西班牙文、俄文和葡萄牙文。自動偵測最適合使用清楚辨識語音的音訊錄製。如果自動偵測找不到語言，轉譯會回復為英文。允許的值：en-US、en-GB、es-ES、es-MX、fr-FR、it-IT、ja-JP、pt-BR、zh-CN、de-DE、ar-EG、ru-RU、hi-IN。

屬性	值
Parameter group:	Audio/Video Analyzer Arguments

--blur-type

允許的值：Box、Low、Med、High、Black。

屬性	值
Parameter group:	Face Detector Arguments

--face-detector-mode

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

屬性	值
Parameter group:	Face Detector Arguments

--ids

一或多個資源識別碼（以空格分隔）。它應該是包含「資源標識碼」自變數所有資訊的完整資源識別碼。您應該提供 --ids 或其他「資源識別碼」自變數。

屬性	值
Parameter group:	Resource Id Arguments

--insights-to-extract

要擷取的深入解析類型。如果未設定，則會根據內容類型選取類型。如果內容只是音訊，則只會擷取音頻深入解析，如果它是僅限視訊深入解析，則會擷取影片深入解析。

屬性	值
Parameter group:	Video Analyzer Arguments
接受的值:	AllInsights, AudioInsightsOnly, VideoInsightsOnly

--name -n

轉換的名稱。

屬性	值
Parameter group:	Resource Id Arguments

--on-error

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

屬性	值
接受的值:	ContinueJob, StopProcessingJob

--relative-priority

設定轉換內轉換輸出的相對優先順序。這會設定服務用來處理 TransformOutputs 的優先順序。默認優先順序為 Normal。

屬性	值
接受的值:	High, Low, Normal

--resolution

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

屬性	值
Parameter group:	Face Detector Arguments

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

屬性	值
Parameter group:	Resource Id Arguments

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

屬性	值
Parameter group:	Resource Id Arguments

--video-analysis-mode

決定要執行的音訊分析作業集。如果未指定，則會選擇標準 AudioAnalysisMode。允許的值：標準、基本。

屬性	值
Parameter group:	Video Analyzer Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False