Merge pull request #239579 from jsaurezlee-msft/master

Windows SDK GA updates (#8)

Author: Court72

articles/communication-services/how-tos/calling-sdk/call-transcription.md

@@ -9,7 +9,7 @@ ms.subservice: calling
 ms.topic: how-to 
 ms.date: 08/10/2021
 ms.custom: template-how-to
-zone_pivot_groups: acs-plat-ios-android
+zone_pivot_groups: acs-plat-ios-android-windows
 
 #Customer intent: As a developer, I want to display the call transcription state on the client.
 ---
@@ -36,6 +36,10 @@ When using call transcription you may want to let your users know that a call is
 [!INCLUDE [Call transcription client-side iOS](./includes/call-transcription/call-transcription-ios.md)]
 ::: zone-end
 
+::: zone pivot="platform-windows"
+[!INCLUDE [Call transcription client-side Windows](./includes/call-transcription/call-transcription-windows.md)]
+::: zone-end
+
 ## Next steps
 - [Learn how to manage video](./manage-video.md)
 - [Learn how to manage calls](./manage-calls.md)

articles/communication-services/how-tos/calling-sdk/includes/call-transcription/call-transcription-windows.md

@@ -0,0 +1,31 @@
+---
+author: jsaurezlee-msft
+ms.service: azure-communication-services
+ms.topic: include
+ms.date: 05/30/2023
+ms.author: jsaurezlee
+---
+
+[!INCLUDE [Install SDK](../install-sdk/install-sdk-windows.md)]
+
+Call transcription is an extended feature of the core `Call` object. You first need to obtain the transcription feature object:
+
+```csharp
+TranscriptionCallFeature transcriptionFeature = call.Features.Transcription;
+```
+
+Then, to check if the call is being transcribed, inspect the `IsTranscriptionActive` property of `transcriptionFeature`. It returns `boolean`.
+
+```csharp
+boolean isTranscriptionActive = transcriptionFeature.isTranscriptionActive;
+```
+
+You can also subscribe to changes in transcription:
+
+```csharp
+private async void Call__OnIsTranscriptionActiveChanged(object sender, PropertyChangedEventArgs args)
+    boolean isTranscriptionActive = transcriptionFeature.IsTranscriptionActive();
+}
+
+transcriptionFeature.IsTranscriptionActiveChanged += Call__OnIsTranscriptionActiveChanged;
+```

articles/communication-services/how-tos/calling-sdk/includes/dominant-speaker/dominant-speaker-android.md

@@ -7,34 +7,32 @@ ms.author: jsaurezlee
 ---
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-android.md)]
 
-[!INCLUDE [public-preview-notes](../../../../includes/public-preview-include.md)]
-
 [!INCLUDE [common](dominant-speaker-common.md)]
 
 In order to use the Dominant Speakers call feature for Android, the first step is to obtain the Dominant Speakers feature API object:
 
 ```java
-DominantSpeakersFeature dominantSpeakersFeature = call.feature(Features.DominantSpeakers);
+DominantSpeakersFeature dominantSpeakersFeature = call.feature(Features.DOMINANT_SPEAKERS);
 ```
 The Dominant Speakers feature object have the following API structure:
 - `OnDominantSpeakersChanged`: Event for listening for changes in the dominant speakers list.
 - `getDominantSpeakersInfo()`: Gets the `DominantSpeakersInfo` object. This object has:
     - `getSpeakers()`: A list of participant identifiers representing the dominant speakers list.
-    - `getTimestamp()`: The date when the dominant speakers list was updated. 
+    - `getLastUpdatedAt()`: The date when the dominant speakers list was updated. 
 
 To subscribe to changes in the Dominant Speakers list:
 
 ```java
 
 // Obtain the extended feature object from the call object.
-DominantSpeakersFeature dominantSpeakersFeature = call.feature(Features.DominantSpeakers);
+DominantSpeakersFeature dominantSpeakersFeature = call.feature(Features.DOMINANT_SPEAKERS);
 // Subscribe to the OnDominantSpeakersChanged event.
 dominantSpeakersFeature.addOnDominantSpeakersChangedListener(handleDominantSpeakersChangedlistener);
 
 private void handleCallOnDominantSpeakersChanged(PropertyChangedEvent args) {
     // When the list changes, get the timestamp of the last change and the current list of Dominant Speakers
     DominantSpeakersInfo dominantSpeakersInfo = dominantSpeakersFeature.getDominantSpeakersInfo();
-    Date timestamp = dominantSpeakersInfo.getTimestamp();
+    Date timestamp = dominantSpeakersInfo.getLastUpdatedAt();
     List<CommunicationIdentifier> dominantSpeakers = dominantSpeakersInfo.getSpeakers();
 }
 ```

