플레이어 호출

Kollus 플레이어의 호출 방법을 설명합니다.

iframe Call

Kollus 플레이어를 호출하는 가장 기본적인 방법인 iframe 호출 방법을 설명합니다.

iframe 호출 예제

<iframe width="1280" height="720" src="https://v.kr.kollus.com/2iyzyDuP?" frameborder="0" allowfullscreen webkitallowfullscreen mozallowfullscreen allow="encrypted-media;autoplay"></iframe>

• 동영상의 레터 박스를 없애려면 동영상의 비율과 iframe 사이즈가 동일해야 합니다.
  • 예) 동영상 사이즈: 1920 * 1080
  • 예) iframe 사이즈: 1280 * 720 or 960 * 540 or 720 * 405
• 예제의 iframe 옵션을 모두 적용하는 것을 권장합니다.
• iframe 외부에서 플레이어를 컨트롤하거나 이벤트 수신이 필요한 경우 V/G Controller를 연동해야 합니다.
  • 참고: 플레이어 제어 스크립트(V/G Controller)

Custom Scheme Call

iframe 방식 호출도 가능하나, 페이지 내의 버튼 등 사용자 인터랙션을 통해 플레이어를 호출해야 하는 경우에는 본 가이드를 참고하여 연동하기 바랍니다.

intent 호출 예제(Android)

intent://path?https%3A%2F%2Fv.kr.kollus.com%2F2iyzyDuP#Intent;package=com.kollus.media;scheme=kollus;end

kollus 스키마 호출 예제(iOS)

kollus://path?https%3A%2F%2Fv.kr.kollus.com%2F2iyzyDuP

• 예제와 같이 path?(메서드) 뒤의 값들은 URL 인코딩(URL Encoding) 처리를 해야 합니다.
• path 메서드로 호출 시에는 스트리밍, download 메서드로 호출 시에는 DRM 다운로드가 동작합니다.
• DRM 다운로드가 동작하려면 DRM 다운로드 콜백 연동이 필요합니다.
  • 참고: DRM 다운로드 콜백
• 호출 시 사용되는 파라미터에 특수문자, 공백, 한글 등의 문자가 포함된 경우 반드시 URL 인코딩(URL Encoding) 처리를 해야 합니다.
  • 참고: Kollus 모바일 앱 연동(scheme_option)
• 자세한 내용은 예제 코드를 참고하세요.