본문으로 건너뛰기

플레이어 호출

콘텐츠 재생을 위한 다양한 플레이어 호출 방식을 설명합니다. 각 방식은 연동 목적과 보안 요구 수준에 따라 차이가 있으므로, 서비스 환경에 가장 적합한 방식을 선택하세요.

Kollus VOD는 크게 두 가지 연동 메커니즘을 지원합니다.

  • Kollus 플레이어 호출: 별도의 플레이어 개발 없이, Kollus VOD가 제공하는 표준 UI와 기능을 즉시 사용하고자 할 때 권장합니다.
  • 직접 스트림 링크(Direct Stream) 호출: 자체 커스텀 UI를 구현하거나 외부 플레이어를 연동하여 사용할 때 적용합니다.
ℹ️관련 정보

플레이어 호출을 위한 식별 정보는 아래 문서를 참고하세요.

일반 호출 방식​

일반 호출은 별도의 보안 인증(JWT) 없이 콘텐츠 식별자인 미디어 콘텐츠 키(Media Content Key)만으로 플레이어를 호출하는 비보안 방식입니다.

기본 호출 (공유 URL)​

기존 웹사이트 로직 수정 없이 가장 간편하게 재생 URL을 배포할 때 사용합니다.

https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}

사용자(End User)가 브라우저 주소창에 해당 URL을 입력하면, Kollus 플레이어가 로드되며 즉시 재생이 시작됩니다.

웹 페이지 내 삽입​

고객사 웹 페이지 내에 플레이어를 삽입하려면 <iframe> 태그의 src 속성에 해당 URL을 설정하세요.

<iframe
  width="#"
  height="#"
  src="https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}?"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>
⚠️주의
  • 화면 비율: width와 height는 콘텐츠의 해상도 비율에 맞춰 설정해야 검은색 여백(Letterbox) 없이 표시됩니다.
  • 전체 화면: 전체 화면 기능을 지원하려면 allowfullscreen, webkitallowfullscreen, mozallowfullscreen 속성을 반드시 명시해야 합니다.
  • Chrome 정책 대응: allow="local-network-access"는 Chrome 브라우저(142.X 이상)에서 Kollus DRM이 적용된 콘텐츠를 <iframe>으로 호출할 때 필수 옵션입니다.

R링크 호출 (비보안 스트림 URL)​

R링크는 Kollus 플레이어가 아닌, 고객사에서 직접 개발한 플레이어를 통해 비암호화 콘텐츠를 재생할 때 사용합니다.

ℹ️참고
  • 제한 사항: R링크 사용 시 Kollus 플레이어의 기본 기능 및 콘솔 내 분석(인사이트) 데이터를 활용할 수 없습니다.
  • 기능 활성화: R링크는 기본적으로 비활성화되어 있습니다. 해당 기능을 활성화하려면 영업 담당자(AM, biz@catenoid.net) 또는 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.

https://v.kr.kollus.com/r/{MEDIA_CONTENT_KEY}

해당 URL 호출 시 Kollus 시스템이 재생 가능한 스트림 주소로 HTTP 302 리다이렉션을 수행합니다.

I링크 호출 (모바일 앱 SDK 전용)​

I링크는 Kollus 모바일 SDK를 사용하여 개발된 앱 환경에서 비암호화 콘텐츠를 로드할 때 사용합니다.

https://v.kr.kollus.com/i/{MEDIA_CONTENT_KEY}

해당 URL을 SDK 초기화 코드 내 미디어 소스 주소로 설정하세요.

보안 호출 방식​

보안 호출은 JWT(JSON Web Token)를 기반으로 권한이 확인된 사용자(End User)에게만 재생을 허용하는 방식입니다. 단순 링크 공유를 통한 무단 시청을 방지하며, 중복 재생 차단 및 재생 만료 일시 설정 등 세밀한 제어가 가능합니다.

⚠️사용 조건

보안 호출 방식은 채널의 비암호화/암호화 설정과 관계없이 모든 콘텐츠에 적용할 수 있습니다.