articles/communication-services/how-tos/calling-sdk/includes/dominant-speaker/dominant-speaker-ios.md

@@ -8,8 +8,6 @@ ms.author: jsaurezlee
 
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-ios.md)]
 
-[!INCLUDE [public-preview-notes](../../../../includes/public-preview-include.md)]
-
 [!INCLUDE [common](dominant-speaker-common.md)]
 
 In order to use the Dominant Speakers call feature for iOS, the first step is to obtain the Dominant Speakers feature API object:
@@ -21,7 +19,7 @@ The Dominant Speakers feature object have the following API structure:
 - `didChangeDominantSpeakers`: Event for listening for changes in the dominant speakers list.
 - `dominantSpeakersInfo`: Which gets the `DominantSpeakersInfo` object. This object has:
     - `speakers`: A list of participant identifiers representing the dominant speakers list.
-    - `timestamp`: The date when the dominant speakers list was updated.
+    - `lastUpdatedAt`: The date when the dominant speakers list was updated.
 
 To subscribe to changes in the dominant speakers list:
 
@@ -36,7 +34,7 @@ public class DominantSpeakersDelegate : DominantSpeakersCallFeatureDelegate
     public func dominantSpeakersCallFeature(_ dominantSpeakersCallFeature: DominantSpeakersCallFeature, didChangeDominantSpeakers args: PropertyChangedEventArgs) {
         // When the list changes, get the timestamp of the last change and the current list of Dominant Speakers
         let dominantSpeakersInfo = dominantSpeakersCallFeature.dominantSpeakersInfo
-        let timestamp = dominantSpeakersInfo.timestamp
+        let timestamp = dominantSpeakersInfo.lastUpdatedAt
         let dominantSpeakersList = dominantSpeakersInfo.speakers
     }
 }

articles/communication-services/how-tos/calling-sdk/includes/dominant-speaker/dominant-speaker-windows.md

@@ -8,33 +8,31 @@ ms.author: jsaurezlee
 
 [!INCLUDE [Install SDK](../install-sdk/install-sdk-windows.md)]
 
-[!INCLUDE [public-preview-notes](../../../../includes/public-preview-include.md)]
-
 [!INCLUDE [common](dominant-speaker-common.md)]
 
 In order to use the Dominant Speakers call feature for Windows, the first step is to obtain the Dominant Speakers feature API object:
 
 ```csharp
-DominantSpeakersCallFeature dominantSpeakersFeature = (DominantSpeakersCallFeature)call.GetCallFeatureExtension(HandleType.DominantSpeakersCallFeature);
+DominantSpeakersCallFeature dominantSpeakersFeature = call.Features.DominantSpeakers;
 ```
 
 The Dominant Speakers feature object have the following API structure:
 - `OnDominantSpeakersChanged`: Event for listening for changes in the dominant speakers list.
 - `DominantSpeakersInfo`: Gets the `DominantSpeakersInfo` object. This object has:
     - `Speakers`: A list of participant identifiers representing the dominant speakers list.
-    - `Timestamp`: The date when the dominant speakers list was updated. 
+    - `LastUpdatedAt`: The date when the dominant speakers list was updated. 
 
 To subscribe to changes in the dominant speakers list:
 ```csharp
 // Obtain the extended feature object from the call object.
-DominantSpeakersFeature dominantSpeakersFeature = (DominantSpeakersCallFeature)call.GetCallFeatureExtension(HandleType.DominantSpeakersCallFeature);
+DominantSpeakersFeature dominantSpeakersFeature = call.Features.DominantSpeakers;
 // Subscribe to the OnDominantSpeakersChanged event.
 dominantSpeakersFeature.OnDominantSpeakersChanged += DominantSpeakersFeature__OnDominantSpeakersChanged;
 
 private void DominantSpeakersFeature__OnDominantSpeakersChanged(object sender, PropertyChangedEventArgs args) {
   // When the list changes, get the timestamp of the last change and the current list of Dominant Speakers
   DominantSpeakersInfo dominantSpeakersInfo = dominantSpeakersFeature.DominantSpeakersInfo;
-  DateTimeOffset date = dominantSpeakersInfo.Timestamp;
+  DateTimeOffset date = dominantSpeakersInfo.LastUpdatedAt;
   IReadOnlyList<ICommunicationIdentifier> speakersList = dominantSpeakersInfo.Speakers;
 }
 ```

articles/communication-services/how-tos/calling-sdk/includes/install-sdk/install-sdk-windows.md

@@ -9,7 +9,7 @@ ms.author: rifox
 
 ### Creating the Visual Studio project
 
