본문으로 건너뛰기

Kollus 모바일 앱 연동

모바일 웹 브라우저나 타 앱에서 Kollus 모바일 앱이 설치된 기기를 대상으로 커스텀 URL 스킴(kollus://)을 호출하여, 플레이어를 직접 실행하거나 특정 동작을 수행할 수 있습니다.

이 문서에서는 Android와 iOS 환경에서 공통으로 지원하는 호출 옵션을 설명합니다.

유의 사항​

  • Scheme에 포함되는 모든 파라미터 값은 반드시 URI 인코딩 처리를 해야 합니다.

기본 호출​

즉시 재생​

콘텐츠를 Kollus 모바일 앱에서 바로 재생합니다.

  • Scheme: kollus://path
  • 파라미터
    파라미터타입설명
    urlstring재생 URL
    자세한 내용은 플레이어 호출 문서를 참고하세요.

다운로드​

콘텐츠를 Kollus 모바일 앱 내 보관함으로 다운로드합니다.

ℹ️참고

다운로드 기능을 사용하려면 해당 콘텐츠가 포함된 채널에서 다운로드 사용을 활성화해야 합니다.
자세한 설명은 DRM 다운로드 콜백 문서를 참고하세요.

  • Scheme: kollus://download
  • 파라미터
    파라미터타입설명
    urlstring재생 URL
    자세한 내용은 플레이어 호출 문서를 참고하세요.
    folderstring콘텐츠가 저장될 폴더
    이 폴더는 실제 경로가 아닌 플레이어에서 지원하는 가상의 구조로, media/movie/video처럼 하위 폴더 구성이 가능합니다.

멀티 다운로드 예시​

url 파라미터를 연결하여 여러 콘텐츠를 한 번에 다운로드할 수 있습니다.

kollus://download?url=...&url=...&url=...

다운로드 콘텐츠 재생​

다운로드된 콘텐츠를 Kollus 모바일 앱에서 재생합니다.
해당 콘텐츠가 기기에서 삭제되었거나 존재하지 않을 경우, 스킴 호출은 **자동으로 무시(Ignored)**되며 플레이어는 아무런 동작을 수행하지 않습니다.

  • Scheme: kollus://download
  • 파라미터
    파라미터타입설명
    urlstring재생 URL
    자세한 내용은 플레이어 호출 문서를 참고하세요.

다운로드 목록 표시​

Kollus 모바일 앱 실행 시, 다운로드 완료 콘텐츠 목록을 바로 보여줍니다.
특정 폴더의 목록만 표시하려면 folder 파라미터를 지정하세요.

  • Scheme: kollus://list
  • 파라미터
    파라미터타입설명
    folderstring해당 폴더에 저장된 콘텐츠 목록만 표시
    미지정 시 루트 폴더의 목록이 표시됩니다.

Mac에서 호출하기​

Mac 전용 Kollus 플레이어도 모바일과 동일한 URL Scheme을 통해 호출할 수 있습니다.

즉시 재생​

  • Scheme: kollus://path
  • 파라미터
    파라미터타입설명
    urlstring재생 URL
    자세한 내용은 플레이어 호출 문서를 참고하세요.

예시​

kollus://path?url=https%3A%2F%2Fv.kr.kollus.com%2Fsi%3Fjwt%3D{JWT}%26custom_key%3D{CUSTOM_KEY}%26title%3D{CUSTOM_TITLE}