Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

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

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

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

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

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

3) 비공유 채널 URL 형식 

Code Block
languagebash
themeMidnight
titleKollus Live URL 형식
https://v-live-kr.kollus.com/s?jwt={JWT_TOKEN}&custom_key={사용자키}

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

Code Block
languagexml
themeMidnight
titleiframe 적용 방법
<iframe src="{라이브플레이어주소}" allow="autoplay;encrypted-media;fullscreen" allowfullscreen="" webkitallowfullscreen="" mozallowfullscreen="" ></iframe>

JWT(Json Web Token) PAYLOAD SPEC

Code Block
languagejs
themeMidnight
titleJWT 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"
    }
}


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_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 의 사용여부를 확정합니다.



Easy Heading Free