INTEGRITY Dokumentace

← Cloudflare Realtime / realtime / realtimekit / recording-guide

Sledování stavu nahrávání

Stavy nahrávání

Nahrávání schůzky může mít následující stavy:

Název Popis
INVOKED Backendové servery RealtimeKit přijaly požadavek na nahrávání a master nyní hledá dostupný worker, kterému úlohu s nahráváním přiřadí.
NAHRÁVÁNÍ Schůzka se právě nahrává pomocí workeru. Vezměte na vědomí, že to platí i v případě, že je schůzka živě vysílána.
NAHRÁVÁNÍ Nahrávání bylo zastaveno a soubor se nahrává do cloudového úložiště. Pokud jste nezadali podrobnosti o úložišti, soubory se nahrají pouze na server RealtimeKitu. V této fázi se zastaví i všechny odkazy RTMP a živého vysílání.
NAHRÁNO Nahrání souboru se záznamem je dokončeno a zároveň se spustí stavový webhook.
ERRORED Při nahrávání schůzky došlo k nenávratné chybě a soubor nebude k dispozici.

Načítání stavu

Existují dva způsoby, jak sledovat stav nahrávání nebo zobrazit další podrobnosti o nahrávání:

Pomocí recording.statusUpdate webhook

RealtimeKit odesílá recording.statusUpdate webhook, když nahrávání během svého životního cyklu přechází mezi stavy. Přidejte recording.statusUpdate k vašemu webhooku events pole pro příjem těchto oznámení.

curl --request POST "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/webhooks" \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Recording status webhook",
    "url": "https://example.com/webhook",
    "events": ["recording.statusUpdate"],
    "enabled": true
  }'

Datový obsah webhooku obsahuje aktuální stav nahrávání, metadata nahrávky a související podrobnosti o schůzce. Když je stav UPLOADED, payload může obsahovat downloadUrl, audioDownloadUrl, a downloadUrlExpiry pole pro přístup k nahraným souborům.

Nastavení, ověřování podpisu, chování opakovaných pokusů a úplný příklad payloadu najdete v Webhooky RealtimeKit.

Dotazováním HTTP API

Alternativně můžete použít také následující API: