Microsoft.Media mediaServices/transforms 2022-05-01-preview

• 最新の を する
• 2022-07-01
• 2022-05-01-プレビュー
• 2021-11-01
• 2021-06-01
• 2020-05-01
• 2019-05-01-プレビュー
• 2018-07-01
• 2018-06-01-プレビュー
• 2018-03-30-プレビュー

Bicep リソース定義

mediaServices/transforms リソースの種類は、次を対象とする操作でデプロイできます。

• リソース グループ - リソース グループのデプロイ コマンドを参照する

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Media/mediaServices/transforms リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Media/mediaServices/transforms@2022-05-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    description: 'string'
    outputs: [
      {
        onError: 'string'
        preset: {
          @odata.type: 'string'
          // For remaining properties, see Preset objects
        }
        relativePriority: 'string'
      }
    ]
  }
}

オーバーレイ オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.AudioOverlay の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.AudioOverlay'
}

#Microsoft.Media.VideoOverlay の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.VideoOverlay'
  cropRectangle: {
    height: 'string'
    left: 'string'
    top: 'string'
    width: 'string'
  }
  opacity: int
  position: {
    height: 'string'
    left: 'string'
    top: 'string'
    width: 'string'
  }
}

プリセット オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.VideoAnalyzerPreset の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.VideoAnalyzerPreset'
  audioLanguage: 'string'
  experimentalOptions: {
    {customized property}: 'string'
  }
  insightsToExtract: 'string'
  mode: 'string'
}

#Microsoft.Media.BuiltInStandardEncoderPreset の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.BuiltInStandardEncoderPreset'
  configurations: {
    complexity: 'string'
    interleaveOutput: 'string'
    keyFrameIntervalInSeconds: int
    maxBitrateBps: int
    maxHeight: int
    maxLayers: int
    minBitrateBps: int
    minHeight: int
    outputFormat: {
      filenamePattern: 'string'
      @odata.type: 'string'
      // For remaining properties, see Format objects
    }
  }
  presetName: 'string'
}

#Microsoft.Media.FaceDetectorPreset の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.FaceDetectorPreset'
  blurType: 'string'
  experimentalOptions: {
    {customized property}: 'string'
  }
  mode: 'string'
  resolution: 'string'
}

#Microsoft.Media.StandardEncoderPreset の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.StandardEncoderPreset'
  codecs: [
    {
      label: 'string'
      @odata.type: 'string'
      // For remaining properties, see Codec objects
    }
  ]
  filters: {
    crop: {
      height: 'string'
      left: 'string'
      top: 'string'
      width: 'string'
    }
    deinterlace: {
      mode: 'string'
      parity: 'string'
    }
    overlays: [
      {
        audioGainLevel: int
        end: 'string'
        fadeInDuration: 'string'
        fadeOutDuration: 'string'
        inputLabel: 'string'
        start: 'string'
        @odata.type: 'string'
        // For remaining properties, see Overlay objects
      }
    ]
    rotation: 'string'
  }
  formats: [
    {
      filenamePattern: 'string'
      @odata.type: 'string'
      // For remaining properties, see Format objects
    }
  ]
}

オブジェクトの書式設定

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.CmafFormat の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.CmafFormat'
  outputFiles: [
    {
      labels: [
        'string'
      ]
    }
  ]
  streamingFormat: 'string'
}

#Microsoft.Media.JpgFormat の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.JpgFormat'
}

#Microsoft.Media.PngFormat の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.PngFormat'
}

#Microsoft.Media.Mp4Format の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.Mp4Format'
  outputFiles: [
    {
      labels: [
        'string'
      ]
    }
  ]
}

#Microsoft.Media.TransportStreamFormat の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.TransportStreamFormat'
  outputFiles: [
    {
      labels: [
        'string'
      ]
    }
  ]
}

コーデック オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.AacAudio の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.AacAudio'
  bitrate: int
  channels: int
  profile: 'string'
  samplingRate: int
}

#Microsoft.Media.DDAudio の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.DDAudio'
  bitrate: int
  channels: int
  samplingRate: int
}

#Microsoft.Media.CopyAudio の場合は、次の値を使用します。

{
  @odata.type: '#Microsoft.Media.CopyAudio'
}

#Microsoft.Media.CopyVideo の場合は、次の値を使用します。

{
  @odata.type: '#Microsoft.Media.CopyVideo'
}

#Microsoft.Media.H264Video の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.H264Video'
  complexity: 'string'
  keyFrameInterval: 'string'
  layers: [
    {
      adaptiveBFrame: bool
      bFrames: int
      bitrate: int
      bufferWindow: 'string'
      crf: int
      entropyMode: 'string'
      frameRate: 'string'
      height: 'string'
      label: 'string'
      level: 'string'
      maxBitrate: int
      profile: 'string'
      referenceFrames: int
      slices: int
      width: 'string'
    }
  ]
  rateControlMode: 'string'
  sceneChangeDetection: bool
  stretchMode: 'string'
  syncMode: 'string'
}

#Microsoft.Media.H265Video の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.H265Video'
  complexity: 'string'
  keyFrameInterval: 'string'
  layers: [
    {
      adaptiveBFrame: bool
      bFrames: int
      bitrate: int
      bufferWindow: 'string'
      crf: int
      frameRate: 'string'
      height: 'string'
      label: 'string'
      level: 'string'
      maxBitrate: int
      profile: 'string'
      referenceFrames: int
      slices: int
      width: 'string'
    }
  ]
  sceneChangeDetection: bool
  stretchMode: 'string'
  syncMode: 'string'
}

#Microsoft.Media.JpgImage の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.JpgImage'
  keyFrameInterval: 'string'
  layers: [
    {
      height: 'string'
      label: 'string'
      quality: int
      width: 'string'
    }
  ]
  range: 'string'
  spriteColumn: int
  start: 'string'
  step: 'string'
  stretchMode: 'string'
  syncMode: 'string'
}

#Microsoft.Media.PngImage の場合は、次を使用します。

{
  @odata.type: '#Microsoft.Media.PngImage'
  keyFrameInterval: 'string'
  layers: [
    {
      height: 'string'
      label: 'string'
      width: 'string'
    }
  ]
  range: 'string'
  start: 'string'
  step: 'string'
  stretchMode: 'string'
  syncMode: 'string'
}

プロパティ値

Aacオーディオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.AacAudio' (必須)
ビットレート	出力エンコードされたオーディオのビットレート (ビット/秒)。	整数 (int)
チャンネル	オーディオ内のチャネルの数。	整数 (int)
プロフィール	AAC でオーディオをエンコードするときに使用するエンコード プロファイル。	「AacLc」 「HeAacV1」 「HeAacV2」
サンプリングレート	ヘルツでのエンコードに使用するサンプリング レート。	整数 (int)

AudioAnalyzerPresetExperimentalOptions (英語)

名前	説明	価値

オーディオオーバーレイ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.AudioOverlay' (必須)

ビルトインスタンダードエンコーダープリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.BuiltInStandardEncoderPreset' (必須)
構成	エンコーダーのオプションの構成設定。 構成は、ContentAwareEncoding と H265ContentAwareEncoding BuiltInStandardEncoderPreset でのみサポートされます。	プリセット構成
プリセット名	ビデオのエンコードに使用する組み込みのプリセット。	「AACGoodQualityAudio」 「アダプティブストリーミング」 「ContentAwareEncoding」 「ContentAwareEncodingExperimental」 'CopyAllBitrateNonInterleaved' 「DDGoodQualityAudio」 「H264MultipleBitrate1080p」 'H264MultipleBitrate720p' 「H264MultipleBitrateSD」 「H264シングルビットレート1080p」 「H264シングルビットレート720p」 「H264シングルビットレートSD」 「H265AdaptiveStreaming」 'H265ContentAwareEncoding' 「H265シングルビットレート1080p」 「H265シングルビットレート4K」 'H265SingleBitrate720p' (必須)

cmafフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CmafFormat' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]
ストリーミングフォーマット		「ダッシュ」 「HLS」 「HlsAndDash」

コーデック

名前	説明	価値
@odata.type	AacAudio 型の場合は 、' #Microsoft.Media.AacAudio' に設定します。 DDAudio 型の場合は 、'#Microsoft.Media.DDAudio' に設定します。 CopyAudio 型の場合は、'#Microsoft.Media.CopyAudio' に設定します。 CopyVideo 型の場合は 、'#Microsoft.Media.CopyVideo' に設定します。 H264Video 型の場合は 、'#Microsoft.Media.H264Video' に設定します。 H265Video 型の場合は 、'#Microsoft.Media.H265Video' に設定します。 JpgImage 型の場合は、'#Microsoft.Media.JpgImage' に設定します。 PngImage 型の場合は、'#Microsoft.Media.PngImage' に設定します。	'#Microsoft.Media.AacAudio' '#Microsoft.Media.CopyAudio' '#Microsoft.Media.CopyVideo' '#Microsoft.Media.DDAudio' 「#Microsoft.Media.H264Video」 「#Microsoft.Media.H265Video」 '#Microsoft.Media.JpgImage' '#Microsoft.Media.PngImage' (必須)
ラベル	コーデックの省略可能なラベル。 このラベルを使用して、多重化の動作を制御できます。	ひも

CopyAudio (オーディオをコピー)

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CopyAudio' (必須)

ビデオのコピー

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CopyVideo' (必須)

DDアウディオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.DDAudio' (必須)
ビットレート	出力エンコードされたオーディオのビットレート (ビット/秒)。	整数 (int)
チャンネル	オーディオ内のチャネルの数。	整数 (int)
サンプリングレート	ヘルツでのエンコードに使用するサンプリング レート。	整数 (int)

インターレース解除

名前	説明	価値
モード	インターレース解除モード。 既定値は AutoPixelAdaptive です。	「オートピクセルアダプティブ」 「オフ」
パリティ	インターレース解除のフィールド パリティ(既定値は Auto)。	「オート」 「ボトムフィールドファースト」 「トップフィールドファースト」

FaceDetectorプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.FaceDetectorPreset' (必須)
ブラータイプ	ぼかしの種類	「ブラック」 「ボックス」 「高い」 「低い」 「メッド」
experimentalオプション	プリセット自体で公開されていないパラメーターのキー値ペアを含むディクショナリ	FaceDetectorPresetExperimentalOptions
モード	このモードでは、1) 分析 - 検出専用の設定から選択できます。このモードでは、ビデオ全体で顔の外観をマークするメタデータ JSON ファイルが生成されます。可能な場合は、同じ人物の外観に同じ ID が割り当てられます。2) 結合 - 検出された顔をさらに編集 (ぼかし) します。 3)編集 - これにより、2パスプロセスが可能になり、検出された顔のサブセットの選択的な編集が可能になります。メタデータ ファイルは、ソース ビデオと共に、以前の分析パスと、再編集を必要とするユーザーが選択した ID のサブセットを取り込みます。	「分析」 「組み合わせた」 「編集」
解決策	ビデオを分析する最大解像度を指定します。 既定の動作は "SourceResolution" であり、分析時に入力ビデオが元の解像度で維持されます。 "StandardDefinition" を使用すると、適切な縦横比を維持しながら、入力ビデオのサイズが標準定義に変更されます。 ビデオの解像度が高い場合にのみサイズが変更されます。 たとえば、1920 x 1080 の入力は、処理の前に 640 x 360 にスケーリングされます。 "StandardDefinition" に切り替えると、高解像度ビデオの処理にかかる時間が短縮されます。 また、このコンポーネントの使用コストを削減することもできます (詳細については、 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics を参照してください)。 ただし、サイズ変更されたビデオでは、最終的に小さすぎる顔が検出されない場合があります。	'ソースレゾリューション' 'StandardDefinition'

FaceDetectorPresetExperimentalOptions

名前	説明	価値

フィルター

名前	説明	価値
実り	入力ビデオをトリミングする四角形ウィンドウのパラメーター。	長方形
インターレース解除	インターレース解除の設定。	インターレース解除
オーバーレイ	入力ビデオに適用されるオーバーレイのプロパティ。 オーディオ、画像、ビデオオーバーレイなどです。	オーバーレイ[]
自転	エンコードされる前に、入力ビデオに適用される回転 (ある場合)。 既定値は Auto です	「オート」 「なし」 '回転0' 「回転180」 「回転270」 「回転90」

フォーマット

名前	説明	価値
@odata.type	CmafFormat 型の場合は、'#Microsoft.Media.CmafFormat' に設定します。 JpgFormat 型の場合は、'#Microsoft.Media.JpgFormat' に設定します。 PngFormat 型の場合は 、'#Microsoft.Media.PngFormat' に設定します。 Mp4Format 型の場合は 、' #Microsoft.Media.Mp4Format' に設定します。 TransportStreamFormat 型の場合は、'#Microsoft.Media.TransportStreamFormat' に設定します。	'#Microsoft.Media.CmafFormat' '#Microsoft.Media.JpgFormat' '#Microsoft.Media.Mp4Format' '#Microsoft.Media.PngFormat' '#Microsoft.Media.TransportStreamFormat' (必須)
ファイル名パターン	出力ファイルの作成に使用されるファイルの名前付けパターン。 ファイル名 {Basename} - 入力ビデオ ファイルの名前を使用する拡張マクロで、次のマクロがサポートされています。 入力ビデオ ファイルのベース名 (ファイル サフィックスが含まれていない) の長さが 32 文字未満の場合は、入力ビデオ ファイルのベース名が使用されます。 入力ビデオ ファイルのベース名の長さが 32 文字を超える場合、ベース名は合計で最初の 32 文字に切り捨てられます。 {Extension} - この形式に適した拡張子。 {Label} - コーデック/レイヤーに割り当てられたラベル。 {Index} - サムネイルの一意のインデックス。 サムネイルにのみ適用されます。 {AudioStream} - 文字列 "Audio" とオーディオ ストリーム番号 (1 から始まる)。 {Bitrate} - オーディオ/ビデオビットレート (kbps)。 サムネイルには適用されません。 {Codec} - オーディオ/ビデオ コーデックの種類。 {Resolution} - ビデオの解像度。 置換されていないマクロはすべて折りたたまれて、ファイル名から削除されます。	string (必須)

