본문으로 건너뛰기

플레이어 호출

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

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

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

식별 키 정보는 아래 문서를 참고하세요.

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

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

⚠️사용 조건

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

기본 호출 (공유 URL)​

기존 웹사이트 로직 수정 없이 가장 간편하게 방송 시청 URL을 배포할 때 사용합니다. 해당 URL은 채널 상세 페이지의 [비디오 게이트웨이 링크]와 동일합니다.

https://v-live-kr.kollus.com/{CHANNEL_KEY}
채널 상세 페이지

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

웹 페이지 내 삽입​

고객사 웹 페이지 내에 플레이어를 삽입하려면 <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링크는 Kollus 플레이어가 아닌, 고객사에서 직접 개발한 자체 플레이어를 활용할 때 사용합니다.

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

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

보안 호출 방식​

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

⚠️사용 조건

보안 호출 방식은 채널의 공개/비공개 설정과 무관하게 적용할 수 있습니다.

S링크 호출 (보안 URL)​

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

ℹ️주요 기능

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

  • 중복 재생 차단: 동일 계정의 다중 디바이스 접속을 실시간으로 감지하고 차단합니다.
  • 만료 일시 설정: 토큰(JWT) 내 만료 일시를 설정하여 특정 시점 이후의 접근을 차단합니다.
  • LMS 콜백 연동: 사용자별 시청 이력 및 학습 진도율 데이터를 외부 시스템(LMS)으로 전송합니다.
https://v-live-kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}

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

웹 페이지 내 삽입​

고객사 웹 페이지 내에 플레이어를 삽입하려면 <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링크는 고객사가 직접 개발한 플레이어를 사용하면서 보안 및 부가 기능을 적용할 때 사용합니다.

ℹ️제한 사항

SR링크 사용 시 Kollus 플레이어의 기본 기능 및 콘솔 내 통계 기능을 사용할 수 없습니다.

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

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