본문으로 건너뛰기

Live Play 콜백

개요

Kollus 전용 플레이어에서 Live 재생 시 고객사에서 정의한 URL을 호출(콜백, Callback)하는 기능을 정의한 문서입니다.

Request

구분설명
POSTHttp POST로 요청합니다.(parameter가 아닙니다.)
kind100
client_user_id고객사 사용자 ID. media_token 생성 시 사용된 client_user_id와 동일합니다.
player_id고객사 사용자가 가지고 있는 디바이스의 ID
hardware_id디바이스의 하드웨어 ID(PC, 입력값이 있으면)
device_name고객사 사용자가 가지고 있는 디바이스의 모델명
media_content_keyKollus 콘텐츠 unique key(방송 시작 시 부여되는 방송 key)
channel_key라이브 방송 채널 키(채널별로 부여되는 key)
uservaluesJSON format(VideoGateway 호출 시 사용된 uservalue0~9)
localtime디바이스의 UTC 시간
  • uservalues 예시
    • uservalues={"uservalue0":"강의코드01","uservalue1":"상품코드02","uservalue9":" 생성코드03"}
    • VideoGateway(http://v.kr.kollus.com) 호출 시 사용된 uservalue0~9 정보를 함께 전달받습니다.

Response

카테고리구분설명
data(int) result0(비정상), 1(정상)
(string) message0(비정상)의 경우 message를 추가하면 상황에 따른 메시지가 표시됩니다.
(int) vmcheck0(사용 안 함), 1(사용함, default)
Virtual Machine 체크 여부(PC v3 전용)
(int) disable_tvout0(TV Out 차단 안 함), 1(TV Out 차단)
이 항목이 없으면 채널의 disable_tvout 정책이 적용됩니다.

data 예시

{
"data": {
"vmcheck": 1,
"disable_tvout": 1,
"result": 1
},
}