H264レイヤー

名前	説明	価値
適応型Bフレーム	このレイヤーをエンコードするときにアダプティブ B フレームを使用するかどうか。 指定しない場合、ビデオ プロファイルで使用が許可されるたびにエンコーダーがオンになります。	ブール (bool)
bフレーム	このレイヤーをエンコードするときに使用する B フレームの数。 指定しない場合、エンコーダーはビデオ プロファイルとレベルに基づいて適切な番号を選択します。	整数 (int)
ビットレート	このレイヤーの生成時に入力ビデオをエンコードする平均ビットレート (ビット/秒)。 これは必須フィールドです。	int (必須)
バッファウィンドウ	VBV バッファー ウィンドウの長さ。 値は ISO 8601 形式である必要があります。 値の範囲は [0.1 - 100] 秒である必要があります。 既定値は 5 秒 (PT5S など) です。	ひも
CRFの	このレイヤーをエンコードするときに使用する CRF の値。 この設定は、ビデオ コーデックの RateControlMode が CRF モードで設定されている場合に有効になります。 CRF 値の範囲は 0 から 51 の範囲です。この値を小さくすると、ファイル サイズが大きくなると品質が向上します。 値が大きいほど圧縮率が高くなりますが、ある時点で品質の低下が見られます。 既定値は 23 です。	整数 (int)
エントロピーモード	このレイヤーに使用するエントロピー モード。 指定しない場合、エンコーダーはプロファイルとレベルに適したモードを選択します。	「カバック」 「Cavlc」
フレームレート	このレイヤーをエンコードするフレーム レート (フレーム/秒)。 この値は、M と N が整数 (30000/1001 など) である M/N の形式、または数値 (30、29.97 など) の形式にすることができます。 エンコーダーは、プロファイルとレベルに基づいて、許可されたフレーム レートに制約を適用します。 指定しない場合、エンコーダーは入力ビデオと同じフレーム レートを使用します。	ひも
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
レベル	現在、レベル 6.2 をサポートしています。 値には、Auto、または H.264 プロファイルに一致する数値を指定できます。 指定しない場合、既定値は Auto です。これにより、エンコーダーはこのレイヤーに適したレベルを選択できます。	ひも
最大ビットレート	VBV バッファーがリフィルと見なされる最大ビットレート (1 秒あたりのビット数)。 指定しない場合、既定値はビットレートと同じ値になります。	整数 (int)
プロフィール	現在、ベースライン、メイン、高、高 422、高 444 がサポートされています。 既定値は Auto です。	「オート」 「ベースライン」 「高い」 「High422」 「High444」 「メイン」
referenceフレーム	このレイヤーをエンコードするときに使用する参照フレームの数。 指定しない場合、エンコーダーはエンコーダーの複雑さの設定に基づいて適切な数を決定します。	整数 (int)
スライス	このレイヤーをエンコードするときに使用するスライスの数。 指定しない場合、既定値は 0 です。つまり、エンコーダーはフレームごとに 1 つのスライスを使用します。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

H264ビデオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.H264Video' (必須)
複雑さ	エンコード設定を選択する方法をエンコーダーに指示します。 既定値は Balanced です。	「バランス」 「品質」 「スピード」
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 H.264 レイヤーのコレクション。	H264レイヤー[]
rateControlMode (レートコントロールモード)	ビデオレート制御モード	「ABR」 「CBR」 「CRF」
sceneChangeDetection	エンコーダーがシーンの変更時にキー フレームを挿入する必要があるかどうか。 指定しない場合、既定値は false です。 このフラグは、エンコーダーが 1 つの出力ビデオを生成するように構成されている場合にのみ true に設定する必要があります。	ブール (bool)
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

H265レイヤー

名前	説明	価値
適応型Bフレーム	このレイヤーをエンコードするときにアダプティブ B フレームを使用するかどうかを指定します。 指定しない場合、ビデオ プロファイルで使用が許可されるたびにエンコーダーがオンになります。	ブール (bool)
bフレーム	このレイヤーをエンコードするときに使用する B フレームの数。 指定しない場合、エンコーダーはビデオ プロファイルとレベルに基づいて適切な番号を選択します。	整数 (int)
ビットレート	このレイヤーの生成時に入力ビデオをエンコードする平均ビットレート (ビット/秒)。 たとえば、3000Kbps または 3 Mbps のターゲット ビットレートは、この値が 30000000 である必要があることを意味します。これは必須フィールドです。	int (必須)
バッファウィンドウ	VBV バッファー ウィンドウの長さ。 値は ISO 8601 形式である必要があります。 値の範囲は [0.1 - 100] 秒である必要があります。 既定値は 5 秒 (PT5S など) です。	ひも
CRFの	このレイヤーをエンコードするときに使用する CRF の値。 この設定は、ビデオ コーデックの RateControlMode が CRF モードで設定されている場合に有効になります。 CRF 値の範囲は 0 から 51 の範囲です。この値を小さくすると、ファイル サイズが大きくなると品質が向上します。 値が大きいほど圧縮率が高くなりますが、ある時点で品質の低下が見られます。 既定値は 28 です。	整数 (int)
フレームレート	このレイヤーをエンコードするフレーム レート (フレーム/秒)。 この値は、M と N が整数 (30000/1001 など) である M/N の形式、または数値 (30、29.97 など) の形式にすることができます。 エンコーダーは、プロファイルとレベルに基づいて、許可されたフレーム レートに制約を適用します。 指定しない場合、エンコーダーは入力ビデオと同じフレーム レートを使用します。	ひも
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
レベル	現在、レベル 6.2 をサポートしています。 値には、Auto、または H.265 プロファイルに一致する数値を指定できます。 指定しない場合、既定値は Auto です。これにより、エンコーダーはこのレイヤーに適したレベルを選択できます。	ひも
最大ビットレート	VBV バッファーがリフィルと見なされる最大ビットレート (1 秒あたりのビット数)。 指定しない場合、既定値はビットレートと同じ値になります。	整数 (int)
プロフィール	現在、メインをサポートしています。 既定値は Auto です。	「オート」 「メイン」 「メイン10」
referenceフレーム	このレイヤーをエンコードするときに使用する参照フレームの数。 指定しない場合、エンコーダーはエンコーダーの複雑さの設定に基づいて適切な数を決定します。	整数 (int)
スライス	このレイヤーをエンコードするときに使用するスライスの数。 指定しない場合、既定値は 0 です。つまり、エンコーダーはフレームごとに 1 つのスライスを使用します。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

H265ビデオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.H265Video' (必須)
複雑さ	エンコード設定を選択する方法をエンコーダーに指示します。 品質により、圧縮率が高くなりますが、コストが高くなり、コンピューティング時間が長くなります。 速度は比較的大きなファイルを生成しますが、より高速で経済的です。 既定値は Balanced です。	「バランス」 「品質」 「スピード」
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 H.265 レイヤーのコレクション。	H265レイヤー[]
sceneChangeDetection	エンコーダーがシーンの変更時にキー フレームを挿入するかどうかを指定します。 指定しない場合、既定値は false です。 このフラグは、エンコーダーが 1 つの出力ビデオを生成するように構成されている場合にのみ true に設定する必要があります。	ブール (bool)
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

jpgフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.JpgFormat' (必須)

jpg画像

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.JpgImage' (必須)
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 JPEG 画像レイヤーのコレクション。	Jpgレイヤー[]
範囲	サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対的な位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止するPT5M30S)、またはフレーム数 (たとえば、開始時刻のフレームから 300 番目のフレームで停止する場合は 300) です。この値が 1 の場合は、開始時刻に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100%であり、ストリームの末尾で停止することを意味します。	ひも
スプライトカラム	サムネイル スプライト 画像で使用される列の数を設定します。 行数が自動的に計算され、スプライト内の各サムネイルの座標マッピングを使用して VTT ファイルが生成されます。 注: この値は正の整数にする必要があり、出力画像の解像度が JPEG の最大ピクセル解像度制限 65535x65535 を超えないように、適切な値をお勧めします。	整数 (int)
始める	サムネイルの生成を開始する位置を入力ビデオ内の位置。 値は ISO 8601 形式 (たとえば、PT05S は 5 秒から始まる)、フレーム数 (たとえば、10 番目のフレームから開始する場合は 10)、ストリームの継続時間に対する相対値 (たとえば、10% は 10% のストリーム継続時間) にすることができます。 また、マクロ {Best} もサポートしています。このマクロは、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示し、ステップと範囲の他の設定に関係なく、サムネイルを 1 つだけ生成します。 既定値はマクロ {Best} です。	string (必須)
歩	サムネイルが生成される間隔。 値は ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、またはフレーム数 (たとえば、30 フレームごとに 1 つのイメージの場合は 30)、またはストリームの継続時間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10%) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは限りません。 これは、最初の出力として開始時刻とステップ位置の間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10%であるため、ストリームの継続時間が長い場合、最初に生成されたサムネイルは、開始時刻に指定されたものから遠く離れている可能性があります。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ]に適切な値を選択し、開始時刻に必要なサムネイルが 1 つだけの場合は Range 値を 1 に設定します。	ひも
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

Jpgレイヤー

名前	説明	価値
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
品質	JPEG 出力の圧縮品質。 範囲は 0 ~ 100 で、既定値は 70 です。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

マイクロソフト.メディア/mediaServices/transforms

名前	説明	価値
名前	リソース名	string (必須)
親	Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「親リソースの外部 子リソース」を参照してください。	種類のリソースのシンボリック名: mediaServices
プロパティ	リソースのプロパティ。	トランスフォームプロパティ

MP4フォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.Mp4Format' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]

出力ファイル

名前	説明	価値
ラベル	エンコーダーがビデオとオーディオを出力ファイルに多重化する方法を説明するラベルの一覧。 たとえば、エンコーダーがラベル v1 と v2 を持つ 2 つのビデオ レイヤーとラベル a1 を持つ 1 つのオーディオ レイヤーを生成している場合、'[v1, a1]' のような配列は、v1 で表されるビデオ トラックと a1 で表されるオーディオ トラックを含む出力ファイルを生成するようにエンコーダーに指示します。	string[] (必須)

オーバーレイ

名前	説明	価値
@odata.type	AudioOverlay 型の場合は、'#Microsoft.Media.AudioOverlay' に設定します。 VideoOverlay 型の場合は、'#Microsoft.Media.VideoOverlay' に設定します。	'#Microsoft.Media.AudioOverlay' '#Microsoft.Media.VideoOverlay' (必須)
オーディオゲインレベル	オーバーレイ内のオーディオのゲイン レベル。 値の範囲は [0, 1.0] である必要があります。 既定値は 1.0 です。	整数 (int)
終了	オーバーレイが終了する入力ビデオを参照する終了位置。 値は ISO 8601 形式である必要があります。 たとえば、PT30S は、入力ビデオに 30 秒でオーバーレイを終了します。 指定しない場合、または値が入力ビデオの再生時間を超える場合、オーバーレイメディアの再生時間が入力ビデオの再生時間よりも長い場合、オーバーレイは入力ビデオの最後まで適用されます。それ以外の場合、オーバーレイはオーバーレイメディアの継続時間まで続きます。	ひも
フェードインデュレーション	オーバーレイが入力ビデオにフェードインする期間。 値は ISO 8601 期間形式である必要があります。 指定しない場合、既定の動作はフェードインなし (PT0S と同じ) になります。	ひも
fadeOutデュレーション	オーバーレイが入力ビデオからフェードアウトする期間。 値は ISO 8601 期間形式である必要があります。 指定しない場合、既定の動作はフェード アウトなし (PT0S と同じ) になります。	ひも
入力ラベル	オーバーレイとして使用するジョブ入力のラベル。 入力では、1 つのファイルを正確に指定する必要があります。 JPG、PNG、GIF、BMP 形式の画像ファイル、またはオーディオ ファイル (WAV、MP3、WMA、M4A ファイルなど)、ビデオ ファイルを指定できます。 サポートされているオーディオおよびビデオ ファイル形式の完全な一覧については、 https://aka.ms/mesformats を参照してください。	string (必須)
始める	オーバーレイが開始される入力ビデオを参照する開始位置。 値は ISO 8601 形式である必要があります。 たとえば、PT05S は、入力ビデオに 5 秒でオーバーレイを開始します。 指定しない場合、オーバーレイは入力ビデオの先頭から開始されます。	ひも

PNGフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.PngFormat' (必須)

