CAE設定

概要

コンテキスト対応エンコーディングでは、指定したガイドラインに基づいて、ビデオ自体の特性に基づいて、ソースビデオの複数のレンディションが作成されます。これにより、ソースの特性を考慮すると、基本的に価値のないレンディションを作成することで、動画のトランスコーディングと保存にかかるコストを回避できます。

を参照してくださいCAEガイド設定に関する追加情報と推奨事項については。

video_codecs

video_codecs:Array

API バージョン:V2

親:dynamic_profile_options

有効な配列項目の値:h264 , hevc

デフォルト値:なし

互換性のあるジョブタイプ:VOD

例:["h264", "hevc"]

説明:

混合コーデック出力の場合、レンディションを作成するコーデックの配列。現在、h264hevc許可される項目値はおよびです。

{
    "dynamic_profile_options": {
      "max_renditions": 6,
      "video_codecs" : ["h264", "hevc"'],
      "video_codec_options": {
        "h264": {
          "min_renditions": 2,
          "max_resolution": { "width": 1280, "height": 720 }
        },
        "hevc": {
          "min_renditions": 2,
          "max_resolution": { "width": 1920, "height": 1080 }
        }
      }
    }
  }

video_codec_options

video_codecs:Object

API バージョン:V2

親:dynamic_profile_options

デフォルト値:なし

互換性のあるジョブタイプ:VOD

例:

"video_codec_options": {
  "h264": {
    "min_renditions": 2,
    "max_resolution": { "width": 1280, "height": 720 }
  },
  "hevc": {
    "min_renditions": 2,
    "max_resolution": { "width": 1920, "height": 1080 }
  }
}

説明:

混合コーデック出力の場合、各コーデックのオプションを指定するオブジェクト。各プロパティは、h264またはという名前のオブジェクトでありhevc、そのプロパティはそのコーデックのレンディションの制約を設定します。これらのオブジェクトに使用できるプロパティは次のとおりです。

min_renditions必須
min_bitrate
max_bitrate
max_first_rendition_bitrate
min_resolution
max_resolution
max_first_rendition_resolution

{
    "dynamic_profile_options": {
      "max_renditions": 6,
      "video_codecs" : ["h264", "hevc"'],
      "video_codec_options": {
        "h264": {
          "min_renditions": 2,
          "max_resolution": { "width": 1280, "height": 720 }
        },
        "hevc": {
          "min_renditions": 2,
          "max_resolution": { "width": 1920, "height": 1080 }
        }
      }
    }
  }

min_renditions

min_renditions:Integer

API バージョン:V2

親:dynamic_profile_options

有効な値:1-15

デフォルト値:1

互換性のあるジョブタイプ:VOD

例:3

説明:

生成するレンディションの最小数。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2
          }
        }

max_renditions

max_renditions:Integer

API バージョン:V2

親:dynamic_profile_options

有効な値:1-15

デフォルト値:8

互換性のあるジョブタイプ:VOD

例:10

説明:

生成するレンディションの最大数。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10
          }
        }

min_resolution

min_resolution:Object

API バージョン:V2

親:dynamic_profile_options

有効な値:16x16-8192x8192

デフォルト値:192x108

互換性のあるジョブタイプ:VOD

例:以下を参照

説明:

ラダーに対して考慮される最小分解能。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_resolution": {
              "height": 180,
              "width": 320
            }
          }
        }

max_resolution

max_resolution:Object

API バージョン:V2

親:dynamic_profile_options

有効な値:16x16-8192x8192

デフォルト値:ソース解像度

互換性のあるジョブタイプ:VOD

例:以下を参照

説明:

ラダーに対して考慮される最大分解能。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_resolution": {
              "height": 180,
              "width": 320
            },
            "max_resolution": {
              "height": 1080,
              "width": 1920
            }
          }
        }

max_frame_rate

max_frame_rate:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:0.1-120

デフォルト値:30

