コールバック
Last updated
Last updated
このページには Kollus VODについて説明します。
コールバックKollus VODは、顧客の動画サービスに様々なビジネスロジックを具現できるよう、コールバック(Callback)ベースのサービス連動をサポートしています。 コールバック機能は、顧客に作業進行成功または失敗した場合、顧客のウェブURLに状況の通知を送信して利便性を提供します。 また、コールバック送信サーバーが応答しない場合は、ログを確認して失敗原因を特定するサービスをサポートします。
すべてのコールバックは、顧客が設定したWebURLのPOST方式を使用して配信します。 コールバック通知は、次のようなイベントが発生したときに設定されたページに通知されます。
アップロード完了: 動画コンテンツのアップロードが完了した場合に配信される通知です。
トランスコーディング完了:アップロードした動画コンテンツのトランスコーディングが完了した場合に配信され、動画コンテンツをチャンネルに登録できる状態のお知らせです。
チャンネルにコンテンツ追加完了:動画コンテンツがチャンネルに追加された時に配信され、各チャンネルに設定された配信ポリシーを適用して動画コンテンツをサービスできる状態のお知らせです。
Kollus Playerのコンテンツ再生要請(Play Callback):Kollus DRMを使用する動画コンテンツに対する再生要請イベントが発生した時に伝達されるお知らせです。 通知に含まれている情報を活用して再生可能かどうかを決定することが決定できます。 再生可能かどうかは、Post Requestに対するレスポンスを通じて制御できます。
Kollus DRM Content再生リクエスト(DRMCallback):ユーザーの機器に動画コンテンツをダウンロードした後、再生リクエストイベントが発生した時に送信されるお知らせです。 通知に含まれている情報を活用して、再生許容可否と様々なDRMポリシーを設定できます。 DRMポリシーの管理は、PostRequestに対するResponseを通じて制御できます。
動画コンテンツに対する再生情報伝送(LMS Callback):一定周期ごとにユーザーの動画コンテンツ再生関連情報を指定されたサーバーに伝送することができます。
Kollus VODのコールバックは、プラットフォームで転送するプラットフォームコールバックとプレーヤーで転送するプレイヤーコールバックに分けられます。 プラットフォームコールバックは、Kollus VOD Webコンソールでユーザー認証後、リクエストした作業が完了した場合に通知を送信します。 プラットフォームのコールバックには、アップロード コールバック、トランスコーディング コールバック、チャネル コールバックが含まれます。
コンテンツを区切る固有のキーであるアップロード ファイル キーを使用して、アップロード完了時にコールバック通知を送信します。
アップロード ファイル キーを使用して、トランスコーディング完了時にコールバック通知を送信します
チャネルにコンテンツが追加、削除、および再生された場合は、コールバック通知を送信します。
プレイヤーコールバックは、プレイヤーが利用したコンテンツ情報をコールバックURLで指定したアドレスに送信する機能です。 プレイヤーコールバックは、Kollus Playerで指定したイベントが発生したときに関連情報を指定されたサーバーに送信します。 プレイヤーコールバックはPlayコールバック、DRMコールバック、LMSコールバックを含みます。
Playコールバックを使用するには、管理者権限でログインしたアカウントでCMSの管理チャンネル属性からコールバックの応答を受けるURLを登録する必要があります。 PlayコールバックURLが設定されていないチャンネルは、コールバック応答と関係なくリクエスト時に動画を再生します。
参考
Playコールバックはセキュリティプレイヤーのみ対応します。
Kollus DRMが適用されたコンテンツをユーザー機器にダウンロードされた映像に対するライセンス管理のために使用するコールバックです。 コンテンツの再生制限回数、コンテンツ満了期間、コンテンツ再生時間情報を設定してコンテンツの再生を制御し、リクエストの結果を確認することができます。 DRMコールバックはコンテンツダウンロード前、ダウンロード後、再生要請段階でユーザー、デバイス、メディアコンテンツキーなどを確認します。 DRMコールバックを使用するためには、チャンネルにDRMコールバックURLを設定する必要があります。 DRMコールバックURLを設定すると、コンテンツをダウンロードする時点で該当URLを呼び出して返した値でDRMコールバックを実行します。
プレイヤーからユーザーが利用した視聴情報をLMSコールバックURLに転送する機能です。 チャンネルでLMSコールバックを設定した後、動画再生情報を設定したサーバーに転送することができます。 LMSコールバックは周期的に動画コンテンツ再生情報を転送し、一時停止、停止などのPlayerイベントが発生した時も関連イベント情報を転送します。
「次の動画」はユーザーが連続したシリーズ動画を視聴する時、表示される「次の動画」ボタンを押してすぐに次の動画を見ることができるサービスです。 このサービスを使用するためには、次の動画に関する情報をサーバーに配信する必要があります。
