미디어 콘텐츠 키 확장
Kollus VOD는 기존의 미디어 콘텐츠 키에 고객사가 정의한 임의 식별자(Custom ID)를 결합하는 기능을 지원합니다.
이 기능을 통해 하나의 원본 파일을 별개의 콘텐츠처럼 활용할 수 있습니다.
핵심 원리
- 논리적 분리: 다운로드, 이어보기 등 특정 기능에 한해서는 확장된 키를 서로 다른 콘텐츠로 인식합니다.
- 물리적 통합: 기본 콘텐츠 정보와 재생 이력은 원본 미디어 콘텐츠 키를 기준으로 공통 관리됩니다.
- 예시: Gmail의 별칭(Alias) 기능과 유사합니다. 확장 주소로 메일을 발송하면 기본 주소(
support@kollus.com)가 수신합니다.- 기본 주소:
support@kollus.com - 확장 주소:
support+cid1@kollus.com,support+cid2@kollus.com
- 기본 주소:
요청 형식
일반(비암호화) 콘텐츠인 경우, 원본 미디어 콘텐츠 키와 Custom ID를 -(하이픈)으로 연결하여 호출합니다.
요청 URL 구조
https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}-{CUSTOM_ID}
예시
https://v.kr.kollus.com/vnCVPVyV-new-custom-id
제약 사항
- 길이 제한: 확장된 키(
MEDIA_CONTENT_KEY-CUSTOM_ID)는 64 bytes 이내여야 합니다. - 허용 문자: 영문, 숫자,
-(하이픈)만 허용됩니다. - 인코딩 유의 사항: Custom ID에 한글 등 멀티바이트 문자를 사용하는 것은 권장하지 않습니다. UTF-8 인코딩 특성상 글자당 바이트 수가 가변적이므로, 64 bytes 제한을 초과하여 오류가 발생할 수 있습니다.
확장 키가 적용되는 기능
확장 키를 사용할 경우, Kollus 시스템은 아래 기능들에 대해 Custom ID별로 개별 데이터를 생성합니다.
- DRM 다운로드 콜백
- LMS 콜백
- 이어보기
- 중복 재생 차단
- 북마크