Add Subtitles
최신 업데이트：2025-05-22 15:09:39
동영상에 자막 추가 기능: 하드코딩(영구 표시)과 소프트코딩(시청자 선택 가능) 자막 트랙 지원
지원 형식
-
입력 동영상: MP4, FLV, M3U8, TS, MKV, MOV, WMV, AVI, VP8, VP9, RealVideo, Windows Media Video 등
-
코덱: H.265, H.264, H.263, MPEG 등
-
자막 형식: SRT, MKV 자막, 내장 자막 스트림
사용 방법
fops 명령어를 다음 형식으로 구성:
<op>/<Format>
/subtitle/<value>
/subtitleType/<value>
/subtitleAttr/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
op |
예 | 작업 유형. 자막 처리 시 avthumb 사용 |
format |
예 | 출력 형식 (mp4/flv/m3u8 등) |
subtitle |
예 | 추가할 자막 파일(URL-safe Base64 인코딩 형식 bucket:path)지원 소스: • UTF-8 인코딩 SRT 파일 • MKV 파일 추출 자막 • 원본 동영상 내장 자막 스트림 예: test 버킷 내 1.srt 파일 → test:1.srt → dGVzdDoxLnNydA==다중 파일: 콤마로 구분 예: subtitle=aHR0cDovL2VuY29kZS5jaGFodW8uY29tLw,aHR0cDovL2VuY29kZS5jaGFodW8uY29tLw |
subtitleType |
아니오 | 자막 적용 방식: • 0 (기본값) - 시스템 자동 선택• 1 - 소프트코딩: 시청자 표시 전환 가능• 2 - 하드코딩: 영상에 직접 삽입 |
subtitleAttr |
아니오 | 적응형 비트레이트(m3u8) 출력용 소프트코딩 자막 속성 형식: subtitleAttr=base64_encode(lang=xx1,name=yy1)• lang - 언어 코드(ISO 639-1)• name - 자막 이름다중 설정: 콤마 구분 예: subtitleAttr=base64_encode(lang=en,name=English),base64_encode(lang=es,name=Spanish)주의: 자막 파일 수와 속성 수 일치 필수 |
saveas |
아니오 | 출력 위치 지정(URL-safe Base64 인코딩 형식): Urlsafe_Base64_Encode(bucket:저장파일명) |
예시
vod-wcs-test001 버킷 내 test.flv 동영상에 zimu.srt 자막 추가 후 MP4 형식으로 test_file.mp4 저장:
의사 코드
curl -v -X POST
–d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.flv)&fops=Urlsafe_Base64_Encode(avthumb/mp4/subtitle/Urlsafe_Base64_Encode(vod-wcs-test001:zimu.srt)|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.mp4))&force=1&separate=1"
–H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
실제 요청
curl -v -X POST
-d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5mbHY=&fops=YXZ0aHVtYi9tcDQvc3VidGl0bGUvZG05a0xYZGpjeTEwWlhOME1EQXhPbnBwYlhVdWMzSjBDZz09fHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNXRjRFFLQ2c9PQ==&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
이 문서의 내용이 도움이 되었습니까?
예
아니오