Service de sélection de domaine

Pour les appareils équipés d'Android 15 ou d'une version ultérieure, vous pouvez implémenter la sélection de domaine entre le service IMS et les anciens services sur les réseaux commutés par circuits à l'aide de l'API système DomainSelectionService. DomainSelectionService est une interface bien définie entre la plate-forme Android et une implémentation de sélection de domaine fournie par le fournisseur. Cette interface permet à l'implémentation du fournisseur de fournir à la plate-forme des informations de signalisation, telles que le domaine dans lequel les appels sortants et les SMS sont placés, ainsi que la préférence de type de réseau lors de l'analyse du réseau.

domain-selection-architecture

Figure 1 : Schéma de l'architecture de la fonctionnalité de sélection de domaine

Exemples et source

Android fournit une implémentation de référence pour la fonctionnalité de sélection de domaine dans AOSP à l'adresse TelephonyDomainSelectionService. Pour obtenir une documentation détaillée sur l'API DomainSelectionService, consultez DomainSelectionService et les autres classes de l'API.

Implémentation

Pour implémenter la fonctionnalité de sélection de domaine sur un appareil Android, procédez comme suit:

  1. Créez une application de sélection de domaine. Le service doit être défini dans le fichier AndroidManifest.xml.

  2. Ajoutez une configuration à la superposition de l'appareil pour permettre à la plate-forme de s'associer à l'implémentation DomainSelectionService.

  3. Prendre en charge les interfaces HAL radio requises pour la fonctionnalité de sélection de domaine.

Cette section fournit des informations supplémentaires sur ces étapes.

Ajouter une entrée de service dans AndroidManifest.xml

Pour que votre application de sélection de domaine enregistre le service DomainSelectionService auprès du framework, ajoutez une entrée de service dans le fichier manifeste en utilisant le format suivant:

<service
     android:name="com.example.domainselection.DomainSelectionService"
     android:directBootAware="true"
     android:persistent="true"
     …
     android:permission="android.permission.BIND_DOMAIN_SELECTION_SERVICE"
     …
    <intent-filter>
        <action android:name="android.telephony.DomainSelectionService"/>
    </intent-filter>
    …
</service>

La définition du service dans AndroidManifest.xml doit définir les attributs suivants pour que la fonctionnalité de sélection de domaine fonctionne.

  • directBootAware="true": permet au service d'être détecté et exécuté par la téléphonie avant que l'utilisateur ne déverrouille l'appareil. Le service ne peut pas accéder au stockage chiffré par l'appareil avant que l'utilisateur ne déverrouille l'appareil. Pour en savoir plus, consultez les sections Prendre en charge le mode Démarrage direct et Chiffrement basé sur les fichiers.

  • persistent="true": permet au service d'être exécuté de manière persistante et de ne pas être arrêté par le système pour récupérer de la mémoire. Cet attribut ne fonctionne que si l'application est compilée en tant qu'application système.

  • permission="android.permission.BIND_DOMAIN_SELECTION_SERVICE": garantit que seul un processus auquel l'autorisation BIND_DOMAIN_SELECTION_SERVICE est accordée peut se lier à l'application. Cela empêche une application malveillante de se lier au service, car seules les applications système peuvent être autorisées par le framework.

Le service doit également spécifier l'élément intent-filter avec l'action android.telephony.DomainSelectionService. Cela permet au framework de trouver le service DomainSelectionService.

Définir la configuration dans la superposition de l'appareil

Pour que la plate-forme se lie de manière sécurisée au service DomainSelectionService, ajoutez la configuration suivante à la superposition de l'appareil:

Étant donné qu'Android n'est pas compatible avec les applications avec des implémentations DomainSelectionService téléchargeables tierces, l'application de sélection de domaine doit être une application système qui se trouve dans le dossier /system_ext/priv-app/ ou /product/priv-app/. Le framework vérifie si le nom du package de l'implémentation correspond à la valeur de superposition de l'appareil pour s'assurer que seules les applications préinstallées fiables sont liées.

Prise en charge des interfaces HAL radio

Pour activer la fonctionnalité de sélection de domaine, prenez en charge les interfaces HAL radio requises suivantes:

  • IRadioNetwork

    void setEmergencyMode(int serial, EmergencyMode emcModeType);
void triggerEmergencyNetworkScan(int serial,
        EmergencyNetworkScanTrigger request);
void cancelEmergencyNetworkScan(int serial, boolean resetScan);
void exitEmergencyMode(int serial);

  • IRadioNetworkIndication

    void emergencyNetworkScanResult(RadioIndicationType type,
        EmergencyRegResult result);

Validation

Pour vérifier que le framework de téléphonie répond correctement à l'interface DomainSelectionService, exécutez les tests CTS dans DomainSelectionServiceTestOnMockModem.