Png画像

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.PngImage' (必須)
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 PNG イメージ レイヤーのコレクション。	PNGレイヤー[]
範囲	サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対的な位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止するPT5M30S)、またはフレーム数 (たとえば、開始時刻のフレームから 300 番目のフレームで停止する場合は 300) です。この値が 1 の場合は、開始時刻に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100%であり、ストリームの末尾で停止することを意味します。	ひも
始める	サムネイルの生成を開始する位置を入力ビデオ内の位置。 値は ISO 8601 形式 (たとえば、PT05S は 5 秒から始まる)、フレーム数 (たとえば、10 番目のフレームから開始する場合は 10)、ストリームの継続時間に対する相対値 (たとえば、10% は 10% のストリーム継続時間) にすることができます。 また、マクロ {Best} もサポートしています。このマクロは、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示し、ステップと範囲の他の設定に関係なく、サムネイルを 1 つだけ生成します。 既定値はマクロ {Best} です。	string (必須)
歩	サムネイルが生成される間隔。 値は ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、またはフレーム数 (たとえば、30 フレームごとに 1 つのイメージの場合は 30)、またはストリームの継続時間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10%) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは限りません。 これは、最初の出力として開始時刻とステップ位置の間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10%であるため、ストリームの継続時間が長い場合、最初に生成されたサムネイルは、開始時刻に指定されたものから遠く離れている可能性があります。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ]に適切な値を選択し、開始時刻に必要なサムネイルが 1 つだけの場合は Range 値を 1 に設定します。	ひも
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

Pngレイヤー

名前	説明	価値
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

プリセット

名前	説明	価値
@odata.type	VideoAnalyzerPreset 型の場合は、'#Microsoft.Media.VideoAnalyzerPreset' に設定します。 BuiltInStandardEncoderPreset 型の場合は、'#Microsoft.Media.BuiltInStandardEncoderPreset' に設定します。 FaceDetectorPreset 型の場合は、'#Microsoft.Media.FaceDetectorPreset' に設定します。 StandardEncoderPreset 型の場合、'#Microsoft.Media.StandardEncoderPreset' に設定します。	'#Microsoft.Media.BuiltInStandardEncoderPreset' '#Microsoft.Media.FaceDetectorPreset' '#Microsoft.Media.StandardEncoderPreset' '#Microsoft.Media.VideoAnalyzerPreset' (必須)

プリセット構成

名前	説明	価値
複雑さ	速度と品質のバランスを制御するようにエンコーダー設定を構成できます。 例: [複雑さ] を [速度] に設定すると、エンコードが高速化されますが、圧縮効率は低下します。	「バランス」 「品質」 「スピード」
インターリーブ出力	オーディオとビデオをコンテナー形式で格納する方法を制御する出力のインターリーブ モードを設定します。 例: InterleavedOutput を NonInterleavedOutput に設定して、オーディオのみの出力とビデオのみの出力を別々の MP4 ファイルに生成します。	'インターリーブ出力' 'NonInterleavedOutput'
キーフレーム間隔 (秒)	キー フレームの間隔 (秒単位)。 例: KeyFrameIntervalInSeconds を 2 に設定して、一部のプレイヤーの再生バッファリングを減らします。	整数 (int)
最大ビットレートBps	最大ビットレート (1 秒あたりのビット数) (トップ ビデオ レイヤーのしきい値)。 例: MaxBitrateBps を 60000000 に設定して、複雑度の高いコンテンツに対して非常に高いビットレート出力が生成されないようにします。	整数 (int)
マックスハイト	出力ビデオ レイヤーの最大高さ。 例: MaxHeight を 720 に設定すると、入力が 4K であっても最大 720P の出力レイヤーが生成されます。	整数 (int)
マックスレイヤー	出力ビデオ レイヤーの最大数。 例: MaxLayers を 4 に設定して、エンコード ジョブの全体的なコストを制御するために最大 4 つの出力レイヤーが生成されるようにします。	整数 (int)
minBitrateBps(分ビットレートBps)	最小ビットレート (1 秒あたりのビット数) (下部のビデオ レイヤーのしきい値)。 例: MinBitrateBps を 200000 に設定して、ネットワーク帯域幅の低いユーザーを対象とする下位レイヤーを設定します。	整数 (int)
最小の高さ	出力ビデオ レイヤーの最小高さ。 例: MinHeight を 360 に設定して、180P のような解像度の小さい出力レイヤーを回避します。	整数 (int)
出力フォーマット	出力形式の種類を設定します。 現在の実装では、Mp4Format と CmafFormat のみがサポートされています。 例: OutputFormat を CmafFormat に設定して、ストリーミング用のオーディオ/ビデオ ストリームバリアントとマニフェスト ファイルを生成します。	形式

長方形

名前	説明	価値
高さ	四角形領域の高さ (ピクセル単位)。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
左	左余白からのピクセル数。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
ページのトップへ	上余白からのピクセル数。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
幅	四角形領域の幅 (ピクセル単位)。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも

StandardEncoderプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.StandardEncoderPreset' (必須)
コーデック	入力ビデオをエンコードするときに使用するコーデックの一覧。	Codec[] (必須)
フィルター	エンコードの前に入力メディアに適用される 1 つ以上のフィルター処理操作。	フィルター
形式	エンコーダーによって生成される出力の一覧。	Format[] (必須)

トランスフォーム出力

名前	説明	価値
オンエラー	変換では、複数の出力を定義できます。 このプロパティは、1 つの出力が失敗したときにサービスが実行する必要がある処理を定義します。これは、他の出力の生成を続行するか、他の出力を停止します。 ジョブの全体的な状態には、"ContinueJob" で指定された出力のエラーは反映されません。 既定値は 'StopProcessingJob' です。	「ContinueJob」 'StopProcessingJob'
プリセット	ソース ファイルから分析情報を変更、トランスコード、または抽出して出力を生成するために使用される操作を記述するプリセット。	プリセット (必須)
relativePriority (相対優先度)	Transform 内の TransformOutput の相対優先度を設定します。 これにより、サービスが TransformOutputs の処理に使用する優先順位が設定されます。 既定の優先度は Normal です。	「高い」 「低い」 「普通」

トランスフォームプロパティ

名前	説明	価値
説明	Transform の詳細な説明 (省略可能)。	ひも
出力	Transform が生成する必要がある 1 つ以上の TransformOutput の配列。	TransformOutput[] (必須)

トランスポートストリームフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.TransportStreamFormat' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]

VideoAnalyzerプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.VideoAnalyzerPreset' (必須)
オーディオ言語	BCP-47 形式の 'language tag-region' (例: 'en-US') を使用した入力内のオーディオ ペイロードの言語。 コンテンツの言語がわかっている場合は、それを指定することをお勧めします。 言語の自動検出は基本モードに含まれていないため、AudioAnalysisMode::Basic では言語を明示的に指定する必要があります。 言語が指定されていない場合、または null に設定されている場合、自動言語検出では、検出された最初の言語が選択され、ファイルの期間中、選択した言語で処理されます。 現在、最初の言語が検出された後の言語間の動的な切り替えはサポートされていません。 自動検出は、明確に識別可能な音声によるオーディオ録音に最適です。 自動検出で言語が見つからない場合、文字起こしは 'en-US' にフォールバックします。サポートされている言語の一覧については、以下を参照してください。 https://go.microsoft.com/fwlink/?linkid=2109463	ひも
experimentalオプション	プリセット自体で公開されていないパラメーターのキー値ペアを含むディクショナリ	AudioAnalyzerPresetExperimentalOptions (英語)
insightsToExtract	サービスで生成する分析情報の種類を定義します。 使用できる値は、"AudioInsightsOnly"、"VideoInsightsOnly"、"AllInsights" です。 既定値は AllInsights です。 これを AllInsights に設定し、入力がオーディオのみの場合は、オーディオ分析情報のみが生成されます。 同様に、入力がビデオのみの場合は、ビデオ分析情報のみが生成されます。 入力の一部がビデオのみであることが予想される場合は、AudioInsightsOnly を使用しないことをお勧めします。または、入力の一部がオーディオのみであることが予想される場合は、VideoInsightsOnly を使用します。 このような状態のジョブはエラーになります。	「オールインサイツ」 「AudioInsightsOnly」 「VideoInsightsOnly」
モード	実行するオーディオ分析操作のセットを決定します。 指定しない場合は、Standard AudioAnalysisMode が選択されます。	「ベーシック」 「スタンダード」

ビデオオーバーレイ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.VideoOverlay' (必須)
クロップレクタングル	オーバーレイの画像またはビデオをトリミングするために使用する省略可能な四角形のウィンドウ。	長方形
不透明	オーバーレイの不透明度。 これは、[0 - 1.0] の範囲内の値です。 既定値は 1.0 で、オーバーレイが不透明であることを意味します。	整数 (int)
立場	オーバーレイが適用される入力ビデオ内の場所。	長方形

ARM テンプレート リソース定義

mediaServices/transforms リソースの種類は、次を対象とする操作でデプロイできます。

• リソース グループ - リソース グループのデプロイ コマンドを参照する

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Media/mediaServices/transforms リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Media/mediaServices/transforms",
  "apiVersion": "2022-05-01-preview",
  "name": "string",
  "properties": {
    "description": "string",
    "outputs": [
      {
        "onError": "string",
        "preset": {
          "@odata.type": "string"
          // For remaining properties, see Preset objects
        },
        "relativePriority": "string"
      }
    ]
  }
}

オーバーレイ オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.AudioOverlay の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.AudioOverlay"
}

#Microsoft.Media.VideoOverlay の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.VideoOverlay",
  "cropRectangle": {
    "height": "string",
    "left": "string",
    "top": "string",
    "width": "string"
  },
  "opacity": "int",
  "position": {
    "height": "string",
    "left": "string",
    "top": "string",
    "width": "string"
  }
}

プリセット オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.VideoAnalyzerPreset の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.VideoAnalyzerPreset",
  "audioLanguage": "string",
  "experimentalOptions": {
    "{customized property}": "string"
  },
  "insightsToExtract": "string",
  "mode": "string"
}

#Microsoft.Media.BuiltInStandardEncoderPreset の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
  "configurations": {
    "complexity": "string",
    "interleaveOutput": "string",
    "keyFrameIntervalInSeconds": "int",
    "maxBitrateBps": "int",
    "maxHeight": "int",
    "maxLayers": "int",
    "minBitrateBps": "int",
    "minHeight": "int",
    "outputFormat": {
      "filenamePattern": "string",
      "@odata.type": "string"
      // For remaining properties, see Format objects
    }
  },
  "presetName": "string"
}

#Microsoft.Media.FaceDetectorPreset の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.FaceDetectorPreset",
  "blurType": "string",
  "experimentalOptions": {
    "{customized property}": "string"
  },
  "mode": "string",
  "resolution": "string"
}

#Microsoft.Media.StandardEncoderPreset の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.StandardEncoderPreset",
  "codecs": [ {
    "label": "string",
    "@odata.type": "string"
    // For remaining properties, see Codec objects
  } ],
  "filters": {
    "crop": {
      "height": "string",
      "left": "string",
      "top": "string",
      "width": "string"
    },
    "deinterlace": {
      "mode": "string",
      "parity": "string"
    },
    "overlays": [ {
      "audioGainLevel": "int",
      "end": "string",
      "fadeInDuration": "string",
      "fadeOutDuration": "string",
      "inputLabel": "string",
      "start": "string",
      "@odata.type": "string"
      // For remaining properties, see Overlay objects
    } ],
    "rotation": "string"
  },
  "formats": [ {
    "filenamePattern": "string",
    "@odata.type": "string"
    // For remaining properties, see Format objects
  } ]
}

オブジェクトの書式設定

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.CmafFormat の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.CmafFormat",
  "outputFiles": [
    {
      "labels": [ "string" ]
    }
  ],
  "streamingFormat": "string"
}

#Microsoft.Media.JpgFormat の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.JpgFormat"
}

#Microsoft.Media.PngFormat の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.PngFormat"
}

#Microsoft.Media.Mp4Format の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.Mp4Format",
  "outputFiles": [
    {
      "labels": [ "string" ]
    }
  ]
}

#Microsoft.Media.TransportStreamFormat の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.TransportStreamFormat",
  "outputFiles": [
    {
      "labels": [ "string" ]
    }
  ]
}

コーデック オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.AacAudio の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.AacAudio",
  "bitrate": "int",
  "channels": "int",
  "profile": "string",
  "samplingRate": "int"
}

#Microsoft.Media.DDAudio の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.DDAudio",
  "bitrate": "int",
  "channels": "int",
  "samplingRate": "int"
}

#Microsoft.Media.CopyAudio の場合は、次の値を使用します。

{
  "@odata.type": "#Microsoft.Media.CopyAudio"
}

#Microsoft.Media.CopyVideo の場合は、次の値を使用します。

{
  "@odata.type": "#Microsoft.Media.CopyVideo"
}

#Microsoft.Media.H264Video の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.H264Video",
  "complexity": "string",
  "keyFrameInterval": "string",
  "layers": [
    {
      "adaptiveBFrame": "bool",
      "bFrames": "int",
      "bitrate": "int",
      "bufferWindow": "string",
      "crf": "int",
      "entropyMode": "string",
      "frameRate": "string",
      "height": "string",
      "label": "string",
      "level": "string",
      "maxBitrate": "int",
      "profile": "string",
      "referenceFrames": "int",
      "slices": "int",
      "width": "string"
    }
  ],
  "rateControlMode": "string",
  "sceneChangeDetection": "bool",
  "stretchMode": "string",
  "syncMode": "string"
}

