> 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/callback-gai-yao/nocall-back.md).

# 次の動画Call-back

## 概要

Kollusプレイヤーで次の動画再生URLを獲得する時、お客様が定義したCallback URLを呼び出す機能を定義した文書です。

## Token Callback

Token callback(以下、コールバック)を使用するためには、Kollus Consoleの管理画面で管理者以上の権限を持つログインしなければならない

チャンネル属性にTokenコールバック項目にコールバックを受け取るために定義されたURLを登録する必要です。 

コールバックが定義されたチャンネルのコンテンツは、コールバック対象のURLを使用して再生するため、お客様が定義したコールバックURLは常にアクティビティ状態を維持してください。

## 注意事項

* 次の動画コールバックはプレイヤーの呼び出すJWT生成する時、next\_eposodeの値をtrueで設定してください。
* intro/outro機能は次の動画機能を使用する時には無効化してください。
* tokenコールバックurlが応答しない場合は次の動画再生機能が動作しません。

## Callback URL Settings

Callback設定はチャンネルから設定できます。Callbackが必要なチャンネル毎に設定しなければなりません。

例）

{% hint style="info" %}
<http://domain.com/callback?id={CLIENT\\_USER\\_ID}\\&mck={MEDIA\\_CONTENT\\_KEY}\\&uservalue0={USERVALUE0}>
{% endhint %}

Plugin option&#x20;

* **CLIENT\_USER\_ID}**
  * USER IDです。
  * MediaToken生成時にパラメータとして入力したユーザーのID情報です。 この時に入力されたユーザーIDは、Kollusシステムで管理されず、ユーザーを区分するUnique情報としてのみ使用されます。
* **{MEDIA\_CONTENT\_KEY}**
  * Kollus media\_content\_key
* **{ENCODING\_PROFILE\_KEY}**
  * Kollus encoding profile key
* **{USERVALUE0}\~{USERVALUE##}**

  * Video-gateway呼び出しに追加された追加情報です。

    ex) LCD={USERVALUE0}\&UCD={USERVALUE4}
  * 英字、数字以外の日本語などの文字列を伝える場合は、その変数を伝える際にUTF-8に伝える必要があります。
  * 特殊文字(英文、数字以外のすべての文字:　漢字、日本語など)は必ずUTF-8文字列をUrlEncodeされた状態でしなければなりません

## Support Options

プレイヤー毎の対応オプションを確認してください。

<br>

| **Option**               | <p><strong>KollusPlayer</strong></p><p><strong>(PC)</strong></p> | <p><strong>KollusPlayer</strong></p><p><strong>(Mobile)</strong></p> |
| ------------------------ | ---------------------------------------------------------------- | -------------------------------------------------------------------- |
| {CLIENT\_USER\_ID}       | O                                                                | O                                                                    |
| {MEDIA\_CONTENT\_KEY}    | O                                                                | O                                                                    |
| {ENCODING\_PROFILE\_KEY} | O                                                                | O                                                                    |
| {USERVALUE0} \~          | O                                                                | O                                                                    |

## Request Data

{% hint style="info" %}

* URL: <http://domain.com/callback>
* Method: POST
* Params:
* id={CLIENT\_USER\_ID}
* mck={MEDIA\_CONTENT\_KEY}
* uservalue0={USERVALUE0}
  {% endhint %}

Response JSON spec.

<br>

| JSON Tag  | Data Type | Description             |
| --------- | --------- | ----------------------- |
| result    | Integer   | 1: Success, 0: Failed   |
| next\_url | String    | 次の動画で再生する Web Token URL |

例）

{% hint style="info" %}

{

&#x20;    “result”: 1,

&#x20;    “next\_url”: ”[https://v.kr.kollus.com/](https://v.kr.kollus.com/%E2%80%A6)**si**?jwt={JWT}\&custom\_key={CUSTOM\_KEY}”

}
{% endhint %}

* 上記の例示の値のように、JSON文字列を平文で回答する必要があります。
* 例示のnext\_url値のようにsiで必ず呼び出してください。