Azure SDK Review - [IC3 ACS Calling]

[azure-sdk]

New SDK Review meeting has been requested.

Service Name: IC3 ACS Calling
Review Created By: Bob Gao
Review Date: 03/12/2024 02:05 PM PT

Hero Scenarios Link: Not Provided
Architecture Diagram Link: Not Provided
Core Concepts Doc Link: Not Provided
APIView Links: .NET, iOS, Android,

Description: ACS Calling Mar Release

Detailed meeting information and documents provided can be accessed here

[DaybreakQuip]

Native SDK
Features being reviewed for the next version (2.7.0 Android, 2.9.0 iOS and 1.5.0 Windows): Push notification TTL, Unreliable data channel, background replacement, media stats. We are also reviewing the version after that, which is CTE and telecom manager (for android).

Android:
2.7.0
https://apiview.dev/Assemblies/Review/95c984e7d94a4961bd724d0d07394cf9/988bba43033e4ed0b5827531d675fde5?diffRevisionId=a4146ab82493458db802dea3d5b2790d&doc=False&diffOnly=True

2.8.0
https://apiview.dev/Assemblies/Review/95c984e7d94a4961bd724d0d07394cf9/bcd6d9c10ef441659d736a70a7ed9e5d?diffRevisionId=988bba43033e4ed0b5827531d675fde5&doc=False&diffOnly=True

CTE Sample: https://apiview.dev/Assemblies/Samples/95c984e7d94a4961bd724d0d07394cf9?revisionId=2f8c55be097943b28445b81ce062c7a0

iOS:
2.9.0
https://apiview.dev/Assemblies/Review/80768c5191c748a69f83e4e2d42bd97d/a3e4b6bbd81b4541bfeffd33a73d55ca?diffRevisionId=8950b0edb507498c97f9796323f2e934&doc=False&diffOnly=True

2.10.0
https://apiview.dev/Assemblies/Review/80768c5191c748a69f83e4e2d42bd97d/0a9fdacb89534da7ab6f15c744c5aeb7?diffRevisionId=a3e4b6bbd81b4541bfeffd33a73d55ca&doc=False&diffOnly=True

CTE Sample: https://apiview.dev/Assemblies/Samples/80768c5191c748a69f83e4e2d42bd97d?revisionId=ebcfa6e719b14d539b91e1972d646c80

Windows:
1.5.0
https://apiview.dev/Assemblies/Review/db8d6cbd1678473da111b1967350b837/ab9142fe74164c7f9494565d9d46b59b?diffRevisionId=91504d6524394a7bbc48376756660ae9&doc=False&diffOnly=True

1.6.0
https://apiview.dev/Assemblies/Review/db8d6cbd1678473da111b1967350b837/6b6aff26f3ef4c8497b9859cf78d873c?diffRevisionId=ab9142fe74164c7f9494565d9d46b59b&doc=False&diffOnly=True

CTE Sample: https://apiview.dev/Assemblies/Samples/db8d6cbd1678473da111b1967350b837?revisionId=6cf2bb2da3524bbc86a159eb065eb1e5

UI SDK
Features being reviewed for UI SDK are: 1 to 1 calling, disable leave confirm dialog API

Android
1.7.0
https://apiview.dev/Assemblies/Review/7bb1657f3b8c4758b5bb9edf41d95d8e/72e3483f2b7b4f1b92a4362f299ce9b9?diffRevisionId=f533b45c617843dc972de67dc05e1300&doc=False&diffOnly=True

Usage:
https://apiview.dev/Assemblies/Samples/7bb1657f3b8c4758b5bb9edf41d95d8e?revisionId=b2034db23ce34cdca1817cb5f179ef72

iOS
1.7.0
https://apiview.dev/Assemblies/Review/18c724ad2da741248b4b58b0a7c07edc/7042dbc9f5c94fd6ba600d137555f058?diffRevisionId=77a4d2d6acfd4b05828c83e06907d34b&doc=False&diffOnly=True

Usage:
https://apiview.dev/Assemblies/Samples/18c724ad2da741248b4b58b0a7c07edc?revisionId=80ec5ce3dee146e69f6a77d72f1dbc07

[DaybreakQuip]

TelecomManager is a system service provided by the Android operating system that allows apps to interact with and manage various aspects of the telephony and call handling functionality on Android devices. It is part of the Android Telephony framework.
Using TelecomManager will allow us to achieve:
• Manage competitive calls: if there is an PSTN call (or VoIP call which also uses TelecomManager) happens same time as ACS call TelecomManager will coordinate Hold/UnHold states between calls.
• Bluetooth and Speakerphone Control: allows us to manage audio routing during calls including the use of Bluetooth headsets, device's speakerphone, and Android Auto for cars.

If Contoso developers set a value to CallAgentOptions.telecomManagerOptions that will enable TelecomManager integration.
By default, CallAgentOptions.telecomManagerOptions is null. If Contoso developer will not set anything, then TelecomManager integrartion will not be enabled.

When TelecomManager integration is enabled, Contoso application will no longer be able to select Audio output device. Contoso developers will need to use SDK to change audio route.

TelecomManagerOptions telecomManagerOptions = TelecomManagerOptions();
telecomManagerOptions.phoneAccountId = "<unique string per application>”;
telecomManagerOptions.isResumeCallAutomatically = false;

CallAgentOptions options = CallAgentOptions();
options.telecomManagerOptions = telecomManagerOptions;
 
CallClient callClient = CallClient(callClientOptions);
CallAgent callAgent = callClient.createCallAgent(
    context,
    callConfig.communicationTokenCredential,
    options
).get();
 
Call call = callAgent.join(context, joinMeetingLocator, joinCallOptions);
 
// Set Audio output via TelecomManager. Only in use with TelecomManager integration.
call.setAudioRoute(CallAudioState.ROUTE_SPEAKER)