본문으로 건너뛰기

플레이어 호출

라이브 방송을 고객사 웹사이트 등에 임베딩하기 위한 플레이어 호출 방식을 설명합니다. 각 방식은 채널 설정과 보안 요구 수준에 차이가 있으므로, 서비스 환경에 적합한 방식을 선택하세요.

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

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

키(Key/ID) 정보는 아래 문서를 참고하세요.

일반 호출 방식 (공개 채널)​

일반 호출은 별도의 보안 인증(JWT) 없이 채널 키만으로 플레이어를 호출하는 비보안 방식입니다.

주의

일반 호출 방식은 채널 설정이 공개 상태인 경우에만 정상적으로 작동합니다. 비공개 채널의 경우에는 보안 호출 방식을 사용하세요.

기본 호출 (공유 URL)​

기존 웹사이트 로직 수정 없이 가장 간편하게 방송 URL을 배포할 때 사용합니다. 해당 URL은 채널 상세 페이지의 [비디오 게이트웨이 링크]와 동일합니다. 사용자가 브라우저 주소창에 해당 URL을 입력하면, Kollus 플레이어가 로드되며 즉시 재생이 시작됩니다.

https://v-live-kr.kollus.com/{CHANNEL_KEY}

웹 페이지 내 삽입​

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

<iframe
  width="#"
  height="#"
  src="https://v-live-kr.kollus.com/{CHANNEL_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 Live 콘솔 내 통계 기능을 사용할 수 없습니다.

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

https://v-live-kr.kollus.com/r/{CHANNEL_KEY}

보안 호출 방식​

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

S링크 호출 (보안 URL)​

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

https://v-live-kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}
주요 기능

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

  • 중복 재생 차단: 동일 계정의 다중 디바이스 접속을 실시간으로 감지하고 차단합니다.
  • 만료일 설정: 토큰(JWT) 내 만료일을 설정하여 특정 시점 이후의 접근을 차단합니다.
  • LMS 콜백 연동: 사용자별 시청 이력 및 재생 진행률(진도율) 데이터를 학습 관리 시스템(LMS)으로 전송합니다.

웹 페이지 내 삽입​

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

<iframe
  width="#"
  height="#"
  src="https://v-live-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 Live 콘솔 내 통계 기능을 사용할 수 없습니다.

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

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