S링크 호출 (보안 URL)​

S링크는 Kollus 플레이어를 사용하면서 보안 및 부가 기능을 적용할 때 사용합니다.

ℹ️주요 기능

S링크 사용 시 다음 기능을 제어할 수 있습니다.

  • 중복 재생 차단: 동일 계정의 다중 디바이스 동시 접속을 실시간으로 감지하고 차단합니다.
  • 만료 일시 설정: 토큰(JWT) 내 만료 일시를 설정하여 특정 시점 이후의 접근을 차단합니다.
  • 탐색(Seek) 차단: 시청자가 임의로 영상의 재생 시점을 건너뛰지 못하도록 제어합니다.
  • 재생속도 변경 제한: 배속 기능을 비활성화하거나 특정 배속으로 고정합니다.
  • 이어보기: 시청자가 시청을 중단했던 시점부터 자동으로 재생을 재개합니다.
  • LMS 콜백 연동: 사용자별 시청 이력 및 학습 진도율 데이터를 외부 시스템(LMS)으로 전송합니다.

https://v.kr.kollus.com/s?{JWT}&custom_key={CUSTOM_KEY}

사용자가 해당 URL에 접근하면 보안 검증 후 Kollus 플레이어가 로드됩니다.

웹 페이지 내 삽입​

고객사 웹 페이지 내에 플레이어를 삽입하려면 <iframe> 태그의 src 속성에 해당 URL을 설정하세요.

<iframe
  width="#"
  height="#"
  src="https://v.kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>
⚠️주의
  • 화면 비율: width와 height는 콘텐츠의 해상도 비율에 맞춰 설정해야 검은색 여백(Letterbox) 없이 표시됩니다.
  • 전체 화면: 전체 화면 기능을 지원하려면 allowfullscreen, webkitallowfullscreen, mozallowfullscreen 속성을 반드시 명시해야 합니다.
  • Chrome 정책 대응: allow="local-network-access"는 Chrome 브라우저(142.X 이상)에서 Kollus DRM이 적용된 콘텐츠를 <iframe>으로 호출할 때 필수 옵션입니다.

SR링크 호출 (보안 스트림 URL)​

SR링크는 고객사가 직접 개발한 플레이어를 사용하면서 보안 및 부가 기능을 적용할 때 사용합니다.

ℹ️제한 사항

SR링크 사용 시 Kollus 플레이어의 기본 기능 및 콘솔 내 분석(인사이트) 데이터를 활용할 수 없습니다.

https://v.kr.kollus.com/sr?{JWT}&custom_key={CUSTOM_KEY}

해당 URL 호출 시 Kollus 시스템이 JWT 유효성을 검증한 후 재생 가능한 스트림 주소로 HTTP 302 리다이렉션을 수행합니다.

SI링크 호출 (모바일 앱 SDK 전용)​

SI링크는 Kollus 모바일 SDK를 사용하여 개발된 앱 환경에서 암호화 콘텐츠를 로드할 때 사용합니다.

ℹ️주요 기능

SI링크 사용 시 다음 기능을 제어할 수 있습니다.

  • 중복 재생 차단: 동일 계정의 다중 디바이스 동시 접속을 실시간으로 감지하고 차단합니다.
  • 만료 일시 설정: 토큰(JWT) 내 만료 일시를 설정하여 특정 시점 이후의 접근을 차단합니다.
  • 탐색(Seek) 차단: 시청자가 임의로 영상의 재생 시점을 건너뛰지 못하도록 제어합니다.
  • 재생속도 변경 제한: 배속 기능을 비활성화하거나 특정 배속으로 고정합니다.
  • 이어보기: 시청자가 시청을 중단했던 시점부터 자동으로 재생을 재개합니다.
  • LMS 콜백 연동: 사용자별 시청 이력 및 학습 진도율 데이터를 외부 시스템(LMS)으로 전송합니다.

https://v.kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_KEY}

해당 URL을 SDK 초기화 코드 내 미디어 소스 주소로 설정하세요.