az ams transform output

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

コマンド

Name 説明 型 状態
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]
                            [--acquire-policy-token]
                            [--audio-analysis-mode]
                            [--audio-language]
                            [--blur-type]
                            [--change-reference]
                            [--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 を参照してください。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--account-name -a

Azure Media Services アカウントの名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--audio-analysis-mode

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

プロパティ 値
パラメーター グループ: 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.

プロパティ 値
パラメーター グループ: Audio/Video Analyzer Arguments
--blur-type

使用できる値: Box、Low、Med、High、Black。

プロパティ 値
パラメーター グループ: Face Detector Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--face-detector-mode

このモードでは、1) 分析 - 検出専用の設定から選択できます。このモードでは、ビデオ全体で顔の外観をマークするメタデータ JSON ファイルが生成されます。可能な場合は、同じ人物の外観に同じ ID が割り当てられます。2) 結合 - 検出された顔をさらに編集 (ぼかし) します。 3)編集 - これにより、2パスプロセスが可能になり、検出された顔のサブセットの選択的な編集が可能になります。メタデータ ファイルは、ソース ビデオと共に、以前の分析パスと、再編集を必要とするユーザーが選択した ID のサブセットを取り込みます。 使用できる値: 分析、編集、結合。

プロパティ 値
パラメーター グループ: Face Detector Arguments
--ids

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

プロパティ 値
パラメーター グループ: Resource Id Arguments
--insights-to-extract

抽出する分析情報の種類。 設定しない場合は、コンテンツ タイプに基づいてタイプが選択されます。 コンテンツがオーディオのみの場合は、オーディオ分析情報のみが抽出され、ビデオの場合はビデオ分析情報のみが抽出されます。

プロパティ 値
パラメーター グループ: Video Analyzer Arguments
指定可能な値: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--name -n

変換の名前。

プロパティ 値
パラメーター グループ: 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。

プロパティ 値
パラメーター グループ: Face Detector Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

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

プロパティ 値
パラメーター グループ: Resource Id Arguments
--video-analysis-mode

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

プロパティ 値
パラメーター グループ: Video Analyzer Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az ams transform output remove

既存の変換から出力を削除します。

az ams transform output remove --output-index
                               [--account-name]
                               [--acquire-policy-token]
                               [--change-reference]
                               [--ids]
                               [--name]
                               [--resource-group]
                               [--subscription]

例

--output-index 引数で指定されたインデックス位置にある出力要素を削除します。

az ams transform output remove -a myAmsAccount -n transformName -g myResourceGroup --output-index 1

必須パラメーター

--output-index

削除する出力の要素インデックス。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--account-name -a

Azure Media Services アカウントの名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--ids

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

プロパティ 値
パラメーター グループ: Resource Id Arguments
--name -n

変換の名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

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

プロパティ 値
パラメーター グループ: Resource Id Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False