ライブ Webhook を受け取る

Stream Live は、Input が接続したとき、切断したとき、または Stream Live でエラーが起きたときに、サービスへ通知する Webhook を提供します。

Stream Live Notifications

対象

Stream を使い、動画のステータスを Webhook で受け取りたいお客様向けです。

その他のオプション / フィルタ

Stream Live ID を入力すると、その入力だけについて通知を受け取れます。空欄の場合は、すべての入力の一覧を受け取ります。

次の入力状態で通知が発火します。オン / オフを切り替えられます。

live_input.connected
live_input.disconnected

含まれるプラン

Stream サブスクリプション。

受け取ったときの対応

Stream の通知はお客様側で自由にカスタマイズできます。対応は有効にしたカスタマイズによって異なります。

Stream Live の Webhook を購読する

Cloudflare ダッシュボードで Notifications ページを開きます。
Notifications を開く ↗
Destinations タブを選択します。
Destinations ページの Webhooks で Create を選択します。
Webhook の情報を入力し、Save and Test を選択します。
通知を作成するには、Notifications ページで All Notifications タブを選択します。
Notifications の横で Add を選択します。
プロダクト一覧で Stream を探し、Select を選択します。
名前と任意の説明を入力します。
Webhooks で Add webhook を選択し、作成したばかりの Webhook を選びます。
Next を選択します。
デフォルトでは、すべての Live Input について Webhook 通知を受け取ります。特定の Input だけに限定する場合は、テキスト欄に Input ID をカンマ区切りで入力します。
完了したら Create を選択します。

Webhook ペイロードの例json

{
  "name": "Live Webhook Test",
  "text": "Notification type: Stream Live Input\nInput ID: eb222fcca08eeb1ae84c981ebe8aeeb6\nEvent type: live_input.disconnected\nUpdated at: 2022-01-13T11:43:41.855717910Z",
  "data": {
    "notification_name": "Stream Live Input",
    "input_id": "eb222fcca08eeb1ae84c981ebe8aeeb6",
    "event_type": "live_input.disconnected",
    "updated_at": "2022-01-13T11:43:41.855717910Z"
  },
  "ts": 1642074233
}

data オブジェクトの event_type プロパティは、live_input.connected、live_input.disconnected、または live_input.errored のいずれかです。

Input に問題が検出された場合、event_type は live_input.errored になります。追加データは live_input_errored JSON キーの下にあり、次のいずれかの値を持つ code を含みます。

エラーコード

ERR_GOP_OUT_OF_RANGE – Input の GOP サイズまたはキーフレーム間隔が範囲外です。
ERR_UNSUPPORTED_VIDEO_CODEC – Input の動画コーデックが、使用中のプロトコルでサポートされていません。
ERR_UNSUPPORTED_AUDIO_CODEC – Input の音声コーデックが、使用中のプロトコルでサポートされていません。
ERR_STORAGE_QUOTA_EXHAUSTED – アカウントのストレージ割り当てを超えました。古いコンテンツを削除するか、追加ストレージを購入してください。
ERR_MISSING_SUBSCRIPTION – ライブ配信を開始する権限がありません。サブスクリプションを確認するか、ダッシュボードにログインして詳細を確認してください。
ERR_UNHEALTHY – アクティブな放送を、多くの場合エンコーダーの設定不備が原因で処理できません。必須・推奨設定と制限に放送が従っていることを確認し、切断して再接続してから再試行してください。

live_input.errored Webhook ペイロードの例json

{
  "name": "Live Webhook Test",
  "text": "Notification type: Stream Live Input\nInput ID: 2c28dd2cc444cb77578c4840b51e43a8\nEvent type: live_input.errored\nUpdated at: 2024-07-09T18:07:51.077371662Z\nError Code: ERR_GOP_OUT_OF_RANGE\nError Message: Input GOP size or keyframe interval is out of range.\nVideo Codec: \nAudio Codec: ",
  "data": {
    "notification_name": "Stream Live Input",
    "input_id": "eb222fcca08eeb1ae84c981ebe8aeeb6",
    "event_type": "live_input.errored",
    "updated_at": "2024-07-09T18:07:51.077371662Z",
    "live_input_errored": {
      "error": {
        "code": "ERR_GOP_OUT_OF_RANGE",
        "message": "Input GOP size or keyframe interval is out of range."
      },
      "video_codec": "",
      "audio_codec": ""
    }
  },
  "ts": 1720548474,
}