Merge pull request #311888 from alvin-l-han/main

Update Call Recording docs to include support for callconnectionid

Author: prmerger-automator[bot]

articles/communication-services/concepts/voice-video-calling/call-recording.md

@@ -51,13 +51,13 @@ Call Recording supports multiple media outputs and content types to address your
 
 
 ## Get full control over your recordings with our Call Recording APIs
-You can use Call Recording APIs to manage recording via internal business logic triggers, such as an application creating a group call and recording the conversation. Also, recordings can be triggered by a user action that tells the server application to start recording. Call Recording APIs use exclusively the `serverCallId` to initiate recording. To learn how to get the `serverCallId`, check our [Call Recording Quickstart](../../quickstarts/voice-video-calling/get-started-call-recording.md).
+You can use Call Recording APIs to manage recording via internal business logic triggers, such as an application creating a group call and recording the conversation. Also, recordings can be triggered by a user action that tells the server application to start recording. To initiate a recording, Call Recording APIs can use the `callConnectionId` (preferred) or the `serverCallId` when the callConnectionId is not available. To learn how to get the `callConnectionId` or `serverCallId`, check our [Call Recording Quickstart](../../quickstarts/voice-video-calling/get-started-call-recording.md).
 A `recordingId` is returned when recording is started, which can then be used for follow-on operations like pause and resume.  
 
 
 | Operation                            | Operates On            | Comments                       |
 | :-------------------- | :--------------------- | :----------------------------- |
-| Start Recording       | `serverCallId`         | Returns `recordingId` | 
+| Start Recording       | `callConnectionId` or `serverCallId`         | Returns `recordingId` | 
 | Get Recording State   | `recordingId` | Returns `RecordingStateResult`       | 
 | Pause Recording       | `recordingId` | Pausing and resuming call recording enables you to skip recording a portion of a call or meeting, and resume recording to a single file. | 
 | Resume Recording      | `recordingId` | Resumes a Paused recording operation. Content is included in the same file as content from prior to pausing. | 
@@ -149,6 +149,9 @@ Many countries/regions and states have laws and regulations that apply to call r
 
 Regulations around the maintenance of personal data require the ability to export user data. In order to support these requirements, recording metadata files include the `participantId` for each call participant in the `participants` array. You can cross-reference the Azure Communication Services User Identity in the `participants` array with your internal user identities to identify participants in a call. 
 
+## Known Issues ##
+In rare High Availability or Disaster Recovery (HADR) scenarios, a single call recording session may produce multiple recording files that share the same `recordingId` and `chunkId`. In these cases, `StopCallRecording` may return `404 Recording not found` even though recording files are successfully delivered via `RecordingFileStatusUpdated` events. Applications should correlate recordings using `serverCallId` and not assume a one‑to‑one relationship between calls, recording IDs, chunk IDs, and output files.
+
 ## Next steps
 
 > [!div class="nextstepaction"]

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

