Video Cropping
최신 업데이트：2025-05-22 15:09:37
동영상 크롭 기능을 통해 원치 않는 영역을 제거하고 특정 관심 영역에 초점을 맞출 수 있습니다. 이 작업은 단일 API 호출로 다른 미디어 처리 작업과 결합하여 실행할 수 있습니다.
사용 방법
요청 본문에서 fops 파라미터를 다음 형식으로 구성하세요:
<op>/<format>
/gravity/<value>
/vcrop/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
필수 파라미터
| 파라미터 | 설명 |
|---|---|
op |
작업 유형. 동영상 크롭 시 avthumb로 설정 필수 |
format |
출력 형식 (예: flv, mp4, m3u8) |
선택적 파라미터
| 파라미터 | 설명 |
|---|---|
gravity |
크롭 시작 위치와 방향 결정. 기본값: TOP_LEFT |
vcrop |
너비와 높이를 사용해 크롭 영역의 크기 정의 |
saveas |
출력 위치 및 파일명을 URL-safe Base64 인코딩 문자열로 지정: Urlsafe_Base64_Encode(bucket:저장파일명) |
기준 위치 참조
gravity 파라미터가 크롭 시작 지점을 지정합니다:
| 값 | 설명 |
|---|---|
TOP_LEFT |
좌상단 모서리에서 시작 (기본값) |
TOP_CENTER |
상단 가장자리 중앙에서 시작 |
TOP_RIGHT |
우상단 모서리에서 시작 |
CENTER_LEFT |
좌측 가장자리 중앙에서 시작 |
CENTER |
프레임 정중앙에서 시작 |
CENTER_RIGHT |
우측 가장자리 중앙에서 시작 |
BOTTOM_LEFT |
좌하단 모서리에서 시작 |
BOTTOM_CENTER |
하단 가장자리 중앙에서 시작 |
BOTTOM_RIGHT |
우하단 모서리에서 시작 |
크롭 크기 참조
vcrop 파라미터가 크롭 영역의 크기를 제어합니다:
| 형식 | 설명 |
|---|---|
<Width>x |
너비만 설정 (원본 높이 유지). 범위: 0-10,000 |
x<Height> |
높이만 설정 (원본 너비 유지). 범위: 0-10,000 |
<Width>x<Height> |
너비와 높이 동시 설정. 각 차원 범위: 0-10,000 |
{vcropSize}a<dx>a<dy> |
시작점에서 오른쪽으로 dx 픽셀, 아래로 dy 픽셀 이동하여 위치 조정 |
예시
이 예시는 두 가지 방법으로 동영상을 크롭하여 별도의 출력 파일을 생성합니다:
- 좌상단에서 400x352 픽셀 m4a 형식 동영상 생성
- 중앙에서 200x352 픽셀 flv 형식 동영상 생성
의사 코드
curl -v -X POST
-d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(avthumb/m4a/gravity/TOP_LEFT/vcrop/400x352|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.m4a);avthumb/flv/gravity/CENTER/vcrop/200x352|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.flv))&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
실제 요청
curl -v -X POST
-d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5tcDQ=&fops=YXZ0aHVtYi9tNGEvZ3Jhdml0eS9UT1BfTEVGVC92Y3JvcC80MDB4MzUyfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNXROR0VLQ2c9PTthdnRodW1iL2Zsdi9ncmF2aXR5L0NFTlRFUi92Y3JvcC8yMDB4MzUyfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNW1iSFlLQ2c9PQoK&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
이 문서의 내용이 도움이 되었습니까?
예
아니오