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使用有無


Copyright © CATENOID, lnc. All Rights Reserved.
E-mail. jp_sales@catenoid.net | Tel. 03-4405-8462