@@ -20,17 +20,20 @@ You can download the sample app from [GitHub](https://github.com/Azure-Samples/c
 
 ## Before you start
 
-Call Recording APIs use exclusively 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 will receive the `callConnectionId` from the response event from a `createCall`, `answer`, or `connect` requests when initiating the call.
+
+### How to fetch serverCallId
 
 When using [Call Automation](../../../call-automation/callflows-for-customer-interactions.md), you have two options to get the `serverCallId`:
 
 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.
 
 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.
 
-### Calling SDK scenarios
 
 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. 
@@ -49,13 +52,13 @@ CallAutomationClient callAutomationClient = new CallAutomationClient("<ACSConnec
 
 ## 2. Start recording session with StartRecordingOptions using 'StartAsync' 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`.
 
 ```csharp
-StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>")) 
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<callConnectionId> or <ServerCallId>")) 
 {
     RecordingContent = RecordingContent.Audio,
     RecordingChannel = RecordingChannel.Unmixed,
@@ -70,7 +73,7 @@ Response<RecordingStateResult> response = await callAutomationClient.GetCallReco
 Start recording using your designated Azure Blob Storage to store the recorded file once recording is complete.
 
 ```csharp
-StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>"))
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<CallConnectionId> or <ServerCallId>"))
 {
     RecordingContent = RecordingContent.Audio,
     RecordingChannel = RecordingChannel.Unmixed,
@@ -88,7 +91,7 @@ Response<RecordingStateResult> response = await callAutomationClient.GetCallReco
 > **Recordings will need to be resumed for recording file to be generated.**
 
 ```csharp
-StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>")) 
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<CallConnectionId> or <ServerCallId>")) 
 {
     RecordingContent = RecordingContent.Audio,
     RecordingChannel = RecordingChannel.Unmixed,
@@ -105,7 +108,7 @@ Response<RecordingStateResult> response = await callAutomationClient.GetCallReco
 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. 
 
 ```csharp
-StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>")) 
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<CallConnectionId> or <ServerCallId>")) 
 {
     RecordingContent = RecordingContent.Audio,
     RecordingChannel = RecordingChannel.Unmixed,
@@ -121,7 +124,7 @@ Response<RecordingStateResult> response = await callAutomationClient.GetCallReco
 
 ```csharp
 var channelAffinity = new ChannelAffinity(new CommunicationUserIdentifier("<ACS_USER_MRI>")) { Channel = 0};
-StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>"))
+StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<CallConnectionId> or <ServerCallId>"))
 {
    RecordingContent = RecordingContent.Audio,
    RecordingChannel = RecordingChannel.Unmixed,

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

@@ -21,20 +21,22 @@ 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.
@@ -53,13 +55,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 +93,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 +111,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)

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

@@ -20,21 +20,25 @@ You can download the sample app from [GitHub](https://github.com/Azure-Samples/c
 
 ## Before you start
 
-Call Recording APIs use exclusively 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`:
-    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 a CallConnected event](../../../call-automation/callflows-for-customer-interactions.md?pivots=programming-language-javascript#update-programcs) from the Call Automation SDK.
-    2) Once 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 [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.
 
-### Calling SDK scenarios
+### How to fetch serverCallId
 
-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 [Call Automation](../../../call-automation/callflows-for-customer-interactions.md), you have two options to get the `serverCallId`:
 
-Use this example to learn how to [Get a serverCallId](../../get-server-call-id.md) from the Calling Client SDK.
+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.
 
-Let's get started with a few simple steps!
+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. 
+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.
 
 ## 1. Create a Call Automation client
 
@@ -48,13 +52,13 @@ const callAutomationClient = new CallAutomationClient.CallAutomationClient("<ACS
 
 ## 2. Start recording session with StartRecordingOptions using 'StartAsync' 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`.
 
 ```javascript
-var locator: CallLocator = { id: "<ServerCallId>", kind: "serverCallLocator" };
+var locator: CallLocator = { id: "<callConnectionId> or <ServerCallId>", kind: "serverCallLocator" };
 
 var options: StartRecordingOptions =
 {
@@ -91,7 +95,7 @@ var response = await callAutomationClient.getCallRecording().start(options);
 > [!NOTE]
 > **Recordings will need to be resumed for recording file to be generated.**
 ```javascript
-var locator: CallLocator = { id: "<ServerCallId>", kind: "serverCallLocator" };
+var locator: CallLocator = { id: "<callConnectionId> or <ServerCallId>", kind: "serverCallLocator" };
 
 var options: StartRecordingOptions =
 {
@@ -110,7 +114,7 @@ var response = await callAutomationClient.getCallRecording().start(options);
 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.
 
 ```javascript
-var locator: CallLocator = { id: "<ServerCallId>", kind: "serverCallLocator" };
+var locator: CallLocator = { id: "<callConnectionId> or <ServerCallId>", kind: "serverCallLocator" };
 
 var options: StartRecordingOptions =
 {