개요
컨텍스트 인식 인코딩은 사용자가 제공한 가이드라인뿐 아니라 비디오 자체의 특성에 따라 소스 비디오의 여러 변환을 만듭니다. 이렇게하면 소스의 특성을 고려할 때 본질적으로 가치가없는 변환을 만들어 비디오를 트랜스 코딩하고 저장하는 비용을 피할 수 있습니다.
참조 CAE 가이드설정에 대한 추가 정보 및 권장 사항은
video_codecs
video_codecs:Array
API 버전: V2
유효한 배열 항목 값 : h264 , hevc
기본값:없음
호환 가능한 작업 유형: 주문형 비디오
예: ["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
기본값:없음
호환 가능한 작업 유형: 주문형 비디오
예:
"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
호환 가능한 작업 유형: 주문형 비디오
예: 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
호환 가능한 작업 유형: 주문형 비디오
예: 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
유효한 값 : 분류: 8 월 8 일
기본값: 192x108
호환 가능한 작업 유형: 주문형 비디오
예:아래 참조
설명:
사다리에 대해 고려해야 할 최소 해상도입니다.
{
"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
유효한 값 : 분류: 8 월 8 일
기본값:소스 해상도
호환 가능한 작업 유형: 주문형 비디오
예:아래 참조
설명:
래더에 대해 고려해야 할 최대 해상도입니다.
{
"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
호환 가능한 작업 유형: 주문형 비디오
예: 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
호환 가능한 작업 유형: 주문형 비디오
예: 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
유효한 값 :참 또는 거짓
기본값:진실
호환 가능한 작업 유형: 주문형 비디오
예:진실
설명:
생성기에 모든 변환에서 동일한 프레임 속도를 사용하도록 지시합니다. 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
호환 가능한 작업 유형: 주문형 비디오
예: 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 - 400
기본값: 15000
호환 가능한 작업 유형: 주문형 비디오
예: 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 - 1000
기본값: 400
호환 가능한 작업 유형: 주문형 비디오
예: 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 (%)
호환 가능한 작업 유형: 주문형 비디오
예: 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 (%)
호환 가능한 작업 유형: 주문형 비디오
예: 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, hevc
기본값: h264
호환 가능한 작업 유형: 주문형 비디오
예: 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
유효한 값 : 1.0 - 2.0
기본값: 1.3
호환 가능한 작업 유형: 주문형 비디오
예: 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
호환 가능한 작업 유형: 주문형 비디오
예: 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 [킬로바이트]
호환 가능한 작업 유형: 주문형 비디오
예: 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 [킬로바이트/분]
호환 가능한 작업 유형: 주문형 비디오
예: 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
호환 가능한 작업 유형: 주문형 비디오
예: 2
설명:
1에서 40까지의 양수로 설정하면quality_rate_tune 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
기본값:그릇된
호환 가능한 작업 유형: 주문형 비디오
예:진실
설명:
true인 경우 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
기본: 프로파일 생성기는 알려진 모든 종횡비에 대해 표준 해상도 목록을 사용합니다. 가능할 때마다 소스의 종횡비, 샘플 종횡비 및 프레임 수는 출력 구성에서 유지됩니다.
호환 가능한 작업 유형: 주문형 비디오
예:아래 참조
설명:
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
기본: 프로파일 생성기는 알려진 모든 종횡비에 대해 표준 해상도 목록을 사용합니다. 가능할 때마다 소스의 종횡비, 샘플 종횡비 및 프레임 수는 출력 구성에서 유지됩니다.
호환 가능한 작업 유형: 주문형 비디오
예:아래 참조
설명:
워터마크를설명하는 해시의 배열입니다.
{
"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"입니다. 입력 파일이 인터레이스 된 것으로 감지되면 디인터레이스됩니다. 디인터레이싱 (입력이 인터레이스되지 않은 경우 품질이 저하됨)을 강제하려면 "on"으로 설정하고, 디인터레이싱을 방지하려면 "off"로 설정합니다. | detect |
deinterlace_mode |
문자열 |
포함되지 않거나 로 설정된frame-to-frame경우 Zencoder 출력은 입력 파일의 프레임 속도와 일치합니다. 로field-to-frame설정하면 Zencoder는 출력 입력 파일의 프레임 속도를 두 배로 늘립니다. 입력 파일의 프레임 속도를 수동으로 두 배로 설정하면framerate Zencoder는 출력 프레임 속도를 두 배로 자동deinterlace_modefield-to-frame설정하여 두 배로 늘립니다.
|
frame-to-frame |
denoise |
문자열 |
비디오에 노이즈 제거 필터를 적용합니다. 유효한 옵션은weak , mediumstrong , 및strongest입니다. 일반적으로 노이즈 제거 수준, 비트 전송률 및 소스 비디오에 따라 파일 크기를 5 % -20 % 줄입니다. 노이즈를 제거하면 인코딩 속도가 약 20 % 느려집니다. 애니메이션이 때때로 높은 수준의 노이즈 제거를 처리 할 수 있지만 '약함'이상의 값은 신중하게 사용해야합니다.
|
none (denoising not applied) |
speed |
정수 | 인코딩 속도 설정입니다. | 3 |
one_pass |
부울 | 1패스 인코딩을 강제합니다. | 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) - 정수 값으로 내용에 대한 최대 라이트 레벨. | 없음 |
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입니다. | 선택 과목 |