#Microsoft.Media.H265Video の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.H265Video",
  "complexity": "string",
  "keyFrameInterval": "string",
  "layers": [
    {
      "adaptiveBFrame": "bool",
      "bFrames": "int",
      "bitrate": "int",
      "bufferWindow": "string",
      "crf": "int",
      "frameRate": "string",
      "height": "string",
      "label": "string",
      "level": "string",
      "maxBitrate": "int",
      "profile": "string",
      "referenceFrames": "int",
      "slices": "int",
      "width": "string"
    }
  ],
  "sceneChangeDetection": "bool",
  "stretchMode": "string",
  "syncMode": "string"
}

#Microsoft.Media.JpgImage の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.JpgImage",
  "keyFrameInterval": "string",
  "layers": [
    {
      "height": "string",
      "label": "string",
      "quality": "int",
      "width": "string"
    }
  ],
  "range": "string",
  "spriteColumn": "int",
  "start": "string",
  "step": "string",
  "stretchMode": "string",
  "syncMode": "string"
}

#Microsoft.Media.PngImage の場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Media.PngImage",
  "keyFrameInterval": "string",
  "layers": [
    {
      "height": "string",
      "label": "string",
      "width": "string"
    }
  ],
  "range": "string",
  "start": "string",
  "step": "string",
  "stretchMode": "string",
  "syncMode": "string"
}

プロパティ値

Aacオーディオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.AacAudio' (必須)
ビットレート	出力エンコードされたオーディオのビットレート (ビット/秒)。	整数 (int)
チャンネル	オーディオ内のチャネルの数。	整数 (int)
プロフィール	AAC でオーディオをエンコードするときに使用するエンコード プロファイル。	「AacLc」 「HeAacV1」 「HeAacV2」
サンプリングレート	ヘルツでのエンコードに使用するサンプリング レート。	整数 (int)

AudioAnalyzerPresetExperimentalOptions (英語)

名前	説明	価値

オーディオオーバーレイ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.AudioOverlay' (必須)

ビルトインスタンダードエンコーダープリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.BuiltInStandardEncoderPreset' (必須)
構成	エンコーダーのオプションの構成設定。 構成は、ContentAwareEncoding と H265ContentAwareEncoding BuiltInStandardEncoderPreset でのみサポートされます。	プリセット構成
プリセット名	ビデオのエンコードに使用する組み込みのプリセット。	「AACGoodQualityAudio」 「アダプティブストリーミング」 「ContentAwareEncoding」 「ContentAwareEncodingExperimental」 'CopyAllBitrateNonInterleaved' 「DDGoodQualityAudio」 「H264MultipleBitrate1080p」 'H264MultipleBitrate720p' 「H264MultipleBitrateSD」 「H264シングルビットレート1080p」 「H264シングルビットレート720p」 「H264シングルビットレートSD」 「H265AdaptiveStreaming」 'H265ContentAwareEncoding' 「H265シングルビットレート1080p」 「H265シングルビットレート4K」 'H265SingleBitrate720p' (必須)

cmafフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CmafFormat' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]
ストリーミングフォーマット		「ダッシュ」 「HLS」 「HlsAndDash」

コーデック

名前	説明	価値
@odata.type	AacAudio 型の場合は 、' #Microsoft.Media.AacAudio' に設定します。 DDAudio 型の場合は 、'#Microsoft.Media.DDAudio' に設定します。 CopyAudio 型の場合は、'#Microsoft.Media.CopyAudio' に設定します。 CopyVideo 型の場合は 、'#Microsoft.Media.CopyVideo' に設定します。 H264Video 型の場合は 、'#Microsoft.Media.H264Video' に設定します。 H265Video 型の場合は 、'#Microsoft.Media.H265Video' に設定します。 JpgImage 型の場合は、'#Microsoft.Media.JpgImage' に設定します。 PngImage 型の場合は、'#Microsoft.Media.PngImage' に設定します。	'#Microsoft.Media.AacAudio' '#Microsoft.Media.CopyAudio' '#Microsoft.Media.CopyVideo' '#Microsoft.Media.DDAudio' 「#Microsoft.Media.H264Video」 「#Microsoft.Media.H265Video」 '#Microsoft.Media.JpgImage' '#Microsoft.Media.PngImage' (必須)
ラベル	コーデックの省略可能なラベル。 このラベルを使用して、多重化の動作を制御できます。	ひも

CopyAudio (オーディオをコピー)

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CopyAudio' (必須)

ビデオのコピー

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CopyVideo' (必須)

DDアウディオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.DDAudio' (必須)
ビットレート	出力エンコードされたオーディオのビットレート (ビット/秒)。	整数 (int)
チャンネル	オーディオ内のチャネルの数。	整数 (int)
サンプリングレート	ヘルツでのエンコードに使用するサンプリング レート。	整数 (int)

インターレース解除

名前	説明	価値
モード	インターレース解除モード。 既定値は AutoPixelAdaptive です。	「オートピクセルアダプティブ」 「オフ」
パリティ	インターレース解除のフィールド パリティ(既定値は Auto)。	「オート」 「ボトムフィールドファースト」 「トップフィールドファースト」

FaceDetectorプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.FaceDetectorPreset' (必須)
ブラータイプ	ぼかしの種類	「ブラック」 「ボックス」 「高い」 「低い」 「メッド」
experimentalオプション	プリセット自体で公開されていないパラメーターのキー値ペアを含むディクショナリ	FaceDetectorPresetExperimentalOptions
モード	このモードでは、1) 分析 - 検出専用の設定から選択できます。このモードでは、ビデオ全体で顔の外観をマークするメタデータ JSON ファイルが生成されます。可能な場合は、同じ人物の外観に同じ ID が割り当てられます。2) 結合 - 検出された顔をさらに編集 (ぼかし) します。 3)編集 - これにより、2パスプロセスが可能になり、検出された顔のサブセットの選択的な編集が可能になります。メタデータ ファイルは、ソース ビデオと共に、以前の分析パスと、再編集を必要とするユーザーが選択した ID のサブセットを取り込みます。	「分析」 「組み合わせた」 「編集」
解決策	ビデオを分析する最大解像度を指定します。 既定の動作は "SourceResolution" であり、分析時に入力ビデオが元の解像度で維持されます。 "StandardDefinition" を使用すると、適切な縦横比を維持しながら、入力ビデオのサイズが標準定義に変更されます。 ビデオの解像度が高い場合にのみサイズが変更されます。 たとえば、1920 x 1080 の入力は、処理の前に 640 x 360 にスケーリングされます。 "StandardDefinition" に切り替えると、高解像度ビデオの処理にかかる時間が短縮されます。 また、このコンポーネントの使用コストを削減することもできます (詳細については、 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics を参照してください)。 ただし、サイズ変更されたビデオでは、最終的に小さすぎる顔が検出されない場合があります。	'ソースレゾリューション' 'StandardDefinition'

FaceDetectorPresetExperimentalOptions

名前	説明	価値

フィルター

名前	説明	価値
実り	入力ビデオをトリミングする四角形ウィンドウのパラメーター。	長方形
インターレース解除	インターレース解除の設定。	インターレース解除
オーバーレイ	入力ビデオに適用されるオーバーレイのプロパティ。 オーディオ、画像、ビデオオーバーレイなどです。	オーバーレイ[]
自転	エンコードされる前に、入力ビデオに適用される回転 (ある場合)。 既定値は Auto です	「オート」 「なし」 '回転0' 「回転180」 「回転270」 「回転90」

フォーマット

名前	説明	価値
@odata.type	CmafFormat 型の場合は、'#Microsoft.Media.CmafFormat' に設定します。 JpgFormat 型の場合は、'#Microsoft.Media.JpgFormat' に設定します。 PngFormat 型の場合は 、'#Microsoft.Media.PngFormat' に設定します。 Mp4Format 型の場合は 、' #Microsoft.Media.Mp4Format' に設定します。 TransportStreamFormat 型の場合は、'#Microsoft.Media.TransportStreamFormat' に設定します。	'#Microsoft.Media.CmafFormat' '#Microsoft.Media.JpgFormat' '#Microsoft.Media.Mp4Format' '#Microsoft.Media.PngFormat' '#Microsoft.Media.TransportStreamFormat' (必須)
ファイル名パターン	出力ファイルの作成に使用されるファイルの名前付けパターン。 ファイル名 {Basename} - 入力ビデオ ファイルの名前を使用する拡張マクロで、次のマクロがサポートされています。 入力ビデオ ファイルのベース名 (ファイル サフィックスが含まれていない) の長さが 32 文字未満の場合は、入力ビデオ ファイルのベース名が使用されます。 入力ビデオ ファイルのベース名の長さが 32 文字を超える場合、ベース名は合計で最初の 32 文字に切り捨てられます。 {Extension} - この形式に適した拡張子。 {Label} - コーデック/レイヤーに割り当てられたラベル。 {Index} - サムネイルの一意のインデックス。 サムネイルにのみ適用されます。 {AudioStream} - 文字列 "Audio" とオーディオ ストリーム番号 (1 から始まる)。 {Bitrate} - オーディオ/ビデオビットレート (kbps)。 サムネイルには適用されません。 {Codec} - オーディオ/ビデオ コーデックの種類。 {Resolution} - ビデオの解像度。 置換されていないマクロはすべて折りたたまれて、ファイル名から削除されます。	string (必須)

H264レイヤー

名前	説明	価値
適応型Bフレーム	このレイヤーをエンコードするときにアダプティブ B フレームを使用するかどうか。 指定しない場合、ビデオ プロファイルで使用が許可されるたびにエンコーダーがオンになります。	ブール (bool)
bフレーム	このレイヤーをエンコードするときに使用する B フレームの数。 指定しない場合、エンコーダーはビデオ プロファイルとレベルに基づいて適切な番号を選択します。	整数 (int)
ビットレート	このレイヤーの生成時に入力ビデオをエンコードする平均ビットレート (ビット/秒)。 これは必須フィールドです。	int (必須)
バッファウィンドウ	VBV バッファー ウィンドウの長さ。 値は ISO 8601 形式である必要があります。 値の範囲は [0.1 - 100] 秒である必要があります。 既定値は 5 秒 (PT5S など) です。	ひも
CRFの	このレイヤーをエンコードするときに使用する CRF の値。 この設定は、ビデオ コーデックの RateControlMode が CRF モードで設定されている場合に有効になります。 CRF 値の範囲は 0 から 51 の範囲です。この値を小さくすると、ファイル サイズが大きくなると品質が向上します。 値が大きいほど圧縮率が高くなりますが、ある時点で品質の低下が見られます。 既定値は 23 です。	整数 (int)
エントロピーモード	このレイヤーに使用するエントロピー モード。 指定しない場合、エンコーダーはプロファイルとレベルに適したモードを選択します。	「カバック」 「Cavlc」
フレームレート	このレイヤーをエンコードするフレーム レート (フレーム/秒)。 この値は、M と N が整数 (30000/1001 など) である M/N の形式、または数値 (30、29.97 など) の形式にすることができます。 エンコーダーは、プロファイルとレベルに基づいて、許可されたフレーム レートに制約を適用します。 指定しない場合、エンコーダーは入力ビデオと同じフレーム レートを使用します。	ひも
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
レベル	現在、レベル 6.2 をサポートしています。 値には、Auto、または H.264 プロファイルに一致する数値を指定できます。 指定しない場合、既定値は Auto です。これにより、エンコーダーはこのレイヤーに適したレベルを選択できます。	ひも
最大ビットレート	VBV バッファーがリフィルと見なされる最大ビットレート (1 秒あたりのビット数)。 指定しない場合、既定値はビットレートと同じ値になります。	整数 (int)
プロフィール	現在、ベースライン、メイン、高、高 422、高 444 がサポートされています。 既定値は Auto です。	「オート」 「ベースライン」 「高い」 「High422」 「High444」 「メイン」
referenceフレーム	このレイヤーをエンコードするときに使用する参照フレームの数。 指定しない場合、エンコーダーはエンコーダーの複雑さの設定に基づいて適切な数を決定します。	整数 (int)
スライス	このレイヤーをエンコードするときに使用するスライスの数。 指定しない場合、既定値は 0 です。つまり、エンコーダーはフレームごとに 1 つのスライスを使用します。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

H264ビデオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.H264Video' (必須)
複雑さ	エンコード設定を選択する方法をエンコーダーに指示します。 既定値は Balanced です。	「バランス」 「品質」 「スピード」
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 H.264 レイヤーのコレクション。	H264レイヤー[]
rateControlMode (レートコントロールモード)	ビデオレート制御モード	「ABR」 「CBR」 「CRF」
sceneChangeDetection	エンコーダーがシーンの変更時にキー フレームを挿入する必要があるかどうか。 指定しない場合、既定値は false です。 このフラグは、エンコーダーが 1 つの出力ビデオを生成するように構成されている場合にのみ true に設定する必要があります。	ブール (bool)
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

H265レイヤー

