Übersicht über Virtual Rooms
Virtual Rooms ermöglicht Entwicklern grundlegende Sicherheits- und Kontrollfunktionen, um gut strukturierte Kommunikationserfahrungen wie virtuelle Termine und Gruppenkommunikationen zu erstellen. Entwickler können virtuelle Räume verwenden, um Sprach-, Video- und PSTN-Anrufe durchzuführen. Sicherheit und Kontrollen in Räumen können folgendermaßen klassifiziert werden.
Sicherheit und Kontrollen für den Benutzerzugriff werden auf Anrufteilnehmer angewendet und steuern, wer an einem Anruf teilnehmen kann und welche Aktionen während des Anrufs ausgeführt werden können. Beispielsweise können während eines virtuellen Termins eines Patienten mit einem Arzt nur die autorisierten Krankenhausmitarbeiter und Patienten am Anruf teilnehmen. Das Einschränken der Teilnehmer sichert die Privatsphäre des Patienten, und die Teilnehmer übertreten nicht die ihnen zugewiesenen Rollen und Berechtigungen, um den laufenden Anruf zu unterbrechen.
Sicherheit und Kontrollen auf Raumebene werden auf die Anrufebene angewendet, um zu steuern, wann der Anruf durchgeführt werden kann und welche Funktionen während des Anrufs verfügbar sind. Beispielsweise sind Kursteilnehmer nur während der zugewiesenen Zeit berechtigt, an einem im Kursraum stattfindenden Anruf teilzunehmen. Außerdem könnte ein PSTN-Anrufer diesem Anruf nicht beitreten.
Allgemeine Funktionen, die von Virtual Rooms unterstützt werden
| Funktion | Unterstützt in Rooms-Anrufen |
|---|---|
| Sprache (VoIP) | ✔️ |
| Video | ✔️ |
| Vom Client initiierte ausgehende Anrufe an eine PSTN-Nummer | ✔️ |
| Vom Server initiierte ausgehende Anrufe an eine PSTN-Nummer** | ✔️ |
| Serverseitige Anrufverwaltung (Anrufautomatisierung)* | ✔️ |
| PSTN-Einwahl | ❌ |
| Asynchrones Messaging (Chat) | ❌ |
| Interoperabilität mit Microsoft Teams | ❌ |
* Es gelten einige Ausnahmen. Die vollständige Liste der unterstützten Funktionen zur Anrufautomatisierung sind in diesem Dokument aufgeführt.
** Zurzeit als Public Preview verfügbar.
Wann sollte Virtual Rooms verwendet werden?
Die folgende Tabelle gibt Ihnen einen Überblick, wann Virtual Rooms zum Einsatz kommen sollte.
| Bedingung | Räume verwenden |
|---|---|
| Wann es wichtig ist, zu steuern, wer an einem Anruf teilnehmen darf (Erfahrung nur für Eingeladene). | ✔️ |
| Wann es wichtig ist, zu steuern, wann der Anruf gestartet und beendet wird. | ✔️ |
| Wann Benutzerrollen und Berechtigungen erforderlich sind, um eine gut verwaltete Kommunikation durchzuführen. | ✔️ |
| Wenn für die Lösung Teams-Interoperabilität erforderlich ist.* | ❌ |
* Wenn die Lösung Interoperabilität zwischen Teams und Azure Communication Services erfordert, verwenden Sie Teams-Interoperabilitätsanrufe
So führen Sie Anrufe in Virtual Rooms durch
Allgemein gesprochen müssen Sie zum Durchführen von Anrufen in Virtual Rooms Räume erstellen und verwalten. Die folgende Tabelle beschreibt, wie Teilnehmer an einem Anruf teilnehmen und durch das Calling SDK client- und serverseitig In-Call-Vorgänge ausführen können.
| Funktion | ACS SDK | Client vs. Server SDK | Beschreibung |
|---|---|---|---|
| Erstellen und Verwalten von Virtual Rooms | Virtual Rooms SDK | Server | Mit dem Virtual Rooms SDK können Entwickler virtuelle Räume erstellen und verwalten, Benutzer hinzufügen und entfernen, Benutzerrollen zuweisen und aktualisieren sowie Zeitpläne für virtuelle Räume festlegen und aktualisieren. Entwickler können auch Sicherheitseinschränkungen festlegen, z. B. ausgehende PSTN-Telefonate aus Rooms einschränken. |
| Teilnehmen an einem Anruf in Virtual Rooms via Sprache, Video oder PSTN und Ausführen der vom Client initiierten In-Call-Vorgänge | Calling SDK | Client | Mithilfe des Client Calling SDKs können Benutzer einem Virtual Rooms-Aufruf beitreten und clientseitig Vorgänge im Rahmen der ihnen zugewiesenen Benutzerrollen ausführen. Die Sicherheit bei einem Virtual Rooms-Anruf wird durch das Erzwingen von Listen, Terminplänen, Benutzerrollen und Kontrolleinschränkungen sichergestellt, die im Rahmen des Erstellens und Verwaltens von Virtual Rooms festgelegt werden. Mithilfe des Client Calling SDKs ermöglichen Entwickler Anrufteilnehmern das Ausführen von In-Call-Vorgängen wie Stummschalten/Aufheben der Stummschaltung, Freigeben des Bildschirms, Aktivieren/Deaktivieren der Videoübertragung, ausgehende Anrufe an einen PSTN-Teilnehmer usw. |
| Serverseitige Verwaltung von In-Call-Vorgängen | Call Automation SDK | Server | Das Call Automation SDK ermöglicht Entwicklern das serverseitige Ausführen von In-Call-Vorgängen. In-Call-Vorgänge umfassen serverinitiierte ausgehende Anrufe an eine PSTN-Nummer, Anrufaufzeichnung, Senden/Empfangen von DTMF, Senden von Ankündigungen an bestimmte Benutzer usw. Da die Ausführung serverseitiger In-Call-Vorgänge unabhängig von den Benutzern ist und von Entwicklern gesteuert wird, werden diese Aktionen nicht durch Benutzerrollen gesteuert. |
Entwickler verwenden das Virtual Rooms SDK, das Calling Client SDK und das Call Automation SDK, um ihre Anrufe abzusichern und client- und serverseitige In-Call-Vorgänge auszulösen.
| Funktion | Rooms Server SDK | Calling Client SDK | Call Automation Server SDK |
|---|---|---|---|
| Verwaltung von Virtual Rooms: Erstellen/Abrufen/Aktualisieren/Auflisten/Löschen virtueller Räume | ✔️ | ❌ | ❌ |
| Verwaltung von Virtual Rooms-Listen: Hinzufügen/Aktualisieren/Entfernen eines Benutzers aus einem virtuellen Raum | ✔️ | ❌ | ❌ |
| Verwaltung von Berechtigungen für Virtual Rooms-Anrufteilnehmer: Zuweisen/Aktualisieren von Benutzerrollen | ✔️ | ❌ | ❌ |
| Zeitplanverwaltung in Virtual Rooms: Festlegen/Aktualisieren des für Virtual Rooms zulässigen Zeitplans | ✔️ | ❌ | ❌ |
| Verwaltung von Sicherheitskontrollen in Virtual Rooms: Festlegen/Aktualisieren von Flags, um ausgehende PSTN-Telefonate aus bestimmten virtuellen Räumen zuzulassen | ✔️ | ❌ | ❌ |
| Abrufen der Liste der in einen virtuellen Raum eingeladenen Benutzer | ✔️ | ❌ | ❌ |
| Ein Benutzer initiiert einen Virtual Rooms-Anruf oder tritt einem laufenden Anruf bei | ❌ | ✔️ | ❌ |
| Ausgehendes Telefonat an einen PSTN-Benutzer | ❌ | ✔️ | ✔️* |
| Hinzufügen/Entfernen von VoIP-Teilnehmern während eines laufenden Anrufs | ❌ | ✔️ | ✔️* |
| Liste der Teilnehmer abrufen, die dem laufenden Anruf beigetreten sind | ❌ | ✔️ | ✔️* |
| Starten/Beenden von Anrufuntertiteln und Ändern der Untertitelsprache | ❌ | ✔️ | ❌ |
| Verwalten der Anrufaufzeichnung | ❌ | ❌ | ✔️ |
| Senden/Empfangen von DTMF an/von PSTN-Teilnehmern | ❌ | ❌ | ✔️* |
| Wiedergeben von Audioaufforderungen für Teilnehmer | ❌ | ❌ | ✔️* |
Das Calling Client SDK- bietet eine vollständige Liste der clientseitigen In-Call-Vorgänge und erläutert ihre Verwendung.
*Zurzeit als Public Preview verfügbar.
Serverseitiges Verwalten von Virtual Rooms-Anrufen mithilfe der Call Automation Server SDK
Mithilfe des Call Automation SDKs können Entwickler Virtual Rooms-Aufrufe serverseitig verwalten und In-Call-Vorgänge ausführen. Funktionen zur Anrufautomatisierung werden in Virtual Rooms-Anrufen schrittweise aktiviert. Die folgende Tabelle zeigt den aktuellen Status dieser Funktionen. Entwickler verwalten und steuern Funktionen zur Anrufautomatisierung serverseitig. Sie arbeiten auf höherer Ebene als die Berechtigungen eines Anrufteilnehmers. Die Funktionen zur Anrufautomatisierung werden also nicht über Benutzerrollen und -berechtigungen gesteuert.
| Funktion zur Anrufautomatisierung | Unterstützt in Rooms-Anrufen |
|---|---|
| Ausgehendes Telefonat an PSTN-Teilnehmer * | ✔️ |
| Senden/Lesen von DTMF an/von PSTN-Teilnehmer | ✔️ |
| Senden von Ankündigungen an bestimmte Anrufteilnehmer * | ✔️ |
| Hinzufügen/Entfernen eines VoIP-Teilnehmers während eines laufenden Anrufs | ✔️ |
| Anruf für alle Benutzer beenden | ✔️ |
| Anruftranskriptionen | ❌ |
| Audiomedienstreaming | ❌ |
*Zurzeit als Public Preview verfügbar.
Diese Abbildung zeigt die Konzepte zum Verwalten von und zum Beitreten zu Räumen.
Serverseitig initiiertes ausgehendes PSTN-Telefonat mithilfe des Call Automation Server SDKs
Entwickler können die Möglichkeit eines ausgehenden Telefonats an einen PSTN-Teilnehmer aktivieren/deaktivieren, indem sie das raumspezifische Flag „pstnDialoutEnabled“ festlegen. Nachdem der Entwickler „pstnDialoutEnabled=TRUE“ für einen Raum festgelegt hat, können Entwickler mithilfe der Anrufautomatisierung serverseitig ein ausgehendes Telefonat mit einem PSTN-Teilnehmer tätigen, ohne dass clientseitige Aktionen erforderlich sind.
Ein Patient kann beispielsweise einen Übersetzungsdienst für seinen bevorstehenden virtuellen Arzttermin anfordern. In den meisten Fällen wird die Telefonnummer für den Übersetzungsdienst über einen Back-End-Prozess dynamisch bestimmt. Mithilfe dieser serverseitigen Funktion für ausgehende PSTN-Telefonate können Entwickler die Zieltelefonnummer ermitteln, den Anruf initiieren und sie zum virtuellen Termin des Patienten hinzufügen, ohne dass clientseitig Aktionen erforderlich sind.
Führen Sie die folgenden Schritte aus, um mithilfe des Call Automation SDKs eine PSTN-Nummer zu einem Raumanruf hinzuzufügen:
- Erstellen eines Raums, wobei das „pstnDialoutEnabled-Flag auf
Truefestgelegt ist - Teilnehmer starten einen Raumanruf
- Verwenden des Call Automation SDKs zum Herstellen einer Verbindung mit einem Raumanruf mithilfe einer Chatroom-ID
- Verwenden des Call Automation SDKs, um eine PSTN-Nummer anzurufen
- Der PSTN-Benutzer akzeptiert und nimmt an einem Raumanruf teil
Verwalten von Virtual Rooms-Anrufen mithilfe clientseitiger Calling SDKs
Verwenden Sie die Calling SDKs, um dem Raumanruf beizutreten. Für den Beitritt zu Raumanrufen können die Calling SDKs für Web, iOS oder Android verwendet werden. Schnellstartbeispiele für den Beitritt zu Raumanrufen finden Sie hier.
Auf Räume kann auch über die Azure Communication Services UI Library zugegriffen werden. Mithilfe der UI-Bibliothek können Entwickler mit nur wenigen Codezeilen einen Rooms-fähigen Anrufclient zu ihrer Anwendung hinzufügen.
Clientseitig initiiertes ausgehendes PSTN-Telefonat mithilfe der Calling Client SDK
Entwickler können die Möglichkeit eines ausgehenden Telefonats an einen PSTN-Teilnehmer zulassen/nicht zulassen, indem sie das raumspezifische Flag „pstnDialoutEnabled“ festlegen. Nachdem der Entwickler „pstnDialoutEnabled=TRUE“ für einen Raum festgelegt hat, können Anrufteilnehmer mit der Rolle „Referent“ einen PSTN-Teilnehmer von ihrem Anrufclient aus anrufen. Die folgenden Schritte werden zum Hinzufügen einer PSTN-Nummer zu einem Raumanruf mithilfe des Calling Client SDKs verwendet.
- Erstellen eines Raums, wobei das „pstnDialoutEnabled-Flag auf „True“ festgelegt ist
- Teilnehmer starten einen Raumanruf
- Ein Teilnehmer mit der Rolle „Referent“ fügt eine PSTN-Nummer zu einem hinzu
- Der PSTN-Benutzer akzeptiert und nimmt an einem Raumanruf teil
API/SDKs für Virtual Rooms
Räume werden über Rooms-APIs oder SDKs erstellt und verwaltet. Verwenden Sie die Rooms-API oder das Rooms SDK in Ihrer Serveranwendung für Vorgänge vom Typ room:
- Erstellen
- Ändern
- Löschen
- Festlegen und Aktualisieren der Teilnehmerliste
- Festlegen und Ändern der Raumgültigkeit
- Zuweisen von Rollen und Berechtigungen zu Benutzern
| Virtual Rooms SDK | Version | Zustand |
|---|---|---|
| SDKs für Virtual Rooms | 15.04.2024 | Allgemein verfügbar – Vollständig unterstützt |
| SDKs für Virtual Rooms | 14.06.2023 | Allgemein verfügbar – Vollständig unterstützt |
| SDKs für Virtual Rooms | 30.10.2023 | Öffentliche Vorschau – Vollständig unterstützt |
| SDKs für Virtual Rooms | 31.03.2023 | Public Preview – eingestellt |
| SDKs für Virtual Rooms | 01.02.2022 | Public Preview – eingestellt |
| SDKs für Virtual Rooms | 07.04.2021 | Public Preview – eingestellt |
Vordefinierte Teilnehmerrollen und -berechtigungen in Virtual Rooms-Anrufen
Raumteilnehmern kann eine der folgenden Rollen zugewiesen werden: Referent, Teilnehmer und Consumer.
Die folgende Tabelle enthält detaillierte Funktionen, die den Rollen zugeordnet sind. Ganz allgemein hat die Rolle Referent die uneingeschränkte Kontrolle. Für Teilnehmer sind die Funktionen auf Audio und Video beschränkt, und Consumer können nur Audio, Video und Bildschirmfreigabe empfangen.
| Funktion | Rolle: Referent | Rolle: Teilnehmer | Rolle: Consumer |
|---|---|---|---|
| Steuerungsmöglichkeiten während eines Anrufs | |||
| - Aktivieren/Deaktivieren des Videos | ✔️ | ✔️ | ❌ |
| - Stummschalten des Mikrofons/Aufheben der Stummschaltung | ✔️ | ✔️ | ❌ |
| – Remotebenutzer stummschalten | ✔️ | ❌ | ❌ |
| - Wechseln zwischen Kameras | ✔️ | ✔️ | ❌ |
| - Aktiver Lautsprecher | ✔️ | ✔️ | ✔️ |
| - Auswählen des Lautsprechers für Anrufe | ✔️ | ✔️ | ✔️ |
| - Auswählen des Mikrofons für Anrufe | ✔️ | ✔️ | ❌ |
| - Anzeigen des Status der Teilnehmer („Beschäftigt“, „Verbindung wird hergestellt“, „Verbunden“, „Gehalten“, „Trennung“, „Getrennt“ usw.) | ✔️ | ✔️ | ✔️ |
| - Anzeigen des Anrufstatus („Early Media“, „Eingehend“, „Verbindung wird hergestellt“, „Klingeln“, „Verbunden“, „Halten“, „Trennung“, „Getrennt“) | ✔️ | ✔️ | ✔️ |
| - Anzeigen, ob ein Teilnehmer stummgeschaltet ist | ✔️ | ✔️ | ✔️ |
| - Anzeigen des Grunds, warum ein Teilnehmer einen Anruf verlassen hat | ✔️ | ✔️ | ✔️ |
| - Anrufuntertitel starten | ✔️ | ✔️ | ✔️ |
| - Untertitelsprache ändern | ✔️ | ✔️ | ❌ |
| – Besprechung für alle Teilnehmer beenden | ✔️ | ❌ | ❌ |
| – Einem Virtual Rooms-Teilnehmer einladen, einem Anruf beizutreten | ✔️ | ❌ | ❌ |
| Bildschirmfreigabe | |||
| - Freigeben des Bildschirms | ✔️ * | ❌ | ❌ |
| - Freigeben einer Anwendung | ✔️ * | ❌ | ❌ |
| - Freigeben eines Browser-Tabs | ✔️ * | ❌ | ❌ |
| - Teilnehmer können freigegebenen Bildschirm anzeigen | ✔️ | ✔️ | ✔️ |
| Listenverwaltung | |||
| - Entfernen eines Teilnehmers | ✔️ | ❌ | ❌ |
| Geräteverwaltung | |||
| - Anfordern der Berechtigung zur Nutzung von Audio und/oder Video | ✔️ | ✔️ | ❌ |
| - Abrufen der Kameraliste | ✔️ | ✔️ | ❌ |
| - Festlegen der Kamera | ✔️ | ✔️ | ❌ |
| - Abrufen der ausgewählten Kamera | ✔️ | ✔️ | ❌ |
| - Abrufen der Mikrofonliste | ✔️ * | ✔️ * | ❌ |
| - Festlegen des Mikrofons | ✔️ * | ✔️ * | ❌ |
| - Abrufen des ausgewählten Mikrofons | ✔️ * | ✔️ * | ❌ |
| - Abrufen der Lautsprecherliste | ✔️ * | ✔️ * | ✔️ * |
| - Festlegen des Lautsprechers | ✔️ * | ✔️ * | ✔️ * |
| - Abrufen des ausgewählten Lautsprechers | ✔️ | ✔️ | ✔️ |
| Videorendering | |||
| - Rendern eines Videos an mehreren Orten (lokale Kamera oder Remotestream) | ✔️ | ✔️ | ✔️ (Nur remote) |
| - Festlegen/Aktualisieren des Videoskalierungsmodus | ✔️ | ✔️ | ✔️ (Nur remote) |
| - Rendern des Remotevideostreams | ✔️ | ✔️ | ✔️ |
| Clientseitiges ausgehendes Telefonat mit einem PSTN-Teilnehmer | |||
| – Ausgehendes Telefonat mit einem PSTN-Teilnehmer aus Virtual Rooms-Anrufen | ✔️ | ❌ | ❌ |
* Nur im Web Calling SDK verfügbar. Für iOS Calling SDK und Android Calling SDK nicht verfügbar.
** Zurzeit als Public Preview verfügbar.
Ereignisbehandlung
Ereignisse für Sprach- und Videoanrufe, die über Event Grid veröffentlicht werden, werden mit Raumanrufinformationen versehen.
- CallStarted wird veröffentlicht, wenn ein Raumanruf gestartet wird.
- CallEnded wird veröffentlicht, wenn ein Raumanruf beendet wird.
- CallParticipantAdded wird veröffentlicht, wenn ein neuer Teilnehmer einem Raumanruf beitritt.
- CallParticipantRemoved wird veröffentlicht, wenn ein Teilnehmer einen Raumanruf verlässt.
Als veraltet markierte Funktionen
Eine frühere öffentliche Vorschauversion der Rooms-API unterstützte zwei Konfigurationen für die Listensteuerung für Rooms wie folgt:
- Ein Nur mit Einladung-Raum, in dem nur eingeladene Benutzer an Raumanrufen teilnehmen können.
- Ein Offener Room, der weniger sicher war. In der Konfiguration offener Räume konnten alle Azure Communication Services-Benutzer an einem Anruf teilnehmen, ohne explizit über die Raumliste eingeladen zu werden.
Das Konzept Offener Raum ist jetzt veraltet. In Zukunft werden Nur mit Einladung-Räume der einzige unterstützte Raumtyp sein.
Bekannte Einschränkungen
- Die Anrufautomatisierungsfunktionen von Azure Communication Services unterstützen derzeit keine Raumanrufe.
Nächste Schritte:
- Verwenden Sie den Schnellstart, um einen Raum zu erstellen, zu verwalten und ihm beizutreten.
- Schnellstart: Teilnehmen an einem Raumanruf
- Erfahren Sie, wie Sie einen Room-Anruf verwalten.
- Netzwerkempfehlungen für Medien und Signale
- Analysieren Sie Ihre Rooms-Daten, siehe: Roomsprotokolle.
- Informationen zur Verwendung des Log Analytics-Arbeitsbereichs finden Sie unter Log Analytics-Tutorial.
- Informationen zum Erstellen eigener Abfragen in Log Analytics finden Sie unter: Erste Schritte mit Abfragen.