LIVE Streaming

 Kollus Live Player 呼出方法

Kollus Live Playerを呼出すURLを生成する方法は2つあります。

公開チャンネル :

  • チャンネル公開有無設定を"公開"にした場合、公開チャンネルとして設定されます。

  • 公開chがんネルの場合、誰でも呼出ができるVideo gateway linkが生成されます。

  • Video gateway linkはチャンネルモニタリングページから確認してください。

非公開チャンネル :

  • 非公開チャンネルはJWTを使用してチャンネルに適用したい運用ポリシーに合うURLを生成・呼出することができます。

  • JWT Payloadは以下の JWT(Json Web Token) PAYLOAD SPEC を参考にしてください。

非公開チャンネル URL 形式

Kollus Live URL 形式

https://v-live-jp.kollus.com/s?jwt={JWT_TOKEN}&custom_key={ユーザーキー}

Webページに適用する方法

取得した URLをブラウザのアドレス欄に入力するか、もしくは iframe タグを使用してHTMLページにエンベデッドしてください。

iframe 適用方法

<iframe src="{取得したURL}" 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

必須

コンテンツにアクセスするサービス利用者の会員ID

client_user_name

String

選択

チャットを使用する際、ハンドルネームとして表示

client_user_image

String

選択

チャットを使用する際、ハンドルネームの表示するイメージURL httpsのみ対応

expire_time(or expt)

Integer

必須

JWTの有効期限 Unix timestamp 形式で入力

顧客側サーバーと時間が正確に一致しない可能性があるため、有効期限の効力に1分くらいの差が発生する可能性があります。

play_expt

Integer

選択 (基本値: 現在時刻から48時間)

ストリーミングにアクセス出来る有効期限

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)

チャットウィンドウが開始する

chatting_policy  is_admin

boolean

選択

(基本値: false)

チャットルームの管理者であるか、ないか

chatting_policy  position

string

選択

(基本値: bottom)

チャットウィンドウの位置を指定 (Chatrollのみ使用可能)

bottom | left | right

video_watermaking_code_policy code_kind

String

選択

"client_user_id"を除外した他のStringの場合そのまま出力

video_watermaking_code_policy alpha

Integer

選択(基本値: 200)

ビデオウォーターマーキングコードのalpha値を定義 (16進数 0~255)

video_watermaking_code_policy font_size

Integer

選択(基本値: 7)

ビデオウォーターマーキングコードのfont-size値を定義 (単位: px)

video_watermaking_code_policy font_color

String

選択(基本値: 'FFFFFF')

ビデオウォーターマーキングコードのfont-color値を定義

video_watermaking_code_policy show_time

Integer

選択(基本値:1)

ビデオウォーターマーキングコードの表示時間 (単位: 秒)

video_watermaking_code_policy hide_time

Integer

選択(基本値:60)

ビデオウォーターマーキングコードが表示されてから非表示になるまでの時間 (単位: 秒)

video_watermaking_code_policy 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桁進数

chat_background_color

String

選択

チャット background_color 値を定義する。6桁 16進数

chat_tab_font_color

String

選択

チャット tab_font_color値wお定義する。6桁 16進数

chat_tab_background_color

String

選択

チャット tab_background_color 値wお定義する。6桁 16進数

Last updated