コンテンツにスキップ

ライブウェブフックの受信

Stream Liveは、Inputが接続、切断、またはエラーに遭遇したときにサービスに通知するためのウェブフックを提供します。

Stream Live Notifications

 Who is it for?

Customers who are using Stream and want to receive webhooks with the status of their videos.

Other options / filters

You can input Stream Live IDs to receive notifications only about those inputs. If left blank, you will receive a list for all inputs.

The following input states will fire notifications. You can toggle them on or off:

  • live_input.connected
  • live_input.disconnected

Included with

Stream subscription.

What should you do if you receive one?

Stream notifications are entirely customizable by the customer. Action will depend on the customizations enabled.

Stream Liveウェブフックの購読

  1. Cloudflareアカウントにログインし、Notificationsをクリックします。
  2. Notificationsページから、Destinationsタブをクリックします。
  3. DestinationsページのWebhooksの下で、Createをクリックします。
  4. ウェブフックの情報を入力し、Save and Testをクリックします。
  5. 通知を作成するには、NotificationsページからAll Notificationsタブをクリックします。
  6. Notificationsの横にあるAddをクリックします。
  7. 製品のリストの中からStreamを見つけて、Selectをクリックします。
  8. 名前とオプションの説明を入力します。
  9. Webhooksの下で、Add webhookをクリックし、新しく作成したウェブフックをクリックします。
  10. Nextをクリックします。
  11. デフォルトでは、すべてのライブ入力に対してウェブフック通知を受け取ります。特定の入力に対してのみウェブフックを受け取りたい場合は、テキストフィールドにカンマ区切りのInput IDのリストを入力します。
  12. 完了したら、Createをクリックします。

ウェブフックペイロードの例
{
  "name": "ライブウェブフックテスト",
  "text": "通知タイプ: Stream Live Input\nInput ID: eb222fcca08eeb1ae84c981ebe8aeeb6\nイベントタイプ: live_input.disconnected\n更新日時: 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
}

データオブジェクトのevent_typeプロパティは、live_input.connected、live_input.disconnected、またはlive_input.erroredのいずれかになります。

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

エラーコード

  • ERR_STORAGE_QUOTA_EXHAUSTED – アカウントのストレージクォータが超過しました。
  • ERR_GOP_OUT_OF_RANGE – 入力GOPサイズまたはキーフレーム間隔が範囲外です。
  • ERR_UNSUPPORTED_VIDEO_CODEC – 入力ビデオコーデックが使用されているプロトコルに対してサポートされていません。
  • ERR_UNSUPPORTED_AUDIO_CODEC – 入力オーディオコーデックが使用されているプロトコルに対してサポートされていません。
例: live_input.erroredウェブフックペイロード
{
  "name": "ライブウェブフックテスト",
  "text": "通知タイプ: Stream Live Input\nInput ID: 2c28dd2cc444cb77578c4840b51e43a8\nイベントタイプ: live_input.errored\n更新日時: 2024-07-09T18:07:51.077371662Z\nエラーコード: ERR_GOP_OUT_OF_RANGE\nエラーメッセージ: 入力GOPサイズまたはキーフレーム間隔が範囲外です。\nビデオコーデック: \nオーディオコーデック: ",
  "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": "入力GOPサイズまたはキーフレーム間隔が範囲外です。"
      },
      "video_codec": "",
      "audio_codec": ""
    }
  },
  "ts": 1720548474,
}
Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Cookie Settings