Merge pull request #259882 from KaranMish/main

Local Recording Feature for ACS Web SDK Quickstarts

Author: v-dirichards

articles/communication-services/how-tos/calling-sdk/includes/record-calls/record-calls-locally-web.md

@@ -0,0 +1,70 @@
+---
+author: karanmish
+title: Local recording notification for Teams
+titleSuffix: An Azure Communication Services tutorials document
+description: Show local recording notifications to users joining Teams calls or Teams meetings
+ms.subservice: teams-interop
+ms.service: azure-communication-services
+ms.topic: tutorial
+ms.date: 09/08/2021
+ms.author: karanmishra
+---
+
+### Local recording notification for Teams
+
+Terms of use for Azure Communication Services require developers to show notification to the users, if they are being recorded. Microsoft Teams application allows Teams users to record Teams calls and Teams meetings in the cloud and on Teams desktop app also locally. Developers can use Azure Communication Services Calling SDK to identify whether local or cloud recording has started or stopped. 
+
+Azure Communication Services Calling SDK provides object `Call` to manage calls, that has dedicated features for local recording `LocalRecordingCallFeature` and cloud recording `RecordingCallFeature `. Developers need to implement both features to provide a compliant solution.
+You first need to import calling Features from the Calling SDK:
+
+```js
+import { Features} from "@azure/communication-calling";
+```
+
+Then you can get the local recording feature API object from the call instance:
+
+```js
+const localCallRecordingApi = call.feature(Features.LocalRecording);
+```
+
+Then, to check if the call is being recorded locally, inspect the `isLocalRecordingActive` property of `localCallRecordingApi`. It returns `Boolean`.
+
+```js
+const isLocalRecordingActive = localCallRecordingApi.isLocalRecordingActive;
+```
+
+You can also get a list of local recordings by using the `localRecordings` property of `localCallRecordingApi`. It returns `LocalRecordingInfo[]` which will have the displayName of the user and current state of the local recording.
+
+```js
+const recordings = localCallRecordingApi.localRecordings;
+
+recordings.forEach(r => {
+    console.log("User: ${r.displayName}, State: ${r.state});
+```
+
+You can subscribe to recording changes:
+
+```js
+const isLocalRecordingActiveChangedHandler = () => {
+    console.log(localCallRecordingApi.isLocalRecordingActive);
+};    
+
+localCallRecordingApi.on('isLocalRecordingActiveChanged', isLocalRecordingActiveChangedHandler);
+```
+
+You can also subscribe to `localRecordingsUpdated` and get a collection of updated recordings. This event is triggered whenever there is a recording update
+
+```js
+const localRecordingsUpdatedHandler = (args: { added: SDK.LocalRecordingInfo[], removed: SDK.LocalRecordingInfo[]}) => {
+                        console.log('Local recording started by: ');
+                        args.added?.forEach(a => {
+                            console.log('User: ${a.displayName}');
+                        });
+
+                        console.log('Local recording stopped by: ');
+                        args.removed?.forEach(r => {
+                            console.log('User: ${r.displayName});
+                        });
+                    };
+localCallRecordingApi.on('localRecordingsUpdated', localRecordingsUpdatedHandler);
+```

articles/communication-services/how-tos/calling-sdk/includes/record-calls/record-calls-web.md

@@ -7,10 +7,11 @@ ms.author: rifox
 ---
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
 
-### Record calls
 > [!NOTE]
 > This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment. To use this api please use 'beta' release of Azure Communication Services Calling Web SDK.
 
+### Cloud Recording
+
 Call recording is an extended feature of the core `Call` API. You first need to import calling Features from the Calling SDK:
 
 ```js
@@ -38,3 +39,29 @@ const isRecordingActiveChangedHandler = () => {
 
 callRecordingApi.on('isRecordingActiveChanged', isRecordingActiveChangedHandler);
 ```
+
+You can also get a list of recordings by using the `recordings` property of `callRecordingApi`. It returns `RecordingInfo[]` which will have the displayName of the user and current state of the cloud recording.
+
+```js
+const recordings = callRecordingApi.recordings;
+
+recordings.forEach(r => {
+    console.log("User: ${r.displayName}, State: ${r.state});
+```
+
+You can also subscribe to 'recordingsUpdated' and get a collection of updated recordings. This event is triggered whenever there is a recording update
+
+```js
+const cloudRecordingsUpdatedHandler = (args: { added: SDK.RecordingInfo[], removed: SDK.RecordingInfo[]}) => {
+                        console.log('Recording started by: ');
+                        args.added?.forEach(a => {
+                            console.log('User: ${a.displayName}');
+                        });
+
+                        console.log('Recording stopped by: ');
+                        args.removed?.forEach(r => {
+                            console.log('User: ${r.displayName});
+                        });
+                    };
+callRecordingApi.on('recordingsUpdated', cloudRecordingsUpdatedHandler );
+```

articles/communication-services/how-tos/calling-sdk/record-calls.md

@@ -29,6 +29,7 @@ zone_pivot_groups: acs-plat-web-ios-android-windows
 
 ::: zone pivot="platform-web"
 [!INCLUDE [Record Calls Client-side JavaScript](./includes/record-calls/record-calls-web.md)]
+[!INCLUDE [Local Recording Notification for Teams JavaScript](./includes/record-calls/record-calls-locally-web.md)]
 ::: zone-end
 
 ::: zone pivot="platform-android"