개요
Kollus에서 제공하는 Callback 정보는 플랫폼에서 전달하는 내용과 플레이어에서 전달하는 내용으로 구분될 수 있습니다. 플레이어에서 전달하는 정보는 사용자가 컨텐츠를 이용한 정보를 활용할 수 있도록 관련 정보를 지정된 Url에 전달하는 기능입니다. 진도율을 전송할때 응답을 확인하지 않습니다. 단, 네트워크 오류인 경우 해당 데이터를 보관후 재 전송 가능할때 재 전송됩니다. 해당 기능을 사용하기 위해서는 Kollus에 접속하여 관련 정보를 설정하시면 Video-gateway를 통해 관련 내용이 전달되어 재생과 관련된 정보를 전달합니다.
...
{CLIENT_USER_ID}
사용자의 User ID 입니다.
MediaToken 생성시 파라미터로 입력한 사용자의 ID 정보입니다. 이때 입력된 사용자 ID는 Kollus 시스템에서 관리되지 않고 사용자를 구분하는 Unique 정보로만 사용됩니다.
{START_AT}
Video-gateway를 호출한 시점의 Unixtimestamp 입니다.
사용자의 컨텐츠 이용중 다수의 재생정보 전달이 발생할 수 있습니다. 동일한 요청에 같은 {START_AT} 값을 갖게 되며, 같은 시간에 다수의 이용자가 발생할 경우 Unixtimestamp 이기 때문에 중복될 수 있습니다.
다운로드 컨텐츠의 경우 start_at은 컨텐츠 재생시 단말의 unixtimestamp 입니다.
{BLOCK_CNT}
Kollus에서 설정한 블럭의 개수입니다.
재생 정보를 지정된 블럭 개수로 나누어 관리하며 정보 전달시 함께 포함시킬수 있습니다.
{PLAY_TIME}
전체 재생 시간 (단위:초)
배속 기능을 사용하는 경우 배속을 포함한 시간입니다. 시간 값은 누적입니다.
10초간 2배속으로 재생한 경우 20초로 계산됩니다.
모든 재생 시간을 포함한 시간입니다. (구간반복을 한 경우도 모두 포함됩니다.)
{REAL_PLAYTIME}
실재 재생 시간 (단위:초)
배속 기능을 사용하는 경우 배속을 포함한 시간입니다. 시간 값은 누적입니다.
10초간 2배속으로 재생한 경우 20초로 계산됩니다.
seek, 구간 반복 등으로 이미 본 구간에 대한 데이터는 집계하지 않습니다.
2배속으로 10초동안 영상을 보신후 이전 20초전 구간으로 seek를 하여 20초 동안 시청하셨을 경우 real playtime은 20초 입니다.
{PLAYTIME_PERCENT}
DURATION에 대한 전체 재생 비율 (단위:%, 정수, 절사)
컨텐츠를 두번 반복해서 본 경우 200%로 계산됩니다.
{DURATION}
컨텐츠 길이 (단위:초)
{MEDIA_CONTENT_KEY}
Kollus media_content_key
{ENCODING_PROFILE_KEY}
Kollus encoding profile key
{PLAY_BLOCK_JSON}
데이터 포멧: JSON
블럭 재생 정보
{BLOCK_PLAY_1}~{BLOCK_PLAY_##{BLOCK_CNT}}
블럭 재생 여부
재생하지 않고 Skip
해당 블럭 재생 (0초 이상 재생하면 1로 설정됩니다.)
{BLOCK_TIME_1} ~{BLOCK_TIME_##{BLOCK_CNT}}
해당 블럭을 재생한 시간입니다. (단위:초)
플레이어의 배속기능을 이용해 재생한 경우 재생시간은 배속을 적용하여 계산됩니다.
반복해서 3초의 범위를 갖는 블럭을 2회 재생한 경우 블럭의 재생시간은 6초입니다.
{DURATION}이 {BLOCK_CNT} 보다 작은 경우 {BLOCK_TIME#}의 합은 {DURATION}을 초과합니다. (각 블럭의 재생시간이 밀리초로 나오는 경우 올림하여 1초로 계산합니다.)
{LAST_PLAY_AT}
마지막 재생 위치 (단위:초)
{HOST_NAME}
비디오 링크 요청 도메인명
ex) catenoid.video.kr.kollus.com
{PLAYER_ID}
Kollus 플레이어의 고유 ID 입니다.
플레이어 설치시 생성된 고유 ID 입니다.
플래쉬 플레이어의 경우 kfp 라는 고유 문자열을 전송합니다.
{PLAY_STATUS}
전용 플레이어에서만 사용가능(Flash, 공개 HTML5 사용안함)
play : 재생중
pause: 재생멈춤(일시정지)
stop: 플레이 창이 내려 갈 때
{RUN_TIME}
JSON_DATA의 runtime과 같음
{SHOW_TIME}
JSON_DATA의 showtime과 같음
{USERVALUE0}~{USERVALUE99}
Video-gateway호출에 추가된 추가 정보 입니다.
ex) LCD={USERVALUE0}&UCD={USERVALUE4}
영문,숫자 이외의 한글등의 문자열을 전달할 경우 웹 브라우저들의 차이점이 있기 때문에 해당 변수 전달시 UTF-8로 전달해야 합니다. (전달되는 문자열은 웹의 특성상 UrlEncode해서 전달해야 합니다.)
{JSON_DATA}
데이터 포멧: JSON
모든 재생 정보를 포함한 데이터
...