← Cloudflare Realtime / realtime / realtimekit

Základní pojmy

Tato stránka nastiňuje klíčové koncepty a terminologii používanou v celém RealtimeKit.

App představuje pracovní prostor v rámci RealtimeKit. Sdružuje vaše schůzky, účastníky, předvolby, nahrávky a další konfiguraci v rámci izolovaného jmenného prostoru.

Na App se dívejte jako na kontejner vázaný na konkrétní prostředí. Většina týmů proto vytváří jednu App pro staging a další pro produkci, aby nedocházelo k míchání dat.

Schůzka je znovupoužitelná virtuální místnost ke které se můžete připojit kdykoli. Pokaždé, když se účastníci připojí ke schůzce, vytvoří se nová relace je vytvořen.

Relace je označena jako ENDED krátce po odchodu posledního účastníka. Schůzka může mít pouze jedna aktivní relace v libovolném okamžiku.

Další informace o schůzkách najdete v Schůzky.

Session je probíhající instance schůzky. Vytvoří se, když se ke schůzce připojí první účastník, a skončí krátce poté, co ji opustí poslední účastník.

Každá relace je nezávislá, má vlastní účastníky, chat a nahrávky. Zároveň přebírá konfiguraci nastavenou při vytváření schůzky, record on start, persist_chat, a další.

Příklad - Opakující se „Týdenní standup“ schůzka vygeneruje novou relaci při každém připojení účastníka.

A Účastník se vytvoří, když přidáte uživatele do schůzky pomocí Přidání účastníka (API). Toto volání API vrací jedinečný authToken který klientský SDK používá k připojení k relaci a ověření uživatele.

Poznámka: Autentizační tokeny účastníků prosím nepoužívejte opakovaně.

Další informace o účastnících najdete v Účastníci.

Předvolba je opakovaně použitelná sada oprávnění, která definuje zážitek účastníka a vzhled a chování UI.

Vytváří se na úrovni aplikace a lze ji uplatnit na libovolného účastníka v libovolné schůzce dané aplikace.

Zároveň definuje typ schůzky, ke které se uživatel připojuje: videohovor, audiohovor nebo webinář. Účastníci téže schůzky mohou pro vytvoření flexibilních rolí používat různé presets. Příklad: Ve velké edtech třídě:

• Učitel se připojí s webinar-host preset, což jim umožňuje sdílet svá média a poskytuje jim ovládací prvky hostitele.
• Studenti se připojí s webinar-participant preset, který jim brání sdílet média, ale umožňuje jim používat funkce jako chat.
• Asistent výuky se připojí s group-call-host preset, což jim umožňuje sdílet svá média, ale nemají plnou kontrolu.

Umožňuje také přizpůsobit vzhled a chování uživatelského rozhraní, včetně barev a motivů, aby zážitek odpovídal vizuální identitě vaší aplikace.

Další informace o presetech najdete v Předvolby.