Übersicht über Rooms
Für Entwickler, die strukturierte Unterhaltungen wie virtuelle Termine oder virtuelle Ereignisse erstellen, bietet Azure Communication Services das Konzept eines Raums (Room). Räume ermöglichen derzeit die Verwendung von Sprach- und Videoanrufen.
Im Anschluss sind die wichtigsten Anwendungsszenarien für Räume aufgeführt:
- Räume ermöglichen eine geplante Kommunikation. Rooms helfen Dienstplattformen dabei, eine Kommunikationserfahrung wie in einem Meeting zu bieten und sind dennoch generisch genug, um sich für eine Vielzahl von Branchenanwendungen zu eignen. Dienste können Räume für Patienten, die medizinischen Rat benötigen, für Finanzplaner, die mit Kunden arbeiten, oder für Rechtsanwälte, die Rechtsberatung anbieten, planen und verwalten.
- Räume ermöglichen die Verwendung einer rein einladungsbasierten Umgebung. Mit Räumen können Ihre Dienste steuern, welche Benutzer dem Raum für einen virtuellen Termin mit Ärzten oder Finanzberatern beitreten können. Dadurch kann nur eine Teilmenge von Benutzern mit zugewiesenen Kommunikationsdienstidentitäten einem Roomanruf beitreten.
- Räume ermöglichen eine strukturierte Kommunikation über Rollen und Berechtigungen. Durch die Möglichkeit, Benutzern vordefinierte Rollen zuzuweisen, bieten Räume Entwicklern mehr Kontrolle und Struktur bei der Kommunikation. So kann in einer großen Besprechung oder in einer virtuellen Konferenz sichergestellt werden, dass nur Referenten sprechen und Inhalte teilen können.
- Fügen Sie PSTN-Teilnehmer hinzu. Laden Sie Teilnehmer des öffentlichen Telefonfestnetzes zu einem Anruf mit einer Nummer ein, die über Ihr Abonnement erworben wurde, oder über Azure Direct Routing an Ihren Session Border Controller (SBC).
Geeignete Anwendungsfälle für Räume
Verwenden Sie Räume, wenn Sie eine der folgenden Funktionen benötigen:
- Steuern, welche Benutzer Raumanrufen beitreten können
- Zeitplanung bzw. Koordinaten, die aktiviert sind und zu einem bestimmten Zeitpunkt (Datum und Uhrzeit) ablaufen
- Strukturierte Kommunikation über Rollen und Berechtigungen für Benutzer
| Funktion | 1-zu-Viele-Anruf | 1-zu-Viele-Anruf mit kurzlebiger ID |
Raumanruf |
|---|---|---|---|
| Interaktive Teilnehmer | 350 | 350 | 350 |
| Kurzlebige ID zur Verteilung an Teilnehmer | ❌ | ✔️ (Gruppen-ID) |
✔️ (Raum-ID) |
| Teilnahme nur für eingeladene Personen | ❌ | ❌ | ✔️ |
| Möglichkeit zum Auswählen an Telefonfestnetz-Benutzer | ✔️ | ✔️ | ✔️ |
| Anrufuntertitel | ✔️ private Preview |
✔️ private Preview |
✔️ private Preview |
| Anrufaufzeichnung | ✔️ | ✔️ | ✔️ öffentliche Preview |
| Anrufteilnahme aller Benutzer in der Kommunikationsdienstressource | ❌ | ✔️ | ✔️ |
| Festlegen der Gültigkeitsdauer für einen Anruf | ❌ | ❌ | ✔️ Bis sechs Monate |
| Festlegen von Benutzerrollen und Berechtigungen für einen Anruf | ❌ | ❌ | ✔️ |
| API zum Erstellen, Entfernen, Aktualisieren und Löschen des Aufrufs | ❌ | ❌ | ✔️ Rooms-API |
Verwaltung von Räumen und Teilnahme an Raumanrufen
Die Rooms-API (bzw. das SDK) wird für Aktionen wie das Erstellen eines Raums, das Hinzufügen von Teilnehmern und das Einrichten des Zeitplans verwendet. Das Calling SDK wird zum clientseitigen Initiieren des Anrufs innerhalb eines Raums verwendet. Die meisten Aktionen, die in regulären 1:1- oder Gruppenanrufen in Calling SDKs verfügbar sind, sind auch in Raumanrufen verfügbar. Eine vollständige Liste der Funktionen, die im Calling SDK zur Verfügung stehen, finden Sie in der Übersicht über Calling SDK.
| Funktion | Calling SDK | Rooms-API/SDK |
|---|---|---|
| Beitreten zu einem Raumanruf mit Sprache und Video | ✔️ | ❌ |
| Auflisten der Teilnehmer, die dem Raumanruf beigetreten sind | ✔️ | ❌ |
| Zulassen/Verbieten der ausgehenden Anrufe für einen Telefonfestnetz-Benutzer auf virtueller Räume-Ebene | ❌ | ✔️ |
| Erstellen eines Raums | ❌ | ✔️ |
| Auflisten aller eingeladenen Teilnehmer für den Raum | ❌ | ✔️ |
| Starten, Anhalten, Beenden der Anrufaufzeichnung | ✔️ | ❌ |
| Hinzufügen oder Entfernen eines VoIP-Teilnehmers | ❌ | ✔️ |
| Zuweisen von Rollen zu Raumteilnehmern | ❌ | ✔️ |
In der folgenden Abbildung wird das Konzept der Verwaltung und des Beitretens zu den Räumen veranschaulicht.
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. Details finden Sie im Folgenden.
| 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 | 30.10.2023 | Öffentliche Vorschau – Vollständig unterstützt |
| SDKs für Virtual Rooms | 14.06.2023 | Allgemein verfügbar – Vollständig unterstützt |
| SDKs für Virtual Rooms | 31.03.2023 | Wird am 30. April 2024 eingestellt |
| SDKs für Virtual Rooms | 01.02.2022 | Wird am 30. April 2024 eingestellt |
| SDKs für Virtual Rooms | 07.04.2021 | Wird am 30. April 2024 eingestellt |
Calling SDKs
Verwenden Sie die Calling SDKs, um dem Raumanruf beizutreten. Für den Beitritt zu Raumanrufen kann das Calling SDK 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. Mit der UI-Bibliothek können Entwickler einen Raum-fähigen Anrufclient mit nur wenigen Codezeilen ihrer Anwendung hinzufügen.
Vordefinierte Teilnehmerrollen und Berechtigungen
Raumteilnehmern kann eine der folgenden Rollen zugewiesen werden: Referent, Teilnehmer und Consumer. Standardmäßig wird einem Benutzer die Rolle Teilnehmer zugewiesen, wenn ihm keine andere Rolle zugewiesen ist.
Die folgenden Tabellen enthalten 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 | ✔️ | ✔️ | ✔️ |
| 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 | ✔️ | ✔️ | ✔️ |
| Hinzufügen von PSTN-Teilnehmern | |||
| – Call-Teilnehmer über Telefonanrufe | ✔️ | ❌ | ❌ |
* Nur im Web Calling SDK verfügbar. Für iOS Calling SDK und Android Calling SDK nicht 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
Die frühere öffentliche Vorschauversion der Rooms-API unterstützte zwei Konfigurationen für die Listensteuerung für Rooms wie folgt:
- Ein „Nur auf Einladung“-Raum, in dem nur eingeladene Benutzer dem Room beitreten können.
- Ein „Offener Raum“, der weniger sicher ist. 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 „Nur auf Einladung“-Räume der einzige unterstützte Raumtyp sein.
Bekannte Einschränkungen
- Die Anrufautomatisierungsfunktionen von Azure Communication Services unterstützen derzeit keinen Roomsanruf.
Nächste Schritte:
- Schnellstart: Erstellen und Verwalten einer Raumressource
- Schnellstart: Teilnehmen an einem Raumanruf
- 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.