LIVE Streaming

Kollus Live Player 呼出方法

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

1) 公開チャンネル :

チャンネル公開有無設定を"公開"にした場合、公開チャンネルとして設定されます。
公開chがんネルの場合、誰でも呼出ができるVideo gateway linkが生成されます。
Video gateway linkはチャンネルモニタリングページから確認してください。

2) 非公開チャンネル :

非公開チャンネルはJWTを使用してチャンネルに適用したい運用ポリシーに合うURLを生成・呼出することができます。
JWT Payloadは以下の JWT(Json Web Token) PAYLOAD SPEC を参考にしてください。

3) 非公開チャンネル URL 形式

Kollus Live URL 形式

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

4) 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"
    }
}

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)	チャットウィンドウを表示するか、しないか
	is_admin	boolean	選択 (基本値: false)	チャットルームの管理者であるか、ないか
	position	string	選択 (基本値: bottom)	チャットウィンドウの位置を指定 (Chatrollのみ使用可能) 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使用有無