라이브 재생 콜백

재생 콜백(Play Callback)은 최종 사용자(End User)가 플레이어에서 라이브 재생을 요청할 때 실시간으로 호출됩니다. 콜백 서버로부터 정상 응답을 수신한 경우에만 라이브 시청이 가능합니다.

---

콜백 설정 방법

콜백 URL은 채널별로 독립적으로 설정할 수 있습니다.

⚠️주의

재생 콜백은 표준 HTML5 기반 플레이어가 아닌 Kollus 보안 플레이어 사용 시에만 작동합니다. Kollus 보안 플레이어가 적용되지 않은 채널에서는 URL을 설정하더라도 콜백이 호출되지 않습니다.

1. Kollus Live 콘솔에서 [채널 관리] > [채널 리스트] 메뉴로 이동합니다.
2. 상황에 따라 다음 중 하나를 선택합니다.
   • 신규 채널 생성 시 설정: 우측 상단의 [채널 등록]을 클릭합니다.
   • 기존 채널에 설정: 대상 채널 우측 [수정 아이콘]을 클릭합니다.
3. 하단의 [콜백] 탭에서 재생 콜백 URL을 입력한 후 [저장]을 클릭합니다.
   

---

요청

전송 방식

• Method: POST
• Content-Type: application/x-www-form-urlencoded
• Data Format: FormData

요청 파라미터

파라미터	타입	설명
kind	integer	100 (라이브 재생 콜백 고정 값)
client_user_id	string	시청자 ID (JWT 생성 시 입력한 client_user_id)
player_id	string	디바이스 고유 식별자
hardware_id	string	하드웨어 시리얼 넘버 (Windows 환경 등 식별 가능한 값이 존재하는 경우 제공)
device_name	string	디바이스 모델명
media_content_key	string	라이브 방송 키
channel_key	string	채널 키
uservalues	JSON string	고객사 정의 값 (uservalue0~uservalue99)
localtime	integer	디바이스 기준 UTC 시간

uservalues 예시

{
  "uservalue0": "class_code_01",
  "uservalue1": "product_code_02",
  "uservalue99": "custom_code_03"
}

---

응답 필드

data 항목

필드	타입	설명
result	integer	0: 비정상 (재생 차단) 1: 정상 (재생 허용)
message	string	result 값이 0일 때 플레이어에 표시할 메시지
vmcheck	integer	(Html5 Player for PC 전용) 가상머신(VM) 환경 재생 허용 여부 0: 허용 1: 체크 및 차단 (기본값)
disable_tvout	integer	TV 출력 제한 설정 (채널 기본 정책보다 우선 적용) 0: TV 출력 허용 1: TV 출력 차단

응답 예시

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