LIVE Streaming

콜러스 라이브 플레이어 호출 방법

콜러스 라이브 플레이어를 호출하기 위해서는 두가지 방법으로 호출 주소를 생성할수 있습니다.

1) 공개 채널 : 채널의 공개 여부 설정을 공개로 지정시 공개 채널로 설정되며

공개 채널의 경우 어느 누구나 호출할수 있는 비디오 게이트웨이 링크가 생성됩니다.

비디오 게이트웨이 링크는 채널 페이지에 접속하시면 확인 가능합니다.

2) 비공유 채널 : 비공유 채널은 JWT를 이용하여 채널 정책에 맞는 URL을 생성하여 호출 할수 있습니다.

JWT의 페이로드는 아래 JWT(Json Web Token) PAYLOAD SPEC 를 참고 하기 바랍니다.

3) 비공유 채널 URL 형식

Kollus Live URL 형식

https://v-live-kr.kollus.com/s?jwt={JWT_TOKEN}&custom_key={사용자키}

4) 웹페이지 적용 방법 : 취득한 URL을 직접 브라우저 주소창에 호출 하시거나 iframe 태그를 이용하여 HTML 페이지에 임베드 시켜 주시면 됩니다.

iframe 적용 방법

<iframe src="{라이브플레이어주소}" allow="autoplay;encrypted-media;fullscreen" allowfullscreen="" webkitallowfullscreen="" mozallowfullscreen="" ></iframe>

JWT(Json Web Token) PAYLOAD SPEC

JWT paylod 형식

{
    "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"
    }
	"chat_font_url": "CHAT_FONT_URL",
	"chat_font_name": "CHAT_FONT_NAME",
	"chat_font_weight": "700",
	"chat_font_color": "ffffff",
	"chat_background_color": "333333",
	"chat_tab_font_color": "00ff00",
	"chat_tab_background_color": "777777"
}

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	선택 (기본값: null)	라이브 채널의 프로파일 가운데 하나를 강제로 지정해 재생할 경우에 사용합니다. 해당 값이 없을 경우 ABR로 동작합니다.
title (TITLE)		String	선택 (기본값: null)	컨텐츠의 기존 타이틀을 대체하는 문자열입니다.
chatting_policy	is_visible	boolean	선택 (기본값: true)	채팅 창이 보여짐을 정합니다.
	is_admin	boolean	선택 (기본값: false)	채팅 창에서 관리자임을 정합니다.
	position	string	선택 (기본값: bottom)	채팅창의 위치를 정합니다. (챗롤에서만 사용 가능) bottom \| left \| right
video_watermarking_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 의 사용여부를 확정합니다.
chat_font_url		String	선택	1개의 웹 폰트 URL (Multiple URL 미지원, 확장자별 지원 브라우저 상이)
chat_font_name		String	선택	30자 이하, 한중일영 무관, chat_font_url 내부와 불일치 가능 (일치 권장)
chat_font_weight		String	선택	chat_font_url 이 포함하는 weight 만 가능 (이외는 설정해도 무시됨)
chat_font_color		String	선택	채팅의 font_color를 정의 합니다. 6자리 16진수
chat_background_color		String	선택	채팅 background_color 값을 정의 합니다. 6자리 16진수
chat_tab_font_color		String	선택	채팅 tab_font_color 값을 정의 합니다. 6자리 16진수
chat_tab_background_color		String	선택	채팅 tab_background_color 값을 정의 합니다. 6자리 16진수