Update call recording documentation for Java SDK

callconnectionid

Author: alvin-l-han

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

@@ -21,24 +21,28 @@ You can download the sample app from [GitHub](https://github.com/Azure-Samples/c
 
 ## Before you start
 
-Call Recording APIs exclusively use the `serverCallId` to initiate recording. There are a couple of methods you can use to fetch the `serverCallId` depending on your scenario:
+Call Recording APIs use the `callConnectionId` or `serverCallId`to initiate recording. There are a couple of methods you can use to fetch the these IDs depending on your scenario:
 
-### Call Automation scenarios
+### How to fetch callConnectionId
 
-When using [Call Automation](../../../call-automation/callflows-for-customer-interactions.md), you have two options to get the `serverCallId`:
+When using [Call Automation](../../../call-automation/callflows-for-customer-interactions.md), you will receive the `callConnectionId` from the response event from a `createCall`, `answer`, or `connect` requests when initiating the call.
+
+### How to fetch serverCallId
 
-1. Once a call is created, a `serverCallId` is returned as a property of the `CallConnected` event after a call is established. Learn how to [Get CallConnected event](../../../call-automation/callflows-for-customer-interactions.md?pivots=programming-language-java#update-programcs) from Call Automation SDK.
+When using [Call Automation](../../../call-automation/callflows-for-customer-interactions.md), you have two options to get the `serverCallId`:
 
-2.  Once you answer the call or a call is created the `serverCallId` is returned as a property of the `AnswerCallResult` or `CreateCallResult` API responses respectively.
+1. When you establish a call, it returns a `serverCallId` as a property of the `CallConnected` event after a call is established. Learn how to [Get CallConnected event](../../../call-automation/callflows-for-customer-interactions.md?pivots=programming-language-csharp#update-programcs) from Call Automation SDK.
 
-### Calling SDK scenarios
+2. When you answer the call or a call is created, it returns the `serverCallId` as a property of the `AnswerCallResult` or `CreateCallResult` API responses respectively.
 
-When using [Calling Client SDK](../../get-started-with-video-calling.md), you can retrieve the `serverCallId` by using the `getServerCallId` method on the call.
 
+When using [Calling Client SDK](../../get-started-with-video-calling.md), you can retrieve the `serverCallId` by using the `getServerCallId` method on the call. 
 Use this example to learn how to [Get serverCallId](../../get-server-call-id.md) from the Calling Client SDK. 
 
 Let's get started with a few simple steps.
 
+Let's get started with a few simple steps.
+
 ## 1. Create a Call Automation client
 
 Call Recording APIs are part of the Azure Communication Services [Call Automation](../../../../concepts/call-automation/call-automation.md) libraries. So you need to create a Call Automation client.
@@ -53,13 +57,13 @@ CallAutomationClient callAutomationClient = new CallAutomationClientBuilder()
 
 ## 2. Start recording session with StartRecordingOptions using `startWithResponse` API
 
-Use the `serverCallId` received during initiation of the call.
+Use the `callConnectionId` or `serverCallId` received during initiation of the call.
 - Use `RecordingContent` to pass the recording content type. Use `AUDIO`.
 - Use `RecordingChannel` to pass the recording channel type. Use `MIXED` or `UNMIXED`.
 - Use `RecordingFormat` to pass the format of the recording. Use `WAV`.
 
 ```java
-StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<serverCallId>"))
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<callConnectionId> or <serverCallId>"))
                     .setRecordingChannel(RecordingChannel.UNMIXED)
                     .setRecordingFormat(RecordingFormat.WAV)
                     .setRecordingContent(RecordingContent.AUDIO)
@@ -91,7 +95,7 @@ Start recording using your designated Azure Blob Storage to store the recorded f
 > **Recordings must be resumed for recording file to be generated.**
 
 ```java
-StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<serverCallId>"))
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<<callConnectionId> or serverCallId>"))
                     .setRecordingChannel(RecordingChannel.UNMIXED)
                     .setRecordingFormat(RecordingFormat.WAV)
                     .setRecordingContent(RecordingContent.AUDIO)
@@ -109,7 +113,7 @@ Response<RecordingStateResult> response = callAutomationClient.getCallRecording(
 To produce unmixed audio recording files, you can use the `AudioChannelParticipantOrdering` functionality to specify which user you want to record on channel 0. The rest of the participants are assigned to a channel as they speak. If you use `RecordingChannel.Unmixed` but don't use `AudioChannelParticipantOrdering`, Call Recording assigns channel 0 to the first participant speaking. 
 
 ```java
-StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<serverCallId>"))
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<<callConnectionId> or serverCallId>"))
                     .setRecordingChannel(RecordingChannel.UNMIXED)
                     .setRecordingFormat(RecordingFormat.WAV)
                     .setRecordingContent(RecordingContent.AUDIO)
@@ -179,7 +183,7 @@ The following code is an example of the event schema.
 {
     "id": string, // Unique guid for event
     "topic": string, // /subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/Microsoft.Communication/communicationServices/{communication-services-resource-name}
-    "subject": string, // /recording/call/{call-id}/serverCallId/{serverCallId}
+    "subject": string, // /recording/call/{call-id}/callConnectionId/{callConnectionId}
     "data": {
         "recordingStorageInfo": {
             "recordingChunks": [