Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Ce document explique comment intégrer TelecomManager à votre application Android.
Conditions préalables
- Un compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Une ressource de services de communication 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. Les fonctionnalités en préversion sont disponibles publiquement et peuvent être utilisées par tous les clients Microsoft nouveaux et existants.
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 ne pas être prises en charge ou les fonctionnalités peuvent être limitées.
Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations 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’instance CallAgent
avec la fonctionnalité TelecomManager
activée.
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 par un autre appel, par exemple un appel RTC entrant, l’appel ACS est placé OnHold
. Vous pouvez configurer ce qui se passe une fois l’appel RTC terminé : reprendre l’appel automatiquement ou attendre que l’utilisateur demande la reprise de l’appel.
telecomManagerOptions.setResumeCallAutomatically(true);