closed caption

Author: vac0224

articles/communication-services/concepts/voice-video-calling/closed-captions.md

@@ -1,49 +1,51 @@
 ---
-title: Azure Communication Services Closed Caption overview
-titleSuffix: An Azure Communication Services concept document
-description: Learn about the Azure Communication Services Closed Captions.
+title: Closed captions overview
+titleSuffix: An Azure Communication Services article
+description: This article describes the Azure Communication Services Closed captions feature.
 author: Kunaal
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.topic: concept-article
-ms.date: 07/08/2024
+ms.date: 06/25/2025
 ms.author: kpunjabi
 ms.custom: public_preview
 ---
 
-# Closed Captions overview
+# Closed captions overview
 
-Closed captions are a textual representation of a voice or video conversation that is displayed to users in real-time. Azure Communication Services Closed captions offer developers the ability to allow users to select when they wish to toggle captions on or off. These captions are only available during the call/meeting for the user that has selected to enable captions, Azure Communication Services does **not** store these captions anywhere. Here are main scenarios where Closed Captions are useful:
+Closed captions are a textual representation of a voice or video conversation that is displayed to users in real-time. Azure Communication Services Closed captions offer developers the ability to allow users to select when they wish to toggle captions on or off. These captions are only available during the call/meeting for the user that enabled captions. Azure Communication Services does **not** store these captions anywhere. Here are main scenarios where closed captions are useful:
 
 ## Common use cases
 
 ### Building accessible experiences
-Accessibility – For people with hearing impairments or who are new to the language to participate in calls and meetings. A key feature requirement in the Telemedical industry is to help patients communicate effectively with their health care providers. This can also be useful when you have scenarios where users might be joining from a PSTN phone number, this will allow your application to receive the captioning data for those users too so that everyone's input is available during these interactions.
 
-### Teams interoperability 
+Accessibility – For people with hearing impairments or who are new to the language to participate in calls and meetings. A key feature requirement in the Telemedical industry is to help patients communicate effectively with their health care providers. This feature can also be useful when you have scenarios where users might be joining from a public switched telephone network (PSTN) phone number. Now your application can receive the captioning data for those users too so that everyone's input is available during interactions.
+
+### Teams interoperability
+
 Use Teams – Organizations using Azure Communication Services and Teams can use Teams closed captions to improve their applications by providing closed captions capabilities to users. Those organizations can keep using Microsoft Teams for all calls and meetings without third party applications providing this capability. Learn more about how you can use captions in [Teams interoperability](../interop/enable-closed-captions.md) scenarios.
 
 ### Global inclusivity 
-Provide translation – Use the translation functions provided to provide translated captions for users who may be new to the language or for companies that operate at a global scale and have offices around the world, their teams can have conversations even if some people might not be familiar with the spoken language.
+Provide translation – Use the translation functions provided to provide translated captions for users who might be new to the language or for companies that operate at a global scale and have offices around the world, their teams can have conversations even if some people might not be familiar with the spoken language.
 
 ![closed captions work flow](../media/call-closed-caption.png)
 
-## When to use Closed Captions
+## When to use closed captions
 
-- Closed Captions help maintain concentration and engagement, which can provide a better experience for viewers with learning disabilities, a language barrier, attention deficit disorder, or hearing impairment. 
-- Closed Captions allow participants to be on the call in loud or sound-sensitive environments.
+- Closed captions help maintain concentration and engagement, which can provide a better experience for viewers with learning disabilities, a language barrier, attention deficit disorder, or hearing impairment. 
+- Closed captions enable participants to be on the call in loud or sound-sensitive environments.
 
 ## Privacy concerns
 
-Closed captions are only available during the call or meeting for the participant that has selected to enable captions, Azure Communication Services doesn't store these captions anywhere. Many countries/regions and states have laws and regulations that apply to storing of data. It is your responsibility to use the closed captions in compliance with the law should you choose to store any of the data generated through closed captions. You must obtain consent from the parties involved in a manner that complies with the laws applicable to each participant. 
+Closed captions are only available during the call or meeting for the participant that selected to enable captions, Azure Communication Services doesn't store these captions anywhere. Many countries/regions and states have laws and regulations that apply to storing of data. It is your responsibility to use the closed captions in compliance with the law should you choose to store any of the data generated through closed captions. You must obtain consent from the parties involved in a manner that complies with the laws applicable to each participant. 
 
-Interoperability between Azure Communication Services and Microsoft Teams enables your applications and users to participate in Teams calls, meetings, and chats. It is your responsibility to ensure that the users of your application are notified when closed captions are enabled in a Teams call or meeting and being stored.
+Interoperability between Azure Communication Services and Microsoft Teams enables your applications and users to participate in Teams calls, meetings, and chats. You need to notify users of your application closed captions are enabled in a Teams call or meeting and are being stored.
 
