Added enhancements on top of Calling Server preview 1

.vscode/cspell.json

@@ -37,6 +37,7 @@
     "contoso",
     "deserializes",
     "diagnoser",
+    "dtmf",
     "epsg",
     "expando",
     "finalizer",
@@ -50,13 +51,15 @@
     "overridden",
     "parallelization",
     "pkcs",
+    "pstn",
     "pwsh",
     "referer",
     "renormalize",
     "retriable",
     "structs",
     "uints",
     "unformattable",
+    "unhold",
     "uninstrumented",
     "westus",
     "xunit"

sdk/communication/Azure.Communication.CallingServer/README.md

@@ -18,7 +18,7 @@ You need an [Azure subscription][azure_sub] and a [Communication Service Resourc
 To create a new Communication Service, you can use the [Azure Portal][communication_resource_create_portal], the [Azure PowerShell][communication_resource_create_power_shell], or the [.NET management client library][communication_resource_create_net].
 
 ### Key concepts
-`CallClient` provides the functionality to make call related operations.
+`CallingServerClient` provides the functionality to make call connection, join call connection or initialize a server call.
 
 ### Using statements
 ```C# Snippet:Azure_Communication_ServerCalling_Tests_UsingStatements
@@ -28,33 +28,33 @@ using Azure.Communication.CallingServer;
 ```
 
 ### Authenticate the client
-Server Calling clients can be authenticated using the connection string acquired from an Azure Communication Resource in the [Azure Portal][azure_portal].
+Calling server client can be authenticated using the connection string acquired from an Azure Communication Resource in the [Azure Portal][azure_portal].
 
 ```C# Snippet:Azure_Communication_ServerCalling_Tests_Samples_CreateServerCallingClient
 var connectionString = "<connection_string>"; // Find your Communication Services resource in the Azure portal
-CallClient client = new CallClient(connectionString);
+CallingServerClient callingServerClient = new CallingServerClient(connectionString);
 ```
 
 ## Examples
 ### Make a call to a phone number recipient
-To make a call, call the `CreateCall` or `CreateCallAsync` function from the `CallClient`.
+To make an outbound call, call the `CreateCallConnection` or `CreateCallConnectionAsync` function from the `CallingServerClient`.
 ```C# Snippet:Azure_Communication_Call_Tests_CreateCallOptions
 var createCallOption = new CreateCallOptions(
        new Uri(TestEnvironment.AppCallbackUrl),
-       new List<CallModality> { CallModality.Audio },
-       new List<EventSubscriptionType>
+       new[] { MediaType.Audio },
+       new[]
        {
            EventSubscriptionType.ParticipantsUpdated,
            EventSubscriptionType.DtmfReceived
        });
 ```
 ```C# Snippet:Azure_Communication_Call_Tests_CreateCallAsync
-CreateCallResponse createCallResponse = await callClient.CreateCallAsync(
+var callConnection = await callingServerClient.CreateCallConnectionAsync(
     source: new CommunicationUserIdentifier("<source-identifier>"), // Your Azure Communication Resource Guid Id used to make a Call
     targets: new List<CommunicationIdentifier>() { new PhoneNumberIdentifier("<targets-phone-number>") }, // E.164 formatted recipient phone number
     options: createCallOption // The options for creating a call.
     );
-Console.WriteLine($"Call Leg id: {createCallResponse.CallLegId}");
+Console.WriteLine($"Call connection id: {callConnection.Value.CallConnectionId}");
 ```
 
 ## Troubleshooting

sdk/communication/Azure.Communication.CallingServer/samples/Sample1_CreateCall.md

@@ -4,13 +4,13 @@ This sample demonstrates how to make a call to a phone number recipient.
 
 To get started you'll need a Communication Service Resource.  See [README][README] for prerequisites and instructions.
 
-## Creating an `ServerCallingClient`
+## Creating an `CallingServerClient`
 
-Server Calling clients can be authenticated using the connection string acquired from an Azure Communication Resource in the Azure Portal.
+Calling server client can be authenticated using the connection string acquired from an Azure Communication Resource in the Azure Portal.
 
 ```C# Snippet:Azure_Communication_ServerCalling_Tests_Samples_CreateServerCallingClient
 var connectionString = "<connection_string>"; // Find your Communication Services resource in the Azure portal
-CallClient client = new CallClient(connectionString);
+CallingServerClient callingServerClient = new CallingServerClient(connectionString);
 ```
 
 ## Make a call to a phone number recipient
@@ -19,20 +19,20 @@ To make a call, call the `CreateCall` or `CreateCallAsync` function from the `Ca
 ```C# Snippet:Azure_Communication_Call_Tests_CreateCallOptions
 var createCallOption = new CreateCallOptions(
        new Uri(TestEnvironment.AppCallbackUrl),
-       new List<CallModality> { CallModality.Audio },
-       new List<EventSubscriptionType>
+       new[] { MediaType.Audio },
+       new[]
        {
            EventSubscriptionType.ParticipantsUpdated,
            EventSubscriptionType.DtmfReceived
        });
 ```
 ```C# Snippet:Azure_Communication_Call_Tests_CreateCall
-CreateCallResponse createCallResponse = callClient.CreateCall(
+var callConnection = callingServerClient.CreateCallConnection(
     source: new CommunicationUserIdentifier("<source-identifier>"), // Your Azure Communication Resource Guid Id used to make a Call
     targets: new List<CommunicationIdentifier>() { new PhoneNumberIdentifier("<targets-phone-number>") }, // E.164 formatted recipient phone number
     options: createCallOption // The options for creating a call.
     );
-Console.WriteLine($"Call Leg id: {createCallResponse.CallLegId}");
+Console.WriteLine($"Call connection id: {callConnection.Value.CallConnectionId}");
 ```
 
 To see the full example source files, see:

sdk/communication/Azure.Communication.CallingServer/samples/Sample1_CreateCallAsync.md

@@ -4,13 +4,13 @@ This sample demonstrates how to make a call to a recipient phone number.
 
 To get started you'll need a Communication Service Resource.  See [README][README] for prerequisites and instructions.
 
-## Creating an `ServerCallingClient`
+## Creating a `ServerCallingClient`
 
 Server Calling clients can be authenticated using the connection string acquired from an Azure Communication Resource in the Azure Portal.
 
 ```C# Snippet:Azure_Communication_ServerCalling_Tests_Samples_CreateServerCallingClient
 var connectionString = "<connection_string>"; // Find your Communication Services resource in the Azure portal
-CallClient client = new CallClient(connectionString);
+CallingServerClient callingServerClient = new CallingServerClient(connectionString);
 ```
 
 ## Make a call to a phone number recipient
@@ -19,20 +19,20 @@ To make a Call, call the `CreateCall` or `CreateCallAsync` function from the `Ca
 ```C# Snippet:Azure_Communication_Call_Tests_CreateCallOptions
 var createCallOption = new CreateCallOptions(
        new Uri(TestEnvironment.AppCallbackUrl),
-       new List<CallModality> { CallModality.Audio },
-       new List<EventSubscriptionType>
+       new[] { MediaType.Audio },
+       new[]
        {
            EventSubscriptionType.ParticipantsUpdated,
            EventSubscriptionType.DtmfReceived
        });
 ```
 ```C# Snippet:Azure_Communication_Call_Tests_CreateCallAsync
-CreateCallResponse createCallResponse = await callClient.CreateCallAsync(
+var callConnection = await callingServerClient.CreateCallConnectionAsync(
     source: new CommunicationUserIdentifier("<source-identifier>"), // Your Azure Communication Resource Guid Id used to make a Call
     targets: new List<CommunicationIdentifier>() { new PhoneNumberIdentifier("<targets-phone-number>") }, // E.164 formatted recipient phone number
     options: createCallOption // The options for creating a call.
     );
-Console.WriteLine($"Call Leg id: {createCallResponse.CallLegId}");
+Console.WriteLine($"Call connection id: {callConnection.Value.CallConnectionId}");
 ```
 
 To see the full example source files, see:

sdk/communication/Azure.Communication.CallingServer/src/Azure.Communication.CallingServer.csproj

@@ -1,13 +1,13 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <Description>
-      This client library enables working with the Microsoft Azure Communication Service Calling Server APIs.
+      This client library enables working with the Microsoft Azure Communication CallingServer service.
       For this release, see notes - https://github.com/Azure/azure-sdk-for-net-pr/blob/master/sdk/communication/Azure.Communication.ServerCalling/README.md and https://github.com/Azure/azure-sdk-for-net-pr/blob/master/sdk/communication/Azure.Communication.ServerCalling/CHANGELOG.md.
     </Description>
-    <AssemblyTitle>Azure Communication Service Calling Server APIs</AssemblyTitle>
+    <AssemblyTitle>Azure Communication CallingServer Service</AssemblyTitle>
     <Version>1.0.0-beta.1</Version>
     <!--The ApiCompatVersion is managed automatically and should not generally be modified manually.-->
-    <PackageTags>Microsoft Azure Communication Calling Server APIs;Microsoft;Azure;Azure Communication Service;Azure Communication Calling Server APIs;Calling;Communication;$(PackageCommonTags)</PackageTags>
+    <PackageTags>Microsoft Azure Communication CallingServer Service;Microsoft;Azure;Azure Communication Service;Azure Communication CallingServer Service;Calling;Communication;$(PackageCommonTags)</PackageTags>
     <TargetFrameworks>$(RequiredTargetFrameworks)</TargetFrameworks>
   </PropertyGroup>