Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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 | ✔️ |
| Iniciování vytáčení klientem na číslo PSTN | ✔️ |
| Serverem iniciované vytáčení 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 najdete v tématu Možnosti automatizace volání.
Kdy použít virtuální místnosti
Následující tabulka popisuje, 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 Azure Communication Services, použijte volání pro interoperabilitu 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 | počítačový 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í ve virtuálních místnostech pomocí hlasu, videa nebo veřejné telefonní sítě (PSTN) a provádějte operace během hovoru, které zahajuje klient. | Použití SDK | Klient | Klientská sada SDK pro volání umožňuje uživatelům připojit se k hovoru ve virtuálních místnostech a provádět operace na straně klienta podle toho, jak je povoleno jejich přiřazenými rolemi uživatelů. Zabezpečení během hovoru ve virtuálních místnostech je zajištěno prostřednictvím uplatnění seznamu účastníků, harmonogramu, role uživatelů a kontrolních omezení nastavených při vytváření a správě virtuálních místností. Vývojáři mohou pomocí klientské sady SDK pro volání umožnit účastníkům hovoru provádět operace při hovoru, jako je ztlumení nebo zrušení ztlumení, sdílení obrazovky, zapnutí nebo vypnutí videa a volání na účastníky veřejné telefonní sítě atd. |
| Správa operací volání na straně serveru | SDK pro automatizaci hovorů | počítačový 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í iniciované serverem na číslo PSTN, nahrávání hovoru, odesílání a přijímání DTMF, odesílání informací 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í je vývojáři, tyto akce nejsou řízeny rolemi uživatelů. |
K zabezpečení hovorů a aktivaci operací na straně klienta nebo serveru používají vývojáři SDK virtuálních místností, SDK klienta pro volání, a SDK pro automatizaci volání.
| Schopnost | Serverová sada SDK pro místnosti | Volání klientské sady SDK | Sada SDK pro server automatizace |
|---|---|---|---|
| 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áva oprávnění účastníků hovorů ve virtuálních místnostech - Přiřazení/Aktualizace rolí uživatelů | ✔️ | ❌ | ❌ |
| 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 ve virtuálních místnostech nebo se připojí k hovoru v průběhu. | ❌ | ✔️ | ❌ |
| 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 | ❌ | ✔️ | ✔️ |
| Spusťte/Zastavte titulky hovoru a změňte jazyk titulků | ❌ | ✔️ | ❌ |
| Správa nahrávání hovorů | ❌ | ❌ | ✔️ |
| Odesílání a přijímání DTMF od/do účastníků veřejné telefonní sítě | ❌ | ❌ | ✔️ |
| Přehrání zvukových výzev účastníkům | ❌ | ❌ | ✔️ |
Úplný seznam operací během hovoru na klientské straně a jejich použití najdete v tématu Klientská sada SDK pro volání.
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 |
|---|---|
| Volání na účastníka veřejné telefonní sítě | ✔️ |
| Odeslání/čtení DTMF do/z účastníka 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.
Serverem iniciované vytáčení veřejné telefonní sítě (PSTN) pomocí serverové sady SDK pro automatizaci volání
Vývojáři mohou aktivovat nebo deaktivovat schopnost volat účastníkovi veřejné telefonní sítě nastavením příznaku pstnDialoutEnabled, který je specifický pro danou 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í schůzky pacienta, aniž by bylo nutné provádět jakékoliv zásahy 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 v místnosti.
- Pomocí sady SDK pro automatizaci volání se připojte k hovoru v 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í v virtuálních místnostech z klientských volacích SDK
Použijte volací SDK k připojení k místnostnímu hovoru. Připojit se k volání v místnosti lze pomocí SDK pro web, iOS nebo Android. Pro příklady a informace o tom, jak se připojit k volání do místnosti, viz Připojení k volání do místnosti.
K místnostem je také možné přistupovat pomocí Azure Communication Services UI Library. Knihovna uživatelského rozhraní umožňuje vývojářům přidat do své aplikace klienta volání podporujícího místnosti pomocí jen několika řádků kódu.
Iniciování vytáčení veřejné telefonní sítě klientem pomocí SDK 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ě nastavením příznaku pstnDialoutEnabled pro konkrétní místnost. Jakmile vývojář nastaví pro místnost hodnotu pstnDialoutEnabled=TRUE, účastníci hovoru s rolí prezentujícího mohou ze svého komunikačního klienta navázat hovor s účastníkem na veřejné telefonní síti. 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řte místnost s příznakem pstnDialoutEnabled nastaveným na Hodnotu True.
- Účastníci zahájí hovor v 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 a/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
- Smazat
- 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 | Stát |
|---|---|---|
| Sady SDK pro virtuální místnosti | 13. 3. 2025 | Obecná dostupnost – plně podporovaná |
| Sady SDK pro virtuální místnosti | 15.4.2024 | Obecná dostupnost – plně podporovaná |
| Sady SDK pro virtuální místnosti | 2023-06-14 | Obecná dostupnost – plně podporovaná |
| Sady SDK pro virtuální místnosti | 2023-10-30 | Public Preview – plně podporovaná |
| Sady SDK pro virtuální místnosti | 31. 3. 2023 | 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ůžete přiřadit jednu z následujících rolí: prezentující, spolupracovník, úč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, spolupracovníci mají možnosti zvuku, videa a sdílení obrazovky, Attendee má možnosti zvuku a videa, zatímco Uživatel může přijímat jenom 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 jim není přiřazena role uživatele. Jejich možnosti jsou omezené na ztlumení nebo zrušení ztlumení na místním zařízení.
| Schopnost | Role: Prezentující | Role: Spolupracovník | 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 | ✔️ | ✔️ | ✔️ | ❌ |
| – Zobrazit stav účastníků: nečinný, připojování, připojený, pozastavený, odpojování, odpojený atd. | ✔️ | ✔️ | ✔️ | ✔️ |
| - Zobrazit stav volání: Předběžná média, Příchozí hovor, Připojování, Vyzvánění, Připojeno, Přidrženo, Odpojování, Odpojeno atd. | ✔️ | ✔️ | ✔️ | ✔️ |
| - Zobrazit, jestli je účastník ztlumený | ✔️ | ✔️ | ✔️ | ✔️ |
| - Zobrazit důvod, proč účastník opustil hovor | ✔️ | ✔️ | ✔️ | ✔️ |
| - Zapnout titulky pro hovory | ✔️ | ✔️ | ✔️ | ✔️ |
| - Změna jazyka titulků | ✔️ | ✔️ | ✔️ | ✔️ |
| - Pozvěte účastníka virtuální místnosti k hovoru | ✔️ | ❌ | ❌ | ❌ |
| Sdílení obrazovky | ||||
| - Sdílet obrazovku | ✔️ * | ✔️ * | ❌ | ❌ |
| – Sdílení aplikace | ✔️ * | ✔️ * | ❌ | ❌ |
| Sdílej kartu 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 na dálku) |
| – Nastavení nebo aktualizace režimu škálování videa | ✔️ | ✔️ | ✔️ | ✔️ (Pouze na dálku) |
| - Vykreslení vzdáleného video streamu | ✔️ | ✔️ | ✔️ | ✔️ |
| Vytáčení účastníků do veřejné telefonní sítě z prostředí klienta | ||||
| - Vytáčení na účastníky ve veřejné telefonní síti z hovorů ve virtuálních místnostech | ✔️ | ❌ | ❌ | ❌ |
* K dispozici pouze ve webovém volacím SDK.
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 v místnosti.
- CallEnded se vyvolá, když skončí hovor v místnosti.
- CallParticipantAdded je publikováno, když se nový účastník připojí do místnosti hovoru.
- CallParticipantRemoved se publikuje, když účastník vypadne z hovoru v 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 Pouze na pozvánku, která povolila pouze pozvaným uživatelům připojit se k hovoru v místnosti.
- 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ý. Do budoucna jsou jediným podporovaným typem pokojů pokoje pouze na pozvání.
Známá omezení
- Automatizace volání služby Azure Communication Services v současné době nepodporuje volání 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 v místnosti.
- Zjistěte, jak spravovat hovor v 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.