az ams transform output

  • リファレンス

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

コマンド

名前 説明 型 Status
az ams transform output add

既存の変換に出力を追加します。

 コア GA
az ams transform output remove

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

 コア 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://docs.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset 。

省略可能のパラメーター

--account-name -a

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

--audio-analysis-mode

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

--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。

--blur-type

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

--face-detector-mode

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

--ids

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

--insights-to-extract

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

承認された値: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--name -n

変換の名前。

--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。

--resource-group -g

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

--subscription

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

--video-analysis-mode

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

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ams transform output remove

編集

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

az ams transform output remove --output-index
                               [--account-name]
                               [--ids]
                               [--name]
                               [--resource-group]
                               [--subscription]

例

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

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

必須のパラメーター

--output-index

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

省略可能のパラメーター

--account-name -a

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

--ids

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

--name -n

変換の名前。

--resource-group -g

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

--subscription

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

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。