본문으로 건너뛰기

Live 암호화 URL 생성(JWT)

Kollus Live 플레이어 호출 방법​

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

  1. 공개 채널: 채널의 공개 여부 설정을 공개로 지정시 공개 채널로 설정되며 공개 채널의 경우 어느 누구나 호출할수 있는 비디오 게이트웨이 링크가 생성됩니다.
    비디오 게이트웨이 링크는 채널 페이지에 접속하시면 확인 가능합니다.
  2. 비공유 채널: 비공유 채널은 JWT를 이용하여 채널 정책에 맞는 URL을 생성하여 호출할 수 있습니다.
    JWT의 페이로드는 아래 JWT Payload 사양를 참고하세요.
  3. 비공유 채널 URL 형식
    Kollus Live URL 형식 
    https://v-live-kr.kollus.com/s?jwt={JWT_TOKEN}&custom_key={사용자키}
  4. 웹페이지 적용 방법: 취득한 URL을 직접 브라우저 주소창에 호출 하시거나 iframe 태그를 이용하여 HTML 페이지에 임베드 시켜주시면 됩니다.
    iframe 적용 방법 
    <iframe src="{Live 플레이어 주소}" allow="autoplay;encrypted-media;fullscreen" allowfullscreen="" webkitallowfullscreen="" mozallowfullscreen="" ></iframe>

JWT Payload 사양​

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필수콘텐츠에 접근하려는 고객사의 사용자 ID.

(영문 이외의 값은 권장하지 않습니다.
영문 이외의 값은 캡처 차단이나 중복 재생 차단 등에서 검색이 제한될 수 있습니다.)
client_user_nameString선택채팅 사용 시 표시되는 이름으로 사용됩니다.
client_user_imageString선택채팅에 표시되는 이름 옆 이미지 URL입니다.
https 여야 합니다.
expire_time (or expt)Integer필수JWT가 유효한 시간 (Unix timestamp).
고객사 서버와의 시간이 완전히 일치하지 않을 수 있으므로, 최대 1분 정도는 유효기간이 지나더라도 접근할 수 있습니다.
play_exptInteger선택
(기본값: 현재시간 + 2일)		스트리밍 접근 유효시간.
live_media_channel_key (or lmckey)String필수재생할 라이브 채널 키.
live_media_profile_key (or lmpf)String선택
(기본값: null)		라이브 채널의 프로파일 중 하나를 강제로 지정해 재생할 경우 사용합니다.
해당 값이 없을 경우 ABR로 동작합니다.
title (TITLE)String선택
(기본값: null)		콘텐츠의 기존 타이틀을 대체하는 문자열입니다.
chatting_policy.is_visibleBoolean선택
(기본값: true)		채팅창의 표시 여부를 설정합니다.
chatting_policy.is_adminBoolean선택
(기본값: false)		채팅창에서 관리자 여부를 설정합니다.
chatting_policy.positionString선택
(기본값: bottom)		채팅창의 위치를 설정합니다.
(챗롤에서만 사용 가능)
가능 값: bottom | left | right
video_watermarking_code_policy<br />.code_kindString선택"client_user_id"를 제외한 다른 문자열일 경우 해당 문자열 그대로 출력합니다.
video_watermarking_code_policy<br />.alphaInteger선택
(기본값: 200)		비디오 워터마킹 코드의 alpha(투명도) 값을 정의합니다.
(16진수 0~255)
video_watermarking_code_policy<br />.font_sizeInteger선택
(기본값: 7)		비디오 워터마킹 코드의 폰트 크기를 정의합니다.
(단위: px)
video_watermarking_code_policy<br />.font_colorString선택
(기본값: 'FFFFFF')		비디오 워터마킹 코드의 색상을 정의합니다.
video_watermarking_code_policy<br />.show_timeInteger선택
(기본값: 1)		워터마킹 코드가 표시되는 시간을 정의합니다.
(단위: 초)
video_watermarking_code_policy<br />.hide_timeInteger선택
(기본값: 60)		워터마킹 코드가 숨겨지는 시간을 정의합니다.
(단위: 초)
video_watermarking_code_policy<br />.enable_html5_playerBoolean선택
(기본값: false)		워터마킹 코드의 HTML5 Player 사용 여부를 설정합니다.
chat_font_urlString선택웹 폰트 URL (1개만 가능).
확장자별 지원 브라우저는 상이합니다.
chat_font_nameString선택30자 이하.
한·중·일·영 문자 모두 가능.
chat_font_url 내 폰트명과 불일치 가능 (일치 권장).
chat_font_weightString선택chat_font_url에 포함된 weight만 설정 가능합니다.
그 외 값은 무시됩니다.
chat_font_colorString선택채팅의 font_color를 정의합니다.
(6자리 16진수)
chat_background_colorString선택채팅의 background_color를 정의합니다.
(6자리 16진수)
chat_tab_font_colorString선택채팅의 탭 폰트 색상을 정의합니다.
(6자리 16진수)
chat_tab_background_colorString선택채팅의 탭 배경색을 정의합니다.
(6자리 16진수)