콜러스 라이브 플레이어 호출 방법
콜러스 라이브 플레이어를 호출하기 위해서는 두가지 방법으로 호출 주소를 생성할수 있습니다.
1) 공개 채널 : 채널의 공개 여부 설정을 공개로 지정시 공개 채널로 설정되며
공개 채널의 경우 어느 누구나 호출할수 있는 비디오 게이트웨이 링크가 생성됩니다.
비디오 게이트웨이 링크는 채널 페이지에 접속하시면 확인 가능합니다.
2) 비공유 채널 : 비공유 채널은 JWT를 이용하여 채널 정책에 맞는 URL을 생성하여 호출 할수 있습니다.
JWT의 페이로드는 아래 JWT(Json Web Token) PAYLOAD SPEC 를 참고 하기 바랍니다.
3) 비공유 채널 URL 형식
https://v-live-kr.kollus.com/s?jwt={JWT_TOKEN}&custom_key={사용자키}
4) 웹페이지 적용 방법 : 취득한 URL을 직접 브라우저 주소창에 호출 하시거나 iframe 태그를 이용하여 HTML 페이지에 임베드 시켜 주시면 됩니다.
<iframe src="{라이브플레이어주소}" allow="autoplay;encrypted-media;fullscreen" allowfullscreen="" webkitallowfullscreen="" mozallowfullscreen="" ></iframe>
JWT(Json Web Token) PAYLOAD SPEC
{
"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"
}
}
PAYLOAD 상세 설명
이름 | Datatype | 필수 여부 | 내용 | 비고 | |
client_user_id (or cuid) | String | 필수 | 컨텐츠에 억세스하려는 고객사의 사용자 아이디. | ||
client_user_name | String | 선택 | 채팅사용시 표시되는 이름으로 사용됩니다. | ||
client_user_image | String | 선택 | 채팅에 나오는 이름옆 이미지 URL 입니다. https 여야 합니다. | ||
expire_time(or expt) | Integer | 필수 | JWT가 유효한 시간. Unix timestamp 형식으로 입력합니다. 고객사 서버와의 시간이 정확하게 일치하지 않을 수도 있으므로, 최대 1분 정도는 유효기간이 지났더라도 접근할 수 있습니다. | ||
play_expt | Integer | 선택 (기본값: 현재시간 + 2일) | 스트리밍 접근 유효시간 | ||
live_media_channel_key (or lmckey) | String | 필수 | 재생할 라이브 채널키 | ||
live_media_profile_key(or lmpf) | String | 선택 | 라이브 채널의 프로파일 가운데 하나를 강제로 지정해 재생할 경우에 사용합니다. 해당 값이 없을 경우 ABR로 동작합니다. | ||
title (TITLE) | String | 선택 (기본값: null) | 컨텐츠의 기존 타이틀을 대체하는 문자열입니다. | ||
| chatting_policy | is_visible | boolean | 선택 (기본값: true) | 채팅 창이 보여짐을 정합니다. | |
is_admin | boolean | 선택 (기본값: false) | 채팅 창에서 관리자임을 정합니다. | ||
position | string | 선택 (기본값: bottom) | 채팅창의 위치를 정합니다. (챗롤에서만 사용 가능) bottom | left | right | ||
| video_watermaking_code_policy | code_kind | String | 선택 | "client_user_id"를 제외한 다른 String 일시 그대로 출력 | |
alpha | Integer | 선택(기본 값: 200) | 비디오워터마킹코드의 alpha 값을 정의 합니다. (16진수 0~255) | ||
font_size | Integer | 선택(기본값: 7) | 비디오워터마킹코드의 font-size 값을 정의 합니다. (단위: px) | ||
font_color | String | 선택(기본값; 'FFFFFF') | 비디오워터마킹코드의 font-color 값을 정의 합니다. | ||
show_time | Integer | 선택(기본값;1) | 비디오워터마킹코드의 보여지는 시간을 정의 합니다. (단위: 초) | ||
hide_time | Integer | 선택(기본값;60) | 비디오워터마킹코드의 보여진후 안보여지는 시간을 정의 합니다. (단위: 초) | ||
enable_html5_player | Boolean | 선택(기본 값:false) | 비디오워터마킹코드의 HTML5 Player 의 사용여부를 확정합니다. | ||