콜러스 라이브 플레이어 호출 방법
콜러스 라이브 플레이어를 호출하기 위해서는 두가지 방법으로 호출 주소를 생성할수 있습니다.Kollus Live Player 呼出方法
Kollus Live Playerを呼出すURLを生成する方法は2つあります。
1) 공개 채널 : 채널의 공개 여부 설정을 공개로 지정시 공개 채널로 설정되며
공개 채널의 경우 어느 누구나 호출할수 있는 비디오 게이트웨이 링크가 생성됩니다.
비디오 게이트웨이 링크는 채널 페이지에 접속하시면 확인 가능합니다.公開チャンネル :
- チャンネル公開有無設定を"公開"にした場合、公開チャンネルとして設定されます。
- 公開chがんネルの場合、誰でも呼出ができるVideo gateway linkが生成されます。
- Video gateway linkはチャンネルモニタリングページから確認してください。
2) 비공유 채널 : 비공유 채널은 JWT를 이용하여 채널 정책에 맞는 URL을 생성하여 호출 할수 있습니다. JWT의 페이로드는 아래 非公開チャンネル :
- 非公開チャンネルはJWTを使用してチャンネルに適用したい運用ポリシーに合うURLを生成・呼出することができます。
- JWT Payloadは以下の JWT(Json Web Token) PAYLOAD SPEC
- を参考にしてください。
3) 비공유 채널 非公開チャンネル URL 형식 形式
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
https://v-live-krjp.kollus.com/s?jwt={JWT_TOKEN}&custom_key={사용자키ユーザーキー} |
4) 웹페이지 적용 방법 Webページに適用する方法 : 취득한 URL을 직접 브라우저 주소창에 호출 하시거나 iframe 태그를 이용하여 HTML 페이지에 임베드 시켜 주시면 됩니다.取得した URLをブラウザのアドレス欄に入力するか、もしくは iframe タグを使用してHTMLページにエンベデッドしてください。
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<iframe src="{라이브플레이어주소取得したURL}" allow="autoplay;encrypted-media;fullscreen" allowfullscreen="" webkitallowfullscreen="" mozallowfullscreen="" ></iframe> |
JWT(Json Web Token) PAYLOAD SPEC
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"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 | 필수 | 컨텐츠에 억세스하려는 고객사의 사용자 아이디.必須 | コンテンツにアクセスするサービス利用者の会員ID | ||
client_user_name | String | 선택 | 채팅사용시 표시되는 이름으로 사용됩니다.選択 | チャットを使用する際、ハンドルネームとして表示 | ||
client_user_image | String | 선택 | 채팅에 나오는 이름옆 이미지 URL 입니다. https 여야 합니다.選択 | チャットを使用する際、ハンドルネームの表示するイメージURL | ||
expire_time(or expt) | Integer | 필수 | JWT가 유효한 시간. 必須 | JWTの有効期限 Unix timestamp 형식으로 입력합니다. 고객사 서버와의 시간이 정확하게 일치하지 않을 수도 있으므로, 최대 1분 정도는 유효기간이 지났더라도 접근할 수 있습니다.形式で入力 顧客側サーバーと時間が正確に一致しない可能性があるため、有効期限の効力に1分くらいの差が発生する可能性があります。 | ||
play_expt | Integer | 선택 選択 (기본값基本値: 현재시간 + 2일 現在時刻から48時間) | 스트리밍 접근 유효시간 ストリーミングにアクセス出来る有効期限 | |||
live_media_channel_key (or lmckey) | String | 필수必須 | 재생할 라이브 채널키再生するライブチャンネルキー | |||
live_media_profile_key(or lmpf) | String | 선택選択 | 라이브 채널의 프로파일 가운데 하나를 강제로 지정해 재생할 경우에 사용합니다. 해당 값이 없을 경우 ABR로 동작합니다. ライブチャンネルのプロファイルの中で一つを強制指定する場合使用 入力しない場合ABRで動作します。 | |||
title (TITLE) | String | 선택選択 (기본값基本値: null) | 컨텐츠의 기존 타이틀을 대체하는 문자열입니다. コンテンツタイトルを代替する文字列 | |||
| chatting_policy | is_visible | boolean | 선택選択 (기본값基本値: true) | 채팅 창이 보여짐을 정합니다.チャットウィンドウを表示するか、しないか | ||
is_admin | boolean | 선택選択 (기본값基本値: false) | 채팅 창에서 관리자임을 정합니다.チャットルームの管理者であるか、ないか | |||
position | string | 선택選択 (기본값基本値: bottom) | 채팅창의 위치를 정합니다. (챗롤에서만 사용 가능チャットウィンドウの位置を指定 (Chatrollのみ使用可能) bottom | left | right | |||
| video_watermaking_code_policy | code_kind | String | 선택選択 | "client_user_id"를 제외한 다른 String 일시 그대로 출력以外のStringである場合そのまま出力 | ||
alpha | Integer | 선택選択(기본 값基本値: 200) | 비디오워터마킹코드의 alpha 값을 정의 합니다. (16진수 ビデオウォーターマーキングコードのalpha値を定義 (16進数 0~255) | |||
font_size | Integer | 선택選択(기본값基本値: 7) | 비디오워터마킹코드의 font-size 값을 정의 합니다. (단위ビデオウォーターマーキングコードのfont-size値を定義 (単位: px) | |||
font_color | String | 선택選択(기본값; 基本値: 'FFFFFF') | 비디오워터마킹코드의 font-color 값을 정의 합니다.ビデオウォーターマーキングコードのfont-color値を定義 | |||
show_time | Integer | 선택選択(기본값;基本値:1) | 비디오워터마킹코드의 보여지는 시간을 정의 합니다. (단위: 초ビデオウォーターマーキングコードの表示時間 (単位: 秒) | |||
hide_time | Integer | 선택選択(기본값;基本値:60) | 비디오워터마킹코드의 보여진후 안보여지는 시간을 정의 합니다. (단위: 초ビデオウォーターマーキングコードが表示されてから非表示になるまでの時間 (単位: 秒) | |||
enable_html5_player | Boolean | 선택選択(기본 값基本値:false) | 비디오워터마킹코드의 HTML5 Player 의 사용여부를 확정합니다.ビデオウォーターマーキングコードのHTML5 Player使用有無 | |||