> For the complete documentation index, see [llms.txt](https://catenoid-support.gitbook.io/kollus-dev-jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://catenoid-support.gitbook.io/kollus-dev-jp/live-streaming.md).

# LIVE Streaming

### Kollus Live Player 呼出方法 <a href="#livestreamingkollusliveplayer-hu-chu-fang-fa" id="livestreamingkollusliveplayer-hu-chu-fang-fa"></a>

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

#### 公開チャンネル :

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

<figure><img src="/files/gjrldSCbWWULjng8rDmW" alt=""><figcaption></figcaption></figure>

#### 非公開チャンネル :

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

#### &#x20;非公開チャンネル URL 形式&#x20;

Kollus Live URL 形式

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

#### Webページに適用する方法&#x20;

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

iframe 適用方法

```
<iframe src="{ライブプレイヤーアドレス}" allow="autoplay;encrypted-media;fullscreen" allowfullscreen="" webkitallowfullscreen="" mozallowfullscreen="" ></iframe>
```

### JWT(Json Web Token) PAYLOAD SPEC <a href="#livestreaming-jwt-jsonwebtoken-payloadspec" id="livestreaming-jwt-jsonwebtoken-payloadspec"></a>

#### 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 詳細説明**

<table data-header-hidden><thead><tr><th></th><th width="131"></th><th width="132"></th><th></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td>名称</td><td>Datatype</td><td>必須有無</td><td>内容</td><td>備考</td><td></td></tr><tr><td><strong>client_user_id (or cuid)</strong></td><td>String</td><td>必須</td><td>コンテンツにアクセスするサービス利用者の会員ID</td><td><br></td><td></td></tr><tr><td><strong>client_user_name</strong></td><td>String</td><td>選択</td><td>チャットを使用する際、ハンドルネームとして表示</td><td><br></td><td></td></tr><tr><td><strong>client_user_image</strong></td><td>String</td><td>選択</td><td>チャットを使用する際、ハンドルネームの表示するイメージURL<br>httpsのみ対応</td><td><br></td><td></td></tr><tr><td><strong>expire_time(or expt)</strong></td><td>Integer</td><td>必須</td><td><p>JWTの有効期限 Unix timestamp 形式で入力</p><p>顧客側サーバーと時間が正確に一致しない可能性があるため、有効期限の効力に1分くらいの差が発生する可能性があります。</p></td><td><br></td><td></td></tr><tr><td><strong>play_expt</strong> </td><td>Integer</td><td>選択 (基本値: 現在時刻から48時間)</td><td>ストリーミングにアクセス出来る有効期限 </td><td><br></td><td></td></tr><tr><td><strong>live_media_channel_key (or lmckey)</strong></td><td>String</td><td>必須</td><td>再生するライブチャンネルキー</td><td><br></td><td></td></tr><tr><td><strong>live_media_profile_key(or lmpf)</strong></td><td>String</td><td>選択<br>(基本値: null)</td><td><p>ライブチャンネルのプロファイルの中で一つを強制指定する場合使用</p><p>入力しない場合ABRで動作します。 </p></td><td><br></td><td></td></tr><tr><td><p><strong>title</strong></p><p>(TITLE)</p></td><td>String</td><td><p>選択</p><p>(基本値: null)</p></td><td>コンテンツタイトルを代替する文字列</td><td><br></td><td></td></tr><tr><td><strong>chatting_policy</strong>　is_visible</td><td>boolean</td><td><p>選択</p><p>(基本値: true)</p></td><td>チャットウィンドウが開始する</td><td>チャットウィンドウを表示するか、しないか</td><td><br></td></tr><tr><td><strong>chatting_policy</strong>　<br>is_admin</td><td>boolean</td><td><p>選択</p><p>(基本値: false)</p></td><td>チャットルームの管理者であるか、ないか</td><td><br></td><td></td></tr><tr><td><strong>chatting_policy</strong>　<br>position</td><td>string</td><td><p>選択</p><p>(基本値: bottom)</p></td><td><p>チャットウィンドウの位置を指定 (Chatrollのみ使用可能)</p><p>bottom | left | right</p></td><td><br></td><td></td></tr><tr><td><strong>video_watermaking_code_policy</strong><br>code_kind</td><td>String</td><td>選択</td><td>"client_user_id"を除外した他のStringの場合そのまま出力</td><td></td><td></td></tr><tr><td><strong>video_watermaking_code_policy</strong><br>alpha</td><td>Integer</td><td>選択(基本値: 200)</td><td>ビデオウォーターマーキングコードのalpha値を定義 (16進数 0~255)</td><td><br></td><td></td></tr><tr><td><strong>video_watermaking_code_policy</strong><br>font_size</td><td>Integer</td><td>選択(基本値: 7)</td><td>ビデオウォーターマーキングコードのfont-size値を定義 (単位: px)</td><td><br></td><td></td></tr><tr><td><strong>video_watermaking_code_policy</strong><br>font_color</td><td>String</td><td>選択(基本値: 'FFFFFF')</td><td>ビデオウォーターマーキングコードのfont-color値を定義</td><td><br></td><td></td></tr><tr><td><strong>video_watermaking_code_policy</strong><br>show_time</td><td>Integer</td><td>選択(基本値:1)</td><td>ビデオウォーターマーキングコードの表示時間 (単位: 秒)</td><td><br></td><td></td></tr><tr><td><strong>video_watermaking_code_policy</strong><br>hide_time</td><td>Integer</td><td>選択(基本値:60)</td><td>ビデオウォーターマーキングコードが表示されてから非表示になるまでの時間 (単位: 秒)</td><td><br></td><td></td></tr><tr><td><strong>video_watermaking_code_policy</strong><br>enable_html5_player</td><td>Boolean</td><td>選択(基本値:false)</td><td>ビデオウォーターマーキングコードのHTML5 Player使用有無</td><td><br></td><td></td></tr><tr><td><strong>chat_font_url</strong></td><td>String</td><td>選択</td><td>1個のウェブフォント URL (Multiple URL 対応無し、拡張子別ブラウザ相違 </td><td></td><td></td></tr><tr><td><strong>chat_font_name</strong></td><td>String</td><td>選択</td><td><p>30文字以下, 韓・</p><p>中・日・英無関、内部chat_font_url 内部と不一致可能 (一致推奨)</p></td><td></td><td></td></tr><tr><td><strong>chat_font_weight</strong></td><td>String</td><td>選択</td><td>chat_font_url が含んだweightのみ可能 (以外は設定しても適用無し)</td><td></td><td></td></tr><tr><td><strong>chat_font_color</strong></td><td>String</td><td>選択</td><td>チャットのfont_colorを定義します。6桁進数</td><td></td><td></td></tr><tr><td><strong>chat_background_color</strong></td><td>String</td><td>選択</td><td>チャット background_color 値を定義する。6桁 16進数</td><td></td><td></td></tr><tr><td><strong>chat_tab_font_color</strong></td><td>String</td><td>選択</td><td>チャット tab_font_color値ｗお定義する。6桁 16進数</td><td></td><td></td></tr><tr><td><strong>chat_tab_background_color</strong></td><td>String</td><td>選択</td><td>チャット tab_background_color 値ｗお定義する。6桁 16進数</td><td></td><td></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://catenoid-support.gitbook.io/kollus-dev-jp/live-streaming.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.