← Cloudflare Stream / stream / stream-live

Příjem živých webhooků

Stream Live nabízí webhooky, které vaší službě oznámí, když se Input připojí, odpojí nebo dojde k chybě Stream Live.

Stream Live Notifications

Pro koho je určeno?

Zákazníci, kteří používají Stream a chtějí dostávat webhooky se stavem svých videí.

Další možnosti / filtry

Můžete zadat Stream Live ID a dostávat oznámení pouze o daných Live Inputs. Pokud pole necháte prázdné, obdržíte seznam pro všechny Live Inputs.

Následující stavy vstupu vyvolávají oznámení. Můžete je jednotlivě zapnout nebo vypnout:

live_input.connected
live_input.disconnected

Zahrnuto v

Předplatné Stream.

Co dělat, když upozornění obdržíte?

Oznámení Stream si zákazník může zcela přizpůsobit. Konkrétní chování závisí na povolených úpravách.

V dashboardu Cloudflare přejděte na Oznámení stránce.
Přejděte na Oznámení ↗
Vyberte Cíle kartě.
Na Cíle stránce v sekci Webhooks, vyberte Vytvořit.
Zadejte informace o webhooku a vyberte Save and Test.
Chcete-li vytvořit oznámení, přejděte do Oznámení stránce vyberte Všechna oznámení kartě.
Vedle Oznámení, vyberte Přidat.
Pod seznamem produktů vyhledejte Stream a vyberte Vyberte.
Zadejte název a volitelný popis.
V části Webhooks, vyberte Přidat webhook a vyberte nově vytvořený webhook.
Vyberte Next.
Standardně budete dostávat webhook notifikace pro všechny Live Inputs. Pokud chcete přijímat webhooky jen pro určité vstupy, zadejte do textového pole seznam Input ID oddělených čárkami.
Až budete hotovi, vyberte Vytvořit.

Ukázkový payload webhooku

{
  "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
}

event_type vlastnost objektu data bude buď live_input.connected, live_input.disconnected, nebo live_input.errored.

Pokud jsou u vstupu zjištěny problémy, event_type bude live_input.errored. Další data budou pod live_input_errored klíč json a bude obsahovat code jednou z hodnot uvedených níže.

Kódy chyb

ERR_GOP_OUT_OF_RANGE : Velikost GOP nebo interval klíčových snímků vstupu je mimo povolený rozsah.
ERR_UNSUPPORTED_VIDEO_CODEC : Video kodek vstupu není pro použitý protokol podporován.
ERR_UNSUPPORTED_AUDIO_CODEC : Zvukový kodek vstupu není pro použitý protokol podporován.
ERR_STORAGE_QUOTA_EXHAUSTED : Byla překročena kvóta úložiště účtu. Odstraňte starší obsah nebo si zakupte další úložiště.
ERR_MISSING_SUBSCRIPTION : Nemáte oprávnění spustit živý stream. Zkontrolujte předplatné nebo se přihlaste do Dash, kde najdete podrobnosti.

Ukázkový payload webhooku live_input.errored

{
  "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,
}

Příjem živých webhooků

Přihlaste se k odběru Stream Live Webhooks

Kódy chyb