VideoGateway 호출 방법

콜러스 연동 시 가장 처음 연동할 V/G 호출하는 방안에 대한 가이드입니다.

1. 미디어컨텐츠키 호출 방식(공유링크)

VOD Example)https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}

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

• 위 주소처럼 V/G 뒷 주소에 미디어 컨텐츠 키를 직접 붙여 호출하는 방식

• 채널 설정이 공유일 경우 사용 가능

• iframe 내 src로 사용하거나 브라우저 주소 입력란에 넣고 사용할 수 있습니다.

2. S Link 호출 방식

VOD Example)https://v.kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_USER_KEY}

Live Example)https://v-live-kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_USER_KEY}

• Kollus JWT를 사용하여 암호화 URL로 호출하는 방식

• 채널 설정 공유 및 비공유 모두 이용 가능

• iframe 내 src로 사용하거나 브라우저 주소 입력란에 넣고 사용할 수 있습니다.

3. SR 링크 호출 방식

VOD Example)https://v.kr.kollus.com/sr?jwt={JWT}&custom_key={CUSTOM_USER_KEY}

Live Example)https://v-live-kr.kollus.com/sr?jwt={JWT}&custom_key={CUSTOM_USER_KEY}

• 위와 같은 방식으로 컨텐츠 호출 시 실제 mp4 / m3u8 주소로 302 리다이렉션 호출

• 자체 플레이어에서 재생 혹은 컨텐츠 다운로드를 위해 사용하는 호출 방식

• 리다이렉트된링크는 2일간 외부에서 호출이 없을 경우 삭제되므로 이 링크를 저장하여 사용하는 방식은 권장하지 않습니다

• sr 링크의 헤더 정보를 읽어 리다이렉트된 주소를 불러오기를 권장 합니다.

4. SI 링크 호출 방식

VOD Example)https://v.kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_USER_KEY}

Live Example)https://v-live-kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_USER_KEY}

• intent 혹은 kollus scheme로 콜러스 앱에 재생하기 위한 컨텐츠 정보를 전달하기 위한 호출 방식입니다.

• 모바일 플레이어 호출 방식은 이 링크를 참고 부탁드립니다.

5. I 링크 호출 방식(공유링크)

VOD Example)https://v.kr.kollus.com/i/{MEDIA_CONTENT_KEY}

Live Example)https://v-live-kr.kollus.com/i/{MEDIA_CONTENT_KEY}

• si 링크와 비슷한 방식으로 공유 링크 방식으로 콜러스 모바일플레이어에 재생 정보를 전달하기 위한 호출 방식

• 모바일 플레이어 호출 방식은 이 링크를 참고 부탁드립니다.

6. R 링크 호출 방식(공유링크)

VOD Example)https://v.kr.kollus.com/r/{MEDIA_CONTENT_KEY}

Live Example)https://v-live-kr.kollus.com/r/{MEDIA_CONTENT_KEY}

• sr 링크와 비슷한 방식으로 실제 mp4 / m3u8 주소를 공유 링크 방식으로 획득하기 위한 호출 방식

• 자체 플레이어에서 재생 혹은 컨텐츠 다운로드를 위해 사용하는 호출 방식

• 리다이렉트된컨텐츠 링크는 2일간 외부에서 호출이 없을 경우 삭제되므로 리다이렉트링크를 저장하여 사용하는 방식은 권장하지 않습니다

• r 링크를 호출한 뒤 헤더 정보를 읽어 리다이렉트된주소를 불러오기를 권장 합니다.

• r 링크 방식을 사용하기 위해서는 담당 PE 또는 [e-mail] 으로 문의주시기 바랍니다.