Overzicht van ruimten
Azure Communication Services biedt een concept van een ruimte voor ontwikkelaars die gestructureerde gesprekken bouwen, zoals virtuele afspraken of virtuele gebeurtenissen. Ruimten staan momenteel spraak- en videogesprekken toe.
Hier volgen de belangrijkste scenario's waarin ruimten nuttig zijn:
- Ruimten maken geplande communicatie mogelijk. Ruimten helpen serviceplatformen om vergaderachtige ervaringen te bieden terwijl ze nog steeds geschikt zijn voor een breed scala aan branchetoepassingen. Services kunnen ruimten plannen en beheren voor patiënten die medisch advies zoeken, financiële planners die met klanten werken en advocaten die juridische diensten verlenen.
- Ruimten maken een ervaring met alleen uitnodigen mogelijk. Met ruimten kunnen uw services bepalen welke gebruikers kunnen deelnemen aan de ruimte voor een virtuele afspraak met artsen of financiële consultants. Hierdoor kan alleen een subset van gebruikers met toegewezen Communication Services-identiteiten deelnemen aan een chatgesprek.
- Ruimten maken gestructureerde communicatie mogelijk via rollen en machtigingen. Met ruimten kunnen ontwikkelaars vooraf gedefinieerde rollen toewijzen aan gebruikers om een hogere mate van controle en structuur in communicatie uit te oefenen. Zorg ervoor dat alleen presentatoren inhoud kunnen spreken en delen in een grote vergadering of in een virtuele vergadering.
- Voeg PSTN-deelnemers toe. Nodig deelnemers aan het PSTN (Public Switched Telephone Network) uit voor een gesprek met behulp van een nummer dat is gekocht via uw abonnement of via directe routering van Azure naar uw Session Border Controller (SBC).
Wanneer gebruikt u ruimten?
Gebruik ruimten wanneer u een van de volgende mogelijkheden nodig hebt:
- Bepalen welke gebruikers kunnen deelnemen aan ruimtegesprekken.
- Planning/coördinaten nodig die zijn ingeschakeld en verlopen op een opgegeven tijdstip en datum.
- Behoefte aan gestructureerde communicatie via rollen en machtigingen voor gebruikers.
| Mogelijkheid | 1:N Oproep | 1:N Oproep met tijdelijke id |
Kamergesprek |
|---|---|---|---|
| Interactieve deelnemers | 350 | 350 | 350 |
| Tijdelijke id om te distribueren naar deelnemers | ❌ | ✔️ (Groeps-id) |
✔️ (Kamer-id) |
| Alleen genodigde deelname | ❌ | ❌ | ✔️ |
| Mogelijkheid om uitbellen naar PSTN-gebruiker | ✔️ | ✔️ | ✔️ |
| Onderschrift s bellen | ✔️ privévoorbeeld |
✔️ privévoorbeeld |
✔️ privévoorbeeld |
| Oproepen opnemen | ✔️ | ✔️ | ✔️ openbare preview |
| Alle gebruikers in de communicatieserviceresource om deel te nemen aan een gesprek | ❌ | ✔️ | ✔️ |
| Geldigheidsperiode instellen voor een oproep | ❌ | ❌ | ✔️ Maximaal zes maanden |
| Gebruikersrollen en -machtigingen instellen voor een aanroep | ❌ | ❌ | ✔️ |
| API voor het maken, verwijderen, bijwerken, verwijderen van de aanroep | ❌ | ❌ | ✔️ Ruimten-API |
Ruimten beheren en deelnemen aan kamergesprekken
Rooms-API/SDK wordt gebruikt om acties uit te voeren, zoals het maken van een ruimte, het toevoegen van deelnemers en het instellen van een planning, enzovoort. Aanroepende SDK wordt gebruikt om de aanroep vanuit de clientzijde te starten. De meeste acties die beschikbaar zijn in een een-op-een- of groepsoproepen in bel-SDK's , zijn ook beschikbaar in kamergesprekken. De volledige lijst met mogelijkheden die in de Calling SDK worden aangeboden, wordt vermeld in het overzicht van de Calling SDK.
| Mogelijkheid | SDK aanroepen | Ruimten-API/SDK |
|---|---|---|
| Deelnemen aan een ruimtegesprek met spraak en video | ✔️ | ❌ |
| Deelnemers vermelden die deelnemen aan de oproep in de ruimten | ✔️ | ❌ |
| Uitbellen toestaan/weigeren aan een PSTN-gebruiker op het niveau van virtuele ruimten | ❌ | ✔️ |
| Ruimte maken | ❌ | ✔️ |
| Alle deelnemers weergeven die zijn uitgenodigd voor de ruimte | ❌ | ✔️ |
| Opname van gesprekken starten, onderbreken, stoppen | ✔️ | ❌ |
| Een VoIP-deelnemer toevoegen of verwijderen | ❌ | ✔️ |
| Rollen toewijzen aan deelnemers aan de ruimte | ❌ | ✔️ |
In de onderstaande afbeelding ziet u het concept van het beheren en deelnemen aan de ruimten.
API/SDK's voor virtuele ruimten
Ruimten worden gemaakt en beheerd via api's of SDK's van ruimten. Gebruik de rooms-API/SDK's in uw servertoepassing voor room bewerkingen:
- Maken
- Wijzigen
- Delete
- De lijst met deelnemers instellen en bijwerken
- De geldigheid van de ruimte instellen en wijzigen
- Rollen en machtigingen toewijzen aan gebruikers. Hieronder vindt u meer informatie.
| Virtual Rooms SDK | Versie | Provincie |
|---|---|---|
| SDK's voor virtuele ruimten | 2024-04-15 | Algemeen beschikbaar - volledig ondersteund |
| SDK's voor virtuele ruimten | 2023-10-30 | Openbare preview - volledig ondersteund |
| SDK's voor virtuele ruimten | 2023-06-14 | Algemeen beschikbaar - volledig ondersteund |
| SDK's voor virtuele ruimten | 2023-03-31 | Wordt buiten gebruik gesteld op 30 april 2024 |
| SDK's voor virtuele ruimten | 2022-02-01 | Wordt buiten gebruik gesteld op 30 april 2024 |
| SDK's voor virtuele ruimten | 2021-04-07 | Wordt buiten gebruik gesteld op 30 april 2024 |
Aanroepen van SDK's
Gebruik de bel-SDK's om deel te nemen aan de chatgesprek. Ruimtegesprekken kunnen worden toegevoegd met behulp van de web-, iOS- of Android-bel-SDK's. Hier vindt u voorbeelden van quickstarts voor het deelnemen aan kamergesprekken.
Ruimten zijn ook toegankelijk met behulp van de Ui-bibliotheek van Azure Communication Services. Met de UI-bibliotheek kunnen ontwikkelaars een aanroepclient toevoegen die is ingeschakeld in hun toepassing met slechts een paar regels code.
Vooraf gedefinieerde rol en machtigingen van deelnemers
Deelnemers aan de vergaderruimte kunnen een van de volgende rollen krijgen: presentator, deelnemer en consument. Standaard krijgt een gebruiker een rol Deelnemer toegewezen als er geen andere rol is toegewezen.
De onderstaande tabellen bieden gedetailleerde mogelijkheden die zijn toegewezen aan de rollen. Op hoog niveau heeft de rol presentator volledige controle, de mogelijkheden van deelnemers zijn beperkt tot audio en video, terwijl consumenten alleen audio, video en scherm delen kunnen ontvangen.
| Mogelijkheid | Rol: Presentator | Rol: Deelnemer | Rol: Consument |
|---|---|---|---|
| Besturingselementen voor middengesprekken | |||
| - Video in-/uitschakelen | ✔️ | ✔️ | ❌ |
| - Microfoon dempen/dempen opheffen | ✔️ | ✔️ | ❌ |
| - Externe gebruiker dempen | ✔️ | ❌ | ❌ |
| - Schakelen tussen camera's | ✔️ | ✔️ | ❌ |
| - Actieve luidspreker | ✔️ | ✔️ | ✔️ |
| - Kies spreker voor oproepen | ✔️ | ✔️ | ✔️ |
| - Microfoon kiezen voor oproepen | ✔️ | ✔️ | ❌ |
| - Deelnemersstatus weergeven (niet-actief, verbinding maken, verbonden, in bewaring, verbreken, verbroken, enzovoort) | ✔️ | ✔️ | ✔️ |
| - Oproepstatus weergeven (vroege media, binnenkomend, Verbinding maken ing, bellen, Verbinding maken ed, wachtstand, verbreken, verbroken | ✔️ | ✔️ | ✔️ |
| - Weergeven of een deelnemer is gedempt | ✔️ | ✔️ | ✔️ |
| - De reden weergeven waarom een deelnemer een gesprek heeft verlaten | ✔️ | ✔️ | ✔️ |
| Scherm delen | |||
| - Scherm delen | ✔️ * | ❌ | ❌ |
| - Een toepassing delen | ✔️ * | ❌ | ❌ |
| - Een browsertabblad delen | ✔️ * | ❌ | ❌ |
| - Deelnemers kunnen gedeeld scherm bekijken | ✔️ | ✔️ | ✔️ |
| Roosterbeheer | |||
| - Een deelnemer verwijderen | ✔️ | ❌ | ❌ |
| Apparaatbeheer | |||
| - Vragen om toestemming voor het gebruik van audio en/of video | ✔️ | ✔️ | ❌ |
| - Cameralijst ophalen | ✔️ | ✔️ | ❌ |
| - Camera instellen | ✔️ | ✔️ | ❌ |
| - Geselecteerde camera ophalen | ✔️ | ✔️ | ❌ |
| - Microfoonlijst ophalen | ✔️ * | ✔️ * | ❌ |
| - Microfoon instellen | ✔️ * | ✔️ * | ❌ |
| - Geselecteerde microfoon ophalen | ✔️ * | ✔️ * | ❌ |
| - Lijst met sprekers ophalen | ✔️ * | ✔️ * | ✔️ * |
| - Luidspreker instellen | ✔️ * | ✔️ * | ✔️ * |
| - Geselecteerde spreker ophalen | ✔️ | ✔️ | ✔️ |
| Videorendering | |||
| - Een video weergeven op meerdere plaatsen (lokale camera of externe stream) | ✔️ | ✔️ | ✔️ (Alleen extern) |
| - Videoschaalmodus instellen/bijwerken | ✔️ | ✔️ | ✔️ (Alleen extern) |
| - Externe videostream weergeven | ✔️ | ✔️ | ✔️ |
| PSTN-deelnemers toevoegen | |||
| - Deelnemers bellen via telefoongesprekken | ✔️ | ❌ | ❌ |
* Alleen beschikbaar in de SDK voor webgesprekken. Niet beschikbaar op iOS- en Android-aanroepende SDK's
Gebeurtenisverwerking
Gebeurtenissen voor spraak- en videogesprekken die via Event Grid worden gepubliceerd, worden voorzien van informatie over ruimtegesprekken.
- CallStarted wordt gepubliceerd wanneer een chatgesprek wordt gestart.
- CallEnded wordt gepubliceerd wanneer een chatgesprek eindigt.
- CallParticipantAdded wordt gepubliceerd wanneer een nieuwe deelnemer deelneemt aan een ruimtegesprek.
- CallParticipantRemoved wordt gepubliceerd wanneer een deelnemer uit een ruimtegesprek valt.
Verouderde functies
Eerdere openbare preview-versie van de Rooms-API ondersteunde twee configuraties voor het besturingselement ruimtenrooster, als volgt:
- Een 'Alleen uitnodigen'-ruimte waarmee alleen uitgenodigde gebruikers kunnen deelnemen aan de chatruimte.
- Een "Open Ruimte" die minder veilig is. In de configuratie van open ruimten konden alle Gebruikers van Azure Communication Services deelnemen aan een oproep zonder expliciet te worden uitgenodigd via het ruimterooster.
Het concept 'Open Ruimte' is nu afgeschaft. In de toekomst is 'Alleen uitnodigen'-ruimten het enige ondersteunde ruimtetype.
Bekende beperkingen
- Call Automation-mogelijkheden van Azure Communication Services bieden momenteel geen ondersteuning voor het bellen van ruimten.
Volgende stappen:
- Gebruik de quickstart om een ruimte te maken, te beheren en eraan deel te nemen.
- Meer informatie over het deelnemen aan een chatgesprek.
- Controleer de netwerkvereisten voor media en signalering.
- Analyseer uw ruimtengegevens, zie: Logboeken van ruimten.
- Meer informatie over het gebruik van de Log Analytics-werkruimte, zie: Log Analytics-zelfstudie.
- Maak uw eigen query's in Log Analytics, zie: Aan de slag-query's.