互換性のあるジョブタイプ:VOD

例:60

説明:

使用できる最大フレームレート。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "max_frame_rate": 60
          }
        }

keyframe_rate

keyframe_rate:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:0.5、1.0

デフォルト値:0.5

互換性のあるジョブタイプ:VOD

例:0.5

説明:

キーフレームレート。この値は 0.5 または 1 のいずれかです。SSAI が有効なコンテンツの場合、この値は 1 である必要があります。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "keyframe_rate": 0.5
          }
        }

fixed_frame_rate

fixed_frame_rate:Boolean

API バージョン:V2

親:dynamic_profile_options

有効な値:真または偽

デフォルト値: true

互換性のあるジョブタイプ:VOD

例:真

説明:

すべてのレンディションで同じフレームレートを使用するようにジェネレータに指示します。false の場合、360p 以下の解像度での H.264 ベースラインプロファイルのレンディションには、半分のフレームレートが割り当てられます。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "fixed_frame_rate": true
          }
        }

min_bitrate

min_bitrate:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:40-400

デフォルト値:200

互換性のあるジョブタイプ:VOD

例:300

説明:

使用できる最小ビットレート (kbps)。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300
          }
        }

max_bitrate

max_bitrate:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:400-40000

デフォルト値:15000

互換性のあるジョブタイプ:VOD

例:20000

説明:

使用できる最大ビットレート (kbps)。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300,
            "max_bitrate": 20000
          }
        }

max_first_rendition_bitrate

max_first_rendition_bitrate:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:40-1000

デフォルト値:400

互換性のあるジョブタイプ:VOD

例:700

説明:

最初のレンディションに使用できる最大ビットレート (kbps)。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300,
            "max_bitrate": 20000
            "max_first_rendition_bitrate": 700
          }
        }

min_granularity

min_granularity:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:1-100 (%)

デフォルト値:30 (%)

互換性のあるジョブタイプ:VOD

例:20

説明:

レンディション間のビットレートの最小相対変化。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_granularity": 20
          }
        }

max_granularity

max_granularity:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:1-100 (%)

デフォルト値:90 (%)

互換性のあるジョブタイプ:VOD

例:80

説明:

レンディション間のビットレートの最大相対変化。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_granularity": 20,
            "max_granularity": 80
          }
        }

video_codec

video_codec:String

API バージョン:V2

親:dynamic_profile_options

有効な値: h264、hvc

デフォルト値: h264

互換性のあるジョブタイプ:VOD

例: h264

説明:

使用するビデオコーデック。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "video_codec": "h264"
          }
        }

bitrate_cap_to_bitrate_ratio

bitrate_cap_to_bitrate_ratio:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:1.0-2.0

デフォルト値:1.3

互換性のあるジョブタイプ:VOD

例:1.5

説明:

VBR エンコーディングに使用される平均ビットレートに対する最大ビットレートの比率。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5
          }
        }

buffer_size_to_bitrate_ratio

buffer_size_to_bitrate_ratio:Number

API バージョン:V2

親:dynamic_profile_options

有効な値:1.0-4.0

デフォルト値:2.0

互換性のあるジョブタイプ:VOD

例:2.5

説明:

VBR エンコーディングに使用される平均ビットレートに対するデコーダバッファサイズの比率。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5
          }
        }

bitrate_cap_offset

bitrate_cap_offset:Number

API バージョン:V2

親:dynamic_profile_options

デフォルト値:64 [KBPS]

互換性のあるジョブタイプ:VOD

例:128

説明:

最大ビットレートを計算するときに追加された定数です。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5,
            "bitrate_cap_offset": 128
          }
        }

buffer_size_offset

buffer_size_offset:Number

API バージョン:V2

親:dynamic_profile_options

デフォルト値:85 [KBPS]

互換性のあるジョブタイプ:VOD

例:100

説明:

VBV バッファサイズの計算時に追加された定数です。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5,
            bitrate_cap_offset": 128,
            "buffer_size_offset": 100
          }
        }

