メインコンテンツまでスキップ

Callback 連携

お知らせ

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

Kollus VOD は、ワークフロー全体にわたるシステム間の自動化のための Callback 連携をサポートしています。 特定のイベント発生時に指定された URL へ HTTP リクエストを送信し、外部システム（LMS、CMS など）とリアルタイムでデータを同期することができます。

注意

Callback を受信するサーバーは、大量のトラフィックを処理できる安定した環境である必要があります。

Callback の種類​

Kollus VOD が提供する Callback の種類は次のとおりです。

  • プラットフォーム Callback: お客様の Kollus VOD コンソール操作（アップロード、トランスコーディング、コンテンツ管理）の完了時に呼び出し
  • プレイヤー Callback: ユーザーの操作（再生、ダウンロード、再生進行率、次の動画への遷移）発生時に呼び出し

プラットフォーム Callback​

プラットフォーム Callback(Platform Callback)は、Kollus VOD コンソールで実行した操作の結果をサーバーに送信します。

ネットワーク設定

入力した Callback サーバー URL のポートが、Kollus サーバーからのリクエストを許可するようにファイアウォールが設定されているか必ず確認してください。

  • 設定パス
    Callback の種類説明および設定パス
    Upload Callbackコンテンツアップロード完了時に通知を送信
    • 設定パス: Kollus VOD コンソール > [サービスアカウント] > [Callback] > [Upload Callback URL]
    • 参考: サービスアカウント単位で 1 つの URL のみ設定可能です。
    Transcoding Callbackトランスコーディング完了時に通知を送信
    • 設定パス: Kollus VOD コンソール > [サービスアカウント] > [Callback] > [Transcoding Callback URL]
    • 参考: サービスアカウント単位で 1 つの URL のみ設定可能です。
    Contents Update Callbackメタデータの修正、コンテンツの削除またはチャンネル移動時に呼び出し
    • 設定パス: Kollus VOD コンソール > [サービスアカウント] > [Callback] > [Contents Update Callback URL]
    • 参考: サービスアカウント単位で 1 つの URL のみ設定可能です。
    コンテンツチャンネル追加 Callbackチャンネルにコンテンツが登録されたときに呼び出し
    • 設定パス: Kollus VOD コンソール > [チャンネル] > 左側チャンネルリストまたはチャンネルカード [もっと見る] > [Callback 設定] > [コンテンツ登録] タブ > [チャンネルにコンテンツ登録時の Callback URL]
    • 参考: チャンネル単位で設定が可能です。
    コンテンツチャンネル削除 Callbackチャンネルからコンテンツが削除されたときに呼び出し
    • 設定パス: Kollus VOD コンソール > [チャンネル] > 左側チャンネルリストまたはチャンネルカード [もっと見る] > [Callback 設定] > [コンテンツ登録] タブ > [チャンネルからコンテンツ削除時の Callback URL]
    • 参考: チャンネル単位で設定が可能です。
  • 開発者ガイド: プラットフォーム Callback

プレイヤー Callback​

プレイヤー Callback(Player Callback)は、視聴環境で発生するイベントをリアルタイムで送信し、チャンネル単位で独立した設定が可能です。

ネットワーク設定

入力した Callback サーバー URL のポートが、Kollus サーバーからのリクエストを許可するようにファイアウォールが設定されているか必ず確認してください。

Play Callback​

ユーザーがコンテンツの再生を試みたときに呼び出されます。

  • 設定パス: Kollus VOD コンソール > [チャンネル] > 左側チャンネルリストまたはチャンネルカード [もっと見る] > [Callback 設定] > [プレイ/ダウンロード] タブ > [Play Callback]
  • 注意: Play Callback は Kollus セキュアプレイヤー環境でのみ動作します。
  • 開発者ガイド: Play Callback

DRM Download Callback​

ユーザーがオフライン視聴のためにダウンロードをリクエストしたときに呼び出されます。

  • 設定パス: Kollus VOD コンソール > [チャンネル] > 左側チャンネルリストまたはチャンネルカード [もっと見る] > [Callback 設定] > [プレイ/ダウンロード] タブ > [DRM Download Callback]
  • 注意: DRM Download Callback は Kollus セキュアプレイヤー環境でのみ動作します。
  • 開発者ガイド: DRM Download Callback

LMS Callback​

ユーザーの再生進行率を正確に計測するために、定期的に再生情報を送信します。

  • 設定パス: Kollus VOD コンソール > [チャンネル] > 左側チャンネルリストまたはチャンネルカード [もっと見る] > [Callback 設定] > [LMS] タブ
  • 設定項目
    項目説明
    ブロック数動画を分割する論理的な区間数
    例: 300 秒の動画のブロック数を 10 に設定すると、各ブロックの長さは 30 秒になります。
    転送サイクルサーバーへデータを送信する時間間隔 (sec)
    ブロック情報を含めるブロック情報を含めるかどうか
    セッション情報を含めるセッション情報（開始時点、再生時間など）を含めるかどうか
    Callback URLLMS データを受信するお客様側のサーバーアドレス
    plug-in optionCallback に含める情報（パラメーターキーの変更可能、LMS Callback - Callback 設定情報参照）
    LMS Callback データ上記項目の設定時に自動作成
  • 開発者ガイド: LMS Callback

次の動画 Callback​

シリーズコンテンツの再生中に次の動画情報を事前に取得し、シームレスな視聴環境を構築します。

  • 必須条件
    • コンソール設定: Kollus VOD コンソール > [チャンネル] > 左側チャンネルリストまたはチャンネルカード [もっと見る] > [Callback 設定] > [次の動画] タブで、[次の動画] ボタンの表示タイミングおよび Callback URL を登録
    • トークン設定: プレイヤー呼び出しトークン(JWT)に "next_episode": true パラメーターを含める（参照: 通合 JWT 規格 - 基本オプション）
  • 設定項目
    項目説明
    次の動画使用連続再生機能を有効にするかどうか
    再生終了{input}秒前に'次の動画'ボタン表示動画終了前に [次の動画] ボタンを表示する時間（動画の長さより長く設定した場合は動画の最初からボタンを表示）
    Callback URLCallback を受信するお客様側のサーバーアドレス
    plug-in optionCallback に含める情報（パラメーターキーの変更可能、次の動画 Callback - Callback 設定情報参照）
    次の動画 Callback データ上記項目の設定時に自動作成
  • 開発者ガイド: 次の動画 Callback