ライブ Play Callback

Play Callback は、ユーザーがプレイヤーでライブ再生をリクエストする際にリアルタイムで呼び出されます。 Callback サーバーから Callback 正常応答を受信した場合にのみ、ライブ視聴が可能です。

Callback の設定方法

Callback URL はチャンネルごとに独立して設定できます。

注意

Play Callback は、標準 HTML5 ベースのプレイヤーではなく、Kollus セキュアプレイヤーを使用している場合にのみ動作します。 Kollus セキュアプレイヤーが適用されていないチャンネルでは、URL を設定しても Callback は呼び出されません。

Kollus Live コンソール > [チャンネル管理] > [チャンネルリスト]に移動します。
状況に応じて、次のいずれかを選択します。
- 新規チャンネル作成時に設定: 右上の[チャンネルに登録]をクリックします。
- 既存チャンネルに設定: 対象チャンネル右側の[編集アイコン]をクリックします。
下部の[Callback] タブで Play Callback URL を入力した後、[保存する]をクリックします。

パラメーター	タイプ	説明
`kind`	`integer`	100（ライブ Play Callback の固定値）
`client_user_id`	`string`	ユーザー ID（JWT 生成時に入力した`client_user_id`）
`player_id`	`string`	Kollus プレイヤー固有 ID
`hardware_id`	`string`	ハードウェア ID（Windows 環境など識別可能な値が存在する場合に提供）
`device_name`	`string`	デバイスモデル名
`media_content_key`	`string`	ライブ配信キー
`channel_key`	`string`	チャンネルキー
`uservalues`	`JSON string`	カスタム変数（`uservalue0`〜`uservalue99`）
`localtime`	`integer`	リクエスト時点のデバイス時刻(Unix timestamp)

{
  "uservalue0": "class_code_01",
  "uservalue1": "product_code_02",
  "uservalue99": "custom_code_03"
}

フィールド	タイプ	説明
`result`	`integer`	`0`: 異常（再生ブロック） `1`: 正常（再生許可）
`message`	`string`	`result`の値が`0`の場合にプレイヤーに表示するメッセージ
`vmcheck`	`integer`	(HTML5 Player for PC 専用) 仮想マシン(VM)環境での再生許可設定 `0`: 許可 `1`（デフォルト値）: 仮想マシン環境を検出してブロック
`disable_tvout`	`integer`	TV 出力制限設定（チャンネルのデフォルトポリシーより優先適用） `0`: TV 出力を許可 `1`: TV 出力をブロック

{
  "data": {
    "result": 1,
    "vmcheck": 0,
    "disable_tvout": 1
  }
}