次の動画 Callback

お知らせ

このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。

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

注意事項

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

Callback 設定方法

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

参照: Callback 連携 - 次の動画 Callback

Callback フロー

Callback 設定: Kollus VOD コンソールでチャンネルごとの Callback URL を設定します。
再生リクエスト: 再生リクエスト時、お客様のサーバーは "next_episode": true が含まれた JWT でプレイヤーを起動します。
次の動画情報リクエスト: プレイヤーは設定されたタイミングで、お客様が設定した Callback URL へ POST リクエストを送信します。
次の動画 URL 生成: お客様のサーバーは現在のユーザーとコンテンツを識別し、次に再生するコンテンツのリンクを生成します。
連続再生: プレイヤーはお客様のサーバーから受信した JSON データを使用して次の動画を再生します。

Callback 設定情報

plug-in option

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

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

次の動画 Callback データ例

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

注意

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

リクエスト規格

配信方式

Method: POST
Content-Type: application/x-www-form-urlencoded
Data Format: FormData

レスポンス規格

お客様のサーバーは次の再生情報を暗号化されていない 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}"
}

注意

再生 URL パス: next_url は必ずセキュア再生パスである SI-link(/si)の形式である必要があります。
データ規格: 他の Callback とは異なり、JWT エンコードではなく通常の JSON 文字列として返す必要があります。

注意事項​

Callback 設定方法​

Callback フロー​

Callback 設定情報​

plug-in option​

次の動画 Callback データ例​

リクエスト規格​

配信方式​

レスポンス規格​

レスポンスフィールド​

レスポンス例​