플레이어 호출

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

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

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

관련 정보

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

• 키(Key/ID) 정보: 인증 및 주요 키
• JWT(JSON Web Token) 규격: 재생 URL 생성 (JWT)

---

일반 호출 방식

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

기본 호출 (공유 URL)

기존 웹사이트 로직 수정 없이 가장 간편하게 재생 URL을 배포할 때 사용합니다. 사용자가 브라우저 주소창에 해당 URL을 입력하면, Kollus 플레이어가 로드되며 즉시 재생이 시작됩니다.

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

웹 페이지 내 삽입

고객사 웹 페이지 내에 플레이어를 삽입하려면 <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링크는 기본적으로 비활성화되어 있습니다. 해당 기능을 활성화하려면 영업 담당자(AM, biz@catenoid.net) 또는 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.
• 제한 사항: R링크 사용 시 Kollus 플레이어의 기본 기능 및 Kollus VOD 콘솔 내 분석(인사이트 메뉴) 데이터를 활용할 수 없습니다.

R링크는 Kollus 플레이어가 아닌, 고객사에서 직접 개발한 플레이어를 통해 비암호화 콘텐츠를 재생할 때 사용합니다. 해당 URL 호출 시 Kollus 시스템이 재생 가능한 스트림 주소로 HTTP 302 리다이렉션을 수행합니다.

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

---

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

I링크는 Kollus 모바일 SDK를 사용하여 개발된 앱 환경에서 비암호화 콘텐츠를 로드할 때 사용합니다. 해당 URL을 SDK 초기화 코드 내 미디어 소스 주소로 설정하세요.

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

---

보안 호출 방식

보안 호출은 JWT(JSON Web Token)를 기반으로 권한이 확인된 사용자에게만 재생을 허용하는 방식입니다. 단순 링크 공유를 통한 무단 시청을 방지하며, 중복 재생 차단 및 재생 만료 일시 설정 등 세밀한 제어가 가능합니다. 보안 호출 방식은 채널 설정(비암호화/암호화 콘텐츠 전용)과 무관하게 적용할 수 있습니다.

S링크 호출 (보안 URL)

S링크는 Kollus 플레이어를 사용하면서 보안 및 부가 기능을 적용할 때 사용합니다. 사용자가 해당 URL에 접근하면 보안 검증 후 Kollus 플레이어가 로드됩니다.

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

주요 기능

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

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

웹 페이지 내 삽입

고객사 웹 페이지 내에 플레이어를 삽입하려면 <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링크 사용 시 Kollus 플레이어의 기본 기능 및 Kollus VOD 콘솔 내 분석(인사이트 메뉴) 데이터를 활용할 수 없습니다.

SR링크는 고객사가 직접 개발한 플레이어를 사용하면서 보안 및 부가 기능을 적용할 때 사용합니다. 해당 URL 호출 시 Kollus 시스템이 JWT 유효성을 검증한 후 재생 가능한 스트림 주소로 HTTP 302 리다이렉션을 수행합니다.

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

---

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

SI링크는 Kollus 모바일 SDK를 사용하여 개발된 앱 환경에서 암호화 콘텐츠를 로드할 때 사용합니다. 일반 웹 브라우저 환경에서는 S링크를 사용하세요. 해당 URL을 SDK 초기화 코드 내 미디어 소스 주소로 설정하세요.

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

주요 기능

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

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