Video Transcoding

비디오 트랜스코딩 기능은 오브젝트 스토리지에 저장된 영상 파일을 원본 포맷에서 다양한 대상 포맷으로 변환합니다. 이 서비스는 비디오 비트레이트, 해상도, 인코딩 방식 등을 유연하게 조정할 수 있도록 지원합니다. 이를 통해 다양한 기기에서 동영상 콘텐츠가 정상적으로 재생되어 모든 사용자가 최적화된 시청 경험을 누릴 수 있습니다.

핵심 기능

• 다양한 포맷 지원: 주요 및 전문 동영상·오디오 포맷과 코덱을 폭넓게 지원합니다.
• 맞춤형 파라미터 설정: 비트레이트, 해상도, 프레임률 등 주요 출력 동영상 파라미터를 직접 정의할 수 있습니다.
• 호환성 강화: 트랜스코딩된 영상이 다양한 최종 사용자 기기 및 플레이어에서 원활하게 재생될 수 있도록 보장합니다.
• 무결점 연동: 오브젝트 스토리지와 매끄럽게 연동되어 영상 리소스의 관리 및 처리가 편리합니다.

지원되는 포맷 및 코덱

CDNetworks 영상 트랜스코딩 서비스는 다음과 같은 파일 형식과 인코딩 표준을 지원합니다:

트랜스코딩 사용 사례

다음과 같은 시나리오에서 live streaming transcoding을 사용할 수 있습니다:

• 업로드 시 트랜스코딩: 비디오 파일을 Object Storage에 업로드할 때 자동 또는 수동으로 트랜스코딩 작업을 트리거합니다.
• 기존 동영상 트랜스코딩: 이미 Object Storage에 저장된 동영상 파일을 처리하고 트랜스코딩합니다.
• 미디어 처리 워크플로우: 트랜스코딩을 복잡한 미디어 처리 워크플로우(예: 동영상 썸네일 생성, 워터마킹)의 일부로 통합합니다.

사용 방법

요청 구조

비디오 트랜스코딩 작업은 요청 시 fops(파일 작업) 파라미터를 설정하여 정의합니다. fops 파라미터는 일련의 명령어와 하위 파라미터로 구성되며, 슬래시(/)로 연결되어 구분됩니다.

일반적인 구조는 다음과 같습니다:
<op>/<Format_value>[/param1/<value1>/param2/<value2>...]|saveas/<Urlsafe_Base64_Encoded_Save_Path>

예를 들어, 일반적으로 사용되는 일부 파라미터를 포함한 좀 더 자세한 구조는 다음과 같습니다:

<op>/<Format>
    /r/<value>
    /ab/<value>
    /vb/<value>
    /vcodec/<value>
    /acodec/<value>
    /s/<value>
    /autoscale/<value>
    /autofill/<value>
    /GOPInterval/<value>
    /rotate/<value>
    /an/<value>
    /vn/<value>
    /moovToFront/<value>
    /sar/<value>
    /preset/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:savedfilename)>

주요 사항:

• op: 작업 유형입니다. 비디오 live streaming transcoding의 경우, 이 값은 avthumb로 고정되어 있습니다.
• Format: 출력 비디오의 대상 포맷(예: mp4, flv)을 나타냅니다.
• |saveas/...: 필수 항목입니다. 변환된 파일의 저장 위치(버킷)와 파일명을 URL-안전 Base64 인코딩을 통해 지정합니다.

상세 매개변수 설명

아래 표는 비디오 live streaming transcoding에서 지원하는 매개변수 및 그 설명을 나열합니다:

참고 사항:

• 파라미터 이름과 값은 대소문자를 구분합니다.
• 특정 파라미터 조합을 사용할 경우, 종속성 또는 충돌이 발생할 수 있습니다. 자세한 내용은 해당 파라미터 설명을 참조해 주시기 바랍니다.

HLS 사전 설정

HLS(m3u8) 트랜스코딩 구성을 간소화하기 위해 일련의 사전 설정이 제공됩니다. 각 사전 설정은 최적화된 파라미터 조합을 의미합니다.

참고: 프리셋의 해상도는 원본 비디오의 특성에 따라 비율 유지를 위해 조정될 수 있습니다.

예시

예시 1: MP4를 FLV로 변환

이 예시는 Object Storage 버킷 vod-wcs-test001에 위치한 test.mp4라는 비디오를 FLV 포맷으로 live streaming transcoding 하는 방법을 보여줍니다. 비디오 비트레이트는 128k로 설정됩니다. 변환된 파일은 test_file.flv로 명명되어 동일한 버킷에 저장됩니다.

파라미터 조합 (fops):
avthumb/flv/vb/128k|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.flv)

의사 코드 요청 (curl):

curl -v -X POST \
  --data "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(avthumb/flv/vb/128k|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.flv))&force=1&separate=1" \
  --header "Authorization: AccessKey:EncodeSign" \
  --url "<http://mgrDomain/fops>"

실제 요청(Base64 인코딩됨):

curl -v -X POST \
  -d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5tcDQ=&fops=YXZ0aHVtYi9mbHYvdmIvMTI4a3xzYXZlYXMvZG05a0xYZGpjeTEwWlhOME1EQXhPblJsYzNSZlptbHNaUzVtYkhZPQ==&force=1&separate=1" \
  -H "Authorization: AccessKey:EncodeSign" \
  --url "<http://mgrDomain/fops>"

예시 2: MP4를 HLS로 변환 (프리셋 사용)

이 예시는 오브젝트 스토리지 버킷 vod-wcs-test001에 저장된 test.mp4 동영상을 HLS 포맷으로 변환하며, .m3u8 매니페스트 파일과 관련 .ts 세그먼트를 생성합니다. 이 예시에서는 video_16x9_150k 프리셋을 사용합니다. 해당 프리셋에는 일반적으로 다음과 같은 파라미터가 포함되어 있습니다:

• 비트레이트: 150kbps
• 화면 비율: 16:9
• 해상도: 약 400x224 (또는 소스를 기준으로 조정)

주요 트랜스코딩된 .m3u8 파일은 test.m3u8으로 명명되어 동일한 버킷에 저장됩니다.

파라미터 조합 (fops):
avthumb/m3u8/preset/video_16x9_150k|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test.m3u8)

의사 코드 요청 (curl):

curl -v -X POST \
  --data "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(avthumb/m3u8/preset/video_16x9_150k|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test.m3u8))&force=1&separate=1" \
  --header "Authorization: AccessKey:EncodeSign" \
  --url "<http://mgrDomain/fops>"

실제 요청(Base64 인코딩됨):

curl -v -X POST \
  -d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5tcDQ=&fops=YXZ0aHVtYi9tM3U4L3ByZXNldC92aWRlb18xNng5XzE1MGt8c2F2ZWFzL2RtOWtMWGRqY3kxMFpYTjBNREF4T25SbGMzUXViVE4xT0E9PQ==&force=1&separate=1" \
  -H "Authorization: AccessKey:EncodeSign" \
  --url "<http://mgrDomain/fops>"