Časté dotazy

Chcete-li používat API RealtimeKit, musíte mít účet Cloudflare ↗.

Postupujte podle Průvodce vytvořením API tokenu a vytvořit tak nový token prostřednictvím Cloudflare dashboard ↗. Při konfiguraci oprávnění zajistěte, aby Realtime / Realtime Admin oprávnění jsou vybrána. Nakonfigurujte veškerá další zásady přístupu a omezení podle potřeby pro váš případ použití.

RealtimeKit sice neobsahuje vestavěný plánovací systém, ale plánování si nad ním můžete v aplikaci vybudovat sami. Schůzky RealtimeKit nemají čas začátku ani konce, takže rozvrh musí ukládat váš backend a ten také musí vynucovat, kdy se uživatelé smí připojit. Běžný postup je:

• Když uživatel naplánuje schůzku, váš backend vytvoří schůzku v RealtimeKit a uloží id spolu s časy zahájení a ukončení.
• Když se uživatel pokusí připojit ke schůzce ve vaší aplikaci, váš backend zkontroluje, zda aktuální čas spadá do povoleného časového okna.
• Pokud kontroly projdou, váš backend přidá účastníka ke schůzce, vrátí autentizační token účastníka do frontendu a frontend tento token předá RealtimeKit SDK, aby se uživatel mohl připojit.

Schůzku můžete v požadovaný čas deaktivovat nastavením jejího stavu na INACTIVE pomocí PATCH požadavek na Aktualizace schůzky koncový bod.

Tím se účastníkům zabrání ve vstupu do schůzky a zamezí se i zahájení jakýchkoli nových relací.

curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/realtime/kit/{APP_ID}/meetings/{MEETING_ID} \
--request PATCH \
--header "Authorization: Bearer <CLOUDFLARE_API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{ "status": "INACTIVE" }'

Váš backend vygeneruje autentizační token tak, že přidá uživatele jako účastníka schůzky pomocí Add Participant endpoint API. Odpověď API obsahuje token pole, což je autentizační token daného účastníka v dané schůzce. Pokud po vypršení platnosti předchozího tokenu potřebujete nový token pro existujícího účastníka, použijte Obnovit token účastníka endpoint. Další podrobnosti najdete v Tokeny účastníka.

Ano. Jeden účastník může být zastoupen více peery, pokud se uživatel připojí ke stejné schůzce z různých zařízení nebo karet. Každé připojení se stane samostatným peerem, ale všechny se mapují zpět na stejného účastníka.

Odstraňte účastníka daného uživatele ze schůzky pomocí Odstranit Účastníka endpoint API. Jakmile je účastník smazán a přestanete pro něj vydávat nové tokeny, nebude se moci do dané schůzky znovu připojit.

Ano. Pokud daný účastník pro danou schůzku existuje a má platný autentizační token, může se tento účastník v průběhu času připojit k více živým relacím téže schůzky.

Ve většině případů ne. Účastníka obvykle vytvoříte jednou pro daného uživatele a schůzku a poté ho opakovaně využíváte napříč relacemi této schůzky. Může být potřeba časem obnovit autentizační token účastníka, ale samotného účastníka není nutné vytvářet znovu.

Použijte stabilní interní identifikátor z vlastního systému, například číselné ID uživatele nebo UUID. Nepoužívejte osobní údaje, jako jsou e-mailové adresy, telefonní čísla nebo jiné osobně identifikovatelné údaje.

Předvolby jsou znovupoužitelný sada pravidel a konfigurací definovaných na úrovni aplikace. Stejný preset můžete použít pro více účastníků.

Více informací o přednastaveních najdete v zde.

RealtimeKit podporuje všechny oblíbené frameworky pro webové i mobilní platformy.

My doporučujeme používat naše UI Kity Pro většinu případů použití.

Poznámka: Když použijete náš UI Kit, získáte s ním i Core SDK, který můžete využít k vytvoření dalších funkcí podle vašich potřeb.

Další informace najdete v našem Průvodce výběrem SDK

Při inicializaci RealtimeKit můžete nastavit mediální konfiguraci pro kvalitu kamery.

Podívejte se na konfigurace médií zde pro další podrobnosti.

Vyšší kvalita kamery zvyšuje spotřebu šířky pásma a může negativně ovlivnit výkon schůzky na slabších zařízeních, pokud zařízení koncového uživatele nemá dostatečný výkon na zpracování rozlišení 1080p od více peerů.

Při inicializaci RealtimeKit můžete nastavit mediální konfiguraci pro kameru.

Podívejte se na konfigurace médií zde pro další podrobnosti.

Vyšší snímková frekvence videa zvyšuje spotřebu šířky pásma a při problémech s připojením na straně koncového uživatele může ovlivnit kvalitu videa u ostatních peerů ve schůzce. Ve skupinových hovorech nastavte nižší hodnotu snímkové frekvence videa (například <= 30). Aktuální výchozí hodnota je 24/30 FPS v závislosti na vrstvě simulcastu.

RealtimeKit SDK se snaží zajistit co nejlepší zážitek automatickým výběrem mikrofonu. Upřednostňuje zařízení Bluetooth před kabelovými zařízeními. Pokud však bylo zařízení připojené ještě před vstupem do schůzky RealtimeKit a nemá bluetooth, headset, nebo earphone ve svém popisku, může být přehlédnut.

