Consignes AEP : Android Telecom Framework

Intégrez le framework Android Telecom à l'aide de la bibliothèque Jetpack Core-Telecom pour vous assurer que les appels VoIP (Voice over IP) sont traités comme une fonctionnalité de base par le système d'exploitation, au même titre que les appels traditionnels basés sur une carte SIM. Cette intégration unifie la gestion des appels, améliore le traitement audio et permet la compatibilité avec les appareils à distance tels que les casques et les montres.

Implémentation requise

Pour être éligible au programme AEP, votre application doit respecter les exigences suivantes :

  • Enregistrement des appels : tous les appels VoIP entrants et sortants doivent être enregistrés auprès du framework Telecom à l'aide de l'API CallsManager#addCall.
  • Gestion de l'état : utilisez CallControlScope et d'autres constructions de bibliothèque pour refléter et gérer avec précision le cycle de vie de l'état de l'appel, y compris les états de numérotation, de sonnerie, d'activité, de mise en attente et de déconnexion.
  • Traitement audio : n'utilisez pas directement les API Audio ou Bluetooth pour gérer la priorité audio et le routage. Au lieu de cela, utilisez le framework Telecom pour gérer les scénarios d'appels simultanés et les modifications d'appareils audio.
  • Notifications : utilisez l'API callStyle pour afficher des notifications de style d'appel cohérentes avec le système Android.
  • Cycle de vie du service de premier plan : gérez le cycle de vie de tous les services de premier plan nécessaires à l'appel conformément aux bonnes pratiques et aux limites d'Android.
  • Intégration de la surface à distance : synchronise l'état et les commandes des appels avec les surfaces à distance connectées, telles que les casques Bluetooth, les appareils Wear OS et Android Auto.
  • Scénarios d'appels multiples : gère de manière fluide les interactions avec d'autres appels, tels que les appels SIM entrants ou les appels provenant d'autres applications VoIP, en garantissant un comportement audio et une expérience utilisateur prévisibles.

Applicabilité des consignes

Ces consignes s'appliquent aux éléments suivants :

  • Les applications offrent des fonctionnalités d'appel VoIP.
  • Tous les facteurs de forme sur lesquels l'application est disponible.

Exceptions

Les exceptions suivantes s'appliquent à ces consignes :

  • Applications qui ne peuvent pas techniquement prendre en charge les dépendances AndroidX en raison d'obstacles techniques tels que :
    • Conflits de dépendances du SDK
    • Contraintes du projet Android Open Source (AOSP)
    • Restrictions du système de compilation du fabricant d'équipement d'origine (OEM)
  • Des exceptions temporaires peuvent être accordées aux applications qui rencontrent des problèmes importants de plate-forme ou de bibliothèque empêchant une migration stable, à condition qu'un calendrier de résolution clair soit disponible et que le problème ait été accepté par Google.
  • Les applications peuvent utiliser un framework alternatif équivalent offrant une qualité, des fonctionnalités utilisateur, une stabilité et une compatibilité similaires dans l'écosystème. Contactez l'assistance si vous disposez d'un framework approprié à prendre en compte.

Documentation et ressources sur les fonctionnalités

Les ressources suivantes fournissent des conseils d'implémentation et des informations techniques sur le framework Android Telecom. Ces ressources sont fournies à titre de référence uniquement et ne contiennent pas d'exigences supplémentaires concernant le programme.