본문으로 건너뛰기

플레이어 호출

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

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

  • Kollus 플레이어 호출: 별도의 플레이어 개발 없이, Kollus가 제공하는 표준 UI와 기능을 즉시 사용하고 싶을 때 권장합니다.
  • 직접 스트림 링크(Direct Stream) 호출: 네이티브 앱 환경에서 자체 커스텀 UI를 구현하거나, 외부 플레이어를 사용하여 연동할 때 사용합니다.

기본 호출 방식​

미디어 콘텐츠 키 호출 (공유 URL)​

기존 웹사이트의 비즈니스 로직을 수정하지 않고, 가장 간편하게 플레이어를 임베드할 때 사용합니다.

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

{MEDIA_CONTENT_KEY}는 Kollus VOD 콘솔 > [채널] > 채널 선택 > 콘텐츠 목록에서 확인할 수 있습니다.

웹 브라우저에서 열기​

사용자가 브라우저 주소창에 해당 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는 콘텐츠의 해상도 비율(예: 16:9)에 맞춰 설정해야 검은색 여백(Letterbox) 없이 표시됩니다.
  • 전체 화면: 전체 화면 기능을 지원하려면 allowfullscreen, webkitallowfullscreen, mozallowfullscreen 속성을 반드시 명시해야 합니다.
  • Chrome 정책 대응: allow="local-network-access"는 Chrome 브라우저(142.X 이상)에서 Kollus DRM이 적용된 콘텐츠를 <iframe>으로 호출할 때 필수 옵션입니다.

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

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

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

{MEDIA_CONTENT_KEY}는 Kollus VOD 콘솔 > [채널] > 채널 선택 > 콘텐츠 목록에서 확인할 수 있습니다.

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


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

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

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

{MEDIA_CONTENT_KEY}는 Kollus VOD 콘솔 > [채널] > 채널 선택 > 콘텐츠 목록에서 확인할 수 있습니다.

I링크 URL을 SDK 초기화 코드 내 미디어 소스 주소로 설정합니다.

보안 호출 방식​

보안 호출은 JWT(JSON Web Token)를 활용하여 승인된 사용자(End User)에게만 콘텐츠 재생을 허용하는 방식입니다.
단순 링크 노출을 방지하고 중복 재생 차단, 재생 만료 시각 설정 등 강력한 제어 기능을 제공합니다.

S링크 호출 (보안 URL)​

S링크는 승인된 사용자만 콘텐츠를 시청할 수 있도록 제어할 때 사용합니다.

ℹ️참고

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

  • 중복 재생 차단, 재생 만료 시각 설정, 탐색(Seek) 차단, 재생속도 변경 제한, 이어보기, 사용자별 LMS 콜백 연동 등
https://v.kr.kollus.com/s?{JWT}&custom_key={CUSTOM_KEY}

{JWT}는 암호화 콘텐츠 재생 URL 생성 (JWT) 문서를 참고하세요.
{CUSTOM_KEY}는 Kollus VOD 콘솔 > [서비스 계정] > [사용자 키]에서 확인할 수 있습니다.

웹 브라우저에서 열기​

사용자가 브라우저 주소창에 S링크 URL을 입력하면 Kollus 플레이어가 로드되며 즉시 재생됩니다.

웹 페이지 내 삽입하기​

고객사의 웹 페이지 내에 플레이어를 포함하려면 <iframe> 태그의 src 속성에 S링크 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는 콘텐츠의 해상도 비율(예: 16:9)에 맞춰 설정해야 검은색 여백(Letterbox) 없이 표시됩니다.
  • 전체 화면: 전체 화면 기능을 지원하려면 allowfullscreen, webkitallowfullscreen, mozallowfullscreen 속성을 반드시 명시해야 합니다.
  • Chrome 정책 대응: allow="local-network-access"는 Chrome 브라우저(142.X 이상)에서 Kollus DRM이 적용된 콘텐츠를 <iframe>으로 호출할 때 필수 옵션입니다.

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

SR링크는 미디어 콘텐츠 키를 외부로 노출하지 않으면서, 고객사의 자체 플레이어에서 보안 정책(중복 재생 차단 등)을 적용하여 스트리밍할 때 사용합니다.

ℹ️참고
  • 기능 제한: SR링크 사용 시 Kollus 플레이어의 고유 기능 및 콘솔 내 분석(인사이트) 기능을 사용할 수 없습니다.
  • SR링크는 기본적으로 비활성화되어 있습니다.
    해당 기능을 활성화하려면 Kollus 영업 담당자(AM, biz@catenoid.net) 또는 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.
https://v.kr.kollus.com/sr?{JWT}&custom_key={CUSTOM_KEY}

{JWT}는 암호화 콘텐츠 재생 URL 생성 (JWT) 문서를 참고하세요.
{CUSTOM_KEY}는 Kollus VOD 콘솔 > [서비스 계정] > [사용자 키]에서 확인할 수 있습니다.

SR링크 URL을 호출하면 Kollus 시스템이 JWT의 유효성을 검증한 뒤 재생 가능한 스트림 주소로 HTTP 302 리다이렉션을 수행합니다.


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

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

ℹ️참고

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

  • 중복 재생 차단, 재생 만료 시각 설정, 탐색(Seek) 차단, 재생속도 변경 제한, 이어보기, 사용자별 LMS 콜백 연동 등
https://v.kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_KEY}

{JWT}는 암호화 콘텐츠 재생 URL 생성 (JWT) 문서를 참고하세요.
{CUSTOM_KEY}는 Kollus VOD 콘솔 > [서비스 계정] > [사용자 키]에서 확인할 수 있습니다.

SI링크 URL을 SDK 초기화 코드 내 미디어 소스 주소로 설정합니다.