← Cloudflare Realtime / realtime / realtimekit / concepts

Účastník

Než se uživatel může připojit ke schůzce prostřednictvím RealtimeKit SDK, musí ho váš backend nejprve přidat jako účastníka dané schůzky pomocí Add Participant API. V RealtimeKit je účastník představuje uživatele, který má povoleno připojit se ke konkrétní schůzce.

Můžete si to představit jako zápis studenta do třídy: schůzka je třída a přidání účastníka je způsob, jak zaregistrovat uživatele, aby se jí mohl zúčastnit.

Když přidáváte účastníka, zároveň zvolíte, které předvolba k použití. Předvolba definuje roli, oprávnění a zážitek daného účastníka ze schůzky.

Když přidáte účastníka do schůzky pomocí Add Participant API endpoint, vrací:

• Účastník id která identifikuje tohoto účastníka v rámci schůzky.
• Autentizační token pro daného účastníka.

Váš backend by jej měl zpřístupnit frontendové aplikaci. Jakmile se uživatel rozhodne připojit ke schůzce, frontend předá token SDK RealtimeKit.

RealtimeKit pomocí tokenu ověří účastníka a určí, do které schůzky a jako který účastník se připojuje. Bez platného ověřovacího tokenu se SDK nemůže ke schůzce připojit jménem daného účastníka. Dokud má účastník platný ověřovací token, může se v průběhu času připojit k více živým relacím téže schůzky.

Autentizační tokeny účastníků jsou časově omezené a nakonec vyprší. Po vypršení tokenu není nutné pro stejného uživatele ve schůzce vytvářet nového účastníka.

Místo toho může váš backend zavolat Obnovit token účastníka API endpoint. Tento endpoint vystaví nový autentizační token pro stávající záznam účastníka a zachová přitom údaje, jako je účastníkovo id a předem nastavte totéž.

Při přidávání účastníka můžete volitelně zadat vlastní identifikátor účastníka, označovaný jako custom_participant_id. Tato hodnota slouží výhradně pro vaše účely. RealtimeKit ji ukládá a vrací v API, ale nepoužívá ji k řízení přístupu. Umožňuje vám namapovat uživatele vaší aplikace na účastníka RealtimeKit a propojit data relace, události nebo analýzy RealtimeKit s informacemi o uživateli ve vašem systému.

Jakmile pochopíte koncept účastníků, můžete prozkoumat tato témata:

• Zjistěte, jak Předvolby definují role a oprávnění pro účastníky
• Začínáme s RealtimeKit SDK