Přehled virtuálních místností
Virtual Rooms umožňuje vývojářům využívat základní možnosti zabezpečení a řízení k vytváření dobře strukturovaných komunikačních prostředí, jako jsou virtuální schůzky a skupinové komunikace. Vývojáři můžou používat virtuální místnosti k vedení hlasových hovorů, videa a volání do veřejné telefonní sítě. Zabezpečení a ovládací prvky v místnostech lze klasifikovat následujícím způsobem.
Zabezpečení přístupu uživatelů a ovládací prvky se použijí pro účastníky volání, řízení toho, kdo se může připojit k hovoru a jaké akce mohou během hovoru provést. Například během virtuální schůzky pacienta s lékařem se k hovoru můžou připojit jenom autorizovaní zaměstnanci nemocnice a pacienti. Omezení účastníků zachovává ochranu osobních údajů pacienta a účastníci nepřekračují přiřazené role a oprávnění, aby přerušili probíhající hovor.
Zabezpečení a ovládací prvky na úrovni místnosti se použijí na úrovni volání, aby bylo možné řídit, kdy lze hovor provádět a jaké možnosti jsou během hovoru k dispozici. Studenti mají například oprávnění připojit se k hovoru v učebně pouze během přiděleného času, ale volající do veřejné telefonní sítě se nemůže připojit ke stejnému hovoru v učebně.
Možnosti vysoké úrovně podporované ve virtuálních místnostech
| Schopnost | Podporované volání v místnostech |
|---|---|
| Hlas (VoIP) | ✔️ |
| Video | ✔️ |
| Vytáčení iniciované klientem na číslo veřejné telefonní sítě | ✔️ |
| Vytáčené volání iniciované serverem na číslo veřejné telefonní sítě | ✔️ |
| Správa volání na straně serveru (Automatizace volání)* | ✔️ |
| Vytáčení do veřejné telefonní sítě | ❌ |
| Asynchronní zasílání zpráv (chat) | ❌ |
| Interoperabilita s Microsoft Teams | ❌ |
* Platí některé výjimky. Úplný seznam podporovaných funkcí automatizace volání je uvedený v tomto dokumentu.
Kdy použít virtuální místnosti
Následující tabulka ukazuje, kdy použít virtuální místnosti.
| Podmínka | Použití místností |
|---|---|
| Pokud je důležité určit, kdo se může připojit k hovoru (prostředí jen pro pozvání). | ✔️ |
| Pokud je důležité řídit, kdy je hovor spuštěný a ukončený. | ✔️ |
| Pokud jsou k vedení dobře spravované komunikace potřeba role a oprávnění uživatelů. | ✔️ |
| Pokud řešení vyžaduje interoperabilitu Teams.* | ❌ |
* Pokud řešení vyžaduje interoperabilitu mezi Teams a Komunikačními službami Azure, použijte volání interoperability Teams.
Jak provádět hovory ve virtuálních místnostech
Pokud chcete provádět hovory ve virtuálních místnostech, musíte vytvářet a spravovat místnosti na vysoké úrovni. Následující tabulka popisuje, jak umožnit účastníkům připojit se k volání a spouštět operace volání z volající sady SDK na straně klienta a na straně serveru.
| Schopnost | ACS SDK | Klientská a serverová sada SDK | Popis |
|---|---|---|---|
| Vytváření a správa virtuálních místností | Virtual Rooms SDK | Server | Sada Virtual Rooms SDK umožňuje vývojářům vytvářet a spravovat virtuální místnosti, přidávat nebo odebírat uživatele, přiřazovat nebo aktualizovat role uživatelů, nastavovat a aktualizovat plány virtuálních místností. Vývojáři můžou také nastavit limity zabezpečení, jako je omezení vytáčení veřejné telefonní sítě z místností. |
| Připojte se k volání virtuálních místností pomocí hlasového hovoru, videa nebo veřejné telefonní sítě a spusťte operace volání iniciované klientem. | Volání sady SDK | Klient | Volání klientské sady SDK umožňuje uživatelům připojit se k volání virtuálních místností a spouštět operace na straně klienta, jak je povoleno jejich přiřazenými rolemi uživatelů. Zabezpečení při volání virtuálních místností je zajištěno prostřednictvím vynucení seznamu, plánu, rolí uživatelů a omezení řízení nastavených prostřednictvím vytváření a správy virtuálních místností. Pomocí klientské sady SDK pro volání můžou vývojáři umožnit účastníkům volání spouštět operace v hovoru, jako je ztlumení nebo zrušení ztlumení, sdílení obrazovky, zapnutí nebo vypnutí videa a vytáčení účastníkům veřejné telefonní sítě atd. |
| Správa operací volání na straně serveru | Volání sady SDK pro automatizaci | Server | Sada SDK pro automatizaci volání umožňuje vývojářům spouštět operace volání ze strany serveru. Mezi operace volání patří vytáčené volání iniciované serverem na číslo veřejné telefonní sítě, nahrávání hovorů, odesílání a přijímání DTMF, odesílání oznámení konkrétním uživatelům atd. Vzhledem k tomu, že spuštěné operace volání na straně serveru jsou nezávislé na uživatelích a řídí se vývojáři, tyto akce nejsou řízeny rolemi uživatelů. |
Vývojáři používají sadu Virtual Rooms SDK, volání klientské sady SDK a sadu SDK pro automatizaci volání k zabezpečení volání a aktivaci operací na straně klienta nebo na straně serveru.
| Schopnost | Serverová sada SDK pro místnosti | Volání klientské sady SDK | Volání sady SDK serveru Automation |
|---|---|---|---|
| Správa virtuálních místností – Vytvoření, získání, aktualizace, seznam nebo odstranění virtuálních místností | ✔️ | ❌ | ❌ |
| Správa seznamu virtuálních místností – Přidání, aktualizace nebo odebrání uživatele do virtuální místnosti | ✔️ | ❌ | ❌ |
| Správaoprávněních | ✔️ | ❌ | ❌ |
| Správa plánu virtuálních místností – Nastavení/aktualizace povoleného plánu virtuálních místností | ✔️ | ❌ | ❌ |
| Správa ovládacích prvků zabezpečení virtuálních místností – Nastavení/aktualizace příznaku pro povolení vytáčení do veřejné telefonní sítě z konkrétních virtuálních místností | ✔️ | ❌ | ❌ |
| Získání seznamu uživatelů pozvaných k připojení k virtuální místnosti | ✔️ | ❌ | ❌ |
| Uživatel zahájí hovor virtuálních místností nebo se připojí k probíhajícímu hovoru. | ❌ | ✔️ | ❌ |
| Vytáčení pro uživatele veřejné telefonní sítě | ❌ | ✔️ | ✔️ |
| Přidání nebo odebrání účastníků VoIP do probíhajícího hovoru | ❌ | ✔️ | ✔️ |
| Získání seznamu účastníků, kteří se připojili k probíhajícímu hovoru | ❌ | ✔️ | ✔️ |
| Start/Stop call captions and change captions language | ❌ | ✔️ | ❌ |
| Správa nahrávání hovorů | ❌ | ❌ | ✔️ |
| Odesílání a přijímání DTMF účastníkům veřejné telefonní sítě | ❌ | ❌ | ✔️ |
| Přehrání zvukových výzev účastníkům | ❌ | ❌ | ✔️ |
Volání klientské sady SDK poskytuje úplný seznam operací volání na straně klienta a vysvětluje, jak je používat.
Správa volání virtuálních místností ze strany serveru pomocí sady SDK serveru pro automatizaci volání
Sada SDK pro automatizaci volání umožňuje vývojářům spravovat volání virtuálních místností ze strany serveru a spouštět operace v rámci volání. Funkce automatizace volání se postupně aktivují ve voláních virtuálních místností. Následující tabulka uvádí aktuální stav těchto funkcí. Vývojáři spravují a řídí možnosti automatizace volání na straně serveru, které fungují na vyšší úrovni než oprávnění účastníka volání. Funkce automatizace volání se proto neřídí prostřednictvím uživatelských rolí a oprávnění.
| Funkce automatizace volání | Podporované volání v místnostech |
|---|---|
| Vytáčení účastníkovi veřejné telefonní sítě | ✔️ |
| Odeslání/čtení DTMF účastníkovi veřejné telefonní sítě | ✔️ |
| Odeslání oznámení konkrétním účastníkům hovoru | ✔️ |
| Přidání nebo odebrání účastníka VoIP z probíhajícího hovoru | ✔️ |
| Ukončit hovor pro všechny uživatele | ✔️ |
| Přepisy volání | ❌ |
| Streamování zvukových médií | ❌ |
* Aktuálně ve verzi Public Preview.
Tento obrázek znázorňuje koncepty správy a připojování k místnostem.
Server iniciovaný vytáčením veřejné telefonní sítě pomocí sady SDK serveru pro automatizaci volání
Vývojáři můžou aktivovat nebo deaktivovat možnost vytáčet se účastníkovi veřejné telefonní sítě nastavením příznaku pstnDialoutEnabled specifické pro místnost. Jakmile vývojář nastaví pstnDialoutEnabled=TRUE pro místnost, můžou vývojáři vytáčet účastníky veřejné telefonní sítě ze strany serveru pomocí automatizace volání, aniž by museli mít účast na straně klienta.
Pacient může například požádat o službu interpretace pro nadcházející virtuální schůzku se svým lékařem. Ve většině případů se telefonní číslo služby interpretace určuje dynamicky prostřednictvím back-endového procesu. Tato funkce vytáčení veřejné telefonní sítě na straně serveru umožňuje vývojářům určit cílové telefonní číslo, zahájit hovor a přidat ho do virtuálního volání události pacienta, aniž by museli provádět akce na straně klienta.
Pomocí tohoto postupu přidejte číslo veřejné telefonní sítě do volání do místnosti pomocí sady SDK pro automatizaci volání:
- Vytvoření místnosti s příznakem pstnDialoutEnabled nastaveným na
True - Účastníci zahájí hovor do místnosti.
- Použití sady SDK pro automatizaci volání pro připojení k volání místnosti pomocí ID místnosti
- Použití sady SDK pro automatizaci volání k vytáčení na číslo veřejné telefonní sítě
- Uživatel veřejné telefonní sítě přijme hovor do místnosti a připojí se k němu.
Správa volání virtuálních místností ze sad SDK pro volání na straně klienta
Volání sad SDK slouží k připojení k hovoru do místnosti. Volání do místnosti se dají připojit pomocí sad SDK pro volání na web, iOS nebo Android. Tady najdete ukázky rychlého startu pro připojení k volání do místnosti.
K místnostem je také možné přistupovat pomocí knihovny uživatelského rozhraní služeb Azure Communication Services. Knihovna uživatelského rozhraní umožňuje vývojářům přidat klienta volání, který je do své aplikace povolených místností, jen s několika řádky kódu.
Vytáčení veřejné telefonní sítě iniciované klientem pomocí sady SDK volajícího klienta
Vývojáři můžou povolit nebo zakázat možnost, aby se účastníci volání připojovali k účastníkovi veřejné telefonní sítě, a to nastavením příznaku pstnDialoutEnabled pro konkrétní místnost. Jakmile vývojář nastaví hodnotu pstnDialoutEnabled=TRUE pro místnost, můžou účastníci hovoru s rolí prezentujícího vytočit účastníka veřejné telefonní sítě ze svého volajícího klienta. Následující postup slouží k přidání čísla veřejné telefonní sítě do volání do místnosti pomocí sady SDK volajícího klienta.
- Vytvoření místnosti s příznakem pstnDialoutEnabled nastaveným na Hodnotu True
- Účastníci zahájí hovor do místnosti.
- Účastník s rolí prezentujícího přidá do hovoru číslo veřejné telefonní sítě.
- Uživatel veřejné telefonní sítě přijme hovor do místnosti a připojí se k němu.
Rozhraní API nebo sady SDK pro virtuální místnosti
Místnosti se vytvářejí a spravují prostřednictvím rozhraní API místností nebo sad SDK. Pro operace použijte rozhraní API a sady SDK místností v serverové aplikaci room :
- Vytvořit
- Změnit
- Odstranění
- Nastavení a aktualizace seznamu účastníků
- Nastavení a úprava platnosti místnosti
- Přiřazování rolí a oprávnění uživatelům
| Virtual Rooms SDK | Verze | State |
|---|---|---|
| Sady SDK pro virtuální místnosti | 2024-04-15 | Obecně dostupná – plně podporovaná |
| Sady SDK pro virtuální místnosti | 2023-06-14 | Obecně dostupná – plně podporovaná |
| Sady SDK pro virtuální místnosti | 2023-10-30 | Public Preview – plně podporovaná |
| Sady SDK pro virtuální místnosti | 2023-03-31 | Public Preview – vyřazeno |
| Sady SDK pro virtuální místnosti | 1. 2. 2022 | Public Preview – vyřazeno |
| Sady SDK pro virtuální místnosti | 2021-04-07 | Public Preview – vyřazeno |
Předdefinované role a oprávnění účastníků ve voláních virtuálních místností
Účastníkům místnosti může být přiřazena jedna z následujících rolí: Prezentující, Účastník a Uživatel.
Následující tabulka obsahuje podrobné možnosti mapované na role. Na vysoké úrovni má role prezentujícího plnou kontrolu, možnosti Účastníků jsou omezené na zvuk a video, zatímco Uživatel může přijímat pouze zvuk, video a sdílení obrazovky.
Poznámka: Účastník hovoru do veřejné telefonní sítě není součástí seznamu místností, takže k nim není přiřazena role uživatele. Možnosti jsou omezené na ztlumení nebo zrušení ztlumení na místním zařízení.
| Schopnost | Role: Prezentující | Role: Účastník | Role: Příjemce |
|---|---|---|---|
| Střední ovládací prvky volání | |||
| - Zapnutí nebo vypnutí videa | ✔️ | ✔️ | ❌ |
| - Ztlumení nebo zrušení ztlumení mikrofonu | ✔️ | ✔️ | ❌ |
| – Ztlumit vzdáleného uživatele | ✔️ | ❌ | ❌ |
| - Přepínání mezi fotoaparáty | ✔️ | ✔️ | ❌ |
| - Aktivní reproduktor | ✔️ | ✔️ | ✔️ |
| - Volba mluvčího pro hovory | ✔️ | ✔️ | ✔️ |
| - Volba mikrofonu pro hovory | ✔️ | ✔️ | ❌ |
| – Zobrazení stavu účastníků (nečinné, připojení, připojení, blokování, odpojení, odpojení atd.) | ✔️ | ✔️ | ✔️ |
| - Zobrazit stav volání (počáteční médium, Příchozí, Připojení, Vyzvánění, Připojeno, Přidržení, Odpojení, Odpojeno | ✔️ | ✔️ | ✔️ |
| - Zobrazit, jestli je účastník ztlumený | ✔️ | ✔️ | ✔️ |
| - Zobrazit důvod, proč účastník opustil hovor | ✔️ | ✔️ | ✔️ |
| - Zahájit titulky volání | ✔️ | ✔️ | ✔️ |
| - Změna jazyka titulků | ✔️ | ✔️ | ❌ |
| - Ukončení schůzky pro všechny účastníky | ✔️ | ❌ | ❌ |
| - Pozvání k připojení účastníka virtuální místnosti k hovoru | ✔️ | ❌ | ❌ |
| Sdílení obrazovky | |||
| - Sdílet obrazovku | ✔️ * | ❌ | ❌ |
| – Sdílení aplikace | ✔️ * | ❌ | ❌ |
| – Sdílení karty prohlížeče | ✔️ * | ❌ | ❌ |
| – Účastníci můžou zobrazit sdílenou obrazovku | ✔️ | ✔️ | ✔️ |
| Správa seznamu | |||
| - Odebrání účastníka | ✔️ | ❌ | ❌ |
| Správa zařízení | |||
| - Požádat o povolení používat zvuk nebo video | ✔️ | ✔️ | ❌ |
| - Získat seznam fotoaparátů | ✔️ | ✔️ | ❌ |
| - Nastavit kameru | ✔️ | ✔️ | ❌ |
| - Získání vybrané kamery | ✔️ | ✔️ | ❌ |
| - Získat seznam mikrofonů | ✔️ * | ✔️ * | ❌ |
| - Nastavení mikrofonu | ✔️ * | ✔️ * | ❌ |
| – Získání vybraného mikrofonu | ✔️ * | ✔️ * | ❌ |
| - Získat seznam reproduktorů | ✔️ * | ✔️ * | ✔️ * |
| - Nastavení reproduktoru | ✔️ * | ✔️ * | ✔️ * |
| - Získání vybraného mluvčího | ✔️ | ✔️ | ✔️ |
| Vykreslování videa | |||
| - Vykreslení videa na více místech (místní kamera nebo vzdálený stream) | ✔️ | ✔️ | ✔️ (Pouze vzdálená) |
| – Nastavení nebo aktualizace režimu škálování videa | ✔️ | ✔️ | ✔️ (Pouze vzdálená) |
| - Vykreslení vzdáleného video streamu | ✔️ | ✔️ | ✔️ |
| Vytáčení účastníků do veřejné telefonní sítě z klientské strany | |||
| - Vytáčení účastníků do veřejné telefonní sítě z volání virtuálních místností | ✔️ | ❌ | ❌ |
* K dispozici pouze ve webové sadě SDK pro volání. Není k dispozici v sadách SDK pro iOS a Android.
** Aktuálně ve verzi Public Preview.
Zpracování událostí
Události hlasových hovorů a videohovorů publikované přes Event Grid jsou opatřeny poznámkami o hovorech místnosti.
- CallStarted se publikuje při zahájení hovoru do místnosti.
- CallEnded se publikuje , když skončí hovor do místnosti.
- CallParticipantAdded se publikuje , když se nový účastník připojí k hovoru do místnosti.
- CallParticipantRemoved se publikuje , když účastník zahodí z hovoru do místnosti.
Zastaralé funkce
Starší verze Public Preview rozhraní API pro místnosti podporovala dvě konfigurace pro ovládací prvek Seznamu místností, a to následujícím způsobem:
- Místnost Jen pozvánka, která povolila pouze pozvaným uživatelům připojit se k hovoru místností.
- Otevřená místnost , která byla méně zabezpečená. V konfiguraci otevřených místností se všichni uživatelé služeb Azure Communication Services mohli připojit k hovoru, aniž by byli explicitně pozváni prostřednictvím seznamu místností.
Koncept Open Room je teď zastaralý. V budoucnu jsou jediným podporovaným typem pokoje Jen pozvánky .
Známá omezení
- Funkce automatizace volání ve službě Azure Communication Services v současné době nepodporují volání do místností.
Další kroky:
- Pomocí rychlého startu můžete vytvořit, spravovat a připojit se k místnosti.
- Zjistěte, jak se připojit k hovoru do místnosti.
- Zjistěte, jak spravovat hovor do místnosti.
- Zkontrolujte požadavky na síť pro média a signalizaci.
- Analyzujte data místností, viz: Protokoly místností.
- Naučte se používat pracovní prostor služby Log Analytics, viz: Kurz služby Log Analytics.
- Vytváření vlastních dotazů v Log Analytics najdete v tématu: Začínáme s dotazy.