Intégrer à TelecomManager
Ce document explique comment intégrer TelecomManager à votre application Android.
Prérequis
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Une ressource Communication Services déployée. Créez une ressource Communication Services.
- Un jeton d’accès utilisateur pour activer le client appelant. Pour plus d’informations, consultez Créer et gérer des jetons d’accès.
- Facultatif : suivez le guide de démarrage rapide permettant d’ajouter l’appel vocal à votre application.
Intégration de TelecomManager
Important
Cette fonctionnalité d’Azure Communication Services est actuellement en préversion.
Ces interfaces de programmation d’applications et kits de développement logiciel (SDK) en préversion sont fournis sans contrat au niveau du service. Nous vous recommandons de ne pas les utiliser pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge.
Pour plus d’informations, consultez Conditions d’utilisation supplémentaires relatives aux préversions de Microsoft Azure.
TelecomManager
L’intégration dans le Kit de développement logiciel (SDK) Android Azure Communication Services gère l’interaction avec d’autres applications d’appel VoIP et PSTN qui sont également intégrées à TelecomManager
.
Configurer TelecomConnectionService
Ajouter TelecomConnectionService
à votre application AndroidManifest.xml
<application>
...
<service
android:name="com.azure.android.communication.calling.TelecomConnectionService"
android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE"
android:exported="true">
<intent-filter>
<action android:name="android.telecom.ConnectionService" />
</intent-filter>
</service>
</application>
Initialiser l’agent d’appel avec TelecomManagerOptions
Avec l’instance configurée de TelecomManagerOptions
, nous pouvons créer l’option CallAgent
avec TelecomManager
activé.
CallAgentOptions options = new CallAgentOptions();
TelecomManagerOptions telecomManagerOptions = new TelecomManagerOptions("<your app's phone account id>");
options.setTelecomManagerOptions(telecomManagerOptions);
CallAgent callAgent = callClient.createCallAgent(context, credential, options).get();
Call call = callAgent.join(context, locator, joinCallOptions);
Configurer l’appareil de sortie audio
Lorsque l’intégration de TelecomManager est activée pour l’application, l’appareil de sortie audio doit être sélectionné via l’API de gestionnaire de télécommunications uniquement.
call.setTelecomManagerAudioRoute(android.telecom.CallAudioState.ROUTE_SPEAKER);
Configurer le comportement de reprise d’appel
Lorsque l’appel est interrompu avec d’autres appels, par exemple appel RTC entrant, l’appel ACS est placé OnHold
. Vous pouvez configurer ce qui se passe une fois que l’appel RTC est automatiquement terminé, ou attendre que l’utilisateur demande la reprise de l’appel.
telecomManagerOptions.setResumeCallAutomatically(true);