名前	説明	価値
適応型Bフレーム	このレイヤーをエンコードするときにアダプティブ B フレームを使用するかどうかを指定します。 指定しない場合、ビデオ プロファイルで使用が許可されるたびにエンコーダーがオンになります。	ブール (bool)
bフレーム	このレイヤーをエンコードするときに使用する B フレームの数。 指定しない場合、エンコーダーはビデオ プロファイルとレベルに基づいて適切な番号を選択します。	整数 (int)
ビットレート	このレイヤーの生成時に入力ビデオをエンコードする平均ビットレート (ビット/秒)。 たとえば、3000Kbps または 3 Mbps のターゲット ビットレートは、この値が 30000000 である必要があることを意味します。これは必須フィールドです。	int (必須)
バッファウィンドウ	VBV バッファー ウィンドウの長さ。 値は ISO 8601 形式である必要があります。 値の範囲は [0.1 - 100] 秒である必要があります。 既定値は 5 秒 (PT5S など) です。	ひも
CRFの	このレイヤーをエンコードするときに使用する CRF の値。 この設定は、ビデオ コーデックの RateControlMode が CRF モードで設定されている場合に有効になります。 CRF 値の範囲は 0 から 51 の範囲です。この値を小さくすると、ファイル サイズが大きくなると品質が向上します。 値が大きいほど圧縮率が高くなりますが、ある時点で品質の低下が見られます。 既定値は 28 です。	整数 (int)
フレームレート	このレイヤーをエンコードするフレーム レート (フレーム/秒)。 この値は、M と N が整数 (30000/1001 など) である M/N の形式、または数値 (30、29.97 など) の形式にすることができます。 エンコーダーは、プロファイルとレベルに基づいて、許可されたフレーム レートに制約を適用します。 指定しない場合、エンコーダーは入力ビデオと同じフレーム レートを使用します。	ひも
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
レベル	現在、レベル 6.2 をサポートしています。 値には、Auto、または H.265 プロファイルに一致する数値を指定できます。 指定しない場合、既定値は Auto です。これにより、エンコーダーはこのレイヤーに適したレベルを選択できます。	ひも
最大ビットレート	VBV バッファーがリフィルと見なされる最大ビットレート (1 秒あたりのビット数)。 指定しない場合、既定値はビットレートと同じ値になります。	整数 (int)
プロフィール	現在、メインをサポートしています。 既定値は Auto です。	「オート」 「メイン」 「メイン10」
referenceフレーム	このレイヤーをエンコードするときに使用する参照フレームの数。 指定しない場合、エンコーダーはエンコーダーの複雑さの設定に基づいて適切な数を決定します。	整数 (int)
スライス	このレイヤーをエンコードするときに使用するスライスの数。 指定しない場合、既定値は 0 です。つまり、エンコーダーはフレームごとに 1 つのスライスを使用します。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

H265ビデオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.H265Video' (必須)
複雑さ	エンコード設定を選択する方法をエンコーダーに指示します。 品質により、圧縮率が高くなりますが、コストが高くなり、コンピューティング時間が長くなります。 速度は比較的大きなファイルを生成しますが、より高速で経済的です。 既定値は Balanced です。	「バランス」 「品質」 「スピード」
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 H.265 レイヤーのコレクション。	H265レイヤー[]
sceneChangeDetection	エンコーダーがシーンの変更時にキー フレームを挿入するかどうかを指定します。 指定しない場合、既定値は false です。 このフラグは、エンコーダーが 1 つの出力ビデオを生成するように構成されている場合にのみ true に設定する必要があります。	ブール (bool)
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

jpgフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.JpgFormat' (必須)

jpg画像

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.JpgImage' (必須)
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 JPEG 画像レイヤーのコレクション。	Jpgレイヤー[]
範囲	サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対的な位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止するPT5M30S)、またはフレーム数 (たとえば、開始時刻のフレームから 300 番目のフレームで停止する場合は 300) です。この値が 1 の場合は、開始時刻に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100%であり、ストリームの末尾で停止することを意味します。	ひも
スプライトカラム	サムネイル スプライト 画像で使用される列の数を設定します。 行数が自動的に計算され、スプライト内の各サムネイルの座標マッピングを使用して VTT ファイルが生成されます。 注: この値は正の整数にする必要があり、出力画像の解像度が JPEG の最大ピクセル解像度制限 65535x65535 を超えないように、適切な値をお勧めします。	整数 (int)
始める	サムネイルの生成を開始する位置を入力ビデオ内の位置。 値は ISO 8601 形式 (たとえば、PT05S は 5 秒から始まる)、フレーム数 (たとえば、10 番目のフレームから開始する場合は 10)、ストリームの継続時間に対する相対値 (たとえば、10% は 10% のストリーム継続時間) にすることができます。 また、マクロ {Best} もサポートしています。このマクロは、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示し、ステップと範囲の他の設定に関係なく、サムネイルを 1 つだけ生成します。 既定値はマクロ {Best} です。	string (必須)
歩	サムネイルが生成される間隔。 値は ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、またはフレーム数 (たとえば、30 フレームごとに 1 つのイメージの場合は 30)、またはストリームの継続時間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10%) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは限りません。 これは、最初の出力として開始時刻とステップ位置の間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10%であるため、ストリームの継続時間が長い場合、最初に生成されたサムネイルは、開始時刻に指定されたものから遠く離れている可能性があります。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ]に適切な値を選択し、開始時刻に必要なサムネイルが 1 つだけの場合は Range 値を 1 に設定します。	ひも
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

Jpgレイヤー

名前	説明	価値
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
品質	JPEG 出力の圧縮品質。 範囲は 0 ~ 100 で、既定値は 70 です。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

マイクロソフト.メディア/mediaServices/transforms

名前	説明	価値
apiVersion (英語)	API のバージョン	「2022-05-01-プレビュー」
名前	リソース名	string (必須)
プロパティ	リソースのプロパティ。	トランスフォームプロパティ
種類	リソースの種類	'Microsoft.Media/mediaServices/transforms'

MP4フォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.Mp4Format' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]

出力ファイル

名前	説明	価値
ラベル	エンコーダーがビデオとオーディオを出力ファイルに多重化する方法を説明するラベルの一覧。 たとえば、エンコーダーがラベル v1 と v2 を持つ 2 つのビデオ レイヤーとラベル a1 を持つ 1 つのオーディオ レイヤーを生成している場合、'[v1, a1]' のような配列は、v1 で表されるビデオ トラックと a1 で表されるオーディオ トラックを含む出力ファイルを生成するようにエンコーダーに指示します。	string[] (必須)

オーバーレイ

名前	説明	価値
@odata.type	AudioOverlay 型の場合は、'#Microsoft.Media.AudioOverlay' に設定します。 VideoOverlay 型の場合は、'#Microsoft.Media.VideoOverlay' に設定します。	'#Microsoft.Media.AudioOverlay' '#Microsoft.Media.VideoOverlay' (必須)
オーディオゲインレベル	オーバーレイ内のオーディオのゲイン レベル。 値の範囲は [0, 1.0] である必要があります。 既定値は 1.0 です。	整数 (int)
終了	オーバーレイが終了する入力ビデオを参照する終了位置。 値は ISO 8601 形式である必要があります。 たとえば、PT30S は、入力ビデオに 30 秒でオーバーレイを終了します。 指定しない場合、または値が入力ビデオの再生時間を超える場合、オーバーレイメディアの再生時間が入力ビデオの再生時間よりも長い場合、オーバーレイは入力ビデオの最後まで適用されます。それ以外の場合、オーバーレイはオーバーレイメディアの継続時間まで続きます。	ひも
フェードインデュレーション	オーバーレイが入力ビデオにフェードインする期間。 値は ISO 8601 期間形式である必要があります。 指定しない場合、既定の動作はフェードインなし (PT0S と同じ) になります。	ひも
fadeOutデュレーション	オーバーレイが入力ビデオからフェードアウトする期間。 値は ISO 8601 期間形式である必要があります。 指定しない場合、既定の動作はフェード アウトなし (PT0S と同じ) になります。	ひも
入力ラベル	オーバーレイとして使用するジョブ入力のラベル。 入力では、1 つのファイルを正確に指定する必要があります。 JPG、PNG、GIF、BMP 形式の画像ファイル、またはオーディオ ファイル (WAV、MP3、WMA、M4A ファイルなど)、ビデオ ファイルを指定できます。 サポートされているオーディオおよびビデオ ファイル形式の完全な一覧については、 https://aka.ms/mesformats を参照してください。	string (必須)
始める	オーバーレイが開始される入力ビデオを参照する開始位置。 値は ISO 8601 形式である必要があります。 たとえば、PT05S は、入力ビデオに 5 秒でオーバーレイを開始します。 指定しない場合、オーバーレイは入力ビデオの先頭から開始されます。	ひも

PNGフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.PngFormat' (必須)

Png画像

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.PngImage' (必須)
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 PNG イメージ レイヤーのコレクション。	PNGレイヤー[]
範囲	サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対的な位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止するPT5M30S)、またはフレーム数 (たとえば、開始時刻のフレームから 300 番目のフレームで停止する場合は 300) です。この値が 1 の場合は、開始時刻に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100%であり、ストリームの末尾で停止することを意味します。	ひも
始める	サムネイルの生成を開始する位置を入力ビデオ内の位置。 値は ISO 8601 形式 (たとえば、PT05S は 5 秒から始まる)、フレーム数 (たとえば、10 番目のフレームから開始する場合は 10)、ストリームの継続時間に対する相対値 (たとえば、10% は 10% のストリーム継続時間) にすることができます。 また、マクロ {Best} もサポートしています。このマクロは、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示し、ステップと範囲の他の設定に関係なく、サムネイルを 1 つだけ生成します。 既定値はマクロ {Best} です。	string (必須)
歩	サムネイルが生成される間隔。 値は ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、またはフレーム数 (たとえば、30 フレームごとに 1 つのイメージの場合は 30)、またはストリームの継続時間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10%) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは限りません。 これは、最初の出力として開始時刻とステップ位置の間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10%であるため、ストリームの継続時間が長い場合、最初に生成されたサムネイルは、開始時刻に指定されたものから遠く離れている可能性があります。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ]に適切な値を選択し、開始時刻に必要なサムネイルが 1 つだけの場合は Range 値を 1 に設定します。	ひも
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

Pngレイヤー

名前	説明	価値
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

プリセット

名前	説明	価値
@odata.type	VideoAnalyzerPreset 型の場合は、'#Microsoft.Media.VideoAnalyzerPreset' に設定します。 BuiltInStandardEncoderPreset 型の場合は、'#Microsoft.Media.BuiltInStandardEncoderPreset' に設定します。 FaceDetectorPreset 型の場合は、'#Microsoft.Media.FaceDetectorPreset' に設定します。 StandardEncoderPreset 型の場合、'#Microsoft.Media.StandardEncoderPreset' に設定します。	'#Microsoft.Media.BuiltInStandardEncoderPreset' '#Microsoft.Media.FaceDetectorPreset' '#Microsoft.Media.StandardEncoderPreset' '#Microsoft.Media.VideoAnalyzerPreset' (必須)

プリセット構成

名前	説明	価値
複雑さ	速度と品質のバランスを制御するようにエンコーダー設定を構成できます。 例: [複雑さ] を [速度] に設定すると、エンコードが高速化されますが、圧縮効率は低下します。	「バランス」 「品質」 「スピード」
インターリーブ出力	オーディオとビデオをコンテナー形式で格納する方法を制御する出力のインターリーブ モードを設定します。 例: InterleavedOutput を NonInterleavedOutput に設定して、オーディオのみの出力とビデオのみの出力を別々の MP4 ファイルに生成します。	'インターリーブ出力' 'NonInterleavedOutput'
キーフレーム間隔 (秒)	キー フレームの間隔 (秒単位)。 例: KeyFrameIntervalInSeconds を 2 に設定して、一部のプレイヤーの再生バッファリングを減らします。	整数 (int)
最大ビットレートBps	最大ビットレート (1 秒あたりのビット数) (トップ ビデオ レイヤーのしきい値)。 例: MaxBitrateBps を 60000000 に設定して、複雑度の高いコンテンツに対して非常に高いビットレート出力が生成されないようにします。	整数 (int)
マックスハイト	出力ビデオ レイヤーの最大高さ。 例: MaxHeight を 720 に設定すると、入力が 4K であっても最大 720P の出力レイヤーが生成されます。	整数 (int)
マックスレイヤー	出力ビデオ レイヤーの最大数。 例: MaxLayers を 4 に設定して、エンコード ジョブの全体的なコストを制御するために最大 4 つの出力レイヤーが生成されるようにします。	整数 (int)
minBitrateBps(分ビットレートBps)	最小ビットレート (1 秒あたりのビット数) (下部のビデオ レイヤーのしきい値)。 例: MinBitrateBps を 200000 に設定して、ネットワーク帯域幅の低いユーザーを対象とする下位レイヤーを設定します。	整数 (int)
最小の高さ	出力ビデオ レイヤーの最小高さ。 例: MinHeight を 360 に設定して、180P のような解像度の小さい出力レイヤーを回避します。	整数 (int)
出力フォーマット	出力形式の種類を設定します。 現在の実装では、Mp4Format と CmafFormat のみがサポートされています。 例: OutputFormat を CmafFormat に設定して、ストリーミング用のオーディオ/ビデオ ストリームバリアントとマニフェスト ファイルを生成します。	形式

長方形

名前	説明	価値
高さ	四角形領域の高さ (ピクセル単位)。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
左	左余白からのピクセル数。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
ページのトップへ	上余白からのピクセル数。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
幅	四角形領域の幅 (ピクセル単位)。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも

StandardEncoderプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.StandardEncoderPreset' (必須)
コーデック	入力ビデオをエンコードするときに使用するコーデックの一覧。	Codec[] (必須)
フィルター	エンコードの前に入力メディアに適用される 1 つ以上のフィルター処理操作。	フィルター
形式	エンコーダーによって生成される出力の一覧。	Format[] (必須)

トランスフォーム出力

名前	説明	価値
オンエラー	変換では、複数の出力を定義できます。 このプロパティは、1 つの出力が失敗したときにサービスが実行する必要がある処理を定義します。これは、他の出力の生成を続行するか、他の出力を停止します。 ジョブの全体的な状態には、"ContinueJob" で指定された出力のエラーは反映されません。 既定値は 'StopProcessingJob' です。	「ContinueJob」 'StopProcessingJob'
プリセット	ソース ファイルから分析情報を変更、トランスコード、または抽出して出力を生成するために使用される操作を記述するプリセット。	プリセット (必須)
relativePriority (相対優先度)	Transform 内の TransformOutput の相対優先度を設定します。 これにより、サービスが TransformOutputs の処理に使用する優先順位が設定されます。 既定の優先度は Normal です。	「高い」 「低い」 「普通」

トランスフォームプロパティ

名前	説明	価値
説明	Transform の詳細な説明 (省略可能)。	ひも
出力	Transform が生成する必要がある 1 つ以上の TransformOutput の配列。	TransformOutput[] (必須)

トランスポートストリームフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.TransportStreamFormat' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]

VideoAnalyzerプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.VideoAnalyzerPreset' (必須)
オーディオ言語	BCP-47 形式の 'language tag-region' (例: 'en-US') を使用した入力内のオーディオ ペイロードの言語。 コンテンツの言語がわかっている場合は、それを指定することをお勧めします。 言語の自動検出は基本モードに含まれていないため、AudioAnalysisMode::Basic では言語を明示的に指定する必要があります。 言語が指定されていない場合、または null に設定されている場合、自動言語検出では、検出された最初の言語が選択され、ファイルの期間中、選択した言語で処理されます。 現在、最初の言語が検出された後の言語間の動的な切り替えはサポートされていません。 自動検出は、明確に識別可能な音声によるオーディオ録音に最適です。 自動検出で言語が見つからない場合、文字起こしは 'en-US' にフォールバックします。サポートされている言語の一覧については、以下を参照してください。 https://go.microsoft.com/fwlink/?linkid=2109463	ひも
experimentalオプション	プリセット自体で公開されていないパラメーターのキー値ペアを含むディクショナリ	AudioAnalyzerPresetExperimentalOptions (英語)
insightsToExtract	サービスで生成する分析情報の種類を定義します。 使用できる値は、"AudioInsightsOnly"、"VideoInsightsOnly"、"AllInsights" です。 既定値は AllInsights です。 これを AllInsights に設定し、入力がオーディオのみの場合は、オーディオ分析情報のみが生成されます。 同様に、入力がビデオのみの場合は、ビデオ分析情報のみが生成されます。 入力の一部がビデオのみであることが予想される場合は、AudioInsightsOnly を使用しないことをお勧めします。または、入力の一部がオーディオのみであることが予想される場合は、VideoInsightsOnly を使用します。 このような状態のジョブはエラーになります。	「オールインサイツ」 「AudioInsightsOnly」 「VideoInsightsOnly」
モード	実行するオーディオ分析操作のセットを決定します。 指定しない場合は、Standard AudioAnalysisMode が選択されます。	「ベーシック」 「スタンダード」

ビデオオーバーレイ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.VideoOverlay' (必須)
クロップレクタングル	オーバーレイの画像またはビデオをトリミングするために使用する省略可能な四角形のウィンドウ。	長方形
不透明	オーバーレイの不透明度。 これは、[0 - 1.0] の範囲内の値です。 既定値は 1.0 で、オーバーレイが不透明であることを意味します。	整数 (int)
立場	オーバーレイが適用される入力ビデオ内の場所。	長方形

使用例

Terraform (AzAPI プロバイダー) リソース定義

mediaServices/transforms リソースの種類は、次を対象とする操作でデプロイできます。

• リソース グループ

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Media/mediaServices/transforms リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Media/mediaServices/transforms@2022-05-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      description = "string"
      outputs = [
        {
          onError = "string"
          preset = {
            @odata.type = "string"
            // For remaining properties, see Preset objects
          }
          relativePriority = "string"
        }
      ]
    }
  }
}

オーバーレイ オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.AudioOverlay の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.AudioOverlay"
}

#Microsoft.Media.VideoOverlay の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.VideoOverlay"
  cropRectangle = {
    height = "string"
    left = "string"
    top = "string"
    width = "string"
  }
  opacity = int
  position = {
    height = "string"
    left = "string"
    top = "string"
    width = "string"
  }
}

プリセット オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.VideoAnalyzerPreset の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.VideoAnalyzerPreset"
  audioLanguage = "string"
  experimentalOptions = {
    {customized property} = "string"
  }
  insightsToExtract = "string"
  mode = "string"
}

#Microsoft.Media.BuiltInStandardEncoderPreset の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.BuiltInStandardEncoderPreset"
  configurations = {
    complexity = "string"
    interleaveOutput = "string"
    keyFrameIntervalInSeconds = int
    maxBitrateBps = int
    maxHeight = int
    maxLayers = int
    minBitrateBps = int
    minHeight = int
    outputFormat = {
      filenamePattern = "string"
      @odata.type = "string"
      // For remaining properties, see Format objects
    }
  }
  presetName = "string"
}

#Microsoft.Media.FaceDetectorPreset の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.FaceDetectorPreset"
  blurType = "string"
  experimentalOptions = {
    {customized property} = "string"
  }
  mode = "string"
  resolution = "string"
}

#Microsoft.Media.StandardEncoderPreset の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.StandardEncoderPreset"
  codecs = [
    {
      label = "string"
      @odata.type = "string"
      // For remaining properties, see Codec objects
    }
  ]
  filters = {
    crop = {
      height = "string"
      left = "string"
      top = "string"
      width = "string"
    }
    deinterlace = {
      mode = "string"
      parity = "string"
    }
    overlays = [
      {
        audioGainLevel = int
        end = "string"
        fadeInDuration = "string"
        fadeOutDuration = "string"
        inputLabel = "string"
        start = "string"
        @odata.type = "string"
        // For remaining properties, see Overlay objects
      }
    ]
    rotation = "string"
  }
  formats = [
    {
      filenamePattern = "string"
      @odata.type = "string"
      // For remaining properties, see Format objects
    }
  ]
}

オブジェクトの書式設定

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.CmafFormat の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.CmafFormat"
  outputFiles = [
    {
      labels = [
        "string"
      ]
    }
  ]
  streamingFormat = "string"
}

#Microsoft.Media.JpgFormat の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.JpgFormat"
}

#Microsoft.Media.PngFormat の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.PngFormat"
}

#Microsoft.Media.Mp4Format の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.Mp4Format"
  outputFiles = [
    {
      labels = [
        "string"
      ]
    }
  ]
}

#Microsoft.Media.TransportStreamFormat の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.TransportStreamFormat"
  outputFiles = [
    {
      labels = [
        "string"
      ]
    }
  ]
}

コーデック オブジェクト

オブジェクトの種類を指定するには 、@odata.type プロパティを設定します。

#Microsoft.Media.AacAudio の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.AacAudio"
  bitrate = int
  channels = int
  profile = "string"
  samplingRate = int
}

#Microsoft.Media.DDAudio の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.DDAudio"
  bitrate = int
  channels = int
  samplingRate = int
}

#Microsoft.Media.CopyAudio の場合は、次の値を使用します。

{
  @odata.type = "#Microsoft.Media.CopyAudio"
}

#Microsoft.Media.CopyVideo の場合は、次の値を使用します。

{
  @odata.type = "#Microsoft.Media.CopyVideo"
}

#Microsoft.Media.H264Video の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.H264Video"
  complexity = "string"
  keyFrameInterval = "string"
  layers = [
    {
      adaptiveBFrame = bool
      bFrames = int
      bitrate = int
      bufferWindow = "string"
      crf = int
      entropyMode = "string"
      frameRate = "string"
      height = "string"
      label = "string"
      level = "string"
      maxBitrate = int
      profile = "string"
      referenceFrames = int
      slices = int
      width = "string"
    }
  ]
  rateControlMode = "string"
  sceneChangeDetection = bool
  stretchMode = "string"
  syncMode = "string"
}

#Microsoft.Media.H265Video の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.H265Video"
  complexity = "string"
  keyFrameInterval = "string"
  layers = [
    {
      adaptiveBFrame = bool
      bFrames = int
      bitrate = int
      bufferWindow = "string"
      crf = int
      frameRate = "string"
      height = "string"
      label = "string"
      level = "string"
      maxBitrate = int
      profile = "string"
      referenceFrames = int
      slices = int
      width = "string"
    }
  ]
  sceneChangeDetection = bool
  stretchMode = "string"
  syncMode = "string"
}

#Microsoft.Media.JpgImage の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.JpgImage"
  keyFrameInterval = "string"
  layers = [
    {
      height = "string"
      label = "string"
      quality = int
      width = "string"
    }
  ]
  range = "string"
  spriteColumn = int
  start = "string"
  step = "string"
  stretchMode = "string"
  syncMode = "string"
}

#Microsoft.Media.PngImage の場合は、次を使用します。

{
  @odata.type = "#Microsoft.Media.PngImage"
  keyFrameInterval = "string"
  layers = [
    {
      height = "string"
      label = "string"
      width = "string"
    }
  ]
  range = "string"
  start = "string"
  step = "string"
  stretchMode = "string"
  syncMode = "string"
}

プロパティ値

Aacオーディオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.AacAudio' (必須)
ビットレート	出力エンコードされたオーディオのビットレート (ビット/秒)。	整数 (int)
チャンネル	オーディオ内のチャネルの数。	整数 (int)
プロフィール	AAC でオーディオをエンコードするときに使用するエンコード プロファイル。	「AacLc」 「HeAacV1」 「HeAacV2」
サンプリングレート	ヘルツでのエンコードに使用するサンプリング レート。	整数 (int)

AudioAnalyzerPresetExperimentalOptions (英語)

名前	説明	価値

オーディオオーバーレイ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.AudioOverlay' (必須)

ビルトインスタンダードエンコーダープリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.BuiltInStandardEncoderPreset' (必須)
構成	エンコーダーのオプションの構成設定。 構成は、ContentAwareEncoding と H265ContentAwareEncoding BuiltInStandardEncoderPreset でのみサポートされます。	プリセット構成
プリセット名	ビデオのエンコードに使用する組み込みのプリセット。	「AACGoodQualityAudio」 「アダプティブストリーミング」 「ContentAwareEncoding」 「ContentAwareEncodingExperimental」 'CopyAllBitrateNonInterleaved' 「DDGoodQualityAudio」 「H264MultipleBitrate1080p」 'H264MultipleBitrate720p' 「H264MultipleBitrateSD」 「H264シングルビットレート1080p」 「H264シングルビットレート720p」 「H264シングルビットレートSD」 「H265AdaptiveStreaming」 'H265ContentAwareEncoding' 「H265シングルビットレート1080p」 「H265シングルビットレート4K」 'H265SingleBitrate720p' (必須)

cmafフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CmafFormat' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]
ストリーミングフォーマット		「ダッシュ」 「HLS」 「HlsAndDash」

コーデック

名前	説明	価値
@odata.type	AacAudio 型の場合は 、' #Microsoft.Media.AacAudio' に設定します。 DDAudio 型の場合は 、'#Microsoft.Media.DDAudio' に設定します。 CopyAudio 型の場合は、'#Microsoft.Media.CopyAudio' に設定します。 CopyVideo 型の場合は 、'#Microsoft.Media.CopyVideo' に設定します。 H264Video 型の場合は 、'#Microsoft.Media.H264Video' に設定します。 H265Video 型の場合は 、'#Microsoft.Media.H265Video' に設定します。 JpgImage 型の場合は、'#Microsoft.Media.JpgImage' に設定します。 PngImage 型の場合は、'#Microsoft.Media.PngImage' に設定します。	'#Microsoft.Media.AacAudio' '#Microsoft.Media.CopyAudio' '#Microsoft.Media.CopyVideo' '#Microsoft.Media.DDAudio' 「#Microsoft.Media.H264Video」 「#Microsoft.Media.H265Video」 '#Microsoft.Media.JpgImage' '#Microsoft.Media.PngImage' (必須)
ラベル	コーデックの省略可能なラベル。 このラベルを使用して、多重化の動作を制御できます。	ひも

CopyAudio (オーディオをコピー)

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CopyAudio' (必須)

ビデオのコピー

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.CopyVideo' (必須)

DDアウディオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.DDAudio' (必須)
ビットレート	出力エンコードされたオーディオのビットレート (ビット/秒)。	整数 (int)
チャンネル	オーディオ内のチャネルの数。	整数 (int)
サンプリングレート	ヘルツでのエンコードに使用するサンプリング レート。	整数 (int)

インターレース解除

名前	説明	価値
モード	インターレース解除モード。 既定値は AutoPixelAdaptive です。	「オートピクセルアダプティブ」 「オフ」
パリティ	インターレース解除のフィールド パリティ(既定値は Auto)。	「オート」 「ボトムフィールドファースト」 「トップフィールドファースト」

FaceDetectorプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.FaceDetectorPreset' (必須)
ブラータイプ	ぼかしの種類	「ブラック」 「ボックス」 「高い」 「低い」 「メッド」
experimentalオプション	プリセット自体で公開されていないパラメーターのキー値ペアを含むディクショナリ	FaceDetectorPresetExperimentalOptions
モード	このモードでは、1) 分析 - 検出専用の設定から選択できます。このモードでは、ビデオ全体で顔の外観をマークするメタデータ JSON ファイルが生成されます。可能な場合は、同じ人物の外観に同じ ID が割り当てられます。2) 結合 - 検出された顔をさらに編集 (ぼかし) します。 3)編集 - これにより、2パスプロセスが可能になり、検出された顔のサブセットの選択的な編集が可能になります。メタデータ ファイルは、ソース ビデオと共に、以前の分析パスと、再編集を必要とするユーザーが選択した ID のサブセットを取り込みます。	「分析」 「組み合わせた」 「編集」
解決策	ビデオを分析する最大解像度を指定します。 既定の動作は "SourceResolution" であり、分析時に入力ビデオが元の解像度で維持されます。 "StandardDefinition" を使用すると、適切な縦横比を維持しながら、入力ビデオのサイズが標準定義に変更されます。 ビデオの解像度が高い場合にのみサイズが変更されます。 たとえば、1920 x 1080 の入力は、処理の前に 640 x 360 にスケーリングされます。 "StandardDefinition" に切り替えると、高解像度ビデオの処理にかかる時間が短縮されます。 また、このコンポーネントの使用コストを削減することもできます (詳細については、 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics を参照してください)。 ただし、サイズ変更されたビデオでは、最終的に小さすぎる顔が検出されない場合があります。	'ソースレゾリューション' 'StandardDefinition'

FaceDetectorPresetExperimentalOptions

名前	説明	価値

フィルター

名前	説明	価値
実り	入力ビデオをトリミングする四角形ウィンドウのパラメーター。	長方形
インターレース解除	インターレース解除の設定。	インターレース解除
オーバーレイ	入力ビデオに適用されるオーバーレイのプロパティ。 オーディオ、画像、ビデオオーバーレイなどです。	オーバーレイ[]
自転	エンコードされる前に、入力ビデオに適用される回転 (ある場合)。 既定値は Auto です	「オート」 「なし」 '回転0' 「回転180」 「回転270」 「回転90」

フォーマット

名前	説明	価値
@odata.type	CmafFormat 型の場合は、'#Microsoft.Media.CmafFormat' に設定します。 JpgFormat 型の場合は、'#Microsoft.Media.JpgFormat' に設定します。 PngFormat 型の場合は 、'#Microsoft.Media.PngFormat' に設定します。 Mp4Format 型の場合は 、' #Microsoft.Media.Mp4Format' に設定します。 TransportStreamFormat 型の場合は、'#Microsoft.Media.TransportStreamFormat' に設定します。	'#Microsoft.Media.CmafFormat' '#Microsoft.Media.JpgFormat' '#Microsoft.Media.Mp4Format' '#Microsoft.Media.PngFormat' '#Microsoft.Media.TransportStreamFormat' (必須)
ファイル名パターン	出力ファイルの作成に使用されるファイルの名前付けパターン。 ファイル名 {Basename} - 入力ビデオ ファイルの名前を使用する拡張マクロで、次のマクロがサポートされています。 入力ビデオ ファイルのベース名 (ファイル サフィックスが含まれていない) の長さが 32 文字未満の場合は、入力ビデオ ファイルのベース名が使用されます。 入力ビデオ ファイルのベース名の長さが 32 文字を超える場合、ベース名は合計で最初の 32 文字に切り捨てられます。 {Extension} - この形式に適した拡張子。 {Label} - コーデック/レイヤーに割り当てられたラベル。 {Index} - サムネイルの一意のインデックス。 サムネイルにのみ適用されます。 {AudioStream} - 文字列 "Audio" とオーディオ ストリーム番号 (1 から始まる)。 {Bitrate} - オーディオ/ビデオビットレート (kbps)。 サムネイルには適用されません。 {Codec} - オーディオ/ビデオ コーデックの種類。 {Resolution} - ビデオの解像度。 置換されていないマクロはすべて折りたたまれて、ファイル名から削除されます。	string (必須)

H264レイヤー

名前	説明	価値
適応型Bフレーム	このレイヤーをエンコードするときにアダプティブ B フレームを使用するかどうか。 指定しない場合、ビデオ プロファイルで使用が許可されるたびにエンコーダーがオンになります。	ブール (bool)
bフレーム	このレイヤーをエンコードするときに使用する B フレームの数。 指定しない場合、エンコーダーはビデオ プロファイルとレベルに基づいて適切な番号を選択します。	整数 (int)
ビットレート	このレイヤーの生成時に入力ビデオをエンコードする平均ビットレート (ビット/秒)。 これは必須フィールドです。	int (必須)
バッファウィンドウ	VBV バッファー ウィンドウの長さ。 値は ISO 8601 形式である必要があります。 値の範囲は [0.1 - 100] 秒である必要があります。 既定値は 5 秒 (PT5S など) です。	ひも
CRFの	このレイヤーをエンコードするときに使用する CRF の値。 この設定は、ビデオ コーデックの RateControlMode が CRF モードで設定されている場合に有効になります。 CRF 値の範囲は 0 から 51 の範囲です。この値を小さくすると、ファイル サイズが大きくなると品質が向上します。 値が大きいほど圧縮率が高くなりますが、ある時点で品質の低下が見られます。 既定値は 23 です。	整数 (int)
エントロピーモード	このレイヤーに使用するエントロピー モード。 指定しない場合、エンコーダーはプロファイルとレベルに適したモードを選択します。	「カバック」 「Cavlc」
フレームレート	このレイヤーをエンコードするフレーム レート (フレーム/秒)。 この値は、M と N が整数 (30000/1001 など) である M/N の形式、または数値 (30、29.97 など) の形式にすることができます。 エンコーダーは、プロファイルとレベルに基づいて、許可されたフレーム レートに制約を適用します。 指定しない場合、エンコーダーは入力ビデオと同じフレーム レートを使用します。	ひも
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
レベル	現在、レベル 6.2 をサポートしています。 値には、Auto、または H.264 プロファイルに一致する数値を指定できます。 指定しない場合、既定値は Auto です。これにより、エンコーダーはこのレイヤーに適したレベルを選択できます。	ひも
最大ビットレート	VBV バッファーがリフィルと見なされる最大ビットレート (1 秒あたりのビット数)。 指定しない場合、既定値はビットレートと同じ値になります。	整数 (int)
プロフィール	現在、ベースライン、メイン、高、高 422、高 444 がサポートされています。 既定値は Auto です。	「オート」 「ベースライン」 「高い」 「High422」 「High444」 「メイン」
referenceフレーム	このレイヤーをエンコードするときに使用する参照フレームの数。 指定しない場合、エンコーダーはエンコーダーの複雑さの設定に基づいて適切な数を決定します。	整数 (int)
スライス	このレイヤーをエンコードするときに使用するスライスの数。 指定しない場合、既定値は 0 です。つまり、エンコーダーはフレームごとに 1 つのスライスを使用します。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

H264ビデオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.H264Video' (必須)
複雑さ	エンコード設定を選択する方法をエンコーダーに指示します。 既定値は Balanced です。	「バランス」 「品質」 「スピード」
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 H.264 レイヤーのコレクション。	H264レイヤー[]
rateControlMode (レートコントロールモード)	ビデオレート制御モード	「ABR」 「CBR」 「CRF」
sceneChangeDetection	エンコーダーがシーンの変更時にキー フレームを挿入する必要があるかどうか。 指定しない場合、既定値は false です。 このフラグは、エンコーダーが 1 つの出力ビデオを生成するように構成されている場合にのみ true に設定する必要があります。	ブール (bool)
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

H265レイヤー

名前	説明	価値
適応型Bフレーム	このレイヤーをエンコードするときにアダプティブ B フレームを使用するかどうかを指定します。 指定しない場合、ビデオ プロファイルで使用が許可されるたびにエンコーダーがオンになります。	ブール (bool)
bフレーム	このレイヤーをエンコードするときに使用する B フレームの数。 指定しない場合、エンコーダーはビデオ プロファイルとレベルに基づいて適切な番号を選択します。	整数 (int)
ビットレート	このレイヤーの生成時に入力ビデオをエンコードする平均ビットレート (ビット/秒)。 たとえば、3000Kbps または 3 Mbps のターゲット ビットレートは、この値が 30000000 である必要があることを意味します。これは必須フィールドです。	int (必須)
バッファウィンドウ	VBV バッファー ウィンドウの長さ。 値は ISO 8601 形式である必要があります。 値の範囲は [0.1 - 100] 秒である必要があります。 既定値は 5 秒 (PT5S など) です。	ひも
CRFの	このレイヤーをエンコードするときに使用する CRF の値。 この設定は、ビデオ コーデックの RateControlMode が CRF モードで設定されている場合に有効になります。 CRF 値の範囲は 0 から 51 の範囲です。この値を小さくすると、ファイル サイズが大きくなると品質が向上します。 値が大きいほど圧縮率が高くなりますが、ある時点で品質の低下が見られます。 既定値は 28 です。	整数 (int)
フレームレート	このレイヤーをエンコードするフレーム レート (フレーム/秒)。 この値は、M と N が整数 (30000/1001 など) である M/N の形式、または数値 (30、29.97 など) の形式にすることができます。 エンコーダーは、プロファイルとレベルに基づいて、許可されたフレーム レートに制約を適用します。 指定しない場合、エンコーダーは入力ビデオと同じフレーム レートを使用します。	ひも
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
レベル	現在、レベル 6.2 をサポートしています。 値には、Auto、または H.265 プロファイルに一致する数値を指定できます。 指定しない場合、既定値は Auto です。これにより、エンコーダーはこのレイヤーに適したレベルを選択できます。	ひも
最大ビットレート	VBV バッファーがリフィルと見なされる最大ビットレート (1 秒あたりのビット数)。 指定しない場合、既定値はビットレートと同じ値になります。	整数 (int)
プロフィール	現在、メインをサポートしています。 既定値は Auto です。	「オート」 「メイン」 「メイン10」
referenceフレーム	このレイヤーをエンコードするときに使用する参照フレームの数。 指定しない場合、エンコーダーはエンコーダーの複雑さの設定に基づいて適切な数を決定します。	整数 (int)
スライス	このレイヤーをエンコードするときに使用するスライスの数。 指定しない場合、既定値は 0 です。つまり、エンコーダーはフレームごとに 1 つのスライスを使用します。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

H265ビデオ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.H265Video' (必須)
複雑さ	エンコード設定を選択する方法をエンコーダーに指示します。 品質により、圧縮率が高くなりますが、コストが高くなり、コンピューティング時間が長くなります。 速度は比較的大きなファイルを生成しますが、より高速で経済的です。 既定値は Balanced です。	「バランス」 「品質」 「スピード」
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 H.265 レイヤーのコレクション。	H265レイヤー[]
sceneChangeDetection	エンコーダーがシーンの変更時にキー フレームを挿入するかどうかを指定します。 指定しない場合、既定値は false です。 このフラグは、エンコーダーが 1 つの出力ビデオを生成するように構成されている場合にのみ true に設定する必要があります。	ブール (bool)
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

jpgフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.JpgFormat' (必須)

jpg画像

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.JpgImage' (必須)
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 JPEG 画像レイヤーのコレクション。	Jpgレイヤー[]
範囲	サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対的な位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止するPT5M30S)、またはフレーム数 (たとえば、開始時刻のフレームから 300 番目のフレームで停止する場合は 300) です。この値が 1 の場合は、開始時刻に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100%であり、ストリームの末尾で停止することを意味します。	ひも
スプライトカラム	サムネイル スプライト 画像で使用される列の数を設定します。 行数が自動的に計算され、スプライト内の各サムネイルの座標マッピングを使用して VTT ファイルが生成されます。 注: この値は正の整数にする必要があり、出力画像の解像度が JPEG の最大ピクセル解像度制限 65535x65535 を超えないように、適切な値をお勧めします。	整数 (int)
始める	サムネイルの生成を開始する位置を入力ビデオ内の位置。 値は ISO 8601 形式 (たとえば、PT05S は 5 秒から始まる)、フレーム数 (たとえば、10 番目のフレームから開始する場合は 10)、ストリームの継続時間に対する相対値 (たとえば、10% は 10% のストリーム継続時間) にすることができます。 また、マクロ {Best} もサポートしています。このマクロは、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示し、ステップと範囲の他の設定に関係なく、サムネイルを 1 つだけ生成します。 既定値はマクロ {Best} です。	string (必須)
歩	サムネイルが生成される間隔。 値は ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、またはフレーム数 (たとえば、30 フレームごとに 1 つのイメージの場合は 30)、またはストリームの継続時間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10%) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは限りません。 これは、最初の出力として開始時刻とステップ位置の間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10%であるため、ストリームの継続時間が長い場合、最初に生成されたサムネイルは、開始時刻に指定されたものから遠く離れている可能性があります。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ]に適切な値を選択し、開始時刻に必要なサムネイルが 1 つだけの場合は Range 値を 1 に設定します。	ひも
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

Jpgレイヤー

名前	説明	価値
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
品質	JPEG 出力の圧縮品質。 範囲は 0 ~ 100 で、既定値は 70 です。	整数 (int)
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