quality_rate_tune

quality_rate_tune:Number

API バージョン:V2

親:dynamic_profile_options

有効な値: -40.0-40.0

デフォルト値:0

互換性のあるジョブタイプ:VOD

例:2

説明:

1 ～ 40 quality_rate_tuneの正の数値に設定すると、CAE プロファイルのビデオ品質が高くなり、ビットレートが高くなります。同様に、-1から-40の範囲の数字が与えられると、ビデオ品質を低下させることで、ビットレートを下げることができます。

たとえば、-10 の場合、約 10% 低いビットレートが期待できます。10の場合、ビットレートは一般的に約10％増加します。これらの数値は近似値です。の正の値のquality_rate_tune CAE は、非常に高いビデオ品質を確保するために特別な予防措置を講じ、粒度や数などのビットレートを制限する他のパラメータが存在する可能性があります。レンディション。

一般的なコンテンツと必要なビデオ品質と帯域幅が大きく異なるため、異なる値を使用して試すことをお勧めします。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "quality_rate_tune": 2
          }
        }

select_baseline_profile_configuration

select_baseline_profile_configuration:Boolean

API バージョン:V2

親:dynamic_profile_options

デフォルト値: true

互換性のあるジョブタイプ:VOD

例:偽

説明:

プロファイルで使用される少なくとも 1 つのレンディションがベースラインプロファイルになります。select_baseline_profile_configurationtrueはデフォルトでであり、次のものが必要であることに注意してください。 少なくとも 1 つのレンディション 512x288以下の解像度にする必要があります。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "select_baseline_profile_configuration": true
          }
        }

select_distinct_configurations

select_distinct_configurations:Boolean

API バージョン:V2

親:dynamic_profile_options

デフォルト値:偽

互換性のあるジョブタイプ:VOD

例:真

説明:

true の場合、CAE は、解像度、フレームレート、コーデックプロファイルの同じ組み合わせを 2 つのレンディションで使用しないようにします。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "select_distinct_configurations": true
          }
        }

video_configurations

video_configurations:Array

API バージョン:V2

親:dynamic_profile_options

デフォルト:プロファイルジェネレータは、既知のアスペクト比すべてについて、標準解像度のリストを使用します。可能な限り、ソースのアスペクト比、サンプルアスペクト比、フレームレートは出力設定で保持されます。

互換性のあるジョブタイプ:VOD

例:以下を参照

説明:

解像度、フレームレート、および関連するコーデック設定を記述する構造体の配列。CAE エンコーディングの一部として優先または必須に生成する必要があります。以下のセクションを参照してください。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "video_configurations": [
              {
                "width": 1920,
                "height": 1080,
                "sample_aspect_ratio": "16:9",
                "frame_rate": 30,
                "video_codec_profile": "high",
                "video_codec_level": 4.1,
                "video_reference_frames": 4,
                "video_bframes": 3,
                "required": true
              }
              ]
          }
        }

透かし

watermarks:Array

API バージョン:V2

親:dynamic_profile_options

デフォルト:プロファイルジェネレータは、既知のアスペクト比すべてについて、標準解像度のリストを使用します。可能な限り、ソースのアスペクト比、サンプルアスペクト比、フレームレートは出力設定で保持されます。

互換性のあるジョブタイプ:VOD

例:以下を参照

説明:

ウォーターマークを記述するハッシュの配列。

    {
        "input": "s3://zencodertesting/test.mov",
        "generate_dynamic_profile": true,
        "dynamic_profile_options" : {
          "min_rendition": 2,
          "max_rendition": 6,
          "watermarks":[
           {
              "url": "{url_to_watermark}",
             "width": "10%",
             "height": "10%"
           }
          ]
        }
      }

