...
Play 콜백이 정의되지 않은 채널은 콜백의 응답과 관계없이 재생을 진행합니다. 콜백이 정의된 채널을 통해 서비스되는 콘텐츠는 콜백에 대한 응답을 확인 후 재생하기 때문에 고객사에서 정의한 콜백 URL은 항상 응답상태를 유지하셔야 원활한 서비스를 받으실 수 있습니다.
주의:
고객사의 회원 아이디를 포함한 미디어 토큰(Media token)을 생성하여 요청된 경우에 Play 콜백이 호출됩니다. (미디어 토큰 생성은 별도 문서를 참고해 주십시오.)
Play 콜백 URL이 응답하지 않으면 재생 되지 않습니다.
Play 콜백은 다운로드된 콘텐츠에 대한 DRM 콜백과 다르게 동작합니다. 다운로드된 콘텐츠는 Play 콜백이 아닌 DRM 콜백으로 동작하게 됩니다. 필요에 따라 Play 콜백과 DRM 콜백 URL을 동일하게 등록하면 다운로드와 스트리밍시에 재생에 대한 응답을 동일하게 받으실 수 있습니다.
Callback flow
...
채널에 Play 콜백 URL을 설정합니다.
ex> http://www.foo.com/auth.php 가 고객사 Play 콜백 서버인 경우
JSON 데이터를 생성 후 JWT로 인코딩 한다.
Kollus mobile player가 http://www.foo.com/auth.php 에 다음의 정보를 POST 전송 합니다.
kind : 1, 3
client_user_id : 고객사 회원 아이디
Media token 생성시 포함된 아이디입니다.
player_id : 고객사 회원이 가지고 있는 단말 아이디
device_name : 고객사 회원이 가지고 있는 단말명
media_content_key : 현재 재생하려는 콘텐츠 key 입니다.
채널에 등록된 컨텐츠에 부여된 고유 키입니다.
업로드된 컨텐츠를 여러채널에 등록하면 media_content_key는 모두 다르게 생성됩니다.
고객사 Play 콜백 서버는 전달 받은 위 정보를 바탕으로 다음의 json 포멧의 data를 JWT의 payload 에 추가하여 Encoding 하고 헤더에 지정된 “시용자키(X-KOLLUS-USERKEY)"를 함께 전송합니다.
(고객사가 인증 정보를 플레이어로 전달할 때 모든 데이터의 자료형은 반드시 기술된대로 integer 형이여야만 합니다.)
Response JSON spec.
Json Tag | Description |
|---|---|
expiration_date | unixtime stamp (만료될 시간의 unixtime stamp) |
result | 반환 결과가 정상인 경우 1, 비정상인 경우 0을 반환하도록 합니다. |
content_expired | DRM 컨텐츠를 강제로 expire 시킵니다. |
Callback Kind
Play 콜백이 호출되는 상황은 아래 3가지 경우입니다.
콘텐츠의 Expire 정보를 요청하는 경우 (kind:1)
Request
구분 | Description |
|---|---|
POST | Http POST로 요청합니다. (parameter가 아닙니다.) |
kind | 1 |
client_user_id | 고객사 사용자 ID, media_token 생성시 사용된 client_user_id와 동일합니다. |
player_id | 고객사 사용자가 가지고 있는 단말의 아이디 |
hardware_id | 단말의 hardware 아이디(PC, 입력값이 있으면) |
device_name | 고객사 사용자가 가지고 있는 단말의 모델명 |
media_content_key | Kollus 컨텐츠 unique key |
uservalues | JSON format (VideoGateway 호출시 사용된 |
uservalue0~999) |
uservalues sample
uservalues={"uservalue0":"강의코드01","uservalue1":"상품코드02","uservalue9":" 생성코드03"}
VideoGateway(v.kr.kollus.com)호출시 사용된 uservalue0~9 uservalue0~999 정보를 함께 전달 받습니다.
Response
카테고리 | 구분 | 필수 | Description |
|---|---|---|---|
Data | (int) expiration_date | O | 만료될 시간의 unixtime stamp |
(int) result | O | 0 (비정상), 1 (정상) | |
(string) message | result == 0 (비정상)의 경우 message를 추가하면 지정 한 메시지가 표출됩니다.
| ||
(int) vmcheck | 0 (사용안함), 1 (사용함, default) virtural machine 체크 여부, PC(v3)용에서만 사용 가능 |
(array)
play_section{
start_time,
end_time
}
(int) disable_tvout | 0 (tvout 차단 안함), 1 (tvout 차단) 이 항목이 없으면 채널에 있는 disable_tvout정책이 적용됩니다. | ||
(int) | 이 항목이 없거나 0이면 재생 시간을 사용하지 않고 0보다 크면 해당 값의 초만큼만 재생 후 종료합니다. | ||
(int) cpcheck | 0 (사용안함), 1 (사용함, default) 캡쳐프로그램 체크 여부, PC용에서만 사용 가능 | ||
exp | (int) | 사용 가능 시간 unixtime stamp(옵션) |
Example
| Code Block | ||
|---|---|---|
| ||
{
“data” : {
"expiration_date": 1402444800,
"vmcheck": 1,
"play_section": [
“start_time”: 0,
“end_time” : 60
],
"disable_tvout": 1,
"expiration_playtime": 1800,
"result": 1
},
“exp” : 1477558242
} |
...
주의) 콘텐츠 재생을 위해 반드시 응답해야 합니다. Play 콜백에 대한 응답을 확인 후에 재생을 시작합니다.
Request
구분 | Description |
|---|---|
POST | Http POST로 요청합니다. (parameter가 아닙니다.) |
kind | 3 |
client_user_id | 고객사 사용자 ID, media_token 생성시 사용된 client_user_id와 동일합니다. |
player_id | 고객사 사용자가 가지고 있는 단말의 아이디 |
device_name | 고객사 사용자가 가지고 있는 단말의 모델명 |
media_content_key | Kollus 컨텐츠 unique key |
uservalues | JSON format (VideoGateway 호출시 사용된 uservalue0~9) |
Response
카테고리 | 구분 | 필수 | Description |
|---|---|---|---|
data | (int) content_expired | 0 (재생가능), 1 (재생 제한) | |
(int) result | O | 0 (비정상), 1 (정상) | |
(string) message | result == 0 (비정상)의 경우나 content_expired이 1(재생 제한)의 경우 message를 추가하면 지정 한 메시지가 표출됩니다.
| ||
exp | (int) expiration_date | 사용 가능 시간 unixtime stamp(옵션) |
Example
| Code Block | ||
|---|---|---|
| ||
{
“data” : {
"content_expired": 1,
"result": 1
},
"exp" : 1477558242
} |
...