マイクロソフト.メディア/mediaServices/transforms

名前	説明	価値
名前	リソース名	string (必須)
parent_id	このリソースの親であるリソースの ID。	種類のリソースの ID: mediaServices
プロパティ	リソースのプロパティ。	トランスフォームプロパティ
種類	リソースの種類	「Microsoft.Media/mediaServices/transforms@2022-05-01-preview」

MP4フォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.Mp4Format' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]

出力ファイル

名前	説明	価値
ラベル	エンコーダーがビデオとオーディオを出力ファイルに多重化する方法を説明するラベルの一覧。 たとえば、エンコーダーがラベル v1 と v2 を持つ 2 つのビデオ レイヤーとラベル a1 を持つ 1 つのオーディオ レイヤーを生成している場合、'[v1, a1]' のような配列は、v1 で表されるビデオ トラックと a1 で表されるオーディオ トラックを含む出力ファイルを生成するようにエンコーダーに指示します。	string[] (必須)

オーバーレイ

名前	説明	価値
@odata.type	AudioOverlay 型の場合は、'#Microsoft.Media.AudioOverlay' に設定します。 VideoOverlay 型の場合は、'#Microsoft.Media.VideoOverlay' に設定します。	'#Microsoft.Media.AudioOverlay' '#Microsoft.Media.VideoOverlay' (必須)
オーディオゲインレベル	オーバーレイ内のオーディオのゲイン レベル。 値の範囲は [0, 1.0] である必要があります。 既定値は 1.0 です。	整数 (int)
終了	オーバーレイが終了する入力ビデオを参照する終了位置。 値は ISO 8601 形式である必要があります。 たとえば、PT30S は、入力ビデオに 30 秒でオーバーレイを終了します。 指定しない場合、または値が入力ビデオの再生時間を超える場合、オーバーレイメディアの再生時間が入力ビデオの再生時間よりも長い場合、オーバーレイは入力ビデオの最後まで適用されます。それ以外の場合、オーバーレイはオーバーレイメディアの継続時間まで続きます。	ひも
フェードインデュレーション	オーバーレイが入力ビデオにフェードインする期間。 値は ISO 8601 期間形式である必要があります。 指定しない場合、既定の動作はフェードインなし (PT0S と同じ) になります。	ひも
fadeOutデュレーション	オーバーレイが入力ビデオからフェードアウトする期間。 値は ISO 8601 期間形式である必要があります。 指定しない場合、既定の動作はフェード アウトなし (PT0S と同じ) になります。	ひも
入力ラベル	オーバーレイとして使用するジョブ入力のラベル。 入力では、1 つのファイルを正確に指定する必要があります。 JPG、PNG、GIF、BMP 形式の画像ファイル、またはオーディオ ファイル (WAV、MP3、WMA、M4A ファイルなど)、ビデオ ファイルを指定できます。 サポートされているオーディオおよびビデオ ファイル形式の完全な一覧については、 https://aka.ms/mesformats を参照してください。	string (必須)
始める	オーバーレイが開始される入力ビデオを参照する開始位置。 値は ISO 8601 形式である必要があります。 たとえば、PT05S は、入力ビデオに 5 秒でオーバーレイを開始します。 指定しない場合、オーバーレイは入力ビデオの先頭から開始されます。	ひも

PNGフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.PngFormat' (必須)

Png画像

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.PngImage' (必須)
キーフレーム間隔	2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。	ひも
層	エンコーダーによって生成される出力 PNG イメージ レイヤーのコレクション。	PNGレイヤー[]
範囲	サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対的な位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止するPT5M30S)、またはフレーム数 (たとえば、開始時刻のフレームから 300 番目のフレームで停止する場合は 300) です。この値が 1 の場合は、開始時刻に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100%であり、ストリームの末尾で停止することを意味します。	ひも
始める	サムネイルの生成を開始する位置を入力ビデオ内の位置。 値は ISO 8601 形式 (たとえば、PT05S は 5 秒から始まる)、フレーム数 (たとえば、10 番目のフレームから開始する場合は 10)、ストリームの継続時間に対する相対値 (たとえば、10% は 10% のストリーム継続時間) にすることができます。 また、マクロ {Best} もサポートしています。このマクロは、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示し、ステップと範囲の他の設定に関係なく、サムネイルを 1 つだけ生成します。 既定値はマクロ {Best} です。	string (必須)
歩	サムネイルが生成される間隔。 値は ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、またはフレーム数 (たとえば、30 フレームごとに 1 つのイメージの場合は 30)、またはストリームの継続時間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10%) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは限りません。 これは、最初の出力として開始時刻とステップ位置の間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10%であるため、ストリームの継続時間が長い場合、最初に生成されたサムネイルは、開始時刻に指定されたものから遠く離れている可能性があります。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ]に適切な値を選択し、開始時刻に必要なサムネイルが 1 つだけの場合は Range 値を 1 に設定します。	ひも
ストレッチモード	サイズ変更モード - 入力ビデオのサイズを目的の出力解像度に合わせて変更する方法。 既定値は AutoSize です	「オートフィット」 「オートサイズ」 「なし」
同期モード	ビデオ同期モード	「オート」 「CFR」 'パススルー' 「VFR」

Pngレイヤー

名前	説明	価値
高さ	このレイヤーの出力ビデオの高さ。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの高さが入力のピクセル数の半分を意味します。	ひも
ラベル	このレイヤーの英数字ラベル。異なるビデオレイヤーとオーディオレイヤーを多重化したり、出力ファイルに名前を付けたりするために使用できます。	ひも
幅	このレイヤーの出力ビデオの幅。 この値には、絶対 (ピクセル単位) または相対値 (パーセンテージ) を指定できます。 たとえば、50% は、出力ビデオの幅が入力の半分のピクセル数を示します。	ひも

プリセット

名前	説明	価値
@odata.type	VideoAnalyzerPreset 型の場合は、'#Microsoft.Media.VideoAnalyzerPreset' に設定します。 BuiltInStandardEncoderPreset 型の場合は、'#Microsoft.Media.BuiltInStandardEncoderPreset' に設定します。 FaceDetectorPreset 型の場合は、'#Microsoft.Media.FaceDetectorPreset' に設定します。 StandardEncoderPreset 型の場合、'#Microsoft.Media.StandardEncoderPreset' に設定します。	'#Microsoft.Media.BuiltInStandardEncoderPreset' '#Microsoft.Media.FaceDetectorPreset' '#Microsoft.Media.StandardEncoderPreset' '#Microsoft.Media.VideoAnalyzerPreset' (必須)

プリセット構成

名前	説明	価値
複雑さ	速度と品質のバランスを制御するようにエンコーダー設定を構成できます。 例: [複雑さ] を [速度] に設定すると、エンコードが高速化されますが、圧縮効率は低下します。	「バランス」 「品質」 「スピード」
インターリーブ出力	オーディオとビデオをコンテナー形式で格納する方法を制御する出力のインターリーブ モードを設定します。 例: InterleavedOutput を NonInterleavedOutput に設定して、オーディオのみの出力とビデオのみの出力を別々の MP4 ファイルに生成します。	'インターリーブ出力' 'NonInterleavedOutput'
キーフレーム間隔 (秒)	キー フレームの間隔 (秒単位)。 例: KeyFrameIntervalInSeconds を 2 に設定して、一部のプレイヤーの再生バッファリングを減らします。	整数 (int)
最大ビットレートBps	最大ビットレート (1 秒あたりのビット数) (トップ ビデオ レイヤーのしきい値)。 例: MaxBitrateBps を 60000000 に設定して、複雑度の高いコンテンツに対して非常に高いビットレート出力が生成されないようにします。	整数 (int)
マックスハイト	出力ビデオ レイヤーの最大高さ。 例: MaxHeight を 720 に設定すると、入力が 4K であっても最大 720P の出力レイヤーが生成されます。	整数 (int)
マックスレイヤー	出力ビデオ レイヤーの最大数。 例: MaxLayers を 4 に設定して、エンコード ジョブの全体的なコストを制御するために最大 4 つの出力レイヤーが生成されるようにします。	整数 (int)
minBitrateBps(分ビットレートBps)	最小ビットレート (1 秒あたりのビット数) (下部のビデオ レイヤーのしきい値)。 例: MinBitrateBps を 200000 に設定して、ネットワーク帯域幅の低いユーザーを対象とする下位レイヤーを設定します。	整数 (int)
最小の高さ	出力ビデオ レイヤーの最小高さ。 例: MinHeight を 360 に設定して、180P のような解像度の小さい出力レイヤーを回避します。	整数 (int)
出力フォーマット	出力形式の種類を設定します。 現在の実装では、Mp4Format と CmafFormat のみがサポートされています。 例: OutputFormat を CmafFormat に設定して、ストリーミング用のオーディオ/ビデオ ストリームバリアントとマニフェスト ファイルを生成します。	形式

長方形

名前	説明	価値
高さ	四角形領域の高さ (ピクセル単位)。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
左	左余白からのピクセル数。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
ページのトップへ	上余白からのピクセル数。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも
幅	四角形領域の幅 (ピクセル単位)。 絶対ピクセル値 (例: 100) またはビデオのサイズに対する相対値 (たとえば、50%) を指定できます。	ひも

StandardEncoderプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.StandardEncoderPreset' (必須)
コーデック	入力ビデオをエンコードするときに使用するコーデックの一覧。	Codec[] (必須)
フィルター	エンコードの前に入力メディアに適用される 1 つ以上のフィルター処理操作。	フィルター
形式	エンコーダーによって生成される出力の一覧。	Format[] (必須)

トランスフォーム出力

名前	説明	価値
オンエラー	変換では、複数の出力を定義できます。 このプロパティは、1 つの出力が失敗したときにサービスが実行する必要がある処理を定義します。これは、他の出力の生成を続行するか、他の出力を停止します。 ジョブの全体的な状態には、"ContinueJob" で指定された出力のエラーは反映されません。 既定値は 'StopProcessingJob' です。	「ContinueJob」 'StopProcessingJob'
プリセット	ソース ファイルから分析情報を変更、トランスコード、または抽出して出力を生成するために使用される操作を記述するプリセット。	プリセット (必須)
relativePriority (相対優先度)	Transform 内の TransformOutput の相対優先度を設定します。 これにより、サービスが TransformOutputs の処理に使用する優先順位が設定されます。 既定の優先度は Normal です。	「高い」 「低い」 「普通」

トランスフォームプロパティ

名前	説明	価値
説明	Transform の詳細な説明 (省略可能)。	ひも
出力	Transform が生成する必要がある 1 つ以上の TransformOutput の配列。	TransformOutput[] (必須)

トランスポートストリームフォーマット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.TransportStreamFormat' (必須)
出力ファイル	生成する出力ファイルの一覧。 リスト内の各エントリは、多重化されるオーディオおよびビデオレイヤーラベルのセットです。	出力ファイル[]

VideoAnalyzerプリセット

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.VideoAnalyzerPreset' (必須)
オーディオ言語	BCP-47 形式の 'language tag-region' (例: 'en-US') を使用した入力内のオーディオ ペイロードの言語。 コンテンツの言語がわかっている場合は、それを指定することをお勧めします。 言語の自動検出は基本モードに含まれていないため、AudioAnalysisMode::Basic では言語を明示的に指定する必要があります。 言語が指定されていない場合、または null に設定されている場合、自動言語検出では、検出された最初の言語が選択され、ファイルの期間中、選択した言語で処理されます。 現在、最初の言語が検出された後の言語間の動的な切り替えはサポートされていません。 自動検出は、明確に識別可能な音声によるオーディオ録音に最適です。 自動検出で言語が見つからない場合、文字起こしは 'en-US' にフォールバックします。サポートされている言語の一覧については、以下を参照してください。 https://go.microsoft.com/fwlink/?linkid=2109463	ひも
experimentalオプション	プリセット自体で公開されていないパラメーターのキー値ペアを含むディクショナリ	AudioAnalyzerPresetExperimentalOptions (英語)
insightsToExtract	サービスで生成する分析情報の種類を定義します。 使用できる値は、"AudioInsightsOnly"、"VideoInsightsOnly"、"AllInsights" です。 既定値は AllInsights です。 これを AllInsights に設定し、入力がオーディオのみの場合は、オーディオ分析情報のみが生成されます。 同様に、入力がビデオのみの場合は、ビデオ分析情報のみが生成されます。 入力の一部がビデオのみであることが予想される場合は、AudioInsightsOnly を使用しないことをお勧めします。または、入力の一部がオーディオのみであることが予想される場合は、VideoInsightsOnly を使用します。 このような状態のジョブはエラーになります。	「オールインサイツ」 「AudioInsightsOnly」 「VideoInsightsOnly」
モード	実行するオーディオ分析操作のセットを決定します。 指定しない場合は、Standard AudioAnalysisMode が選択されます。	「ベーシック」 「スタンダード」

ビデオオーバーレイ

名前	説明	価値
@odata.type	派生型の識別子。	'#Microsoft.Media.VideoOverlay' (必須)
クロップレクタングル	オーバーレイの画像またはビデオをトリミングするために使用する省略可能な四角形のウィンドウ。	長方形
不透明	オーバーレイの不透明度。 これは、[0 - 1.0] の範囲内の値です。 既定値は 1.0 で、オーバーレイが不透明であることを意味します。	整数 (int)
立場	オーバーレイが適用される入力ビデオ内の場所。	長方形