Virtuális szobák áttekintése
A virtuális szobák alapvető biztonsági és vezérlési képességekkel teszik lehetővé a fejlesztők számára, hogy jól strukturált kommunikációs szolgáltatásokat, például virtuális találkozókat és csoportos kommunikációt építsenek ki. A fejlesztők virtuális szobákkal hang-, video- és PSTN-hívásokat bonyolíthatnak le. A szobák biztonsági és vezérlői az alábbiak szerint besorolhatók.
A rendszer a felhasználók hozzáférésének biztonságát és vezérlőit alkalmazza a hívás résztvevőire, szabályozva, hogy kik csatlakozhatnak a híváshoz, és hogy milyen műveleteket hajthatnak végre a hívás során. Például egy orvossal való virtuális találkozó során csak az arra jogosult kórházi személyzet és betegek csatlakozhatnak a híváshoz. A résztvevők korlátozása megőrzi a beteg magánéletét, és a résztvevők nem lépik túl a hozzárendelt szerepköreiket és jogosultságaikat, hogy megzavarják a folyamatban lévő hívást.
A szobaszintű biztonság és vezérlők a hívás szintjén vannak alkalmazva annak szabályozására, hogy mikor indítható a hívás, és mely képességek érhetők el a hívás során. A diákok például csak a lefoglalt idő alatt csatlakozhatnak egy osztályterem-híváshoz, de a PSTN-hívó nem tud ugyanahhoz az osztályterem-híváshoz csatlakozni.
A virtuális szobákban támogatott magas szintű képességek
| Funkció | A Szobák hívása támogatott |
|---|---|
| Hang (VoIP) | ✔️ |
| Videó | ✔️ |
| Az ügyfél PSTN-számra kezdeményezett kitárcsázást | ✔️ |
| Kiszolgáló által kezdeményezett kitárcsázás PSTN-számra** | ✔️ |
| Kiszolgálóoldali híváskezelés (Hívásautomatizálás)* | ✔️ |
| PSTN betárcsázás | ❌ |
| Aszinkron üzenetkezelés (csevegés) | ❌ |
| Együttműködés a Microsoft Teamsszel | ❌ |
* Néhány kivétel érvényes. A támogatott Hívásautomatizálási képességek teljes listája ebben a dokumentumban található.
** Jelenleg nyilvános előzetes verzióban érhető el.
Mikor érdemes virtuális szobákat használni?
Az alábbi táblázat bemutatja, hogy mikor érdemes virtuális szobákat használni.
| Feltétel | Szobák használata |
|---|---|
| Ha fontos szabályozni, hogy ki csatlakozhat egy híváshoz (csak meghívásos felület). | ✔️ |
| Amikor fontos szabályozni a hívás indítását és befejezését. | ✔️ |
| Ha a jól felügyelt kommunikációhoz felhasználói szerepkörökre és engedélyekre van szükség. | ✔️ |
| Ha a megoldáshoz Teams-együttműködésre van szükség.* | ❌ |
* Ha a megoldás együttműködésre van szükség a Teams és az Azure Communication Services között, használjon Teams együttműködési hívásokat
Hívások végrehajtása virtuális szobákban
Magas szinten a virtuális szobákban történő hívások indításához létre kell hoznia és kezelnie kell a szobákat. Az alábbi táblázat azt ismerteti, hogyan engedélyezheti a résztvevőknek, hogy csatlakozzanak a hívásokhoz, és hogyan hajthassanak végre híváson belüli műveleteket az ügyféloldali és kiszolgálóoldali hívó SDK-ból.
| Funkció | ACS SDK | Ügyfél és kiszolgáló SDK | Leírás |
|---|---|---|---|
| Virtuális szobák létrehozása és kezelése | Virtuális szobák SDK | Kiszolgáló | A Virtual Rooms SDK lehetővé teszi a fejlesztők számára a virtuális szobák létrehozását és kezelését, a felhasználók hozzáadását/eltávolítását, a felhasználói szerepkörök hozzárendelését/frissítését, a virtuális szobák ütemezésének beállítását/frissítését. A fejlesztők biztonsági korlátokat is beállíthatnak, például korlátozhatják a PSTN-kitárcsázást a szobákból. |
| Csatlakozzon egy virtuális szoba hívásához hanggal, videóval vagy PSTN-vel, és hajtsa végre az ügyfél által kezdeményezett hívás közbeni műveleteket | SDK hívása | Ügyfél | A hívó ügyféloldali SDK lehetővé teszi a felhasználók számára, hogy csatlakozzanak egy virtuális szoba hívásához, és ügyféloldali műveleteket hajtsanak végre a hozzárendelt felhasználói szerepkörök által megengedett módon. A virtuális szobák hívásainak biztonságát a virtuális szobák létrehozásával és kezelésével meghatározott névsorok, ütemezések, felhasználói szerepkörök és vezérlési korlátok kényszerítése biztosítja. Az ügyfélhívási SDK használatával a fejlesztők lehetővé teszik a hívás résztvevői számára a híváson belüli műveletek végrehajtását, például a némítást/visszahangosítást, a képernyő megosztását, a videó be- és kikapcsolását, valamint a PSTN-résztvevőknek való kitárcsázást stb. |
| A hívás közbeni műveletek kiszolgálóoldali kezelése | Automation SDK hívása | Kiszolgáló | A HívásautomatizálásI SDK lehetővé teszi a fejlesztők számára, hogy hívás közbeni műveleteket hajtsanak végre a kiszolgálóoldalról. A híváson belüli műveletek közé tartozik a kiszolgáló által kezdeményezett kitárcsázás egy PSTN-számra, hívásrögzítés, DTMF küldése/fogadása, bejelentések küldése adott felhasználóknak stb. Mivel a kiszolgálóoldali hívásközi műveletek futtatása független a felhasználóktól, és a fejlesztők felügyelik őket, ezeket a műveleteket nem felhasználói szerepkörök vezérlik. |
A fejlesztők a Virtual Rooms SDK-t, az ügyféloldali SDK-t és a Call Automation SDK-t használják a hívások biztonságossá tételéhez és a hívásközi ügyféloldali/kiszolgálóoldali műveletek elindításához.
| Funkció | Szobák kiszolgálói SDK | Ügyféloldali SDK hívása | Automation Server SDK meghívása |
|---|---|---|---|
| Virtuális szobák kezelése – Virtuális szobák létrehozása/lekérése/frissítése/listázása/törlése | ✔️ | ❌ | ❌ |
| Virtuális szobák névsorának kezelése – Felhasználó hozzáadása/frissítése/eltávolítása virtuális helyiségbe | ✔️ | ❌ | ❌ |
| Virtuális szobák meghívják a résztvevők engedélykezelését – Felhasználói szerepkörök hozzárendelése/frissítése | ✔️ | ❌ | ❌ |
| Virtuális szobák ütemezésének kezelése – Virtuális szobák engedélyezett ütemezésének beállítása/frissítése | ✔️ | ❌ | ❌ |
| Virtuális szobák biztonsági vezérlőinek kezelése – Beállítás/frissítés jelző, amely engedélyezi a PSTN-kitárcsázást adott virtuális szobákból | ✔️ | ❌ | ❌ |
| Virtuális helyiségbe való csatlakozásra meghívott felhasználók listájának lekérése | ✔️ | ❌ | ❌ |
| A felhasználó elindít egy virtuális szobát, vagy csatlakozik egy folyamatban lévő híváshoz | ❌ | ✔️ | ❌ |
| Kitárcsázás PSTN-felhasználónak | ❌ | ✔️ | ✔️* |
| VoIP-résztvevők hozzáadása/eltávolítása folyamatban lévő híváshoz | ❌ | ✔️ | ✔️* |
| A folyamatban lévő híváshoz csatlakozott résztvevők listájának lekérése | ❌ | ✔️ | ✔️* |
| Hívásfeliratok indítása/leállítása és a feliratok nyelvének módosítása | ❌ | ✔️* | ❌ |
| Hívásrögzítés kezelése | ❌ | ❌ | ✔️* |
| DTMF küldése/fogadása PSTN-résztvevőknek/résztvevőktől | ❌ | ❌ | ✔️* |
| Hangüzenetek lejátszása a résztvevőknek | ❌ | ❌ | ✔️* |
Az ügyféloldali SDK hívása az ügyféloldali hívásközi műveletek teljes listáját tartalmazza, és ismerteti azok használatát.
* Jelenleg nyilvános előzetes verzióban.
Virtuális szobák kiszolgálóoldali hívásainak kezelése a Call Automation Server SDK használatával
A Call Automation SDK lehetővé teszi a fejlesztők számára a virtuális szobák kiszolgálóoldali hívásainak kezelését és a híváson belüli műveletek végrehajtását. A hívásautomatizálási képességek fokozatosan engedélyezve vannak a Virtual Rooms-hívásokban. Az alábbi táblázat ezeknek a képességeknek az aktuális állapotát mutatja be. A fejlesztők a hívásautomatizálási képességeket kiszolgálóoldalról felügyelik és felügyelik, amelyek magasabb szinten működnek, mint a hívás résztvevőinek jogosultságai. A hívásautomatizálási képességeket tehát nem felhasználói szerepkörök és engedélyek vezérlik.
| Hívásautomatizálási képesség | A Szobák hívása támogatott |
|---|---|
| Kitárcsázás PSTN-résztvevőnek * | ✔️ |
| DTMF küldése/olvasása PSTN-résztvevőnek/ résztvevőtől * | ✔️ |
| Közlemények küldése adott hívás résztvevőinek * | ✔️ |
| VoIP-résztvevő hozzáadása/eltávolítása folyamatban lévő hívásból | ✔️ |
| Az összes felhasználó hívásának befejezése | ✔️ |
| Hívásátiratok | ❌ |
| Audio médiastreamelés | ❌ |
* Jelenleg nyilvános előzetes verzióban.
Ez az ábra a szobák kezelésével és csatlakozásával kapcsolatos fogalmakat mutatja be.
Kiszolgáló által kezdeményezett PSTN-tárcsázás a Call Automation Server SDK használatával
A fejlesztők a szobaspecifikus pstnDialoutEnabled jelölő beállításával aktiválhatják/inaktiválhatják a PSTN-résztvevőknek való kitárcsázás lehetőségét. Miután a fejlesztő beállította a pstnDialoutEnabled=TRUE értéket egy helyiséghez, a fejlesztők a Call Automation használatával kitárcsázhatnak egy PSTN-résztvevőhöz a kiszolgálóoldalról anélkül, hogy ügyféloldali részvételre kellenek.
Előfordulhat például, hogy a páciens tolmácsszolgáltatást kér a közelgő virtuális találkozóhoz az orvosával. A legtöbb esetben a tolmácsolási szolgáltatás telefonszámát egy háttérfolyamat dinamikusan határozza meg. Ez a kiszolgálóoldali PSTN-kitárcsázási funkció lehetővé teszi a fejlesztők számára, hogy meghatározzák a cél telefonszámot, kezdeményezik a hívást, és hozzáadják azt a páciens virtuális találkozóihoz anélkül, hogy ügyféloldali műveleteket kellene végrehajtaniuk.
Kövesse az alábbi lépéseket, ha PSTN-számot szeretne hozzáadni egy szobahíváshoz a Call Automation SDK használatával:
- Helyiség létrehozása pstnDialoutEnabled jelölővel
True - A résztvevők szobahívást kezdeményeznek
- A HívásautomatizálásI SDK használata helyiség-híváshoz való csatlakozáshoz szobaazonosító használatával
- PsTN-számra történő kitárcsázás a Call Automation SDK használatával
- A PSTN-felhasználó fogadja és csatlakozik egy szobahíváshoz
Virtuális szobák hívásainak kezelése ügyféloldali hívó SDK-kból
A Hívó SDK-k használatával csatlakozzon a szobahíváshoz. A szobahívások a webes, iOS- vagy Android-hívó SDK-k használatával csatlakoztathatók. A szobahívásokhoz való csatlakozáshoz itt talál gyors kezdési mintákat.
A szobák az Azure Communication Services felhasználói felületi kódtárával is elérhetők. A felhasználói felületi kódtár lehetővé teszi a fejlesztők számára, hogy csak néhány sornyi kóddal adjanak hozzá egy Szobabarát hívásügyfélt az alkalmazásukhoz.
Ügyfél által kezdeményezett PSTN-kitárcsázás az ügyfél SDK hívásával
A fejlesztők a szobaspecifikus pstnDialoutEnabled jelölő beállításával engedélyezhetik/tilthatják le a hívás résztvevőinek a PSTN-résztvevőknek való kitárcsázását. Miután a fejlesztő beállította a pstnDialoutEnabled=TRUE értéket egy helyiségre, az előadói szerepkörrel rendelkező hívás résztvevői kitárcsázhatnak egy PSTN-résztvevőt a hívó ügyfélprogramjukból. Az alábbi lépésekkel PSTN-számot adhat hozzá egy szobahíváshoz az ügyféloldali SDK hívásával.
- Helyiség létrehozása a pstnDialoutEnabled jelölő igaz értékre állításával
- A résztvevők szobahívást kezdeményeznek
- Egy előadói szerepkörrel rendelkező résztvevő PSTN-számot ad hozzá egy híváshoz
- A PSTN-felhasználó fogadja és csatlakozik egy szobahíváshoz
Virtual Rooms API/SDK-k
A szobák létrehozása és kezelése szobák API-kkal vagy SDK-kkal. Használja a szobák API-jait/SDK-jait a kiszolgálóalkalmazásban a műveletekhez room :
- Létrehozás
- Módosítás
- Törlés
- A résztvevők listájának beállítása és frissítése
- A szoba érvényességének beállítása és módosítása
- Szerepkörök és engedélyek hozzárendelése a felhasználókhoz
| Virtuális szobák SDK | Verzió | Állapot |
|---|---|---|
| Virtuális szobák SDK-k | 2024-04-15 | Általánosan elérhető – Teljes mértékben támogatott |
| Virtuális szobák SDK-k | 2023-06-14 | Általánosan elérhető – Teljes mértékben támogatott |
| Virtuális szobák SDK-k | 2023-10-30 | Nyilvános előzetes verzió – Teljes mértékben támogatott |
| Virtuális szobák SDK-k | 2023-03-31 | 2024. április 30-án megszűnik |
| Virtuális szobák SDK-k | 2022-02-01 | 2024. április 30-án megszűnik |
| Virtuális szobák SDK-k | 2021-04-07 | 2024. április 30-án megszűnik |
Előre definiált résztvevői szerepkörök és engedélyek a Virtual Rooms-hívásokban
A szoba résztvevői a következő szerepkörök egyikéhez rendelhetők hozzá: Előadó, Résztvevő és Fogyasztó.
Az alábbi táblázat a szerepkörökhöz rendelt részletes képességeket tartalmazza. Magas szinten az előadói szerepkör teljes körű vezérléssel rendelkezik, a Résztvevők képességei hangra és videóra korlátozódnak, míg a Fogyasztó csak hang-, video- és képernyőmegosztást fogadhat.
| Funkció | Szerepkör: Előadó | Szerepkör: Résztvevő | Szerepkör: Fogyasztó |
|---|---|---|---|
| Közepes hívásvezérlők | |||
| – Videó be- és kikapcsolása | ✔️ | ✔️ | ❌ |
| - Mikrofon elnémítása/visszahangosítása | ✔️ | ✔️ | ❌ |
| - Távoli felhasználó elnémítása | ✔️ | ❌ | ❌ |
| - Váltás kamerák között | ✔️ | ✔️ | ❌ |
| - Aktív hangszóró | ✔️ | ✔️ | ✔️ |
| - Hangszóró kiválasztása hívásokhoz | ✔️ | ✔️ | ✔️ |
| - Válassza ki a mikrofont a hívásokhoz | ✔️ | ✔️ | ❌ |
| - Résztvevők állapotának megjelenítése (inaktív, csatlakozás, csatlakoztatott, Várakozó, Leválasztott, Leválasztott stb.) | ✔️ | ✔️ | ✔️ |
| - Hívás állapotának megjelenítése (Korai adathordozó, Bejövő, Csatlakozás, Csengés, Csatlakoztatott, Visszatartás, Leválasztva, Leválasztva | ✔️ | ✔️ | ✔️ |
| - Annak megjelenítése, hogy egy résztvevő el van-e némítva | ✔️ | ✔️ | ✔️ |
| – Annak az oka, hogy egy résztvevő miért hagyott el egy hívást | ✔️ | ✔️ | ✔️ |
| - Hívásfeliratok indítása ** | ✔️ | ✔️ | ✔️ |
| - Feliratok nyelvének módosítása ** | ✔️ | ✔️ | ❌ |
| – Értekezlet befejezése az összes résztvevő számára | ✔️ | ❌ | ❌ |
| – Meghívás virtuális szoba résztvevőjéhez való csatlakozásra egy híváshoz | ✔️ | ❌ | ❌ |
| Képernyőmegosztás | |||
| – Megosztás képernyő | ✔️ * | ❌ | ❌ |
| – Alkalmazás megosztása | ✔️ * | ❌ | ❌ |
| – Böngészőlap megosztása | ✔️ * | ❌ | ❌ |
| – A résztvevők megtekinthetik a megosztott képernyőt | ✔️ | ✔️ | ✔️ |
| Névsorkezelés | |||
| – Résztvevő eltávolítása | ✔️ | ❌ | ❌ |
| Eszközkezelés | |||
| - Kérjen engedélyt a hang és/vagy videó használatára | ✔️ | ✔️ | ❌ |
| - Kameralista lekérése | ✔️ | ✔️ | ❌ |
| - Kamera beállítása | ✔️ | ✔️ | ❌ |
| – A kiválasztott kamera lekérése | ✔️ | ✔️ | ❌ |
| - Mikrofonlista lekérése | ✔️ * | ✔️ * | ❌ |
| - Mikrofon beállítása | ✔️ * | ✔️ * | ❌ |
| – Kijelölt mikrofon lekérése | ✔️ * | ✔️ * | ❌ |
| – Előadók listájának lekérése | ✔️ * | ✔️ * | ✔️ * |
| - Hangszóró beállítása | ✔️ * | ✔️ * | ✔️ * |
| – Kijelölt előadó lekérése | ✔️ | ✔️ | ✔️ |
| Videó renderelése | |||
| - Videó megjelenítése több helyen (helyi kamera vagy távoli stream) | ✔️ | ✔️ | ✔️ (Csak távoli) |
| – Videoskálázási mód beállítása/frissítése | ✔️ | ✔️ | ✔️ (Csak távoli) |
| - Távoli videóstream renderelése | ✔️ | ✔️ | ✔️ |
| Kitárcsázás PSTN-résztvevőknek az ügyféloldalról | |||
| - Kitárcsázás PSTN-résztvevőknek a Virtuális szobák hívásaiból | ✔️ | ❌ | ❌ |
* Csak a webes hívó SDK-n érhető el. Nem érhető el iOS- és Android-hívó SDK-k esetén
** Jelenleg nyilvános előzetes verzióban érhető el.
Eseménykezelés
Az Event Griden keresztül közzétett hang- és videohívási eseményeket a rendszer a szobahívási információkkal együtt jegyzeteli.
- A CallStarted a szobahívás indításakor jelenik meg.
- A CallEnded akkor jelenik meg, amikor egy szobahívás véget ér.
- A CallParticipantAdded akkor jelenik meg, ha egy új résztvevő csatlakozik egy szobahíváshoz.
- A CallParticipantRemoved akkor jelenik meg, ha egy résztvevő leesik egy szobahívásból.
Elavult funkciók
A Rooms API egy korábbi nyilvános előzetes verziója az alábbiak szerint támogatott két konfigurációt a Szobák névsor-vezérléséhez:
- Csak meghívási szoba, amely csak a meghívott felhasználók számára engedélyezte, hogy csatlakozzanak a Szobák híváshoz.
- Egy nyitott szoba , ami kevésbé volt biztonságos. A nyitott szobák konfigurációjában az Összes Azure Communication Services-felhasználó anélkül tudott csatlakozni egy híváshoz, hogy kifejezetten meghívták volna őket a Helyiség névsoron keresztül.
A Nyitott szoba koncepció elavult. A továbbiakban a Csak meghívása szobák az egyetlen támogatott szobatípus.
Ismert korlátozások
- Az Azure Communication Services hívásautomatizálási képességei jelenleg nem támogatják a szobák hívását.
Következő lépések:
- A gyorsútmutatóval létrehozhat, kezelhet és csatlakozhat egy helyiséghez.
- Megtudhatja, hogyan csatlakozhat egy szobahíváshoz.
- Megtudhatja, hogyan kezelheti a szobahívásokat.
- Tekintse át a média és a jelzés hálózati követelményeit.
- Elemezze a Szobák adatait, lásd: Szobanaplók.
- További információ a Log Analytics-munkaterület használatáról: Log Analytics-oktatóanyag.
- Hozzon létre saját lekérdezéseket a Log Analyticsben, lásd: Első lépések lekérdezései.