JWT PAYLOAD SPEC (LIVE)
Kollus Live 를 위해 신설된 jwt spec 입니다.
JWT Payload의 형식은 다음과 같은 JSON 문자열입니다.
{ "client_user_id": "CLIENT_USER_ID", "client_user_name": "CLIENT_USER_NAME", "video_watermarking_code_policy": { "code_kind":"client_user_id", "font_size":7, "font_color":"FFFFFF", "show_time":1, "hide_time":500, "alpha":50, "enable_html5_player": false }, "client_user_image": "CLIENT_USER_IMAGE", "expire_time": EXPIRE_TIME, "play_expt": PLAY_EXPT_TIME, "live_media_channel_key": "LIVE_MEDIA_CHANNEL_KEY", "live_media_profile_key": "LIVE_MEDIA_PROFILE_KEY", "title": "TITLE", "chatting_policy": { "is_visible": true, "is_admin": false, "position": "right" } }
LIVE IFRAME SAMPLE
Kollus Live 적용을 위한 iframe 형식의 셈플 코드입니다
{livesample url} 해당 영역에 “비디오 게이트웨이 링크” 입력 하시면 됩니다.
iframe src = { livesample url }
1. 해당 Live 채널을 선택
2. 채널의 비디오 게이트웨이 링크 URL 복사
PAYLOAD 항목
이름 | Datatype | 필수 여부 | 내용 | 비고 |
client_user_id (or cuid) | String | 필수 | 컨텐츠에 억세스하려는 고객사의 사용자 아이디. 북마크나 NScreen 데이터의 Key로 사용됩니다. | |
client_user_name | String | 선택 | 채팅사용시 표시되는 이름으로 사용됩니다. | |
client_user_image | String | 선택 | 채팅에 나오는 이름옆 이미지 URL 입니다. https 여야 합니다. | |
expire_time(or expt) | Integer | 필수 | JWT가 유효한 시간. Unix timestamp 형식으로 입력합니다. 고객사 서버와의 시간이 정확하게 일치하지 않을 수도 있으므로, 최대 1분 정도는 유효기간이 지났더라도 접근할 수 있습니다. | |
play_expt | Integer | 선택 (기본값: 현재시간 + 2일) | edge로 요청시 적용받을 expire time | |
live_media_channel_key (or lmckey) | String | 필수 | 재생할 컨텐츠의 식별 키. 확장 라이브 미디어 채널 키 형식도 동일하게 사용할 수 있습니다. | |
live_media_profile_key(or lmpf) | String | 선택 | 라이브 채널의 프로파일 가운데 하나를 강제로 지정해 재생할 경우에 사용합니다. 강제로 지정할 프로파일의 키를 입력합니다. 자동 선택하게 두려면 해당 Entry를 삭제하거나, null로 입력하면 됩니다. 없으면 ABR로 작동합니다. | |
title (TITLE) | String | 선택 (기본값: null) | 컨텐츠의 기존 타이틀을 대체하는 문자열입니다. | |
chatting_policy.is_visible | boolean | 선택 (기본값: true) | 채팅 창이 보여짐을 정합니다. | |
chatting_policy.is_admin | boolean | 선택 (기본값: false) | 채팅 창에서 관리자임을 정합니다. | |
chatting_policy.position | string | 선택 (기본값: bottom) | 채팅창의 위치를 정합니다. bottom | left | right | |
video_watermaking_code_policy.code_kind | String | 선택 | "client_user_id"를 제외한 다른 String 일시 그대로 출력 | |
video_watermaking_code_policy.alpha | Integer | 선택(기본 값: 200) | 비디오워터마킹코드의 alpha 값을 정의 합니다. (16진수 0~255) | |
video_watermaking_code_policy.font_size | Integer | 선택(기본값: 7) | 비디오워터마킹코드의 font-size 값을 정의 합니다. (단위: px) | |
video_watermaking_code_policy.font_color | String | 선택(기본값; 'FFFFFF') | 비디오워터마킹코드의 font-color 값을 정의 합니다. | |
video_watermaking_code_policy.show_time | Integer | 선택(기본값;1) | 비디오워터마킹코드의 보여지는 시간을 정의 합니다. (단위: 초) | |
video_watermaking_code_policy.hide_time | Integer | 선택(기본값;60) | 비디오워터마킹코드의 보여진후 안보여지는 시간을 정의 합니다. (단위: 초) | |
video_watermaking_code_policy.enable_html5_player | Boolean | 선택(기본 값:false) | 비디오워터마킹코드의 HTML5 Player 의 사용여부를 확정합니다. |