ライブ LMS Callback
お知らせ
このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。
LMS Callback は、視聴データをリアルタイム で収集し、学習管理システム(LMS)サーバーへ転送する機能です。 これにより、受講完了処理、学習パターン分析、視聴統計算出などの高度な教育管理ロジックを実装できます。
主な特徴
- 非同期転送: プレイヤーはデータ転送時にサーバーのレスポンスを待たないため、ネットワーク環境に関わらず視聴フローが途切れません。
- 個人情報保護: LMS Callback データには、Mac Address・IP Address などの機密性の高い個人情報が含まれないため、セキュリティに優れています。
Callback の設定方法
Callback URL はチャンネルごとに個別に設定できます。
- Kollus Live コンソール > [チャンネル管理] > [チャンネルリスト]へ移動します。
- 状況に応じて、以下のいずれかを選択します。
- 新規チャンネル作成時に設定: 右上の[チャンネルに登録]をクリックします。
- 既存チャンネルに設定: 対象チャンネル右側の[編集アイコン]をクリックします。
- 下部の[Callback] タブにある[LMS Callback]項目に、"転送サイクル:Callback URL"の形式で入力します。
- 区切り文字: コロン(
:) - 転送サイクル: 秒単位（推奨: 30〜60 秒）
- Callback URL: データを受け取るサーバーアドレス（https 必須）
- 複数登録: 改行(
\n)を使用して複数の URL を登録し、複数のシステムへ転送できます。
- 区切り文字: コロン(
- 入力完了後、[保存する]をクリックします。
Callback の呼び出しタイミング
- 定期呼び出し: 設定された転送サイクルごとに繰り返し呼び出されます。
- イベント呼び出し: 周期に関わらず、ユーザーが再生(Play)・一時停止(Pause)・停止(Stop)した際に即時呼び出されます。
- セッション識別: プレイヤーのリフレッシュや再接続時に
{START_AT}の値が変更され、新しい視聴セッションとして区別されます。
Callback 設定例
30 秒ごとに特定のサーバー(https://your-service-domain/lms_callback)へ視聴詳細データ(JSON_DATA)とカス タム変数(USERVALUE0)を受け取る場合、Kollus Live コンソールに以下のように入力します。
30:https://your-service-domain/lms_callback?json_data={JSON_DATA}&uservalue0={USERVALUE0}
リクエストオプション
Callback URL の後ろにパラメータとして追加できるオプションです。
| パラメータ | 説明 |
|---|---|
{JSON_DATA} | すべての視聴情報を含む JSON オブジェクト |
{CLIENT_USER_ID} | ユーザー ID（JWT 生成時に入力したclient_user_id） |
{START_AT} | 転送リクエスト時刻（VideoGateway 呼び出し時点、Unix timestamp） |
{MEDIA_CONTENT_KEY} | ライブ配信キー |
{ENCODING_PROFILE_KEY} | エンコーディングプロファイルキー |
{HOST_NAME} | ライブ配信リンクをリクエストしたドメイン
|
{PLAYER_ID} | Kollus プレイヤー固有 ID |
{PLAYLIST_STATUS} | (Kollus セキュアプレイヤー使用時) 視聴ステータス
|
{DEVICE} | デバイスモデル名 |
{RUN_TIME} | 一時停止を含む累積視聴時間 (sec) |
{SHOW_TIME} | 一時停止を含まず、タイムシフトを含む累積視聴時間 (sec) |
{USERVALUE0~99} | カスタム変数（UTF-8 形式準拠）
|
転送データ(JSON_DATA)の詳細
JSON_DATAは全視聴データを含みます。
user_info
| フィールド | タイプ | 説明 |
|---|---|---|
content_provider_key | string | サービスアカウントキー（配信主体） |
client_user_id | string | ユーザー ID（JWT 生成時に入力したclient_user_id） |
player_id | string | Kollus プレイヤー固有 ID |
hardware_id | string | ハードウェア ID |
host_name | string | ライブ配信リンクをリクエストしたドメイン |
device | string | デバイスモデル名 |
content_info
| フィールド | タイ プ | 説明 |
|---|---|---|
media_content_key | string | ライブ配信キー |
channel_key | string | チャンネルキー |
start_at | integer | 転送リクエスト時刻（VideoGateway 呼び出し時点、Unix timestamp） |
runtime | integer | 一時停止を含む累積視聴時間 (sec) |
showtime | integer | 一時停止を含まず、タイムシフトを含む累積視聴時間 (sec) |
serial | integer | LMS 送信順序（0 から開始） |
uservalue{0~99} | string | カスタム変数（uservalue0〜uservalue99） |
視聴時間の用語定義
視聴時間の算定基準
視聴時間の計算時、ネットワークのバッファリング時間は含まれません。
視聴シナリオ例
イメージしやすくするため、ユーザーが 40 秒間接続した状況を想定します。
- [13:00:00] ライブ配信の視聴開始
- [13:00:20] ライブ配信の視聴一時停止（20 秒間停止）
- [13:00:40] ライブ配信の視聴終了
| 用語 | 定義 | 計算方式 | 例の結果 |
|---|---|---|---|
| Run Time | 全体滞在時間 サービスに接続していた総時間 | 視聴終了時刻 - 視聴開始時刻 | 40 秒 |
| Show Time | 実際の視聴時間 プレイヤーが実際に再生された時間 | Run Time - 一時停止時間 | 20 秒 |