video_configurations透かしは次の部分にも含まれることがあります。

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options" : {
            "video_configurations": [
              {
               "width": 640,
               "height": 360,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-10",
                    "y": 10"
                  }
                ]
              },
              {
               "width": 960,
               "height": 540,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-15",
                    "y": "15"
                 }
                ]
              },
              {
                "width": 1280,
                "height": 720,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-20",
                    "y": "20"
                 }
                ]
              }
            ]
          }

追加の設定

以下は、CAEに使用できる追加の一般的なエンコーディング設定です。

追加設定
名前	タイプ	説明	デフォルト
`speed`	整数	エンコード速度の設定。	`3`
`one_pass`	ブール値	1 パスエンコードを強制します。	`false`
`tuning`	ストリング	コーデック固有のチューニングオプション。
`start_clip`	文字列/番号	特定の時刻から開始して、元のビデオのクリップを作成します。これは、の形式のタイムコード`HH:MM:SS.S`、または開始する秒数を表す小数点のいずれかになります。	`0`
`clip_length`	文字列/番号	特定の長さのクリップを作成します。これは、形式を持つデュレーション`HH:MM:SS.S`、またはクリップの長さを秒単位で表す小数点のいずれかになります。	ソース期間

HDR 設定

CAEはHDR10もサポートしており、には以下の設定を組み込めることができるdynamic_profile_options。

追加設定
名前	タイプ	説明	デフォルト
`master_display`	オブジェクト	HDR 出力のカラーボリュームと輝度設定を含むハッシュ。	無し
`max_content_light_level`	整数	総ニットまたはカンデラ/平方メートル（cd/m2）としてのコンテンツの最大光レベル-整数。	無し
`max_frame_average_light_level`	整数	コンテンツフレームニットまたはカンデラ/平方メートル (cd/m2) の最大平均光レベル-整数。10000 までの値を指定できますが、通常は 100 ～ 200 の範囲の値を指定すると、最適な結果が得られます。	無し

ビデオ構成の設定

この機能は、CAE が出力に持つ必要のある特定のコンフィギュレーションを生成しない場合に使用できます。

これは、CAE が出力の一部として生成する必要がある/する必要があるビデオ解像度とコーデック設定を記述するオブジェクトの配列です（上記の例を参照）。この配列はオプションです。省略すると、192x108 からコンテンツの解像度までのデフォルトの解像度の配列が CAE のデフォルト入力セットとして使用されます。

ビデオ構成設定
名前	タイプ	説明	必須？
`width`	整数	ビデオフレームの幅 [ピクセル]	必須
`height`	整数	ビデオフレームの高さ [ピクセル]	必須
`sample_aspect_ratio`	整数:整数ペア	アスペクト比のサンプル (例:1:1、4:3)	オプショナル
`frame_rate`	[番号]	ビデオフレームレート [fps]	オプショナル
`video_codec_profile`	ストリング	ビデオコーデックプロファイル	オプショナル
`video_codec_level`	ストリング	ビデオコーデックレベル	オプショナル
`video_reference_frames`	整数	基準フレームの数を制約します。既定値は 4 (H.264 ベースラインの場合の 3) です。	オプショナル
`video_bframes`	整数	B フレーム数の制約既定値は 3 (H.264 ベースラインの場合は 0) です。	オプショナル
`required`	ブール値	これをtrueに設定すると、出力に推奨される構成設定が保証されます。既定値は false です。	オプショナル

ページコンテンツ

CAE設定

概要

video_codecs

video_codec_options

min_renditions

max_renditions

min_resolution

max_resolution

max_frame_rate

keyframe_rate

fixed_frame_rate

min_bitrate

max_bitrate

max_first_rendition_bitrate

min_granularity

max_granularity

video_codec

bitrate_cap_to_bitrate_ratio

buffer_size_to_bitrate_ratio

bitrate_cap_offset

buffer_size_offset

quality_rate_tune

select_baseline_profile_configuration

select_distinct_configurations

video_configurations

透かし

追加の設定

HDR 設定

ビデオ構成の設定