본문으로 건너뛰기

미디어 콘텐츠 키 확장

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 콜백
  • 이어보기
  • 중복 재생 차단
  • 북마크