Skip to content

Commit 051a787

Browse files
Update room-concept.md
1 parent 3e6fc00 commit 051a787

File tree

1 file changed

+47
-45
lines changed

1 file changed

+47
-45
lines changed

articles/communication-services/concepts/rooms/room-concept.md

Lines changed: 47 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -147,58 +147,60 @@ Rooms are created and managed via rooms APIs or SDKs. Use the rooms API/SDKs in
147147
## Predefined participant roles and permissions in Virtual Rooms calls
148148
<a name="predefined-participant-roles-and-permissions"></a>
149149

150-
Room participants can be assigned one of the following roles: **Presenter**, **Attendee**, and **Consumer**.
150+
Room participants can be assigned one of the following roles: **Presenter**, **Attendee**, **Consumer**, and **Collaborator**\*\*\*.
151151

152-
The following table provides detailed capabilities mapped to the roles. At a high level, **Presenter** role has full control, **Attendee** capabilities are limited to audio and video, while **Consumer** can only receive audio, video, and screen sharing.
152+
The following table provides detailed capabilities mapped to the roles. At a high level, **Presenter** role has full control, **Attendee** capabilities are limited to audio and video, while **Consumer** can only receive audio, video, and screen sharing. **Collaborator** is similar to Attendee, with the additional capability of screenshare.
153153

154154
<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.
155155

156-
| Capability | Role: Presenter | Role: Attendee | Role: Consumer
157-
|---------------------------------------------| :--------: | :--------: | :--------: |
158-
| **Mid call controls** | | |
159-
| - Turn video on/off | ✔️ | ✔️ ||
160-
| - Mute/Unmute mic | ✔️ | ✔️ ||
161-
| - Mute remote user | ✔️ |||
162-
| - Switch between cameras | ✔️ | ✔️ ||
163-
| - Active speaker | ✔️ | ✔️ | ✔️ |
164-
| - Choose speaker for calls | ✔️ | ✔️ | ✔️ |
165-
| - Choose mic for calls | ✔️ | ✔️ ||
166-
| - Show participants state (idle, connecting, connected, On-hold, Disconnecting, Disconnected etc.) | ✔️ | ✔️ | ✔️ |
167-
| - Show call state (Early media, Incoming, Connecting, Ringing, Connected, Hold, Disconnecting, Disconnected | ✔️ | ✔️ | ✔️ |
168-
| - Show if a participant is muted | ✔️ | ✔️ | ✔️ |
169-
| - Show the reason why a participant left a call | ✔️ | ✔️ | ✔️ |
170-
| - Start call captions | ✔️ | ✔️ | ✔️ |
171-
| - Change captions language | ✔️ | ✔️ | ✔️ |
172-
| - Invite to join a Virtual Room participant to a call | ✔️ |||
173-
| **Screen sharing** | | |
174-
| - Share screen | ✔️ * |||
175-
| - Share an application | ✔️ * |||
176-
| - Share a browser tab | ✔️ * |||
177-
| - Participants can view shared screen | ✔️ | ✔️ | ✔️ |
178-
| **Roster management** | | |
179-
| - Remove a participant | ✔️ |||
180-
| **Device management** | | |
181-
| - Ask for permission to use audio and/or video | ✔️ | ✔️ ||
182-
| - Get camera list | ✔️ | ✔️ ||
183-
| - Set camera | ✔️ | ✔️ ||
184-
| - Get selected camera | ✔️ | ✔️ ||
185-
| - Get mic list | ✔️ * | ✔️ * ||
186-
| - Set mic | ✔️ * | ✔️ * ||
187-
| - Get selected mic | ✔️ * | ✔️ * ||
188-
| - Get speakers list | ✔️ * | ✔️ * | ✔️ * |
189-
| - Set speaker | ✔️ * | ✔️ * | ✔️ * |
190-
| - Get selected speaker | ✔️ | ✔️ | ✔️ |
191-
| **Video rendering** | | | |
192-
| - Render a video in multiple places (local camera or remote stream) | ✔️ | ✔️ | ✔️ <br>(Only Remote)</br> |
193-
| - Set/Update video scaling mode | ✔️ | ✔️ | ✔️ <br>(Only Remote)</br> |
194-
| - Render remote video stream | ✔️ | ✔️ | ✔️ |
195-
| **Dial-out to PSTN participants from the client-side** | | |
196-
| - Dial-out to PSTN participants from Virtual Rooms calls | ✔️ |||
197-
198-
\* Only available on the web calling SDK. Not available on iOS and Android calling SDKs
156+
| Capability | Role: Presenter | Role: Attendee | Role: Consumer | Role: Collaborator\*\*\* |
157+
|---------------------------------------------| :--------: | :--------: | :--------: | :--------: |
158+
| **Mid call controls** | | | |
159+
| - Turn video on/off | ✔️ | ✔️ || ✔️ |
160+
| - Mute/Unmute mic | ✔️ | ✔️ || ✔️ |
161+
| - Mute remote user | ✔️ ||||
162+
| - Switch between cameras | ✔️ | ✔️ || ✔️ |
163+
| - Active speaker | ✔️ | ✔️ | ✔️ | ✔️ |
164+
| - Choose speaker for calls | ✔️ | ✔️ | ✔️ | ✔️ |
165+
| - Choose mic for calls | ✔️ | ✔️ || ✔️ |
166+
| - Show participants state (idle, connecting, connected, On-hold, Disconnecting, Disconnected etc.) | ✔️ | ✔️ | ✔️ | ✔️ |
167+
| - Show call state (Early media, Incoming, Connecting, Ringing, Connected, Hold, Disconnecting, Disconnected | ✔️ | ✔️ | ✔️ | ✔️ |
168+
| - Show if a participant is muted | ✔️ | ✔️ | ✔️ | ✔️ |
169+
| - Show the reason why a participant left a call | ✔️ | ✔️ | ✔️ | ✔️ |
170+
| - Start call captions | ✔️ | ✔️ | ✔️ | ✔️ |
171+
| - Change captions language | ✔️ | ✔️ | ✔️ | ✔️ |
172+
| - Invite to join a Virtual Room participant to a call | ✔️ ||||
173+
| **Screen sharing** | | | |
174+
| - Share screen | ✔️ * ||| ✔️ * |
175+
| - Share an application | ✔️ * ||| ✔️ * |
176+
| - Share a browser tab | ✔️ * ||| ✔️ * |
177+
| - Participants can view shared screen | ✔️ | ✔️ | ✔️ | ✔️ |
178+
| **Roster management** | | | |
179+
| - Remove a participant | ✔️ ||||
180+
| **Device management** | | | |
181+
| - Ask for permission to use audio and/or video | ✔️ | ✔️ || ✔️ |
182+
| - Get camera list | ✔️ | ✔️ || ✔️ |
183+
| - Set camera | ✔️ | ✔️ || ✔️ |
184+
| - Get selected camera | ✔️ | ✔️ || ✔️ |
185+
| - Get mic list | ✔️ * | ✔️ * || ✔️ * |
186+
| - Set mic | ✔️ * | ✔️ * || ✔️ * |
187+
| - Get selected mic | ✔️ * | ✔️ * || ✔️ * |
188+
| - Get speakers list | ✔️ * | ✔️ * | ✔️ * | ✔️ * |
189+
| - Set speaker | ✔️ * | ✔️ * | ✔️ * | ✔️ * |
190+
| - Get selected speaker | ✔️ | ✔️ | ✔️ | ✔️ |
191+
| **Video rendering** | | | | |
192+
| - Render a video in multiple places (local camera or remote stream) | ✔️ | ✔️ | ✔️ <br>(Only Remote)</br> | ✔️ |
193+
| - Set/Update video scaling mode | ✔️ | ✔️ | ✔️ <br>(Only Remote)</br> | ✔️ |
194+
| - Render remote video stream | ✔️ | ✔️ | ✔️ | ✔️ |
195+
| **Dial-out to PSTN participants from the client-side** | | | |
196+
| - Dial-out to PSTN participants from Virtual Rooms calls | ✔️ ||||
197+
198+
\* Only available on the web calling SDK. Not available on iOS and Android calling SDKs.
199199

200200
\*\* Currently in [public preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
201201

202+
\*\*\* Collaborator role is available in Rooms version 2025-03-13 or newer.
203+
202204
## Event handling
203205

204206
[Voice and video calling events](../../../event-grid/communication-services-voice-video-events.md) published via [Event Grid](../../../event-grid/event-schema-communication-services.md) are annotated with room call information.

0 commit comments

Comments
 (0)