-Microsoft indicates to you via the Azure Communication Services API that recording or closed captions has commenced, and you must communicate this fact, in real-time, to your users within your application's user interface. You agree to indemnify Microsoft for all costs and damages incurred due to your failure to comply with this obligation.
+Microsoft indicates to you via the Azure Communication Services API that recording or closed captions started. You need to communicate this, in real-time, to your users within your application's user interface. You agree to indemnify Microsoft for all costs and damages incurred due to your failure to comply with this obligation.
 
 
 ## Next steps
 
-- Get started with a [Closed Captions Quickstart](../../quickstarts/voice-video-calling/get-started-with-closed-captions.md)
+- [Enable closed captions](../../quickstarts/voice-video-calling/get-started-with-closed-captions.md).
 - Learn more about using closed captions in [Teams interop](../interop/enable-closed-captions.md) scenarios.
 - Learn more about the [UI Library](../ui-library/ui-library-overview.md).

articles/communication-services/concepts/voice-video-calling/retrieve-support-files.md

@@ -1,18 +1,19 @@
 ---
-title: Collecting user feedback in native calling scenarios
-description: Understand how to provide effective user feedback.
+title: User support
+titleSuffix: An Azure Communication Services article
+description: This article describes how to provide effective user feedback.
 author:      ahammer
 ms.author:   adamhammer
 ms.service:  azure-communication-services
 ms.topic:    conceptual
-ms.date:     07/17/2023
+ms.date:     06/28/2025
 ---
 
 # Collecting user feedback in native calling scenarios
 
 ## Introduction
 
-As a third-party library, we must acknowledge that diagnostic data, crucial for troubleshooting, resides on end user mobile devices. Our support model hinges on a symbiotic relationship: to assist your customers effectively, we must ensure you're equipped to do so. This documentation outlines the methodologies to collect diagnostic data when a user reports an issue.
+As a third-party library, we acknowledge that diagnostic data, crucial for troubleshooting, resides on end user mobile devices. Our support model hinges on a symbiotic relationship: to assist your customers effectively, we must ensure you're equipped to do so. This article outlines methods to collect diagnostic data when a user reports an issue.
 
 ### Key development concerns
 
@@ -83,4 +84,4 @@ For developers utilizing the Calling SDK or the ACS UI Library, consider the fol
 
 ## Conclusion
 
-This guide emphasizes the necessity of efficiently collecting and transmitting diagnostic data for effective user support in native calling applications. Employing these strategies enables the rapid diagnosis and resolution of user issues, improving the app's performance and user satisfaction. 
+This guide emphasizes how to efficiently collect and transmit diagnostic data for user support in native calling applications. Employing these strategies enables the rapid diagnosis and resolution of user issues, improving app performance and user satisfaction. 

articles/communication-services/concepts/voice-video-calling/user-experience.md

@@ -6,19 +6,23 @@ manager: chpalm
 services: azure-communication-services
 
 ms.author: tchladek
-ms.date: 07/13/2023
+ms.date: 06/28/2025
 ms.topic: tutorial
 ms.service: azure-communication-services
 ms.subservice: teams-interop
 ---
 
 # User experience
-Developers strive to bring the best user experience to their users. Azure Communication Services is integrating the best practices into the UI library, but if you are building your user interface, here are some tools to help you achieve the best user experience.
 
+Developers strive to bring the best user experience to their users. Azure Communication Services is integrating the best practices into the UI library, but if you're building your user interface, here are some tools to help you achieve the best user experience.
 
-## Hide buttons that are not enabled
-Developers building their audio and video experience with Azure Communication Services calling SDK are facing issues that some actions available in the calling SDK are unavailable for a given call type, role, meeting, or tenant. This issue leads to undesired situations when users see a button to, for example, share screen. Still, this action fails because the user cannot share the screen. Capability API is the tool that helps you render just the actions that apply to the user in the current context. You can learn more about [Capability APIs here](../../how-tos/calling-sdk/capabilities.md).
+## Hide buttons that aren't enabled
+
+Developers building their audio and video experience with Azure Communication Services calling SDK are facing issues that some actions available in the calling SDK are unavailable for a given call type, role, meeting, or tenant. This issue leads to undesired situations when users see a button to, for example, share screen. Still, this action fails because the user can't share the screen.
+
+The Capability API helps you render just the actions that apply to the user in the current context. For more information, see [Capability APIs](../../how-tos/calling-sdk/capabilities.md).
 
 ## Next steps
-- Learn more about [Capability APIs](../../how-tos/calling-sdk/capabilities.md).
-- [Troubleshooting VoIP call quality](./troubleshoot-web-voip-quality.md)
+
+- [Capability APIs](../../how-tos/calling-sdk/capabilities.md).
+- [Troubleshooting VoIP call quality](./troubleshoot-web-voip-quality.md).

articles/communication-services/how-tos/calling-sdk/closed-captions-teams-interop-how-to.md

@@ -1,21 +1,21 @@
 ---
