INTEGRITY Dokumentace

← Cloudflare Realtime / realtime / realtimekit / concepts

Schůzka

Meeting je znovupoužitelná virtuální místnost do níž se můžete v reálném čase připojit a interagovat v ní.

Můžete mu přiřadit název a konfiguraci funkcí a poté přidat účastníky, kteří jsou oprávněni se připojit. Samotná Meeting nezačíná ani nekončí, prostě existuje.

Protože Meetings nemají konkrétní datum ani čas, můžete je vytvořit dlouho dopředu, nebo až těsně předtím, než je uživatelé potřebují k připojení.

Následující diagram znázorňuje strukturu objektu Meeting:

---
title: Meeting
---
flowchart TB
  accTitle: Meeting blueprint
  accDescr: Diagram showing blueprint of a Meeting

  subgraph details [ ]
      direction LR
      subgraph feat ["<b>Features</b>"]
          feat-content["Chat<br>...<br>Recording<br>...<br>Transcriptions"]
      end
      subgraph config ["<b>Configuration</b>"]
          config-content["record_on_start<br>...<br>persist_chat<br>...<br>ai_config"]
      end
  end

  subgraph participants ["<b>Participants</b>"]
      direction LR
      subgraph participants-row2 [ ]
          direction TB
          P3["<br>Participant 3
          <br>
          "]
          P4["<br>Participant 4
          <br>
          "]
      end
      subgraph participants-row1 [ ]
          direction TB
          P1["<br>Participant 1
          <br>
          "]
          P2["<br>Participant 2
          <br>
          "]
      end
  end

  style participants-row1 fill:none,stroke:none
  style participants-row2 fill:none,stroke:none
  style details fill:none,stroke:none

Relace

A Relace je živou instancí Meeting. Spouští se automaticky, jakmile se do schůzky připojí první účastník, a končí krátce po odchodu posledního účastníka. Session dědí všechna nastavení (jako jsou funkce a název) od nadřazeného Meeting.

Protože Meeting je trvalý, může v průběhu času obsahovat mnoho různých Sessions.

Příklad - Meeting si můžete představit jako opakující se týdenní standup.

Meeting je trvalá „standup event“, která ve vašem systému existuje.

Každý týden, když se účastníci připojí ke standupu daného týdne, new Session se vytvoří: tato Session představuje skutečný živý standup daného týdne.

Poznámka: Toto rozlišení je důležité pro fakturaci. Účtuje se vám za jednotlivé účastníky pouze po dobu trvání aktivní relace, nikoli za nečinnou schůzku.

Podrobnosti o svých relacích získáte z RealtimeKit Dashboard ↗ nebo pomocí Sessions API koncové body.

Relace v RealtimeKit Dashboard

Terminologie relací

Waiting Room

A čekárna umožňuje účastníkům připojit se ke schůzce, aniž by ihned vstoupili do živé relace. To dává hostitelům plnou kontrolu nad kdo se dostane dovnitř, kdy vstoupí, a jak je řízen průběh schůzky.

Hostitelé mohou také nastavit konkrétní chování pro přechod uživatelů z čekárny do schůzky.

Tyto možnosti umožňují přizpůsobit způsob řízení přístupu: ať už potřebujete přísnou kontrolu vstupu, plynulejší průběh po příchodu hostitele, nebo kombinaci obou.

Stage

Schůzky lze nakonfigurovat pomocí virtuální pódium, což vám pomáhá řídit, kdo aktivně vysílá zvuk a video během schůzek s velkým počtem účastníků.

Když je účastník na pódiu, jsou viditelní v mřížce a mohou svůj zvuk a video publikovat všem účastníkům schůzky. Účastníci, kteří jsou mimo pódium nemohou publikovat média, ale stále se mohou plně zapojit pomocí funkcí, jako je chat, ankety, Otázky a odpovědi, a pluginy, což zpříjemňuje zážitek interaktivitou, aniž by to narušilo rozvržení živého videa.

Účastníci mohou také žádost o vstup na stage, což jim umožňuje signalizovat, kdy chtějí mluvit nebo prezentovat. Hostitelé si po celou dobu zachovávají plnou kontrolu: mohou schvalovat nebo zamítat žádosti, nebo přímo pozvat účastníky na pódium nebo je z pódia odebrat podle potřeby.

Toto nastavení je ideální pro webináře, celofiremní setkání, AMA a další strukturované akce, kde má vysílat jen část uživatelů a ostatní se účastní jako publikum.

Connected Meetings

Connected Meetings umožňují vytvářet propojené prostory schůzek, mezi kterými mohou účastníci během relace přepínat. Hodí se pro workshopy, výuku, paralelní diskuse nebo jakýkoli scénář, kdy se hlavní schůzka rozdělí na menší skupiny a poté se znovu spojí.

Pomocí následujících oprávnění můžete řídit, jak se účastníci pohybují mezi těmito propojenými prostory:

Vytvoření schůzky

Schůzky RealtimeKit vytváříte a spravujete, obvykle z backendu, pomocí Meetings API. Chcete-li vytvořit schůzku, odešlete POST požadavek na Vytvoření schůzky koncový bod.

Požadavky na API

Ujistěte se, že pro tento požadavek API máte k dispozici následující hodnoty:

Pokud je ještě nemáte, projděte si Začínáme návod.

curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/realtime/kit/{APP_ID}/meetings \
  --request POST \
  --header "Authorization: Bearer <CLOUDFLARE_API_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "title": "My First Cloudflare RealtimeKit meeting"
    }'

Úspěšná odpověď obsahuje jedinečný id pro vytvořenou schůzku. Toto ID si uložte, protože je potřebné pro všechny další operace s touto konkrétní schůzkou, například přidávání účastníků nebo její deaktivaci.

Úplný seznam všech dostupných konfiguračních parametrů najdete v API pro vytvoření schůzky.

Kam pokračovat dál

Jakmile se seznámíte se schůzkami a relacemi, můžete pokračovat těmito dalšími kroky: