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/quickstarts/rooms/manage-rooms-call.md
+24-21Lines changed: 24 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,20 +16,20 @@ ms.custom: mode-other
16
16
# Quickstart: Manage a room call
17
17
18
18
## Introduction
19
-
Once Azure Communication Services (ACS) room call is started, the call can be managed using Calling SDKs or Call Automation SDKs or both. In a room call, the mid-call actions are controlled by either the roles assigned to participants and properties configured in the room. The participant's roles are used to control capabilities permitted per participant while room's properties are applied to a room call as a whole.
19
+
During an Azure Communication Services (ACS) room call, you can manage the call using Calling SDKs or Call Automation SDKs or both. In a room call, you can control in-call actions using both the roles assigned to participants and properties configured in the room. The participant's roles control capabilities permitted per participant, while room properties apply to the room call as a whole.
20
20
21
21
## Calling SDKs
22
-
Calling SDK is a clientside calling libraries enabling participants in a room call to perform several mid-call operations (e.g. screen share, turn on/off video, mute/unmute, etc. ). Full list of capabilities offered in Calling SDK is listed in the [Calling SDK Overview](../../concepts/voice-video-calling/calling-sdk-features.md#detailed-capabilities)
22
+
Calling SDK is a client-side calling library enabling participants in a room call to perform several in-call operations, such as screen share, turn on/off video, mute/unmute, and so on. For the full list of capabilities, see [Calling SDK Overview](../../concepts/voice-video-calling/calling-sdk-features.md#detailed-capabilities).
23
23
24
-
The capabilities are controlled based on roles assigned participants in the call (e.g. Only presenter can screen share). Please refer to [Rooms concepts](../../concepts/rooms/room-concept#predefined-participant-roles-and-permissions) for participant roles and permissions.
24
+
You control the capabilities based on roles assigned to participants in the call. For example, only the presenter can screen share. For participant roles and permissions, see [Rooms concepts](../../concepts/rooms/room-concept.md#predefined-participant-roles-and-permissions).
25
25
26
26
## Call Automation SDKs
27
-
Call Automation SDK is a sever side libraries enabling administrator to manage an ongoing room call in a central and controlled environment. Unlike Calling SDK, Call Automation SDK operations are roles agnostic. Therefore, a call administrator may perform several mid-call operations on behalf of the room call participants.
27
+
Call Automation SDK is a server-side library enabling administrators to manage an ongoing room call in a central and controlled environment. Unlike Calling SDK, Call Automation SDK operations are roles agnostic. Therefore, a call administrator can perform several in-call operations on behalf of the room call participants.
28
28
29
-
The following lists common mid-call actions available in a room call.
29
+
The following lists describe common in-call actions available in a room call.
30
30
31
31
### Connect to a room call
32
-
Call Automation must connect to an existing room call prior to performing any mid-call operations. CallConnected or ConnectFailed events are notified using callback mechanism to indicate a connect operation is successful or failed respectively.
32
+
Call Automation must connect to an existing room call before performing any in-call operations. The `CallConnected` or `ConnectFailed` events are raised using callback mechanisms to indicate if a connect operation was successful or failed respectively.
Once successfully connected to a room call, a CallConnect event is notified via Callback URI. The ```callConnectionId``` is available such that it can be used to retrieve a call connection on the room call as needed. ```callConnectionId``` will be used in the following sample code snippets.
67
+
Once successfully connected to a room call, a `CallConnect` event is notified via Callback URI. You can use `callConnectionId`to retrieve a call connection on the room call as needed. The following sample code snippets use the `callConnectionId` to demonstrate this function.
68
68
69
69
70
70
### Add PSTN Participant
71
-
Call Automation can dial out to a PSTN number and add the participant into a room call. A room, however, must be set up to enable PSTN dial-out option (EnabledPSTNDialout is set to true) and Azure Communication Services (ACS) resource must have a valid phone number. Please refer to [Rooms quickstart](get-started-rooms?tabs=windows&pivots=platform-azcli#enable-pstn-dial-out-capability-for-a-room) for detail.
71
+
Using Call Automation you can dial out to a PSTN number and add the participant into a room call. You must, however, set up a room to enable PSTN dial-out option (`EnabledPSTNDialout` set to `true`) and the Azure Communication Services resource must have a valid phone number provisioned.
72
+
73
+
For more information, see [Rooms quickstart](../../quickstarts//rooms/get-started-rooms.md?tabs=windows&pivots=platform-azcli#enable-pstn-dial-out-capability-for-a-room).
74
+
72
75
73
76
### [csharp](#tab/csharp)
74
77
75
78
```csharp
76
-
varcallerIdNumber=newPhoneNumberIdentifier("+16044561234"); // This is the Azure Communication Services provisioned phone number for the caller
77
-
varcallThisPerson=newCallInvite(newPhoneNumberIdentifier("+16041234567"), callerIdNumber); //person to call
79
+
varcallerIdNumber=newPhoneNumberIdentifier("+16044561234"); // This is the ACS-provisioned phone number for the caller
80
+
varcallThisPerson=newCallInvite(newPhoneNumberIdentifier("+16041234567"), callerIdNumber); //The target phone number to dial out to
PhoneNumberIdentifier callerIdNumber =newPhoneNumberIdentifier("+16044561234"); // This is the Azure Communication Services provisioned phone number for the caller
87
+
PhoneNumberIdentifier callerIdNumber =newPhoneNumberIdentifier("+16044561234"); // This is the ACS-provisioned phone number for the caller
@@ -216,7 +219,7 @@ result = call_connection_client.send_dtmf_tones(
216
219
-----
217
220
218
221
### Call Recording
219
-
ACS Rooms supports recording capabilities (start, stop, pause, resume, etc.) provided by Call Automation. The following code snippets are used to start/stop/pause/resume a recording in a room call. However, please refer to [Call Automation recording](../../concepts/voice-video-calling/call-recording#get-full-control-over-your-recordings-with-our-call-recording-apis) for a complete list of actions.
222
+
Azure Communication Services rooms support recording capabilities including `start`, `stop`, `pause`, `resume`, and so on, provided by Call Automation. See the following code snippets to start/stop/pause/resume a recording in a room call. For a complete list of actions, see [Call Automation recording](../../concepts/voice-video-calling/call-recording.md#get-full-control-over-your-recordings-with-our-call-recording-apis).
220
223
221
224
### [csharp](#tab/csharp)
222
225
```csharp
@@ -315,7 +318,7 @@ resume_recording = call_automation_client.resume_recording(recording_id = record
315
318
316
319
317
320
### Terminate a Call
318
-
Call Automation SDKs provides Hang Up action which can be used to terminate a call. CallDisconnected event is published once the Hang Up action has completed successfully.
321
+
You can use the Call Automation SDK Hang Up action to terminate a call. When the Hang Up action completes, the SDK publishes a `CallDisconnected` event.
The following mid-call actions are also supported in a room call.
353
+
The following in-call actions are also supported in a room call.
351
354
1. Add participant (ACS identifier)
352
355
1. Remove participant (ACS identifier)
353
356
1. Cancel add participant (ACS identifier and PSTN number)
@@ -360,15 +363,15 @@ The following mid-call actions are also supported in a room call.
360
363
1. Recognize both DTMF and speech
361
364
1. Recognize continuous DTMF
362
365
363
-
Please see [call actions](../../how-tos/call-automation/actions-for-call-control?branch=pr-en-us-280574&tabs=csharp) and [media actions](../../how-tos/call-automation/control-mid-call-media-actions?branch=pr-en-us-280574&tabs=csharp) for detail.
366
+
For more information, see [call actions](../../how-tos/call-automation/actions-for-call-control.md?branch=pr-en-us-280574&tabs=csharp) and [media actions](../../how-tos/call-automation/control-mid-call-media-actions.md?branch=pr-en-us-280574&tabs=csharp).
364
367
365
368
## Next steps
366
369
367
370
In this section you learned how to:
368
371
> [!div class="checklist"]
369
372
> - Join a room call from your application
370
-
> - Add mid-call actions into a room call using calling SDKs
371
-
> - Add mid-call actions into a room call using Call Automation SDKs
373
+
> - Add in-call actions into a room call using calling SDKs
374
+
> - Add in-call actions into a room call using Call Automation SDKs
372
375
373
376
You may also want to:
374
377
- Learn about [Rooms concept](../../concepts/rooms/room-concept.md)
0 commit comments