Merge pull request #263069 from tophpalmer/master

Jill Grant · web-flow · commit 2e3b1731e505 · 2024-01-24T15:52:25.000-07:00
Updating Calling docs for brevity
diff --git a/articles/communication-services/concepts/voice-video-calling/calling-sdk-features.md b/articles/communication-services/concepts/voice-video-calling/calling-sdk-features.md
@@ -15,27 +15,36 @@ ms.custom: devx-track-js
 ---
 # Calling SDK overview
 
+Azure Communication Services allows end-user browsers, apps, and services to drive voice and video communication. This page focuses on Calling client SDK, which can be embedded in websites and native applications. This page provides detailed descriptions of Calling client features such as platform and browser support information. Services programmatically manage and access calls using the [Call Automation APIs](../call-automation/call-automation.md). The [Rooms API](../rooms/room-concept.md) is an optional Azure Communication Services API that adds additional features to a voice or video call, such as roles and permissions.
+
 [!INCLUDE [Survey Request](../../includes/survey-request.md)]
 
+To build your own user experience with the Calling SDK, check out [Calling quickstarts](../../quickstarts/voice-video-calling/getting-started-with-calling.md) or [Calling hero sample](../../samples/calling-hero-sample.md).
+
+If you'd like help with the end-user experience, the Azure Communication Services UI Library provides a collection of open-source production-ready UI components to drop into your application. With this set of prebuilt controls, you can create beautiful communication experiences using [Microsoft's Fluent design language](https://developer.microsoft.com/en-us/fluentui#/). If you want to learn more about the UI Library, visit [the overview site](../ui-library/ui-library-overview.md) or [Storybook](https://aka.ms/acsstorybook).
 
-The Calling SDK enables end-user devices to drive voice and video communication experiences. This page provides detailed descriptions of Calling features, including platform and browser support information. To get started right away, check out [Calling quickstarts](../../quickstarts/voice-video-calling/getting-started-with-calling.md) or [Calling hero sample](../../samples/calling-hero-sample.md).
+Once you start development, check out the [known issues page](../known-issues.md) to find bugs we're working on.
 
-Once you've started development, check out the [known issues page](../known-issues.md) to find bugs we're working on.
+**SDK links**
 
-Key features of the Calling SDK:
+| Platform | Web (JavaScript) | Windows (.NET) |  iOS | Android | Other |
+| -------------- | ---------- |   ---- | -------------- | -------------- | ------------------------------ |
+| Calling | [npm](https://www.npmjs.com/package/@azure/communication-calling) | [NuGet](https://www.nuget.org/packages/Azure.Communication.Calling.WindowsClient) |  [GitHub](https://github.com/Azure/Communication/releases) | [Maven](https://search.maven.org/artifact/com.azure.android/azure-communication-calling/)| |
+| UI Library| [npm](https://www.npmjs.com/package/@azure/communication-react) | - |  [GitHub](https://github.com/Azure/communication-ui-library-ios) | [GitHub](https://github.com/Azure/communication-ui-library-android) | [GitHub](https://github.com/Azure/communication-ui-library), [Storybook](https://azure.github.io/communication-ui-library/?path=/story/overview--page) |
 
+**Key features** 
+- **Device Management and Media** - The Calling SDK provides facilities for binding to audio and video devices, encodes content for efficient transmission over the communications dataplane, and renders content to output devices and views that you specify. APIs are also provided for screen and application sharing.
+- **PSTN** - The Calling SDK can initiate voice calls with the traditional publicly switched telephone network, [using phone numbers you acquire in the Azure portal](../../quickstarts/telephony/get-phone-number.md) or programmatically. You can also bring your own numbers using session border controllers. 
+- **Teams Meetings & Calling** - The Calling SDK can [join Teams meetings](../../quickstarts/voice-video-calling/get-started-teams-interop.md) and interact with the Teams voice and video dataplane.
+- **Encryption** - The Calling SDK encrypts traffic and prevents tampering on the wire.
 - **Addressing** - Azure Communication Services provides generic [identities](../identity-model.md) that are used to address communication endpoints. Clients use these identities to authenticate to the service and communicate with each other. These identities are used in Calling APIs that provide clients visibility into who is connected to a call (the roster).
 - **User Access Security**
-  - **Roster** control, **Schedule** control, and user **roles/permissions** are enforced through [Virtual Rooms](../rooms/room-concept.md).
+  - **Roster** control, **schedule** control, and user **roles/permissions** are enforced through [Virtual Rooms](../rooms/room-concept.md).
   - Ability for a user to **Initiate a new call** or to **Join an existing call** can be managed through [User Identities and Tokens](../identity-model.md) 
-- **Encryption** - The Calling SDK encrypts traffic and prevents tampering on the wire.
-- **Device Management and Media** - The Calling SDK provides facilities for binding to audio and video devices, encodes content for efficient transmission over the communications dataplane, and renders content to output devices and views that you specify. APIs are also provided for screen and application sharing.
-- **PSTN** - The Calling SDK can initiate voice calls with the traditional publicly switched telephone network, [using phone numbers you acquire in the Azure portal](../../quickstarts/telephony/get-phone-number.md) or programmatically.
-- **Teams Meetings** - The Calling SDK can [join Teams meetings](../../quickstarts/voice-video-calling/get-started-teams-interop.md) and interact with the Teams voice and video dataplane.
 - **Notifications** - The Calling SDK provides APIs allowing clients to be notified of an incoming call. In situations where your app isn't running in the foreground, patterns are available to [fire pop-up notifications](../notifications.md) ("toasts") to inform end-users of an incoming call.
-- **User Facing Diagnostics (UFD)** - The Calling SDK provides [events](user-facing-diagnostics.md) that are designed to provide insights into underlying issues that could affect call quality. Developers can subscribe to triggers such as weak network signals or muted microphones, ensuring that they're always aware of any factors impacting the calls.
 - **Media Stats** - The Calling SDK provides comprehensive insights into [the metrics](media-quality-sdk.md) of your VoIP and video calls. With this information, developers have a clearer understanding of call quality and can make informed decisions to further enhance their communication experience.
 - **Video Constraints** - The Calling SDK provides APIs that gain the ability to regulate [video quality among other parameters](../../quickstarts/voice-video-calling/get-started-video-constraints.md) during video calls by adjusting parameters such as resolution and frame rate supporting different call situations for different levels of video quality
+- **User Facing Diagnostics (UFD)** - The Calling SDK provides [events](user-facing-diagnostics.md) that are designed to provide insights into underlying issues that could affect call quality. Developers can subscribe to triggers such as weak network signals or muted microphones, ensuring that they're always aware of any factors impacting the calls.
 
 ## Detailed capabilities
 
@@ -90,63 +99,44 @@ The following list presents the set of features that are currently available in
 |                   | Custom background image                                                                                             | ✔️   | ❌       | ❌              | ❌                 |
 
 
-1. The capability to Mute Others is currently in public preview.
-2. The Share Screen capability can be achieved using Raw Media, if you want to learn, **how  to add Raw Media**, visit [the quickstart guide](../../quickstarts/voice-video-calling/get-started-raw-media-access.md).
-3. The Calling SDK doesn't have an explicit API, you need to use the OS (android & iOS) API to achieve it.
-
-## UI Library
-
-UI Library makes it easy for you to build modern communications user experiences using Azure Communication Services. It provides a library of production-ready UI components to drop into your application.
-
-With this set of prebuilt controls, you can create beautiful designs using [the fluent UI SDK](https://developer.microsoft.com/en-us/fluentui#/) components and audio/video communication experiences. If you want to learn more about the UI Library, you can visit [the overview site](../ui-library/ui-library-overview.md), where you find details about web and mobile platforms.
-
-## Calling SDK streaming support
-
-The Azure Communication Services Calling SDK supports the following streaming configurations:
-
-| Limit                                                         | Web                         | Windows/Android/iOS        |
-| ------------------------------------------------------------- | --------------------------- | -------------------------- |
-| **Maximum # of outgoing local streams that can be sent simultaneously**     | 1 video and 1 screen sharing | 1 video + 1 screen sharing |
-| **Maximum # of incoming remote streams that can be rendered simultaneously** | 9 videos + 1 screen sharing on desktop browsers*, 4 videos + 1 screen sharing on web mobile browsers | 9 videos + 1 screen sharing |
-
-\* Starting from Azure Communication Services Web Calling SDK version [1.16.3](https://github.com/Azure/Communication/blob/master/releasenotes/acs-javascript-calling-library-release-notes.md#1163-stable-2023-08-24)
-While the Calling SDK don't enforce these limits, your users might experience performance degradation if they're exceeded. Use the API of [Optimal Video Count](../../how-tos/calling-sdk/manage-video.md?pivots=platform-web#remote-video-quality) to determine how many current incoming video streams your web environment can support.
-
-## Calling SDK timeouts
-
-The following timeouts apply to the Communication Services Calling SDKs:
-
-| Action                                                                      | Timeout in seconds |
-| --------------------------------------------------------------------------- | ------------------ |
-| Reconnect/removal participant                                               | 60                |
-| Add or remove new modality from a call (Start/stop video or screen sharing) | 40                 |
-| Call Transfer operation timeout                                             | 60                 |
-| 1:1 call establishment timeout                                              | 85                 |
-| Group call establishment timeout                                            | 85                 |
-| PSTN call establishment timeout                                             | 115                |
-| Promote 1:1 call to a group call timeout                                    | 115                |
-
-## Maximum call duration
-
-**The maximum call duration is 30 hours**, participants that reach the maximum call duration lifetime of 30 hours will be disconnected from the call.
+<sup>1</sup> The capability to Mute Others is currently in public preview.
+<sup>2</sup> The Share Screen capability can be achieved using Raw Media APIs. To learn more visit [the raw media access quickstart guide](../../quickstarts/voice-video-calling/get-started-raw-media-access.md).
+<sup>3</sup> The Calling SDK doesn't have an explicit API for these functions, you should use the Android & iOS OS APIs to achieve instead.
 
 ## JavaScript Calling SDK support by OS and browser
 
 The following table represents the set of supported browsers, which are currently available. **We support the most recent three major versions of the browser (most recent three minor versions for Safari)**  unless otherwise indicated.
 
 | Platform     | Chrome | Safari | Edge  | Firefox |  Webview |
 | ------------ | ------ | ------ | ------ | ------- | ------- |
-| Android      | ✔️      | ❌      | ✔️           | ❌      | ✔️ *    |
+| Android      | ✔️      | ❌      | ✔️           | ❌      | ✔️     |
 | iOS          | ✔️      | ✔️      | ❌           | ❌      | ✔️      |
 | macOS        | ✔️      | ✔️      | ✔️           | ✔️      | ❌      |
 | Windows      | ✔️      | ❌      | ✔️           | ✔️      | ❌      |
 | Ubuntu/Linux | ✔️      | ❌      | ❌           | ❌      | ❌      |
 
 - Outgoing Screen Sharing isn't supported on iOS or Android mobile browsers.
 - Firefox support is in public preview.
-- Currently, the calling SDK only supports Android System WebView on Android, iOS WebView(WKWebView) in public preview. Other types of embedded browsers or WebView on other OS platforms aren't officially supported, for example, GeckoView, Chromium Embedded Framework (CEF), Microsoft Edge WebView2.
-Running JavaScript Calling SDK on these platforms isn't actively tested, it might or might not work.
-- [An iOS app on Safari can't enumerate/select mic and speaker devices](../known-issues.md#enumerating-devices-isnt-possible-in-safari-when-the-application-runs-on-ios-or-ipados) (for example, Bluetooth); this issue is a limitation of the OS, and there's always only one device, OS controls default device selection.
+- Currently, the calling SDK only supports Android System WebView on Android, iOS WebView(WKWebView) in public preview. Other types of embedded browsers or WebView on other OS platforms aren't officially supported, for example, GeckoView, Chromium Embedded Framework (CEF), Microsoft Edge WebView2. Running JavaScript Calling SDK on these platforms isn't actively tested, it might or might not work.
+- [An iOS app on Safari can't enumerate/select mic and speaker devices](../known-issues.md#enumerating-devices-isnt-possible-in-safari-when-the-application-runs-on-ios-or-ipados) (for example, Bluetooth). This issue is a limitation of iOS, and the operating system controls default device selection.
+
+## Calling client - browser security model
+
+### Use WebRTC over HTTPS
+
+WebRTC APIs like `getUserMedia` require that the app that calls these APIs is served over HTTPS. For local development, you can use `http://localhost`.
+
+### Embed the Communication Services Calling SDK in an iframe
+
+A new [permissions policy (also called a feature policy)](https://www.w3.org/TR/permissions-policy-1/#iframe-allow-attribute) is available in various browsers. This policy affects calling scenarios by controlling how applications can access a device's camera and microphone through a cross-origin iframe element.
+
+If you want to use an iframe to host part of the app from a different domain, you must add the `allow` attribute with the correct value to your iframe.
+
+For example, this iframe allows both camera and microphone access:
+
+```html
+<iframe allow="camera *; microphone *">
+```
 
 ## Android Calling SDK support
 
@@ -161,29 +151,36 @@ Running JavaScript Calling SDK on these platforms isn't actively tested, it migh
 - Xcode 12.0+
 - Support for **iPadOS** 13.0+
 
-## Calling client - browser security model
 
-### User WebRTC over HTTPS
-
-WebRTC APIs like `getUserMedia` require that the app that calls these APIs is served over HTTPS.
+## Maximum call duration
 
-For local development, you can use `http://localhost`.
+**The maximum call duration is 30 hours**, participants that reach the maximum call duration lifetime of 30 hours will be disconnected from the call.
 
-### Embed the Communication Services Calling SDK in an iframe
+## Limits to the number of simultaneous video streams
 
-A new [permissions policy (also called a feature policy)](https://www.w3.org/TR/permissions-policy-1/#iframe-allow-attribute) is available in various browsers. This policy affects calling scenarios by controlling how applications can access a device's camera and microphone through a cross-origin iframe element.
+The Azure Communication Services Calling SDK supports the following streaming configurations:
 
-If you want to use an iframe to host part of the app from a different domain, you must add the `allow` attribute with the correct value to your iframe.
+| Limit                                                         | Web                         | Windows/Android/iOS        |
+| ------------------------------------------------------------- | --------------------------- | -------------------------- |
+| **Maximum # of outgoing local streams that can be sent simultaneously**     | 1 video and 1 screen sharing | 1 video + 1 screen sharing |
+| **Maximum # of incoming remote streams that can be rendered simultaneously** | 9 videos + 1 screen sharing on desktop browsers*, 4 videos + 1 screen sharing on web mobile browsers | 9 videos + 1 screen sharing |
 
-For example, this iframe allows both camera and microphone access:
+\* Starting from Azure Communication Services Web Calling SDK version [1.16.3](https://github.com/Azure/Communication/blob/master/releasenotes/acs-javascript-calling-library-release-notes.md#1163-stable-2023-08-24)
+While the Calling SDK does not enforce these limits, your users might experience performance degradation if they're exceeded. Use the API of [Optimal Video Count](../../how-tos/calling-sdk/manage-video.md?pivots=platform-web#remote-video-quality) to determine how many current incoming video streams your web environment can support.
 
-```html
-<iframe allow="camera *; microphone *">
-```
+## Calling SDK timeouts
 
-## Known issues
+The following timeouts apply to the Communication Services Calling SDKs:
 
-Once you've started development, check out the [known issues page](../known-issues.md) to find bugs we're working on.
+| Action                                                                      | Timeout in seconds |
+| --------------------------------------------------------------------------- | ------------------ |
+| Reconnect/removal participant                                               | 60                |
+| Add or remove new modality from a call (Start/stop video or screen sharing) | 40                 |
+| Call Transfer operation timeout                                             | 60                 |
+| 1:1 call establishment timeout                                              | 85                 |
+| Group call establishment timeout                                            | 85                 |
+| PSTN call establishment timeout                                             | 115                |
+| Promote 1:1 call to a group call timeout                                    | 115                |
 
 ## Next steps
 
diff --git a/articles/communication-services/quickstarts/voice-video-calling/getting-started-with-calling.md b/articles/communication-services/quickstarts/voice-video-calling/getting-started-with-calling.md
@@ -14,9 +14,7 @@ ms.custom: mode-other, devx-track-js, devx-track-azurecli
 
 # Quickstart: Add voice calling to your app
 
-Get started with Azure Communication Services by using the Communication Services Calling SDK to add voice and video calling to your app.
-
-[!INCLUDE [Emergency Calling Notice](../../includes/emergency-calling-notice-include.md)]
+Get started with Azure Communication Services by using the Calling SDK to add voice and video calling to your app.
 
 ::: zone pivot="platform-windows"
 [!INCLUDE [Calling with Windows](./includes/get-started/get-started-windows.md)]
