thumbnails:Array or Hash
API 버전: V2
부모의:출력
호환 가능한 작업 유형: 주문형 비디오
예:
설명:
모든 출력에 대해 하나 이상의 축소판을 요청할 수 있습니다.
각 출력은 고유 한 썸네일 세트를 가질 수 있습니다. 크기 , base_url , 및액세스 제어세트.
배열 내에서 여러 축소판 해시를 전달하여 단일 출력에 대해 여러 축소판 집합을 만들 수 있습니다. 축소판 옵션이 배열로 전달되면상표세트로 설정해야합니다.
S3 설정액세스 제어출력 비디오에 사용하는 것과 동일한 옵션을 사용합니다.
썸네일은 세트당 100 개로 제한됩니다. 요청 된 옵션에 따라 더 많은 썸네일이 생성되면 출력에 경고가 추가되고 한계에 도달하면 썸네일 생성이 중지됩니다.
참고: 썸네일 전용 작업 같은 것은 없습니다. 썸네일만으로 출력 지정또한 만들 것입니다기본 트랜스 코딩 설정으로 청구 가능한 전체 길이 mp4를 임시 저장소에 업로드합니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: [
{
"label": "첫 번째",
“숫자”: 10
},
{
"label": "초",
“간격_인_프레임”: 5000
}
]
}
]
}
또한보십시오:상표
label:String
API 버전: V2
호환 가능한 작업 유형: VOD
예:포스터
설명:
썸네일 세트의 이름입니다. 배열의 축소판 집합을 요청할 때 필요합니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: [
{
"label": "포스터"
},
{
"label": "클립"
}
]
}
]
}
format:String
API 버전: V2
기본: png
유효한 값 : png 또는 jpg
호환 가능한 작업 유형: VOD
예: jpg
설명:
축소판 이미지의 형식입니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"형식": "jpg"
}
}
]
}
number:Integer
API 버전: V2
유효한 값 : 양의 정수
호환 가능한 작업 유형: 주문형 비디오
예: 3
설명:
캡처 할 여러 썸네일. Zencoder는 파일의 전체 기간에 걸쳐 균일 한 간격의 축소판을 캡처합니다. 따라서 썸네일 1 개를 요청하면 파일 중간 근처에 있습니다. 8 분 동영상에 3 개의 섬네일을 지정하면 약 2, 4, 6 분에 섬네일이 생성됩니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“숫자”: 3
}
}
]
}
start_at_first_frame:Boolean
API 버전: V2
기본:그릇된
유효한 값 :참 또는 거짓
호환 가능한 작업 유형: 주문형 비디오
예:진실
설명:
사용할 때번호썸네일 생성 옵션은 첫 번째 프레임에서 썸네일 촬영을 시작합니다.
예를 들어 동영상 길이가 5 초이고 썸네일 5 개를 요청하는 경우번호옵션을 선택하면 0 초, 1 초, 2 초, 3 초, 4 초에 썸네일이 생성됩니다. 일반적으로 0.83s, 1.66s, 2.49s, 3.32s 및 4.15s에서 축소판을 가져옵니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“숫자”: 5,
"start_at_first_frame": true
}
}
]
}
interval:Float
API 버전: V2
호환 가능한 작업 유형: 주문형 비디오
예: 60
설명:
초 단위로 짝수 간격으로 썸네일을 찍습니다. Zencoder는 파일의 N 초마다 하나의 썸네일을 반환합니다. 따라서 간격을 60으로 선택하고 입력 파일의 길이가 12 분이면 1 분에 하나씩 12 개의 미리보기 이미지를 받게됩니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"간격": 60
}
}
]
}
또한보십시오: interval_in_frames
interval_in_frames:Float
API 버전: V2
호환 가능한 작업 유형: 주문형 비디오
예: 120
설명:
프레임 단위로 균일한 간격으로 썸네일을 찍습니다. Zencoder는 파일의 N 프레임마다 하나의 썸네일을 반환합니다. 따라서 간격을 120으로 선택하고 입력 파일이 초당 29.97 프레임이면 약 4 초마다 축소판을 다시 가져옵니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“간격_인_프레임”: 120
}
}
]
}
또한보십시오:간격
times:Array
API 버전: V2
호환 가능한 작업 유형: VOD
예: [0, 30, 60, 90]
설명:
축소판을 가져올 시간 (초) 의 배열입니다. 소수점이 유효합니다. 따라서 시간을 [12.5, 25]로 설정하면 12.5 초와 25 초에 하나씩 두 개의 썸네일이 캡처됩니다. 이 값은 음수가 아닌 숫자의 배열이어야합니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"회": [0, 30, 60, 90]
}
}
]
}
aspect_mode:String
API 버전: V2
기본:보존하다
유효한 값 :보존, 늘리기, 자르기 또는 채우기
호환 가능한 작업 유형: VOD
예:인주
설명:
축소판을 만들 때 사용할 종횡비 모드입니다.
참고: 비디오 스케일링 알고리즘의 제약으로 인해 썸네일의 크기는 짝수입니다. 예를 들어 100x75 크기의 미리보기 이미지를 요청하면 100x74 크기의 미리보기 이미지가 표시됩니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"aspect_mode": "패드",
“ 너비”: 200,
“높이”: 200
}
}
]
}
size:String
API 버전: V2
호환 가능한 작업 유형: 주문형 비디오
예: 400x300
설명:
"160 × 120"과 같은 썸네일의 목표 해상도. 크기가 제공되지 않으면 썸네일은 출력 비디오와 동일한 크기가됩니다. 기본적으로 가로 세로 비율을 유지하므로이 크기 매개 변수의 가로 세로 비율이 영화의 가로 세로 비율과 일치하지 않으면 결과 파일이이 크기와 정확히 일치하지 않을 수 있습니다. 해당 출력 파일에 대해 Stretch가 true로 설정되어 있으면이 축소판도 해상도를 채우기 위해 늘어납니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"크기": "400x300"
}
}
]
}
또한보십시오:폭 , 신장 , 및 aspect_mode
width:Integer
API 버전: V2
유효한 값 : 양의 정수
호환 가능한 작업 유형: 주문형 비디오
예: 640
설명:
썸네일 너비. 너비가 제공되지 않으면 출력 파일 너비를 사용하거나크기또는신장환경.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“ 너비”: 640
}
}
]
}
또한보십시오:크기 , 신장 , 및 aspect_mode
height:Integer
API 버전: V2
유효한 값 : 양의 정수
호환 가능한 작업 유형: 주문형 비디오
예: 480
설명:
썸네일 높이. 높이가 제공되지 않으면 출력 파일 높이를 사용하거나크기또는폭환경.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“높이”: 480
}
}
]
}
또한보십시오:크기 , 폭 , 및 aspect_mode
base_url:String
API 버전: V2
유효한 값 : 유효한 S3, 클라우드 파일, GCS, FTP, FTPS 또는 SFTP URL (파일 이름 제외). 형식 : s3 : // [버킷 이름] / [경로] 또는 ftp : // [사용자] : [암호] @ [ftp.url] / [경로]
호환 가능한 작업 유형: 주문형 비디오
예:
설명:
축소판의 출력 대상입니다. base_url이 비어 있으면 Zencoder S3 버킷에 썸네일을 저장합니다. Zencoder S3 버킷에 저장된 파일은 24 시간 후에 사용할 수 있습니다. 파일 이름은 출력간에 고유하지 않으므로 (예 : frame_0000.png) 대상은 파일 덮어 쓰기를 방지하기 위해 고유 한 디렉토리 또는 키 접두사 여야합니다.
FTP 사용자 : 서버의 루트에서 쓰기를 시도하므로 URL에 대한 절대 경로를 사용하여 서버에 성공적으로 쓸 수 있는지 확인합니다.
자격 증명에 대한 참고 사항 :
base_url을 통해 자격 증명을 제공하면 다음 요청에 나타나는 URL에직업 세부 정보 , 출력 세부 정보등 만약신임장 Zencoder와 함께 저장되면 해당 응답의 URL에 표시되지 않습니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"base_url": "s3 : // my-output-bucket /"
}
}
]
}
prefix:String
API 버전: V2
기본:틀
호환 가능한 작업 유형: 주문형 비디오
예:
설명:
썸네일 파일은 순차적 인 파일 이름으로 내보내집니다. 그러나 축소판 파일에 대해 사용자 지정 접두사를 지정할 수 있습니다. 접두사가 지정되지 않은 경우 프레임을 사용합니다. 예를 들어 접두사 'custom'을 사용하는 경우 내 보낸 파일의 이름은 custom_0000.png, custom_0001.png 등이됩니다. 사용자 지정 접두사가 없으면 이름이 frame_0000.png, frame_0001.png 등으로 지정됩니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"접두사": "엄지 손가락"
}
}
]
}
filename:String
API 버전: V2
기본:틀
호환 가능한 작업 유형: 주문형 비디오
예:
설명:
썸네일 파일은 여러 속성에 따라 파일 이름을 지정할 수 있습니다. 속성에는 숫자, 패딩 된 숫자, 너비, 높이 및 크기가 포함됩니다. 파일 확장자는 "형식"옵션에 따라 Zencoder에 의해 추가되므로 추가 할 필요가 없습니다.
숫자 또는 패딩 된 숫자를 사용해야하며 나머지는 모두 선택 사항입니다. padded-number는 4 개의 스팟 (0000, 0001 등)을 사용합니다.
높이, 너비 및 크기는 생성 된 미리보기 이미지의 실제 크기를 기반으로합니다.
예: _x-thumbnail
유효한 문자에는 문자, 숫자, 대시, 밑줄 및 보간 된 값이 포함됩니다.
참고: 파일 이름을 지정하면 지정된접두사무시됩니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"파일 이름": "_x-thumbnail"
}
}
]
}
public:Boolean
API 버전: V2
기본:그릇된
유효한 값 :참 또는 거짓
호환 가능한 작업 유형: VOD
설명:
동일공공의출력 파일 용. 보다공공의이 옵션에 대한 전체 문서는
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“숫자”: 10,
"공개": 참
}
}
]
}
또한보십시오:액세스 제어
access_control:Array
API 버전: V2
유효한 값 : 두 가지 설정을 포함하는 해시 배열 : 피부 여자과허가 .
호환 가능한 작업 유형: VOD
설명:
동일액세스 제어출력 파일 용. 보다액세스 제어이 옵션에 대한 전체 문서는
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“액세스 제어”: [
{
“권한”: "읽다",
"grantee": "someone@example.com"
}
]
}
}
]
}
grantee:String
API 버전: V2
유효한 값 : 유효한 S3 피부여자 (이메일, ID 또는 URI)
호환 가능한 작업 유형: VOD
설명:
동일피부 여자출력 파일 용. 보다피부 여자이 옵션에 대한 전체 문서는
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“액세스 제어”: [
{
“권한”: “전체제어”,
“피부여자”: “피부여자”
}
]
}
}
]
}
permission:String
API 버전: V2
유효한 값 : 다음을 포함하는 문자열 또는 문자열 배열: READ, READ_ACP, WRITE_ACP 또는 FULL_CONTROL
호환 가능한 작업 유형: VOD
설명:
동일허가출력 파일 용. 보다허가이 옵션에 대한 전체 문서는
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“액세스 제어”: [
{
“권한”: “전체제어”,
“피부여자”: “피부여자”
}
]
}
}
]
}
rrs:Boolean
API 버전: V2
기본:그릇된
유효한 값 :참 또는 거짓
호환 가능한 작업 유형: VOD
설명:
동일 rrs출력 파일 용. 보다 rrs이 옵션에 대한 전체 문서는
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"rrs": 참
}
}
]
}
headers:Hash
API 버전: V2
호환 가능한 작업 유형: VOD
예: { "Content-Type": "binary / octet-stream"}
설명:
미리보기 이미지를 업로드 할 때 미리보기 이미지와 함께 보낼 HTTP 헤더. 이 기능은 현재 S3 및 Cloud Files를 사용할 때 지원됩니다.
Zencoder는 다음 헤더의 제한된 하위 집합 설정을 지원합니다. Cache-Control, Content-Disposition, Content-Encoding, Content-Type, Expires, x-amz-acl, x-amz-storage-class, x-amz-server-side-encryption 및 x-amz-meta- * .
출력 위치를 지정하지 않으면 헤더가 무시됩니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
"headers": {
"Content-Type": "이진 / 옥텟 스트림",
"x-amz-acl": "공개 읽기-쓰기"
}
}
}
]
}
credentials:String
API 버전: V2
호환 가능한 작업 유형: VOD
예: ftp_dev_server
설명:
전송에 사용할 저장된 자격 증명의 별명을 참조합니다. 계정 자격 증명 섹션 .
노트: 신디케이션 서비스에 대한 자격 증명은 출력 비디오 전용입니다.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“베이스_URL”: "ftp://ftp.example.com/thumbnails/ “,
"credentials": "ftp_dev_server"
}
}
]
}
또한보십시오: base_url
parallel_upload_limit:Integer
API 버전: V2
기본: S3의 경우 30, 다른 모든 목적지의 경우 10.
유효한 값 : 1에서 30 사이의 정수
호환 가능한 작업 유형: 주문형 비디오
예: 5
설명:
미리보기 이미지를 업로드 할 때 생성되는 최대 동시 업로드 수입니다.
원격 서버의 대역폭에 따라 전송 시간이 빨라질 수 있습니다. 연결 수가 많을수록 서버에 더 많은 부하가 발생할 수 있습니다. 업로드 시간 초과에 문제가 있거나 Zencoder가 파일을 업로드 할 때 너무 많은 대역폭을 사용하지 않도록하려면이 값을 1로 설정하십시오.
{
“입력”: “S3: //zencodertesting/test.mov”,
“출력”: [
{
“썸네일”: {
“베이스_URL”: "ftp://ftp.example.com/thumbnails/ “,
"parallel_upload_limit": 5
}
}
]
}