Merge pull request #281092 from valindrae/closed-captions-GA-changes

Closed captions ga changes

Author: prmerger-automator[bot]

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

@@ -6,24 +6,19 @@ author: Kunaal
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.topic: concept-article
-ms.date: 02/27/2024
+ms.date: 07/08/2024
 ms.author: kpunjabi
 ms.custom: public_preview
 ---
 
 # Closed Captions overview
 
-[!INCLUDE [Public Preview Disclaimer](../../includes/public-preview-include-document.md)]
-
->[!NOTE]
->Closed Captions will not be billed at the beginning of its Public Preview. This is for a limited time only, usage of Captions will likely be billed starting from June.
-
 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:
 
 ## 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.
+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 
 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.
@@ -46,8 +41,6 @@ Interoperability between Azure Communication Services and Microsoft Teams enable
 
 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.
 
-## Known limitations
-- Closed captions feature isn't supported on Firefox. 
 
 ## Next steps
 

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

@@ -5,7 +5,6 @@ author: valindrae
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.topic: include
-ms.topic: include file
 ms.date: 07/21/2023
 ms.author: kpunjabi
 ---

articles/communication-services/quickstarts/voice-video-calling/includes/closed-captions/closed-captions-javascript.md

@@ -1,12 +1,11 @@
 ---
-title: include file
+title: Get started with Closed captions for Web app
 description: Web how-to guide for enabling Closed captions during an ACS call.
 author: Kunaal
 ms.service: azure-communication-services
 ms.subservice: calling
 ms.topic: include
-ms.topic: include file
-ms.date: 12/19/2023
+ms.date: 07/08/2024
 ms.author: kpunjabi
 ---
 
@@ -49,7 +48,7 @@ if (captionsCallFeature.captions.kind === 'Captions') {
 ### Add a listener to receive captions active/inactive status
 ```typescript
 const captionsActiveChangedHandler = () => {
-    if (captions.isCaptionsFeatureActive()) {
+    if (captions.isCaptionsFeatureActive) {
         /* USER CODE HERE - E.G. RENDER TO DOM */
     }
 }
@@ -90,7 +89,7 @@ const captionsReceivedHandler : CaptionsHandler = (data: CaptionsInfo) => {
         captionContainer.style['borderBottom'] = '1px solid';
         captionContainer.style['whiteSpace'] = 'pre-line';
         captionContainer.textContent = captionText;
-        captionContainer.classList.add(newClassName);
+        captionContainer.classList.add(outgoingCaption);
 
         captionArea.appendChild(captionContainer);
     } else {
@@ -106,6 +105,8 @@ captions.on('CaptionsReceived', captionsReceivedHandler);
 
 ### Add a listener to receive spoken language changed status
 ```typescript
+// set a local variable currentSpokenLanguage to track the current spoken language in the call
+let currentSpokenLanguage = ''
 const spokenLanguageChangedHandler = () => {
     if (captions.activeSpokenLanguage !== currentSpokenLanguage) {
         /* USER CODE HERE - E.G. RENDER TO DOM */
@@ -167,3 +168,14 @@ try {
     /* USER ERROR HANDLING CODE HERE */
 }
 ```
+
+### Add a listener to receive captions kind changed status
+Captions kind can change from Captions to TeamsCaptions if a Teams/CTE user joins the call or if the call changes
+to an interop call type. Resubscription to [Teams Captions listeners](../../../../how-tos/calling-sdk/closed-captions-teams-interop-how-to.md) is required to continue the Captions experience. TeamsCaptions kind can not be switched or changed back to Captions kind in a call once TeamsCaptions is utilized in the call.
+
+```typescript
+const captionsKindChangedHandler = () => {
+    /* USER CODE HERE - E.G. SUBSCRIBE TO TEAMS CAPTIONS */
+}
+captions.on('CaptionsKindChanged', captionsKindChangedHandler)
+```