Android 9 fournit des API pour une meilleure prise en charge des applications d'appel tierces. Les applications d'appel tierces s'appuient généralement sur des API de téléphonie telles que la diffusion PHONE_STATE pour coexister avec les appels téléphoniques des opérateurs. Par conséquent, les applications d'appel tierces doivent donner la priorité aux appels des opérateurs et ont souvent recours au rejet silencieux des appels entrants dans l'application ou à la fin d'un appel en cours pour laisser la place à un appel d'opérateur.
Les API d'Android 9 sont compatibles avec les scénarios d'appel simultanés entre les applications tierces et les appels d'opérateur. Cela permet, par exemple, de recevoir un appel entrant tiers tout en étant engagé dans un appel d'opérateur. Le framework assume la responsabilité de s'assurer que l'appel via l'opérateur est mis en attente lorsque l'utilisateur participe à l'appel tiers.
Dans Android 9, les applications d'appel tierces sont encouragées à implémenter l'API ConnectionService autogérée. Pour en savoir plus sur la création d'une application d'appel à l'aide de cette API, consultez
Créer une application d'appel.
L'API autogérée ConnectionService permet également aux développeurs de choisir
d'enregistrer les appels de leur application dans le journal d'appels du système (voir
EXTRA_LOG_SELF_MANAGED_CALLS).
Conformément aux exigences du
document de définition de compatibilité Android (CDD)
(section 7.4.1.2), vous devez vous assurer que votre application de numérotation ou de téléphone affiche ces
entrées du journal d'appels et indique le nom de l'application d'appel tierce à l'origine de l'appel (pour obtenir un exemple de la manière dont l'application de numérotation AOSP répond à cette
exigence, consultez
Entrées du journal d'appels provenant d'applications d'appel tierces).
Les applications sont responsables de la définition de
CAPABILITY_SUPPORT_HOLD
et
CAPABILITY_HOLD
sur les connexions de leurs applications. Toutefois, il est possible qu'une application ne puisse pas mettre un appel en attente dans certaines circonstances. Le framework comprend des dispositions pour résoudre ces types de cas.
Scénarios
Vous devez modifier votre application de numérotation pour gérer les scénarios suivants.
Gérer les appels entrants qui interrompent un appel en cours
Dans un scénario où un appel tiers est en cours (par exemple, dans un appel SuperCaller) qui ne prend pas en charge la mise en attente et où l'utilisateur reçoit un appel mobile (par exemple, à l'aide de son opérateur FooCom), votre application Téléphone doit indiquer à l'utilisateur que répondre à l'appel du réseau mobile mettra fin à l'appel tiers en cours.
Cette expérience utilisateur est importante, car une application d'appel tierce peut avoir un appel en cours qui ne peut pas être mis en attente par le framework. Répondre à un nouvel appel mobile entraîne la déconnexion de l'appel tiers en cours.
Consultez l'interface utilisateur de la figure pour obtenir un exemple :
Figure 1. Appel entrant interrompant un appel tiers en cours.
Votre application de numérotation peut vérifier si un appel entrant entraîne la déconnexion d'un autre appel en vérifiant les extras de l'appel.
Assurez-vous que
EXTRA_ANSWERING_DROPS_FG_CALL
est défini sur TRUE, et
EXTRA_ANSWERING_DROPS_FG_CALL_APP_NAME
est défini sur le nom de l'application dont l'appel est déconnecté lorsque vous répondez à l'
appel mobile entrant.
Entrées du journal d'appels provenant d'applications d'appel tierces
Les développeurs d'applications d'appel tierces peuvent choisir d'enregistrer les appels de leur application
dans le journal d'appels du système (voir
EXTRA_LOG_SELF_MANAGED_CALLS).
Cela signifie qu'il est possible d'avoir des entrées dans le journal d'appels qui ne concernent pas les appels du
réseau mobile.
Lorsque l'application de numérotation AOSP affiche des entrées du journal d'appels liées à une application d'appel tierce, le nom de l'application dans laquelle l'appel a eu lieu s'affiche dans le journal d'appels, comme illustré dans la figure :
Figure 2. Entrée de journal d'appels avec le nom de l'application d'appel tierce dans l'application Téléphone.
Pour déterminer le nom d'une application associée à une entrée de journal d'appels, utilisez les
PHONE_ACCOUNT_COMPONENT_NAME
et
PHONE_ACCOUNT_ID
colonnes dans le fournisseur du journal d'appels pour créer une instance de
PhoneAccountHandle,
qui identifie la source d'une entrée de journal d'appels. Interrogez
TelecomManager
pour obtenir les détails du PhoneAccount.
Pour déterminer si une entrée du journal d'appels provient d'une application d'appel tierce, vérifiez
PhoneAccount fonctionnalités
pour voir si
CAPABILITY_SELF_MANAGED
est défini.
La
getLabel
méthode du PhoneAccount renvoyé renvoie le nom de l'application associée
à une entrée de journal d'appels provenant de l'application d'appel tierce.
Validation
Pour vérifier que votre appareil est compatible avec les applications d'appel tierces, utilisez l'application de test Telecomm, qui implémente l'API ConnectionService autogérée. L'application se trouve dans
/packages/services/Telecomm/testapps/.
Créez l'application de test à partir de la racine de votre dépôt source Android à l'aide de :
mmma packages/services/Telecomm/testapps/Installez l'APK de compilation à l'aide de
adb install -g -r <apk path>. Une icône d'exemple autogéré est ensuite ajoutée à votre lanceur.Appuyez sur l'icône pour ouvrir l'application de test.
Gérer les appels entrants qui interrompent un appel en cours
Procédez comme suit pour vérifier qu'un appel entrant interrompt un appel tiers en cours.
Figure 3. Application de test avec des exemples d'implémentations de l'API ConnectionService.
- Effacez l'option Holdable (Peut être mis en attente).
- Appuyez sur OUTGOING (Sortant) pour démarrer un nouvel exemple d'appel sortant.
- Appuyez sur le bouton ACTIVE (Actif) pour activer l'appel.
- Appelez le numéro de téléphone de l'appareil testé avec un autre téléphone. Cela appelle le scénario dans lequel le nom d'une application est fourni à votre application de numérotation, dont l'appel sera déconnecté.
- Lorsque vous avez terminé, appuyez sur le bouton DISCONNECT (Déconnecter) dans l'application de test.
Entrées du journal d'appels provenant d'applications d'appel tierces
Une fois les étapes ci-dessus effectuées, l'application de test doit avoir enregistré un appel dans le journal d'appels du système. Pour confirmer que l'appareil enregistre les appels provenant d'applications d'appel tierces, ouvrez votre application de numérotation et vérifiez que l'appel apparaît dans le journal d'appels du système.