Intégrer à TelecomManager

Ce document explique comment intégrer TelecomManager à votre application Android.

Prérequis

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);

Étapes suivantes