fix errors, add augmented reality

Author: vac0224

articles/communication-services/quickstarts/voice-video-calling/includes/raw-media/raw-media-access-android.md

@@ -520,6 +520,6 @@ This feature gives you access the video frames inside the `IncomingVideoStream`
     }
     ```
 
-## Next steps
+## Sample code
 
 - Use the sample app on GitHub at [Raw Video](https://github.com/Azure-Samples/communication-services-android-quickstarts/tree/main/RawVideo).

articles/communication-services/quickstarts/voice-video-calling/includes/raw-media/raw-media-access-ios.md

@@ -682,6 +682,6 @@ This feature gives you access the video frames inside `IncomingVideoStream` to m
     }
     ```
 
-## Next steps
+## Sample code
 
 - Use the sample app on GitHub at [Raw Video](https://github.com/Azure-Samples/communication-services-ios-quickstarts/tree/main/raw-video).

articles/communication-services/quickstarts/voice-video-calling/includes/raw-media/raw-media-access-windows.md

@@ -610,6 +610,6 @@ This feature gives you access the video frames inside the `IncomingVideoStream`
     }
     ```
 
-## Next steps
+## Sample code
 
 - Use the sample app on GitHub at [Raw Video](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/RawVideo).

articles/communication-services/tutorials/add-video-augmented-reality-tutorial.md

@@ -1,29 +1,28 @@
 ---
-title: Tutorial - Add Augmented Reality filter to your app
-titleSuffix: An Azure Communication Services tutorial
-description: In this tutorial, you learn how to add Augmented Reality filter to your app using Azure Communication Services and other effects SDKs.
+title: Add augmented reality filters to video calls
+titleSuffix: An Azure Communication Services article
+description: This article describes how to add an augmented reality filter to your app using Azure Communication Services and other effects SDKs.
 author: sloanster
 services: azure-communication-services
 
 ms.author: micahvivion
-ms.date: 01/15/2024
+ms.date: 06/24/2025
 ms.topic: tutorial
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.custom: mode-other
 ---
 
-# Tutorial: How to add Augmented Reality filters to your video calls
+# Add augmented reality filters to video calls
 
 > [!NOTE]
-> DeepAR SDK is third-party software which is licensed under its own terms. Microsoft does not make any representations or warranties concerning the use of third-party software.
+> DeepAR SDK is third-party software, which is licensed under its own terms. Microsoft doesn't make any representations or warranties concerning the use of third-party software.
 
-In some usage scenarios, you may want to apply some video processing to the original camera video, such as background blur or background replacement.
-This can provide a better user experience.
-The Azure Communication Calling video effects package provides several video processing functions. However, this isn't the only choice.
-You can also integrate other video effects library with ACS raw media access API.
+In some usage scenarios, you might want to apply some video processing to the original camera video, such as background blur or background replacement. This change can provide a better user experience.
 
-We'll use DeepAR SDK(https://www.deepar.ai/) as an example to show how to integrate other effects libraries with ACS Calling SDK. 
+The Azure Communication Calling video effects package provides several video processing functions. However, this isn't the only choice. You can also integrate other video effects library with Azure Communication Services raw media access API.
+
+We use DeepAR SDK(https://www.deepar.ai/) as an example to show how to integrate other effects libraries with Azure Communication Services Calling SDK. 
 Let's try DeepAR to enrich your video with Augmented Reality!
 
 ## Prerequisites
@@ -33,20 +32,20 @@ Let's try DeepAR to enrich your video with Augmented Reality!
 - An Azure Communication Services voice and video calling enabled client. [Add video calling to your app](../quickstarts/voice-video-calling/get-started-with-video-calling.md?pivots=platform-web).
 - DeepAR license key. [Getting started | DeepAR](https://docs.deepar.ai/deepar-sdk/platforms/web/getting-started).
 
-## How video input and output work between ACS Web SDK and DeepAR
-Both ACS Web SDK and DeepAR can read the camera device list and get the video stream directly from the device.
-We want to provide consistency in the app, and DeepAR SDK provides a way for us to directly input a video stream acquired from ACS Web SDK.
-Similarly, ACS Web SDK needs the processed video stream output from DeepAR SDK and sends this video stream to the remote endpoint.
-DeepAR offers the option to use a canvas as an output. ACS Web SDK can consume the raw video stream captured from the canvas.
+## How video input and output work between Azure Communication Services Web SDK and DeepAR
 
-Here's the data flow:
+Both Azure Communication Services Web SDK and DeepAR can read the camera device list and get the video stream directly from the device. We want to provide consistency in the app, and DeepAR SDK provides a way for us to directly input a video stream acquired from Azure Communication Services Web SDK.
 
-:::image type="content" source="./media/ar/videoflow.png" alt-text="The diagram of data flow between ACS SDK and DeepAR SDK.":::
+Similarly, Azure Communication Services Web SDK needs the processed video stream output from DeepAR SDK and sends the video stream to the remote endpoint. DeepAR offers the option to use a canvas as an output. Azure Communication Services Web SDK can consume the raw video stream captured from the canvas.
+
+Here's the data flow:
 
+:::image type="content" source="./media/ar/videoflow.png" alt-text="The diagram of data flow between Azure Communication Services SDK and DeepAR SDK.":::
 
 ## Initialize DeepAR SDK
 
-To enable DeepAR filters, you need to initialize DeepAR SDK, this can be done by invoking `deepar.initialize` API.
+To enable DeepAR filters, you need to initialize DeepAR SDK. Use the following code to invoke `deepar.initialize` API.
+
 ```javascript
 const canvas = document.createElement('canvas');
 const deepAR = await deepar.initialize({
@@ -59,21 +58,26 @@ const deepAR = await deepar.initialize({
     }
 });
 ```
-Here we disable the default camera because we want ACS Web SDK to provide the source video stream.
-The canvas is required as this provides a way for ACS Web SDK to consume the video output from DeepAR SDK.
+
+Here we disable the default camera because we want Azure Communication Services Web SDK to provide the source video stream.
+
+The canvas is required for Azure Communication Services Web SDK to consume the video output from DeepAR SDK.
 
 ## Connect the input and output
 
 To start a video call, you need to create a `LocalVideoStream` object as the video input in SDK.
+
 ```javascript
 const deviceManager = await callClient.getDeviceManager();
 const cameras = await deviceManager.getCameras();
 const camera = cameras[0]
 const localVideoStream = new LocalVideoStream(camera);
 await call.startVideo(localVideoStream);
 ```
-By doing this, ACS SDK directly sends out the video from camera without processed by DeepAR.
-We need to create a path to forward the video acquired from ACS SDK to DeepAR SDK.
+
+When you start the video call, Azure Communication Services SDK directly sends out the video from camera without processed by DeepAR.
+
+We need to create a path to forward the video acquired from Azure Communication Services SDK to DeepAR SDK.
 
 ```javascript
 const deviceManager = await callClient.getDeviceManager();
@@ -91,7 +95,8 @@ video.autoplay = true;
 video.srcObject = inputMediaStream;
 deepAR.setVideoElement(video, true);
 ```
-Now we have finished configuring the input video. To configure the output video, we need another `LocalVideoStream`.
+
+Now we finished configuring the input video. To configure the output video, we need another `LocalVideoStream`.
 
 ```javascript
 const outputMediaStream = canvas.captureStream(30);
@@ -102,27 +107,29 @@ await call.startVideo(outputVideoStream);
 ## Start the effect
 
 In DeepAR, effects and background processing are independent, which means you can apply the filter while enabling the background blur or background replacement.
+
 ```javascript
 // apply the effect
 await deepAR.switchEffect('https://cdn.jsdelivr.net/npm/deepar/effects/lion');
 // enable the background blur
 await deepAR.backgroundBlur(true, 8);
-
 ```
-:::image type="content" source="./media/ar/screenshot.png" alt-text="Screenshot of the video effect.":::
+
+:::image type="content" source="./media/ar/screenshot.png" alt-text="Screen capture of the DeepAR background replacement video effect.":::
 
 ## Stop the effect
 
 If you want to stop the effect, you can invoke `deepar.clearEffect` API
 ```javascript
 await deepAR.clearEffect();
 ```
+
 To disable the background blur, you can pass `false` to `deepar.backgroundBlur` API.
 
 ## Disable DeepAR during the video call
 
-In case you want to disable DeepAR during the video call.
-You need to call `deepar.stopVideo`.
+In case you want to disable DeepAR during the video call, you need to call `deepar.stopVideo`.
+
 Invoking `deepar.stopVideo` also ends the current media stream captured from the canvas.
 
 ```javascript
@@ -131,8 +138,7 @@ await deepAR.stopVideo();
 ```
 
 ## Next steps
-For more information, see the following articles:
 
 - Learn about [Video effects](../quickstarts/voice-video-calling/get-started-video-effects.md?pivots=platform-web).
 - Learn more about [Manage video during calls](../how-tos/calling-sdk/manage-video.md?pivots=platform-web).
-- DeepAR documentation. [Getting started | DeepAR](https://docs.deepar.ai/deepar-sdk/platforms/web/getting-started).
+- Learn about DeepAR at [Getting started | DeepAR](https://docs.deepar.ai/deepar-sdk/platforms/web/getting-started).