플레이어 호출

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

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

공개 채널 : 채널의 공개 여부 설정을 공개로 지정시 공개 채널로 설정되며 공개 채널의 경우 어느 누구나 호출할수 있는 비디오 게이트웨이 링크가 생성됩니다. 비디오 게이트웨이 링크는 채널 페이지에 접속하시면 확인 가능합니다.

비공개 채널 : 비공개 채널은 JWT를 이용하여 채널 정책에 맞는 URL을 생성하여 호출 할수 있습니다. JWT의 페이로드는 아래 JWT(Json Web Token) PAYLOAD SPEC 를 참고 하기 바랍니다.

Kollus Live URL 형식

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

iframe 적용 방법

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

<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진수

Last updated 1 year ago

Was this helpful?