Podporujeme automatický výběr mikrofonů s popiskem bluetooth, headset, earphone, nebo microphone, a USB zařízení s označením jako usb a wired. Podporována jsou i některá běžně používaná zařízení, jako jsou AirPods nebo Airdopes. Virtuální zařízení automaticky nevybíráme.

Pokud automatický výběr selže, mohou si koncoví uživatelé vybrat mikrofon ručně pomocí tlačítka Nastavení ve schůzce a SDK si tuto volbu zapamatuje pro příští relace. Pokud používáte zařízení, o kterém si myslíte, že je běžně rozšířené, obraťte se prosím na podporu a požádejte o přidání podpory automatického výběru přímo pro toto zařízení.

Při inicializaci RealtimeKit můžete nastavit mediální konfiguraci pro sdílení obrazovky.

Podívejte se na konfigurace médií zde pro další podrobnosti.

Vyšší snímková frekvence sdílení obrazovky zvyšuje spotřebu šířky pásma a při problémech s připojením na straně koncového uživatele může ovlivnit kvalitu videa u ostatních peerů ve schůzce. Ve skupinových hovorech nastavte nižší hodnotu snímkové frekvence sdílení obrazovky (například <= 30). Ve většině případů postačí 5 FPS (výchozí hodnota).

Může to mít několik důvodů.

Nejprve vyzkoušejte ukázkovou schůzku na demo aplikace ↗. Pokud nemůžete odeslat zprávu v ukázkové aplikaci, kontaktujte podporu. Pokud zprávu v ukázkové aplikaci odeslat můžete, problém je na straně integrace.

Chcete-li řešit problémy s integrací, nejprve zkontrolujte, zda se uživatel úspěšně připojil ke schůzce. Pokud uživatel připojeno ke schůzce úspěšně, zkontrolujte, zda uživatelovo předvolba má oprávnění odesílat zprávy. Pokud používáte vlastní uživatelské rozhraní, ověřte, zda základní Chat API pracujeme na odstranění Core SDK z obvyklých podezřelých.

Pokud tím problém nevyřešíte, zkontrolujte, zda uživatelské rozhraní neblokuje váš framework. Frameworky jako Material UI mohou blokovat zaměření vstupu pomocí focus trapů v komponentě Drawer. Obvykle existuje prop pro vypnutí focus trapu. Material UI má disableEnforceFocus prop pro tento účel.

Pokud stále nemůžete odeslat zprávu, obraťte se prosím na podporu.

Když předáte adresu URL obrázku vodoznaku prostřednictvím Spustit nahrávání API načte rekordér tento obrázek uvnitř prohlížeče běžícího v kontejneru Cloudflare. Pokud se obrázek zobrazuje nesprávně, zkontrolujte následující:

• CORS hlavičky: Adresa URL obrázku musí vracet správné hlavičky CORS (například Access-Control-Allow-Origin: *) v HTTP odpovědi. Bez těchto hlaviček prohlížeč načtení obrázku zablokuje.
• Přímá URL adresa obrázku: Adresa URL musí směřovat přímo na soubor obrázku (například https://example.com/logo.png), nikoli na HTML stránku, která obrázek vkládá.
• Žádná přesměrování: Adresa URL nesmí přesměrovávat na jiné umístění. Nahrávací nástroj načítá adresu URL tak, jak je, takže přesměrování může způsobit, že se obrázek nenačte.

Pokud vaše síť omezuje odchozí provoz, podívejte se na Seznam povolených sítí pro domény a porty potřebné pro vaši integraci RealtimeKit.

Přejděte na test.realtime.cloudflare.com ↗ a spusťte test před hovorem. Test zkontroluje vaši kameru, mikrofon a síť a ověří konektivitu ke koncovým bodům Cloudflare Realtime, abyste se ještě před připojením ke schůzce ujistili, že požadované služby nejsou blokovány vaší sítí nebo firewallem. Požadované domény a porty najdete v Seznam povolených sítí.

Důrazně nedoporučujeme vkládat Cloudflare hostovanou demo aplikaci nebo příklady jako iframe do vašeho webu, a to ani v případě, že autentizační tokeny předáváte prostřednictvím parametrů URL.

Namísto toho nastavte výchozí uživatelské rozhraní schůzky na vlastním webu podle Průvodce nastavením UI Kit nebo nasaďte Příklady RealtimeKit pro web ↗ pod vlastní doménou. Úsilí potřebné pro kterýkoli z těchto přístupů je minimální a přináší značné výhody:

• Ovládání: Zachováváte si plnou kontrolu nad uživatelským zážitkem, strukturou i rozhraním.
• Stabilita: Vaše implementace zůstává konzistentní a nezmění se ze dne na den, což chrání váš produkt před náhlými výpadky.
• Spolehlivost: Sami rozhodujete, kdy a jak aktualizovat, což vašim uživatelům zajišťuje stabilní zážitek.

Demo aplikace a ukázkové aplikace mohou být kdykoli aktualizovány bez předchozího upozornění.