-title: Enable Closed captions during a call
-titleSuffix: An Azure Communication Services how-to document
-description: Provides a how-to guide enabling Closed captions during a call.
+title: Enable closed captions for Teams interop
+titleSuffix: An Azure Communication Services article
+description: This article describes how to enable closed captions during a call.
 author: kunaal
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.topic: include
-ms.date: 03/20/2023
+ms.date: 06/28/2025
 ms.author: kpunjabi
 ms.custom: private_preview
 services: azure-communication-services
 zone_pivot_groups: acs-plat-web-ios-android-windows
 ---
 
-# Enable Closed captions for Teams interoperability
+# Enable closed captions for Teams interop
 
-Learn how to allow your users to enable closed captions during a Teams interoperability scenario where your users might be in a meeting between an Azure Communication Services user and a Teams client user, or where your users are using Azure Communication Services calling SDK with their Microsoft 365 identity. 
+Provide your users with the option to enable closed captions during a Teams interoperability scenario. If your users are in a meeting between an Azure Communication Services user and a Teams client user, or when your users are using Azure Communication Services calling SDK with their Microsoft 365 identity.
 
 ::: zone pivot="platform-windows"
 [!INCLUDE [Closed captions with Windows](./includes/closed-captions/closed-captions-teams-interop-windows.md)]
@@ -39,7 +39,6 @@ If you want to clean up and remove a Communication Services subscription, you ca
 
 ## Next steps
 
-For more information, see the following articles:
 - Learn about [Voice](./manage-calls.md) and [Video calling](./manage-video.md).
 - Learn about [Teams interoperability](./teams-interoperability.md).
 - Learn more about Microsoft Teams [live translated captions](https://support.microsoft.com//office/use-live-captions-in-a-teams-meeting-4be2d304-f675-4b57-8347-cbd000a21260).

articles/communication-services/how-tos/calling-sdk/includes/closed-captions/closed-captions-teams-interop-android.md

@@ -1,27 +1,29 @@
 ---
 title: include file
-description: Android how-to guide for enabling Closed captions during a Teams interop call.
+description: Android article to enable closed captions during a Teams interop call.
 author: Kunaal
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.topic: include
 ms.topic: include file
-ms.date: 07/21/2023
+ms.date: 06/28/2025
 ms.author: kpunjabi
 ---
 
 ## Prerequisites
-- Azure account with an active subscription, for details see [Create an account for free.](https://azure.microsoft.com/free/)
+
+- Azure account with an active subscription, for details see [Create an account for free](https://azure.microsoft.com/free/).
 - Azure Communication Services resource. See [Create an Azure Communication Services resource](../../../../quickstarts/create-communication-resource.md?tabs=windows&pivots=platform-azp). Save the connection string for this resource. 
 - An app with voice and video calling, refer to our [Voice](../../../../quickstarts/voice-video-calling/getting-started-with-calling.md) and [Video](../../../../quickstarts/voice-video-calling/get-started-with-video-calling.md) calling quickstarts.
 - [Access tokens](../../../../quickstarts/manage-teams-identity.md) for Microsoft 365 users. 
 - [Access tokens](../../../../quickstarts/identity/access-tokens.md) for External identity users.
 - For Translated captions, you need to have a [Teams premium](/MicrosoftTeams/teams-add-on-licensing/licensing-enhance-teams#meetings) license.  
 
 > [!NOTE]
-> Please note that you will need to have a voice calling app using Azure Communication Services calling SDKs to access the closed captions feature that is described in this guide.
+> You need to have a voice calling app using Azure Communication Services calling SDKs to access the closed captions feature that is described in this guide.
 
 ## Models
+
 | Name                       | Description                                               |
 | -------------------------- | --------------------------------------------------------- |
 | CaptionsCallFeature        | API for captions call feature                             |
@@ -114,7 +116,7 @@ public void addOnActiveCaptionLanguageChangedListener() {
 
 ## Start captions
 
-Once you've set up all your listeners, you can now start adding captions.
+Once you set up all your listeners, you can start adding captions.
 
 ``` java
 public void startCaptions() {
@@ -149,14 +151,16 @@ public void removeOnCaptionsReceivedListener() {
 ## Spoken language support 
 
 ### Get list of supported spoken languages
+
 Get a list of supported spoken languages that your users can select from when enabling closed captions. 
 
 ``` java
 // bcp 47 formatted language code
 teamsCaptions.getSupportedSpokenLanguages();
 ```
 
-### Set spoken language 
+### Set spoken language
+
 When the user selects the spoken language, your app can set the spoken language that it expects captions to be generated from. 
 
 ``` java 
@@ -172,7 +176,7 @@ public void setSpokenLanguage() {
 
 ### Get supported caption language 
 
-If your organization has an active Teams premium license, then your Azure Communication Services users can enable translated captions as long as the organizer of the meeting has a Teams premium license. As for users with Microsoft 365 identities this check is done against their own user account if they meeting organizer doesn't have a Teams premium license.
+If your organization has an active Teams premium license, then your Azure Communication Services users can enable translated captions as long as the organizer of the meeting has a Teams premium license. For users with Microsoft 365 identities, this check is done against their own user account if they meeting organizer doesn't have a Teams premium license.
 
 ``` java
 // ISO 639-1 formatted language code