次の動画 Callback

次の動画 Callback は、コンテンツ再生中に次に再生するコンテンツ情報をリアルタイムで取得し、連続再生を実装する機能です。プレイヤーは現在の動画が終わる前にお客様のサーバーへ次の動画の URL をリクエストし、再生を継続します。

注意事項

有効化条件: 再生用 JWT を生成する際、"next_episode": true パラメーターを必ず含めてください。最後のエピソードの場合、この値を false に設定して機能を無効化します。（参照: 通合 JWT 規格 - 基本オプション）
機能干渉の注意: intro および outro 機能と同時に使用できません。
サーバーの可用性: Callback サーバーのレスポンス LE が遅延したり、データ規格が一致しない場合、機能は動作しません。

Callback URL は Kollus VOD コンソールで設定できます。

Callback リクエスト時にお客様のサーバーへ一緒に送信されるパラメーター項目です。

パラメーター	タイプ	説明
メディアコンテンツキー (`mck`)	`string`	コンテンツの一意識別子
ユーザー（サービス会員）ID (`id`)	`string`	ユーザー ID（JWT 生成時に入力した `client_user_id`）
エンコーディングプロファイルキー (`epk`)	`string`	エンコーディングプロファイルの一意識別子

https://domain.com/callback?mck={MEDIA_CONTENT_KEY}&id={CLIENT_USER_ID}&epk={ENCODING_PROFILE_KEY}&uservalue0={USERVALUE0}

注意

ハングル、特殊文字、スペースが含まれている場合、必ずその値を UTF-8 URL エンコード処理して渡す必要があります。

お客様のサーバーは次の再生情報を暗号化されていない Plain JSON 形式で返す必要があります。

フィールド	タイプ	説明
`result`	`integer`	処理結果 `0`: 失敗 `1`: 成功
`next_url`	`string`	次の動画コンテンツの再生 URL

{
  "result": 1,
  "next_url": "https://v.jp.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_KEY}"
}

注意