본문으로 건너뛰기

VideoGateway 호출

Kollus Live 연동 시, 가장 먼저 호출해야 하는 VideoGateway(VG)의 호출 방법을 설명합니다.

미디어 콘텐츠 키 호출 방식(공유 링크)​

https://v-live-kr.kollus.com/{MEDIA_CONTENT_KEY}
  • 위의 주소처럼 URL 마지막에 미디어 콘텐츠 키를 직접 붙여 호출하는 방식입니다.
  • 공유 채널에서 사용할 수 있습니다.
  • iframe 내 src로 사용하거나 브라우저 주소 입력란에 넣어 사용할 수 있습니다.
https://v-live-kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
  • Kollus JWT를 사용하여 암호화 URL로 호출하는 방식입니다.
  • 공유 채널 및 암호화 콘텐츠 전용 채널 모두에서 사용할 수 있습니다.
  • iframe 내 src로 사용하거나 브라우저 주소 입력란에 넣어 사용할 수 있습니다.

SR 링크 호출 방식​

https://v-live-kr.kollus.com/sr?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
  • 위의 방식으로 콘텐츠 호출 시 실제 mp4 / m3u8 주소로 302 리다이렉션이 발생합니다.
  • 자체 플레이어에서 콘텐츠를 재생하거나 다운로드하기 위해 사용하는 호출 방식입니다.
  • 리다이렉트된 링크는 2일간 외부에서 호출이 없을 경우 삭제되므로 이 링크를 저장하여 사용하는 방식은 권장하지 않습니다.
  • SR 링크의 헤더 정보를 읽어 리다이렉트된 주소를 불러오는 방식을 권장합니다.
  • SR 링크와 레퍼러 차단 기능은 함께 사용할 수 없습니다.

SI 링크 호출 방식​

https://v-live-kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
  • intent 혹은 kollus scheme으로 Kollus 앱에 재생하려는 콘텐츠 정보를 전달하기 위한 호출 방식입니다.
  • 모바일 플레이어 호출 방법은 여기를 참고하세요.

I 링크 호출 방식(공유 링크)​

https://v-live-kr.kollus.com/i/{MEDIA_CONTENT_KEY}
  • SI 링크와 비슷한 방식으로 Kollus 모바일 플레이어에 재생 정보를 전달하기 위한 호출 방식입니다.
  • 모바일 플레이어 호출 방법은 여기를 참고하세요.

R 링크 호출 방식(공유 링크)​

https://v-live-kr.kollus.com/r/{MEDIA_CONTENT_KEY}
  • SR 링크와 비슷한 방식으로 실제 mp4 / m3u8 주소를 공유 링크 방식으로 획득하기 위한 호출 방식입니다.
  • 자체 플레이어에서 콘텐츠를 재생하거나 다운로드하기 위해 사용하는 호출 방식입니다.
  • 리다이렉트된 콘텐츠 링크는 2일간 외부에서 호출이 없을 경우 삭제되므로 리다이렉트링크를 저장하여 사용하는 방식은 권장하지 않습니다.
  • R 링크를 호출한 뒤 헤더 정보를 읽어 리다이렉트된 주소를 불러오는 방식을 권장합니다.
  • R 링크 방식을 사용하려면 담당 PE 또는 tech_support@catenoid.net 으로 문의하기 바랍니다.
  • R 링크 방식과 레퍼러 차단 기능은 함께 사용할 수 없습니다.