콜백 설정
이 페이지에서는 Kollus VOD의 채널 메뉴에서 콜백 설정을 하는 방법에 대해 안내합니다.
콜백Kollus VOD는 작업이 완료되었음을 표시하기 위해 콜백(callback) 알림을 지원합니다. 콜백 기능은 Kollus VOD의 콘텐츠 전송 채널마다 콜백을 설정할 수 있도록 지원하며 고객에게 작업 진행 성공 또는 실패 시 고객의 웹 URL로 작업 진행 상황 알림을 전송하여 편의성을 제공합니다.
콜백
Kollus VOD의 콜백은 플랫폼에서 전달하는 플랫폼 콜백과 플레이어에서 전달하는 플레이어 콜백으로 구분됩니다. 플랫폼 콜백은 Kollus VOD 웹 콘솔에서 요청한 작업을 완료했을 경우 알림을 전송합니다. 플랫폼 콜백은 채널에 콘텐츠가 추가, 삭제 및 재생이 되면 알림을 전송하는 채널 콜백을 포함합니다.
Kollus VOD의 채널 메뉴 리스트 또는 카드 리스트에서 더보기> 콜백 설정에서는 채널에 콘텐츠가 추가가 되면 콜백 알림을 전송하는 채널 콜백을 설정할 수 있습니다. 채널에 콘텐츠가 추가, 삭제, 재생이 될 때 알림을 받고 싶은 경우 콜백 사용 버튼을 클릭하여 콘텐츠 추가 콜백 URL과 삭제 URL을 입력합니다. 재생 콜백 URL을 입력하고자 하는 경우, 콜백 사용 버튼을 클릭하지 않아도 입력 및 저장이 가능합니다.
다운로드 콜백
플레이어 콜백은 플레이어에서 이용한 콘텐츠 정보를 콜백 URL로 지정한 주소에 전달하는 기능입니다. 플레이어 콜백은 Kollus Player에서 요청한 작업을 완료했을 경우 알림을 전송합니다.
Kollus Player에서 DRM으로 보안이 적용된 동영상 콘텐츠의 재생 제한 횟수, 콘텐츠 만료 기간, 콘텐츠 재생시간 정보를 설정하여 콘텐츠의 재생을 제어하고, 요청의 결과를 확인할 수 있습니다. DRM 콜백은 콘텐츠 다운로드 전, 다운로드 후, 재생 요청 단계에서 사용자, 디바이스, 미디어 콘텐츠 키 등을 확인합니다.
DRM 콜백을 사용하기 위해서는 더보기> 콜백 설정의 다운로드 콜백 메뉴에서 DRM 콜백 URL을 설정해야 합니다. 다운로드 콜백 메뉴 하단의 모바일 다운로드 사용을 선택하여 모바일 다운로드 DRM 콜백 URL을 입력합니다.
LMS 콜백
플레이어 콜백은 플레이어에서 사용자가 이용한 콘텐츠 정보를 LMS 콜백 URL에 전달하는 LMS 콜백을 포함합니다. 채널에서 LMS 콜백을 설정한 후에 동영상 재생 정보를 설정된 LMS 콜백으로 전달받을 수 있습니다. LMS 콜백은 플레이어가 일시정지, 정지를 하는 경우도 콜백이 호출됩니다. LMS 콜백은 다음의 항목을 설정할 수 있습니다.
블록 수: 콘텐츠 재생 구간을 나누는 블록의 수입니다. 10으로 설정하면 콘텐츠의 길이가 300초의 경우 각 블록은 30초로 구성됩니다.
전송 주기: 지정한 전송 주기마다 호출됩니다. 전송 주기는 초 단위를 지원합니다.
블록 정보 포함: 활성화할 경우 block_info 전송 항목에 블록 개수 정보를 포함 시킵니다.
세션 정보 포함: 활성화할 경우 block_info 전송 항목에 세션 정보(블록 정보, 블록 시작, 재생 시간 등)를 포함 시킵니다.
콜백 URL: LMS 콜백을 전달받을 URL을 입력합니다.
플러그인 옵션: 재생 정보를 전달하기 위한 옵션은 JSON 형태의 Array로 전달됩니다. LMS 콜백에 포함할 옵션을 선택합니다.
LMS 콜백 URL: 설정 항목이 적용된 LMS 콜백 URL을 확인할 수 있습니다.
플레이어 '다음 회차' 콜백
'다음 회차'는 사용자가 연속된 시리즈 동영상을 볼 때 일일이 다음 편을 찾아가지 않고, 보던 영상 끝 부분에 뜨는 ‘다음 회’ 버튼을 눌러 바로 다음 영상을 볼 수 있는 서비스입니다. 이 서비스를 위해서는 ‘다음 회차’ 콜백 설정과 JWT 등이 준비되어야 합니다.
플레이어 ‘다음 회차 사용 : '다음 회차' 사용 여부를 체크합니다. (기본값은 off)
영상 종료 N초 전 ‘다음 회’ 버튼 표시 : 영상 종료까지 입력한 숫자의 시간이 남았을 때 ‘다음 회’ 버튼이 표시됩니다.
텍스트 박스에는 600이하의 정수만 입력 가능합니다. (기본값은 10)
플레이어 영상 시간보다 더 긴 시간으로 설정 시, ‘다음 회’ 버튼은 영상 처음부터 노출됩니다.
콜백 URL : 다음 회차 콜백을 받으실 URL을 입력합니다.
플러그인 옵션 : '다음 회차' 실행 관련 정보들을 JSON 형태로 전달합니다. 콜백에 포함할 플러그인을 선택합니다.
다음 회차 콜백 URL : 콜백 URL 입력과 플러그인 옵션 선택을 마치면 자동으로 ‘다음 회차 콜백 URL’이 작성됩니다.
Last updated