az ams transform output

Azure Media Services アカウントの変換出力を管理します。

コマンド

名前	説明	型	状態
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 ファイルからカスタム Standard Encoder プリセットを使用して出力を追加します。

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

オーディオ言語として es-ES、オーディオ分析情報のみを使用して VideoAnalyzer プリセットを使用して出力を追加します。

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。使用できる値に加えて、カスタム Standard Encoder プリセット 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 Media Services アカウントの名前。

プロパティ	値
Parameter group:	Resource Id Arguments

--audio-analysis-mode

実行するオーディオ分析操作のセットを決定します。指定しない場合は、Standard AudioAnalysisMode が選択されます。使用できる値: Standard、Basic。

プロパティ	値
Parameter group:	Audio/Video Analyzer Arguments

--audio-language

BCP-47 形式の "language tag-region" (例: 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 ファイルが生成されます。可能な場合は、同じ人物の外観に同じ ID が割り当てられます。2) 結合 - 検出された顔をさらに編集 (ぼかし) します。 3)編集 - これにより、2パスプロセスが可能になり、検出された顔のサブセットの選択的な編集が可能になります。メタデータファイルは、ソースビデオと共に、以前の分析パスと、再編集を必要とするユーザーが選択した ID のサブセットを取り込みます。使用できる値: 分析、編集、結合。

プロパティ	値
Parameter group:	Face Detector Arguments

--ids

1 つ以上のリソース ID (スペース区切り)。これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ	値
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

変換では、複数の出力を定義できます。このプロパティは、1 つの出力が失敗したときにサービスが実行する必要がある処理を定義します。これは、他の出力の生成を続行するか、他の出力を停止します。ジョブの全体的な状態には、"ContinueJob" で指定された出力のエラーは反映されません。既定値は 'StopProcessingJob' です。

プロパティ	値
指定可能な値:	ContinueJob, StopProcessingJob

--relative-priority

変換内の変換出力の相対的な優先順位を設定します。これにより、サービスが TransformOutputs の処理に使用する優先順位が設定されます。既定の優先度は Normal です。

プロパティ	値
指定可能な値:	High, Low, Normal

--resolution

ビデオを分析する最大解像度を指定します。既定の動作は "SourceResolution" であり、分析時に入力ビデオが元の解像度で維持されます。 StandardDefinition を使用すると、適切な縦横比を維持しながら、入力ビデオのサイズが標準定義に変更されます。ビデオの解像度が高い場合にのみサイズが変更されます。たとえば、1920 x 1080 の入力は、処理の前に 640 x 360 にスケーリングされます。 "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

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ	値
Parameter group:	Resource Id Arguments

--video-analysis-mode

実行するオーディオ分析操作のセットを決定します。指定しない場合は、Standard AudioAnalysisMode が選択されます。使用できる値: Standard、Basic。

プロパティ	値
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