Screenshot
최신 업데이트：2026-05-15 15:33:09
스크린샷 기능 고품질 정지 이미지를 동영상에서 추출하여 썸네일, 커버 이미지, 미리보기 프레임 및 콘텐츠 모더레이션에 활용할 수 있습니다. CDNetworks 플랫폼은 다양한 입력 동영상 포맷을 지원하며, 고급 포맷팅 옵션으로 여러 출력 형식의 이미지를 생성할 수 있습니다.
지원 포맷
- 입력 포맷: MP4, FLV, M3U8, TS, MKV, MOV, WMV, AVI, VP8, VP9, RealVideo, Windows Media Video 등
- 코덱: H.265, H.264, H.263, MPEG 등
- 출력 포맷: JPG, PNG, GIF (JPG 및 PNG는 CSS 스프라이트 지원)
사용 방법
요청 본문에 다음과 같이 fops 명령을 구성하세요:
<op>/<Format>
/offset/<value>
/offsets/<value>
/interval/<value>
/vframeN/<value>
/t/<value>
/sprite/<value>
/mode/<value>
/w/<value>
/h/<value>
/autofill/<value>
/rotate/<value>
/isZip/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
op |
예 | 작업 유형. 스크린샷은 vframe 사용 |
format |
예 | 출력 포맷 (jpg, png, gif 등) |
offset |
아니오 | 단일 스크린샷 타임스탬프 (초 단위, 소수점 3자리까지 지원) |
offsets |
아니오 | 여러 스크린샷 타임스탬프 (오름차순으로 콜론 구분) 예: 0:30:60:120 - 0초, 30초, 60초, 120초 프레임 캡처 |
interval |
아니오 | 여러 스크린샷 간 시간 간격 (초 단위) |
vframeN |
아니오 | 일정 간격으로 캡처할 총 스크린샷 수 |
t |
아니오 | GIF 출력 지속 시간 (초 단위, 기본값: 5초) |
sprite |
아니오 | 지정된 행×열 패턴으로 CSS 스프라이트 시트 생성 예: 4x5 - 4행 5열의 단일 이미지 생성참고: interval 매개변수와 함께 사용해야 함 |
mode |
아니오 | 종횡비 유지 스케일링 모드 (모드 매개변수 표 참조) |
w |
아니오 | 스크린샷 너비 (픽셀, 1-1920) |
h |
아니오 | 스크린샷 높이 (픽셀, 1-1080) |
autofill |
아니오 | w 및 h 사용 시 배경 채우기 방법:• 0 (기본값) - 강제 크기 조정 (왜곡 가능)• 1 - 종횡비 유지 및 검은색 배경 패딩참고: mode 매개변수와 함께 사용 불가 |
rotate |
아니오 | 회전 각도: 90, 180, 270 또는 auto |
isZip |
아니오 | 여러 스크린샷을 ZIP 파일로 패키징: • 0 - 패키징 안 함• 1 - 순차적 파일명으로 ZIP 생성 (예: a_00001.jpg)참고: 출력 파일명은 .zip으로 끝나야 함 |
saveas |
아니오 | 출력 위치 (URL-safe Base64 인코딩 문자열): Urlsafe_Base64_Encode(bucket:savedfilename) |
모드 매개변수
| 매개변수 | 설명 |
|---|---|
/mode/1 |
정확한 크기에 맞게 비율 조정 및 중앙 크롭 너비 또는 높이만 지정된 경우 최소 치수에 비례해 조정 |
/mode/2 |
크롭 없이 비율 조정, 최대 치수 내에 맞춤 한 차원만 지정된 경우 다른 차원은 비례 조정 |
/mode/3 |
크롭 없이 정확한 크기에 맞게 비율 조정 너비 또는 높이만 지정된 경우 다른 차원은 비례 조정 |
예제
test-mp4-encrypt 버킷의 test.mp4 동영상에서 5초 지점의 프레임을 캡처하여 test.jpg로 저장하는 예제:
의사 코드:
curl -v -X POST
-d "bucket=Urlsafe_Base64_Encode(test-mp4-encrypt)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(vframe/jpg/offset/5|saveas/Urlsafe_Base64_Encode(test-mp4-encrypt:test.jpg))&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
실제 요청:
curl -v -X POST
-d "bucket=dGVzdC1tcDQtZW5jcnlwdA==&key=dGVzdC5tcDQ=&fops=dmZyYW1lL2pwZy9vZmZzZXQvNXxzYXZlYXMvZEdWemRDMXRjRFF0Wlc1amNubHdkRHAwWlhOMExtcHdadz09&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
이 문서의 내용이 도움이 되었습니까?
예
아니오