Merge pull request #110734 from moirf/ga/callrecording-docs

call recording doc updates

Author: Jak-MS

articles/communication-services/quickstarts/voice-video-calling/includes/call-recording-samples/call-recording-csharp.md

@@ -1,20 +1,20 @@
 ---
 author: dbasantes
 ms.service: azure-communication-services
-ms.date: 10/14/2022
+ms.date: 06/11/2023
 ms.topic: include
 ms.custom: public_preview
 ---
 ## Sample Code
 
-You can download the sample app from [GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/ServerRecording)
+You can download the sample app from [GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/CallRecording)
 
 ## Prerequisites
 
 - You need an Azure account with an active subscription.
 - Deploy a Communication Service resource. Record your resource **connection string**.
 - Subscribe to events via [Azure Event Grid](../../../../../event-grid/event-schema-communication-services.md).
-- Download the [.NET SDK](https://www.nuget.org/packages/Azure.Communication.CallAutomation/1.0.0-beta.1)
+- Download the [.NET SDK](https://dotnet.microsoft.com/en-us/download/dotnet)
 
 ## Before you start
 
@@ -44,7 +44,7 @@ To create a call automation client, you'll use your Communication Services conne
 CallAutomationClient callAutomationClient = new CallAutomationClient("<ACSConnectionString>");
 ```
 
-## 2. Start recording session with StartRecordingOptions using 'StartRecordingAsync' API
+## 2. Start recording session with StartRecordingOptions using 'StartAsync' API
 
 Use the `serverCallId` received during initiation of the call.
 - RecordingContent is used to pass the recording content type. Use audio
@@ -57,10 +57,10 @@ StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCal
     RecordingContent = RecordingContent.Audio,
     RecordingChannel = RecordingChannel.Unmixed,
     RecordingFormat = RecordingFormat.Wav,
-    RecordingStateCallbackEndpoint = new Uri("<CallbackUri>");
+    RecordingStateCallbackUri = new Uri("<CallbackUri>");
 };
-Response<RecordingStateResult> response = await callAutomationClient.getCallRecording()
-.StartRecordingAsync(recordingOptions);
+Response<RecordingStateResult> response = await callAutomationClient.GetCallRecording()
+.StartAsync(recordingOptions);
 ```
 
 ### 2.1. Only for Unmixed - Specify a user on channel 0
@@ -72,36 +72,51 @@ StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCal
     RecordingContent = RecordingContent.Audio,
     RecordingChannel = RecordingChannel.Unmixed,
     RecordingFormat = RecordingFormat.Wav,
-    RecordingStateCallbackEndpoint = new Uri("<CallbackUri>"),
+    RecordingStateCallbackUri = new Uri("<CallbackUri>"),
     AudioChannelParticipantOrdering = { new CommunicationUserIdentifier("<ACS_USER_MRI>") }
 
 };
-Response<RecordingStateResult> response = await callAutomationClient.getCallRecording().StartRecordingAsync(recordingOptions);
+Response<RecordingStateResult> response = await callAutomationClient.GetCallRecording().StartAsync(recordingOptions);
 ```
-The `StartRecordingAsync` API response contains the `recordingId` of the recording session.
 
-## 3.	Stop recording session using 'StopRecordingAsync' API
+### 2.2. Only for Unmixed - Specify channel affinity
 
-Use the `recordingId` received in response of `startRecordingWithResponse`.
+```csharp
+var channelAffinity = new ChannelAffinity(new CommunicationUserIdentifier("<ACS_USER_MRI>")) { Channel = 0};
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>"))
+{
+   RecordingContent = RecordingContent.Audio,
+   RecordingChannel = RecordingChannel.Unmixed,
+   RecordingFormat = RecordingFormat.Wav,
+   RecordingStateCallbackUri = new Uri("<CallbackUri>"),
+   ChannelAffinity = { channelAffinity }
+};
+Response<RecordingStateResult> response = await callAutomationClient.GetCallRecording().StartAsync(recordingOptions);
+```
+The `StartAsync` API response contains the `recordingId` of the recording session.
+
+## 3.	Stop recording session using 'StopAsync' API
+
+Use the `recordingId` received in response of `StartAsync`.
 
 ```csharp
-var stopRecording = await callAutomationClient.GetCallRecording().StopRecordingAsync(recording.Value.RecordingId);
+var stopRecording = await callAutomationClient.GetCallRecording().StopAsync(recordingId);
 ```
 
-## 4.	Pause recording session using 'PauseRecordingAsync' API
+## 4.	Pause recording session using 'PauseAsync' API
 
-Use the `recordingId` received in response of `startRecordingWithResponse`.
+Use the `recordingId` received in response of `StartAsync`.
 
 ```csharp
-var pauseRecording = await callAutomationClient.GetCallRecording ().PauseRecordingAsync(recording.Value.RecordingId);
+var pauseRecording = await callAutomationClient.GetCallRecording ().PauseAsync(recordingId);
 ```
 
-## 5.	Resume recording session using 'ResumeRecordingAsync' API
+## 5.	Resume recording session using 'ResumeAsync' API
 
-Use the `recordingId` received in response of `startRecordingWithResponse`.
+Use the `recordingId` received in response of `StartAsync`.
 
 ```csharp
-var resumeRecording = await callAutomationClient.GetCallRecording().ResumeRecordingAsync(recording.Value.RecordingId);
+var resumeRecording = await callAutomationClient.GetCallRecording().ResumeAsync(recordingId);
 ```
 
 ## 6.	Download recording File using 'DownloadToAsync' API
@@ -141,19 +156,19 @@ Below is an example of the event schema.
 }
 ```
 
-Use `DownloadStreamingAsync` API for downloading the recorded media.
+Use `DownloadToAsync` API for downloading the recorded media.
 
 ```csharp
 var recordingDownloadUri = new Uri(contentLocation);
-var response = await callAutomationClient.GetCallRecording().DownloadStreamingAsync(recordingDownloadUri);
+var response = await callAutomationClient.GetCallRecording().DownloadToAsync(recordingDownloadUri, fileName);
 ```
-The `downloadLocation` for the recording can be fetched from the `contentLocation` attribute of the `recordingChunk`. `DownloadStreamingAsync` method returns response of type `Response<Stream>`, which contains the downloaded content.
+The `downloadLocation` for the recording can be fetched from the `contentLocation` attribute of the `recordingChunk`. `DownloadToAsync` method download the content into provided filename.
 
-## 7. Delete recording content using 'DeleteRecordingAsync' API
+## 7. Delete recording content using 'DeleteAsync' API
 
-Use `DeleteRecordingAsync` API for deleting the recording content (for example, recorded media, metadata)
+Use `DeleteAsync` API for deleting the recording content (for example, recorded media, metadata)
 
 ```csharp
 var recordingDeleteUri = new Uri(deleteLocation);
-var response = await callAutomationClient.GetCallRecording().DeleteRecordingAsync(recordingDeleteUri);
+var response = await callAutomationClient.GetCallRecording().DeleteAsync(recordingDeleteUri);
 ```

articles/communication-services/quickstarts/voice-video-calling/includes/call-recording-samples/call-recording-java.md

@@ -1,14 +1,14 @@
 ---
 author: dbasantes
 ms.service: azure-communication-services
-ms.date: 10/14/2022
+ms.date: 06/11/2023
 ms.topic: include
 ms.custom: public_preview
 ---
 
 ## Sample Code
 
-You can download the sample app from [GitHub](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/ServerRecording)
+You can download the sample app from [GitHub](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/CallRecording)
 
 ## Prerequisites
 
@@ -47,7 +47,7 @@ CallAutomationClient callAutomationClient = new CallAutomationClientBuilder()
             .buildClient();
 ```
 
-## 2. Start recording session with StartRecordingOptions using 'startRecordingWithResponse' API
+## 2. Start recording session with StartRecordingOptions using 'startWithResponse' API
 
 Use the `serverCallId` received during initiation of the call.
 - RecordingContent is used to pass the recording content type. Use AUDIO
@@ -61,8 +61,8 @@ StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCal
                     .setRecordingContent(RecordingContent.AUDIO)
                     .setRecordingStateCallbackUrl("<recordingStateCallbackUrl>");
 
-Response<StartCallRecordingResult> response = callAutomationClient.getCallRecording()
-.startRecordingWithResponse(recordingOptions, null);
+Response<RecordingStateResult> response = callAutomationClient.getCallRecording()
+.startWithResponse(recordingOptions, null);
 
 ```
 
@@ -78,35 +78,52 @@ StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCal
                     .setAudioChannelParticipantOrdering(List.of(new CommunicationUserIdentifier("<participantMri>")));
 
 Response<RecordingStateResult> response = callAutomationClient.getCallRecording()
-.startRecordingWithResponse(recordingOptions, null);
+.startWithResponse(recordingOptions, null);
+
+```
 
+### 2.2. Only for Unmixed - Specify channel affinity
+```java
+ChannelAffinity channelAffinity = new ChannelAffinity()
+.setParticipant(new PhoneNumberIdentifier("RECORDING_ID"))
+.setChannel(0);
+List<ChannelAffinity> channelAffinities = Arrays.asList(channelAffinity);
+
+StartRecordingOptions startRecordingOptions = new StartRecordingOptions(new ServerCallLocator(SERVER_CALL_ID))
+   .setRecordingChannel(RecordingChannel.UNMIXED)
+   .setRecordingFormat(RecordingFormat.WAV)
+   .setRecordingContent(RecordingContent.AUDIO)
+   .setRecordingStateCallbackUrl("<recordingStateCallbackUrl>")
+   .setChannelAffinity(channelAffinities);
+Response<RecordingStateResult> response = callAutomationClient.getCallRecording()
+.startRecordingWithResponse(recordingOptions, null);
 ```
-The `startRecordingWithResponse` API response contains the `recordingId` of the recording session.
+The `startWithResponse` API response contains the `recordingId` of the recording session.
 
-## 3.	Stop recording session using 'stopRecordingWithResponse' API
+## 3.	Stop recording session using 'stopWithResponse' API
 
-Use the `recordingId` received in response of `startRecordingWithResponse`.
+Use the `recordingId` received in response of `startWithResponse`.
 
 ```java
 Response<Void> response = callAutomationClient.getCallRecording()
-               .stopRecordingWithResponse(response.getValue().getRecordingId(), null);
+               .stopWithResponse(response.getValue().getRecordingId(), null);
 ```
 
-## 4.	Pause recording session using 'pauseRecordingWithResponse' API
+## 4.	Pause recording session using 'pauseWithResponse' API
 
-Use the `recordingId` received in response of `startRecordingWithResponse`.
+Use the `recordingId` received in response of `startWithResponse`.
 ```java
 Response<Void> response = callAutomationClient.getCallRecording()
-              .pauseRecordingWithResponse(response.getValue().getRecordingId(), null);
+              .pauseWithResponse(response.getValue().getRecordingId(), null);
 ```
 
-## 5.	Resume recording session using 'resumeRecordingWithResponse' API
+## 5.	Resume recording session using 'resumeWithResponse' API
 
-Use the `recordingId` received in response of `startRecordingWithResponse`.
+Use the `recordingId` received in response of `startWithResponse`.
 
 ```java
 Response<Void> response = callAutomationClient.getCallRecording()
-               .resumeRecordingWithResponse(response.getValue().getRecordingId(), null);
+               .resumeWithResponse(response.getValue().getRecordingId(), null);
 ```
 
 ## 6.	Download recording File using 'downloadToWithResponse' API
@@ -166,13 +183,13 @@ Response<Void> downloadResponse = callAutomationClient.getCallRecording().downlo
 ```
 The content location and document IDs for the recording files can be fetched from the `contentLocation` and `documentId` fields respectively, for each `recordingChunk`.
 
-## 7. Delete recording content using ‘deleteRecordingWithResponse’ API.
+## 7. Delete recording content using ‘deleteWithResponse’ API.
 
-Use `deleteRecordingWithResponse` method of `CallRecording` class for deleting the recorded media. Following are the supported parameters for `deleteRecordingWithResponse` method:
+Use `deleteWithResponse` method of `CallRecording` class for deleting the recorded media. Following are the supported parameters for `deleteWithResponse` method:
 - `deleteLocation`: Azure Communication Services URL where the content to delete is located.
 - `context`: A Context representing the request context.
 
 ```
-Response<Void> deleteResponse = callAutomationClient.getCallRecording().deleteRecordingWithResponse(deleteLocation, context);
+Response<Void> deleteResponse = callAutomationClient.getCallRecording().deleteWithResponse(deleteLocation, context);
 ```
 The delete location for the recording can be fetched from the `deleteLocation` field of the Event Grid event.