-For UWP app, in Visual Studio 2019, create a new `Blank App (Universal Windows)` project. After entering the project name, feel free to pick any Windows SDK greater than `10.0.17134`. 
+For UWP app, in Visual Studio 2022, create a new `Blank App (Universal Windows)` project. After entering the project name, feel free to pick any Windows SDK greater than `10.0.17134`. 
 
 For WinUI 3 app, create a new project with the `Blank App, Packaged (WinUI 3 in Desktop)` template to set up a single-page WinUI 3 app. [Windows App SDK version 1.2 preview 2](https://learn.microsoft.com/windows/apps/windows-app-sdk/preview-channel#version-12-preview-2-120-preview2) and above is required.
 ### Install the package and dependencies with NuGet Package Manager
@@ -18,8 +18,7 @@ The Calling SDK APIs and libraries are publicly available via a NuGet package.
 The following steps exemplify how to find, download, and install the Calling SDK NuGet package.
 
 1. Open NuGet Package Manager (`Tools` -> `NuGet Package Manager` -> `Manage NuGet Packages for Solution`)
-2. Click on `Browse` and then type `Azure.Communication.Calling` in the search box.
-3. Make sure that `Include prerelease` check box is selected.
-4. Click on the `Azure.Communication.Calling` package, select `Azure.Communication.Calling` [1.0.0-beta.33](https://www.nuget.org/packages/Azure.Communication.Calling/1.0.0-beta.33) or newer version.
+2. Click on `Browse` and then type `Azure.Communication.Calling.WindowsClient` in the search box.
+4. Click on the `Azure.Communication.Calling.WindowsClient` package, select `Azure.Communication.Calling` [1.0.0](https://www.nuget.org/packages/Azure.Communication.Calling.WindowsClient/1.0.0) or newer version.
 5. Select the checkbox corresponding to the CS project on the right-side tab.
-6. Click on the `Install` button.
+6. Click on the `Install` button.

articles/communication-services/how-tos/calling-sdk/includes/manage-calls/manage-calls-windows.md

@@ -44,7 +44,7 @@ The following steps inform the C# compiler about these namespaces allowing Visua
 
 ```csharp
 using Azure.Communication;
-using Azure.Communication.Calling;
+using Azure.Communication.Calling.WindowsClient;
 ```
 
 Keep `MainPage.xaml.cs` or `MainWindows.xaml.cs` open. The next steps will add more code to it.
@@ -85,30 +85,30 @@ The following classes and interfaces handle some of the major features of the Az
 | ------------------------------------- | ------------------------------------------------------------ |
 | `CallClient` | The `CallClient` is the main entry point to the Calling client library. |
 | `CallAgent` | The `CallAgent` is used to start and join calls. |
-| `Call` | The `Call` is used to manage placed or joined calls. |
+| `CommunicationCall` | The `CommunicationCall` is used to manage placed or joined calls. |
 | `CommunicationTokenCredential` | The `CommunicationTokenCredential` is used as the token credential to instantiate the `CallAgent`.|
 | `CallAgentOptions` | The `CallAgentOptions` contains information to identify the caller. |
 | `HangupOptions` | The `HangupOptions` informs if a call should be terminated to all its participants. |
 
 ## Initialize the CallAgent
 
-To create a `CallAgent` instance from `CallClient`, you must use `CallClient.CreateCallAgent` method that asynchronously returns a `CallAgent` object once it's initialized.
+To create a `CallAgent` instance from `CallClient`, you must use `CallClient.CreateCallAgentAsync` method that asynchronously returns a `CallAgent` object once it's initialized.
 
-To create `CallAgent`, you must pass a `CommunicationTokenCredential` object and a `CallAgentOptions` object. Keep in mind that `CommunicationTokenCredential` throws if a malformed token is passed.
+To create `CallAgent`, you must pass a `CallTokenCredential` object and a `CallAgentOptions` object. Keep in mind that `CallTokenCredential` throws if a malformed token is passed.
 
 The following code should be added inside and helper function to be called in app initialization.
 
 ```csharp
 var callClient = new CallClient();
-this.deviceManager = await callClient.GetDeviceManager();
+this.deviceManager = await callClient.GetDeviceManagerAsync();
 
-var tokenCredential = new CommunicationTokenCredential("<AUTHENTICATION_TOKEN>");
+var tokenCredential = new CallTokenCredential("<AUTHENTICATION_TOKEN>");
 var callAgentOptions = new CallAgentOptions()
 {
     DisplayName = "<DISPLAY_NAME>"
 };
 
-this.callAgent = await callClient.CreateCallAgent(tokenCredential, callAgentOptions);
+this.callAgent = await callClient.CreateCallAgentAsync(tokenCredential, callAgentOptions);
 ```
 
 Change the `<AUTHENTICATION_TOKEN>` with a valid credential token for your resource. Refer to the [user access token](../../../../quickstarts/identity/access-tokens.md) documentation if a credential token has to be sourced.