You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/communication-services/concepts/rooms/room-concept.md
+40-38Lines changed: 40 additions & 38 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,17 +1,17 @@
1
1
---
2
-
title: Azure Communication Services Rooms overview
3
-
titleSuffix: An Azure Communication Services concept document
4
-
description: Learn about the Azure Communication Services Rooms.
2
+
title: Rooms API for structured meetings
3
+
titleSuffix: An Azure Communication Services article
4
+
description: This article describes Azure Communication Services Rooms API for structured meetings.
5
5
author: farrukhghaffar
6
6
manager: cassidyfein
7
7
services: azure-communication-services
8
8
9
9
ms.author: FAGHAFFA
10
-
ms.date: 07/10/2024
10
+
ms.date: 05/15/2025
11
11
ms.topic: conceptual
12
12
ms.service: azure-communication-services
13
13
---
14
-
# Virtual Rooms overview
14
+
# Rooms API for structured meetings
15
15
16
16
Virtual Rooms empower developers with essential security and control capabilities to build well-structured communication experiences such as virtual appointments and group communications. Developers can use virtual rooms to conduct voice, video, and PSTN calls. Security and controls in rooms can be classified as follows.
17
17
@@ -32,11 +32,11 @@ Virtual Rooms empower developers with essential security and control capabilitie
32
32
| Async Messaging (Chat) | ❌ |
33
33
| Interoperability with Microsoft Teams | ❌ |
34
34
35
-
\* Some exceptions apply. The full list of supported [Call Automation capabilities](#how-to-conduct-calls-in-virtual-rooms) are listed in this document.
35
+
\* Some exceptions apply. For the full list, see [Call Automation capabilities](#how-to-conduct-calls-in-virtual-rooms).
36
36
37
37
## When to use Virtual Rooms
38
38
39
-
Following table shows when to use Virtual Rooms.
39
+
The following table describes when to use Virtual Rooms.
40
40
41
41
| Condition | Use Rooms |
42
42
| ------ | ------ |
@@ -45,22 +45,22 @@ Following table shows when to use Virtual Rooms.
45
45
| When user roles and permissions are needed to conduct well-managed communications. | ✔️ |
46
46
| When solution requires Teams interoperability.*| ❌ |
47
47
48
-
\* If the solution requires interoperability between Teams and Azure Communication Services, use [Teams interoperability calls](../interop/teams-user-calling.md)
48
+
\* If the solution requires interoperability between Teams and Azure Communication Services, use [Teams interoperability calls](../interop/teams-user-calling.md).
49
49
50
50
## How to conduct calls in Virtual Rooms
51
51
52
52
At a high level, to conduct calls in a Virtual Rooms you need to create and manage rooms. The following table describes how to enable participants to join calls and execute in-call operations from the Calling SDK on client-side and server-side.
53
53
54
-
| Capability | ACS SDK | Client vs Server SDK | Description |
| Capability | ACS SDK | Client vs Server SDK | Description |
55
+
|---|---|---|---|
56
56
| Create and manage Virtual Rooms |[Virtual Rooms SDK](../../quickstarts/rooms/join-rooms-call.md)| Server | The Virtual Rooms SDK enables developers to create and manage Virtual Rooms, add/remove users, assign/update user roles, set/update Virtual Rooms schedules. Developers can also set security limits such as to restrict PSTN dial-out from Rooms.|
57
57
| Join a Virtual Rooms call with voice, video, or PSTN and execute the client-initiated in-call operations |[Calling SDK](../voice-video-calling/calling-sdk-features.md#detailed-capabilities)| Client | The Calling client SDK enables users to join a Virtual Rooms call and execute client-side operations as permitted by their assigned user roles. Security in a Virtual Rooms call is ensured through enforcement of roster, schedule, user roles, and control limits set through creation and management of Virtual Rooms. Using The client Calling SDK, developers empower call participants to execute in-call operations like mute/unmute, share screen, turn video on/off and dial-out to a PSTN participant, and so on. |
58
-
| Server-side management of in-call operations |[Call Automation SDK](../../how-tos/call-automation/actions-for-call-control.md)| Server | The Call Automation SDK enables developers to execute in-call operations from the server-side. In-call operations include server-initiated dial-out to a PSTN number, call recording, sending/receiving DTMF, sending announcements to specific users, and so on. Because running server-side in-call operations are independent from users and are controlled by developers, these actions aren't controlled by user-roles. |
58
+
| Server-side management of in-call operations |[Call Automation SDK](../../how-tos/call-automation/actions-for-call-control.md)| Server | The Call Automation SDK enables developers to execute in-call operations from the server-side. In-call operations include server-initiated dial-out to a PSTN number, call recording, sending/receiving DTMF, sending announcements to specific users, and so on. Because running server-side in-call operations are independent from users and controlled by developers, these actions aren't controlled by user-roles. |
59
59
60
-
<b>Developers use Virtual Rooms SDK, Calling client SDK, and Call Automation SDK to secure their calls and to trigger in-call client-side/server-side operations. </b>
60
+
<b>To secure calls and to trigger in-call client-side/server-side operations, Developers use Virtual Rooms SDK, Calling client SDK, and Call Automation SDK.</b>
61
61
62
-
| Capability | Rooms Server SDK| Calling Client SDK | Call Automation Server SDK |
| Play audio prompts to participants | ❌ | ❌ | ✔️ |
78
78
79
-
[Calling client SDK](../voice-video-calling/calling-sdk-features.md#detailed-capabilities) provides the full list of client-side in-call operations and explains how to use them.
79
+
For the full list of client-side in-call operations and how to use them, see [Calling client SDK](../voice-video-calling/calling-sdk-features.md#detailed-capabilities).
80
80
81
81
## Managing Virtual Rooms calls from the server-side using Call Automation Server SDK
82
82
@@ -111,19 +111,19 @@ Follow these steps to add a PSTN number to a room call using Call Automation SDK
111
111
1. Use Call Automation SDK to dial-out to a PSTN number
112
112
1. PSTN user accepts and joins a room call
113
113
114
-
## Managing Virtual Rooms calls from client-side Calling SDKs
114
+
## Managing virtual rooms calls from client-side Calling SDKs
115
115
116
-
Use the [Calling SDKs](../voice-video-calling/calling-sdk-features.md) to join the room call. Room calls can be joined using the Web, iOS, or Android Calling SDKs. You can find quick start samples for joining room calls[here](../../quickstarts/rooms/join-rooms-call.md).
116
+
Use the [Calling SDKs](../voice-video-calling/calling-sdk-features.md) to join the room call. Room calls can be joined using the Web, iOS, or Android Calling SDKs. For samples and how to join room calls, see [Join a room call](../../quickstarts/rooms/join-rooms-call.md).
117
117
118
118
Rooms can also be accessed using the [Azure Communication Services UI Library](https://azure.github.io/communication-ui-library/?path=/docs/concepts-rooms--docs). The UI Library enables developers to add a call client that is Rooms-enabled into their application with only a couple lines of code.
119
119
120
120
### Client initiated PSTN Dial-out using Calling client SDK
121
121
122
-
Developers can allow/disallow the ability for call participants to dial-out to a PSTN participant, by setting the Room specific pstnDialoutEnabled flag. Once the developer sets pstnDialoutEnabled=TRUE for a Room, the call participants with the Presenter role can dial-out to a PSTN participant from their calling client. The following steps are used to add a PSTN number to a room call using Calling Client SDK.
123
-
1. Create a room with pstnDialoutEnabled flag set to True
124
-
1. Participants start a room call
125
-
1. A participant with Presenter role adds PSTN number into a call
126
-
1. PSTN user accepts and joins a room call
122
+
Developers can enable / disable the ability for call participants to dial-out to a PSTN participant, by setting the Room specific pstnDialoutEnabled flag. Once the developer sets pstnDialoutEnabled=TRUE for a Room, the call participants with the Presenter role can dial-out to a PSTN participant from their calling client. The following steps are used to add a PSTN number to a room call using Calling Client SDK.
123
+
1. Create a room with pstnDialoutEnabled flag set to True.
124
+
1. Participants start a room call.
125
+
1. A participant with Presenter role adds PSTN number into a call.
126
+
1. PSTN user accepts and joins a room call.
127
127
128
128
### Virtual Rooms API/SDKs
129
129
@@ -135,50 +135,51 @@ Rooms are created and managed via rooms APIs or SDKs. Use the rooms API/SDKs in
Room participants can be assigned one of the following roles: **Presenter**, **Collaborator**, **Attendee**, and **Consumer**.
152
+
You can assign room participants one of the following roles: **Presenter**, **Collaborator**, **Attendee**, and **Consumer**.
152
153
153
154
The following table provides detailed capabilities mapped to the roles. At a high level, **Presenter** role has full control, **Collaborator** has audio, video, and screenshare capabilities, **Attendee** has audio and video capabilities, while **Consumer** can only receive audio, video, and screen sharing.
154
155
155
-
<b>Note:</b> A PSTN call participant is not a part of Room roster, so a user role is not assigned to them. They capabilities are limited to mute/unmute themselves on the local device.
156
+
<b>Note:</b> A PSTN call participant isn't a part of Room roster, so a user role isn't assigned to them. They capabilities are limited to mute/unmute themselves on the local device.
0 commit comments