概覽
「環境感知編碼」會根據您提供的指導方針，為來源視訊建立多個轉譯，同時也會根據視訊本身的特性來建立多個轉譯。鑑於來源的特徵，通過創建本質上毫無價值的演繹，這有助於避免轉碼和存儲視頻的成本。
見CAE指南有關設置的其他信息和建議。
video_codecs
video_codecs:Array
API 版本：V2
有效的數組項目值：h264，hevc
默認值：沒有
兼容的工作類型：VOD
例：["h264", "hevc"]
描述：
對於混合編解碼器輸出，要建立轉譯的編解碼器陣列。當前，允許的項目值為h264和hevc。
{
"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
默認值：沒有
兼容的工作類型：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_bitratemax_bitratemax_first_rendition_bitratemin_resolutionmax_resolutionmax_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
有效值：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
有效值：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
有效值：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
有效值：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
有效值：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
有效值：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
有效值：對或錯
預設值：真
兼容的工作類型：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
有效值：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
有效值：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
有效值：40-千
默認值：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
有效值：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
有效值：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
有效值： H264、
預設值：
兼容的工作類型：VOD
範例：
描述：
要使用的視訊轉碼器。
{
"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
有效值：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
有效值：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
默認值：64 [千位元]
兼容的工作類型：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
默認值：85 [千位元]
兼容的工作類型：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
有效值： -40.0-40.0
默認值： 0
兼容的工作類型：VOD
例：2
描述：
藉由設定quality_rate_tune為 1 到 40 的正數，CAE 設定檔將具有較高的視訊品質，而且位元率較高。同樣地，給定從-1 到-40 的範圍內的數字可以降低位元率，而代價是降低視訊品質。
例如，-10 可以預期大約降低 10％ 的位元率。對於 10，比特率一般會增加約 10％。這些數字是近似值，因為 CAE 對於正值的確保非常高的視訊品質quality_rate_tune需要額外的預防措施，而且可能還有其他參數會限制位元速率，例如粒度和節目數目。
由於一般內容和想要的視訊品質與頻寬差異很大，因此建議您嘗試不同的值。
{
"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
預設值：真
兼容的工作類型：VOD
示例： 錯誤
描述：
縱斷面中使用的至少一個節目將是基準線縱斷面。注意select_baseline_profile_configuration是true默認情況下，它要求至少一次演繹具有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
默認值：假
兼容的工作類型：VOD
例：真正
描述：
如果為真，CAE 將確保沒有兩個再現使用相同的組合：分辨率、幀速率和編解碼器配置文件。
{
"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
默認：描述檔產生器使用所有已知外觀比例的標準解析度清單。只要可能，輸出配置中會保留來源的外觀比例、取樣外觀比例和畫面格速率。
兼容的工作類型：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
watermarks:Array
API 版本：V2
默認：描述檔產生器使用所有已知外觀比例的標準解析度清單。只要可能，輸出配置中會保留來源的外觀比例、取樣外觀比例和畫面格速率。
兼容的工作類型：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"
}
]
}
]
}
Additional settings
以下是 CAE 可以使用的其他一般編碼設定。
| 名字 | 類型 | 描述 | 預設 |
|---|---|---|---|
deblock |
布林值 | 將解塊濾鏡應用於視頻。 | false |
deinterlace |
字串 | 確定是否應用去隔行濾鏡。默認值為“檢測” –如果將輸入文件檢測為隔行掃描，則將對其進行隔行掃描。將此設置為“開”可強制進行去隔行處理（如果輸入未進行隔行處理，則會降低質量），或將其設置為“關”以避免進行隔行處理。 | detect |
deinterlace_mode |
字串 |
如果未包含或設定為frame-to-frame，Zencoder 輸出將符合輸入檔案的畫面播放速率。如果設定為field-to-frame，Zencoder 會將輸出的輸入檔案的畫面速率加倍。如果您手動設定framerate為輸入檔案的畫面播放速率加倍，Zencoder 將自動設定deinterlace_mode為輸出的畫面播放速率field-to-frame並將其加倍。
|
frame-to-frame |
denoise |
字串 |
將降噪濾鏡應用於視頻。有效選項包括weakmediumstrong、、和strongest。通常，根據降噪級別，比特率和源視頻，將文件大小減小5％-20％。任何降噪都會使編碼速度降低約20％。高於“弱”的值應謹慎使用，儘管動畫有時可以處理高水平的降噪。
|
none (denoising not applied) |
speed |
整數 | 編碼速度設定。 | 3 |
one_pass |
布林值 | 強制進行單程編碼。 | false |
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）的內容的最大光級別（cd/m2）-整數值。 | 無 |
max_frame_average_light_level |
整數 | 每平方公尺 (cd/m2) 內容幀 nto 或新燭光的最大平均光級-整數值。雖然允許多達 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 將保證輸出中建議的組態設定。預設值 = 假。 | 可選的 |