Skip to content

Commit dfe4c8a

Browse files
vac0224vac0224
committed
Reconcile articles with new TOC (11)
voice and video calling
1 parent c923f81 commit dfe4c8a

File tree

10 files changed

+146
-123
lines changed

10 files changed

+146
-123
lines changed

‎articles/communication-services/how-tos/calling-sdk/includes/push-notifications/push-notifications-android.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
author: sanathr
33
ms.service: azure-communication-services
44
ms.topic: include
5-
ms.date: 08/06/2024
5+
ms.date: 06/28/2025
66
ms.author: sanathr
77
---
88

@@ -99,7 +99,7 @@ catch(Exception e) {
9999

100100
To receive incoming call push notifications, call `handlePushNotification()` on a `CallAgent` instance with a payload.
101101

102-
To obtain the payload from Firebase Cloud Messaging, begin by creating a new service (select **File** > **New** > **Service** > **Service**) that extends the `FirebaseMessagingService` Firebase SDK class and overrides the `onMessageReceived` method. This method is the event handler that's called when Firebase Cloud Messaging delivers the push notification to the application.
102+
To obtain the payload from Firebase Cloud Messaging, begin by creating a new service (select **File** > **New** > **Service** > **Service**) that extends the `FirebaseMessagingService` Firebase SDK class and overrides the `onMessageReceived` method. This method is the event handler called when Firebase Cloud Messaging delivers the push notification to the application.
103103

104104
```java
105105
public class MyFirebaseMessagingService extends FirebaseMessagingService {

‎articles/communication-services/how-tos/calling-sdk/includes/push-notifications/push-notifications-ios.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,11 @@
22
author: probableprime
33
ms.service: azure-communication-services
44
ms.topic: include
5-
ms.date: 09/08/2021
5+
ms.date: 06/28/2025
66
ms.author: rifox
77
---
8-
## Considerations for mobile push notifications
8+
9+
## Implement iOS mobile push notifications
910

1011
Mobile push notifications are the pop-up notifications that appear on mobile devices. For calling, this article focuses on voice over Internet Protocol (VoIP) push notifications. For a guide on CallKit integration in your iOS application, see [Integrate with CallKit](../../callkit-integration.md).
1112

@@ -62,7 +63,7 @@ callAgent.handlePush(notification: callNotification) { (error) in
6263
Applications can unregister push notification at any time. To unregister, call the `unregisterPushNotification` method on `CallAgent`.
6364

6465
> [!NOTE]
65-
> Applications are not automatically unregistered from push notifications on logout.
66+
> Applications aren't automatically unregistered from push notifications on sign out.
6667
6768
```swift
6869
callAgent.unregisterPushNotification { (error) in
@@ -81,7 +82,7 @@ The push payload of an incoming call can be delivered to the callee in two ways:
8182
- Using Apple Push Notification service (APNS) and registering the device token with the API mentioned earlier, `registerPushNotification` on `CallAgent` or `TeamsCallAgent`
8283
- Registering the SDK with an internal service upon creation of `CallAgent` or `TeamsCallAgent` to get the push payload delivered
8384

84-
By using the property `disableInternalPushForIncomingCall` in `CallAgentOptions` or `TeamsCallAgentOptions`, it's possible to instruct the SDK to disable the delivery of the push payload via the internal push service:
85+
By using the property `disableInternalPushForIncomingCall` in `CallAgentOptions` or `TeamsCallAgentOptions`, you can instruct the SDK to disable the delivery of the push payload via the internal push service:
8586

8687
```swift
8788
let options = CallAgentOptions()

‎articles/communication-services/how-tos/calling-sdk/includes/push-notifications/push-notifications-web.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
author: chriswhilar
3-
title: Azure Communication Services Web Calling SDK - Web push notifications
4-
description: Find the quickstart for setting up Azure Communication Services Web Calling SDK push notifications.
3+
title: Web push notifications
4+
description: Azure Communication Services Web Calling SDK push notifications.
55
ms.service: azure-communication-services
66
ms.subservice: web calling sdk
77
ms.topic: include
8-
ms.date: 03/20/2023
8+
ms.date: 06/28/2025
99
ms.author: chwhilar
1010
---
1111

‎articles/communication-services/how-tos/calling-sdk/includes/push-notifications/push-notifications-windows.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
author: probableprime
33
ms.service: azure-communication-services
44
ms.topic: include
5-
ms.date: 03/26/2024
5+
ms.date: 06/28/2025
66
ms.author: jsaurezlee
77
---
88

9-
## Considerations for Windows push notifications
9+
## Implement Windows push notifications
1010

1111
Mobile push notifications are the pop-up notifications that appear on mobile devices. For calling, this article focuses on voice over Internet Protocol (VoIP) push notifications.
1212

@@ -60,7 +60,7 @@ Before you start the tasks of registering for, handling, and showing a Windows n
6060
}
6161
```
6262

63-
1. Register the event handler that's activated when a new push notification message arrives on `App.xaml.cs`:
63+
1. Register the event handler activated when a new push notification message arrives on `App.xaml.cs`:
6464

6565
```C#
6666
// App.xaml.cs

‎articles/communication-services/how-tos/calling-sdk/push-notifications.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
2-
title: Enable push notifications for calls
3-
titleSuffix: An Azure Communication Services how-to guide
2+
title: Enable push notifications
3+
titleSuffix: An Azure Communication Services article
44
description: Use Azure Communication Services SDKs to enable push notifications for calls.
55
author: tophpalmer
66
ms.author: chpalm
77
ms.service: azure-communication-services
88
ms.subservice: calling
9-
ms.topic: how-to
10-
ms.date: 08/10/2021
9+
ms.topic: how-to
10+
ms.date: 06/28/2025
1111
ms.custom: template-how-to
1212
zone_pivot_groups: acs-plat-web-ios-android-windows
1313

1414
#Customer intent: As a developer, I want to enable push notifications by using the Azure Communication Services SDKs so that I can create a calling application that provides push notifications to its users.
1515
---
1616

17-
# Enable push notifications for calls
17+
# Enable push notifications
1818

1919
Push notifications send information from your application to users' devices. You can use push notifications to show a dialog, play a sound, or display incoming call into the app's UI layer.
2020

@@ -24,7 +24,7 @@ In this article, you learn how to enable push notifications for Azure Communicat
2424

2525
The time-to-live (TTL) token is a setting that determines the length of time that a notification token stays valid before becoming invalid. This setting is useful for applications where user engagement doesn't require daily interaction but remains critical over longer periods.
2626

27-
The TTL configuration allows the management of push notifications' life cycle. It reduces the need for frequent token renewals while helping to ensure that the communication channel between the application and its users remains open and reliable for extended durations.
27+
The TTL configuration enables the management of push notifications' life cycle. It reduces the need for frequent token renewals while helping to ensure that the communication channel between the application and its users remains open and reliable for extended durations.
2828

2929
Currently, the maximum value for TTL is **180 days (15,552,000 seconds)**, and the minimum value is **5 minutes (300 seconds)**. You can enter this value and adjust it to fit your needs. If you don't provide a value, the default value is **24 hours (86,400 seconds)**.
3030

@@ -63,7 +63,7 @@ If you want to revoke an identity, follow [this process](../../concepts/identity
6363
[!INCLUDE [Enable push notifications Windows](./includes/push-notifications/push-notifications-windows.md)]
6464
::: zone-end
6565

66-
## Related content
66+
## Related articles
6767

6868
- [Subscribe to SDK events](./events.md)
6969
- [Manage calls](./manage-calls.md)

‎articles/communication-services/how-tos/calling-sdk/telecommanager-integration.md

Lines changed: 55 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,79 +1,81 @@
11
---
2-
ms.date: 03/20/2024
3-
ms.topic: how-to
2+
title: Integrate with TelecomManager on Android
3+
titleSuffix: An Azure Communication Services article
4+
description: This article describes how to integrate TelecomManager with Azure Communication Services calling SDK.
45
author: pavelprystinka
56
ms.author: pprystinka
6-
title: TelecomManager integration in Azure Communication Services calling SDK
7+
ms.date: 06/28/2025
8+
ms.topic: how-to
79
ms.service: azure-communication-services
810
ms.subservice: calling
9-
description: Steps on how to integrate TelecomManager with Azure Communication Services calling SDK
1011
---
1112

12-
# Integrate with TelecomManager
13+
# Integrate with TelecomManager
1314

14-
This document describes how to integrate TelecomManager with your Android application.
15+
This article describes how to integrate TelecomManager with your Android application.
1516

16-
## Prerequisites
17+
## Prerequisites
18+
19+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
20+
- A deployed Communication Services resource. [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
21+
- A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
22+
- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md).
1723

18-
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
19-
- A deployed Communication Services resource. [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
20-
- A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
21-
- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
24+
## TelecomManager integration
2225

23-
## TelecomManager integration
26+
[!INCLUDE [Public Preview Notice](../../includes/public-preview-include.md)]
2427

25-
[!INCLUDE [Public Preview Notice](../../includes/public-preview-include.md)]
28+
`TelecomManager` Integration in the Azure Communication Services Android SDK handles interaction with other voice over IP (VoIP) and public switched telephone network (PSTN) calling apps that also integrate with `TelecomManager`.
2629

27-
`TelecomManager` Integration in the Azure Communication Services Android SDK handles interaction with other VoIP and PSTN calling Apps that also integrated with `TelecomManager`.
30+
### Configure `TelecomConnectionService`
2831

29-
### Configure `TelecomConnectionService`
30-
Add `TelecomConnectionService` to your App `AndroidManifest.xml`
31-
```
32-
<application>
33-
...
34-
<service
35-
android:name="com.azure.android.communication.calling.TelecomConnectionService"
36-
android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE"
37-
android:exported="true">
38-
<intent-filter>
39-
<action android:name="android.telecom.ConnectionService" />
40-
</intent-filter>
41-
</service>
42-
</application>
43-
```
32+
Add `TelecomConnectionService` to your App `AndroidManifest.xml`.
4433

45-
### Initialize call agent with TelecomManagerOptions
34+
```
35+
<application>
36+
...
37+
<service
38+
android:name="com.azure.android.communication.calling.TelecomConnectionService"
39+
android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE"
40+
android:exported="true">
41+
<intent-filter>
42+
<action android:name="android.telecom.ConnectionService" />
43+
</intent-filter>
44+
</service>
45+
</application>
46+
```
4647

47-
With configured instance of `TelecomManagerOptions`, we can create the `CallAgent` with `TelecomManager` enabled.
48+
### Initialize call agent with TelecomManagerOptions
4849

49-
```Java
50-
CallAgentOptions options = new CallAgentOptions();
51-
TelecomManagerOptions telecomManagerOptions = new TelecomManagerOptions("<your app's phone account id>");
52-
options.setTelecomManagerOptions(telecomManagerOptions);
50+
With configured instance of `TelecomManagerOptions`, we can create the `CallAgent` with `TelecomManager` enabled.
5351

54-
CallAgent callAgent = callClient.createCallAgent(context, credential, options).get();
55-
Call call = callAgent.join(context, locator, joinCallOptions);
56-
```
52+
```Java
53+
CallAgentOptions options = new CallAgentOptions();
54+
TelecomManagerOptions telecomManagerOptions = new TelecomManagerOptions("<your app's phone account id>");
55+
options.setTelecomManagerOptions(telecomManagerOptions);
5756

58-
59-
### Configure audio output device
57+
CallAgent callAgent = callClient.createCallAgent(context, credential, options).get();
58+
all call = callAgent.join(context, locator, joinCallOptions);
59+
```
60+
61+
### Configure audio output device
6062

61-
When TelecomManager integration is enabled for the App, the audio output device has to be selected via telecom manager API only.
63+
When TelecomManager integration is enabled for the App, the audio output device must be selected via telecom manager API only.
6264

63-
```Java
64-
call.setTelecomManagerAudioRoute(android.telecom.CallAudioState.ROUTE_SPEAKER);
65-
```
65+
```Java
66+
call.setTelecomManagerAudioRoute(android.telecom.CallAudioState.ROUTE_SPEAKER);
67+
```
6668

67-
### Configure call resume behavior
69+
### Configure call resume behavior
6870

69-
When call is interrupted with other call, for instance incoming PSTN call, ACS call is placed `OnHold`. You can configure what happens once PSTN call is over resume call automatically, or wait for user to request call resume.
71+
When a call is interrupted by another call, for instance incoming PSTN call, Azure Communication Services call is placed `OnHold`. You can configure what happens once PSTN call is over resume call automatically, or wait for user to request call resume.
7072

73+
```Java
74+
telecomManagerOptions.setResumeCallAutomatically(true);
75+
```
7176

72-
```Java
73-
telecomManagerOptions.setResumeCallAutomatically(true);
74-
````
77+
## Next steps
7578

76-
## Next steps
77-
- [Learn how to manage video](./manage-video.md)
78-
- [Learn how to manage calls](./manage-calls.md)
79-
- [Learn how to record calls](./record-calls.md)
79+
- [Learn how to manage video](./manage-video.md)
80+
- [Learn how to manage calls](./manage-calls.md)
81+
- [Learn how to record calls](./record-calls.md)

‎articles/communication-services/quickstarts/voice-video-calling/get-started-webview.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
---
22
ms.author: enricohuang
3-
title: Azure Communication Calling Web SDK in WebView environment
4-
titleSuffix: An Azure Communication Services quickstart
5-
description: In this quickstart, you'll learn how to integrate Azure Communication Calling WebJS SDK in a WebView environment
3+
title: Add audio and video calling to your WebView application
4+
titleSuffix: An Azure Communication Services article
5+
description: This article describes how to integrate Azure Communication Calling WebJS SDK in a WebView environment
66
author: sloanster
77
services: azure-communication-services
8-
ms.date: 01/18/2022
8+
ms.date: 06/28/2025
99
ms.topic: quickstart
1010
ms.service: azure-communication-services
1111
ms.subservice: calling
1212
zone_pivot_groups: acs-plat-ios-android
1313
ms.custom: mode-other
1414
---
1515

16-
# QuickStart: Add video calling to your WebView client app
16+
# Add audio and video calling to your WebView application
1717

1818
::: zone pivot="platform-android"
1919
[!INCLUDE [Android WebView](./includes/webview/get-started-android-webview.md)]

0 commit comments

Comments
 (0)