Servizio di selezione domini

Per i dispositivi con Android 15 o versioni successive, puoi implementare la selezione del dominio tra il servizio IMS e i servizi precedenti sulle reti con commutazione di circuito utilizzando l'API di sistema DomainSelectionService. DomainSelectionService è un'interfaccia ben definita tra la piattaforma Android e un'implementazione di selezione del dominio fornita dal fornitore. Questa interfaccia consente all'implementazione del fornitore di fornire alla piattaforma informazioni di segnalazione, ad esempio il dominio in cui vengono effettuate le chiamate in uscita e gli SMS e la preferenza per il tipo di rete nella scansione della rete.

domain-selection-architecture

Figura 1. Diagramma dell'architettura per la funzionalità di selezione del dominio

Esempi e origine

Android fornisce un'implementazione di riferimento per la funzionalità di selezione del dominio in AOSP all'indirizzo TelephonyDomainSelectionService. Per la documentazione dettagliata dell'API DomainSelectionService, consulta DomainSelectionService e le altre classi dell'API.

Implementazione

Per implementare la funzionalità di selezione del dominio su un dispositivo Android, sono necessari i seguenti passaggi:

  1. Crea un'app di selezione del dominio. Il servizio deve essere definito nel fileAndroidManifest.xml.

  2. Aggiungi una configurazione all'overlay del dispositivo per consentire alla piattaforma di eseguire il binding all'implementazioneDomainSelectionService.

  3. Supporta le interfacce HAL radio richieste per la funzionalità di selezione del dominio.

Questa sezione fornisce ulteriori dettagli su questi passaggi.

Aggiungi la voce del servizio in AndroidManifest.xml

Affinché l'app di selezione del dominio registri il servizio DomainSelectionService con il framework, aggiungi una voce di servizio nel file manifest utilizzando il seguente formato:

<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 definizione del servizio in AndroidManifest.xml deve definire i seguenti attributi per il funzionamento della funzionalità di selezione del dominio.

  • directBootAware="true": consente al servizio di essere rilevato ed eseguito dalla telefonia prima che l'utente sblocchi il dispositivo. Il servizio non può accedere allo spazio di archiviazione criptato sul dispositivo prima che l'utente sblocchi il dispositivo. Per ulteriori informazioni, consulta Supportare la modalità di avvio diretto e Crittografia basata su file.

  • persistent="true": consente l'esecuzione del servizio in modo persistente e ne impedisce l'interruzione da parte del sistema per recuperare la memoria. Questo attributo funziona solo se l'app è creata come app di sistema.

  • permission="android.permission.BIND_DOMAIN_SELECTION_SERVICE": garantisce che solo un processo a cui è stata concessa l'autorizzazione BIND_DOMAIN_SELECTION_SERVICE possa associarsi all'app. In questo modo, un'app non autorizzata non può associarsi al servizio, perché solo le app di sistema possono ricevere l'autorizzazione dal framework.

Il servizio deve specificare anche l'elemento intent-filter con l'azione android.telephony.DomainSelectionService. In questo modo, il framework può trovare il servizio DomainSelectionService.

Definire la configurazione nell'overlay del dispositivo

Affinché la piattaforma si leghi in modo sicuro al servizio DomainSelectionService, aggiungi la seguente configurazione all'overlay del dispositivo:

Poiché Android non supporta le app con implementazioni DomainSelectionService scaricabili di terze parti, l'app di selezione del dominio deve essere un'app di sistema che si trova nella cartella /system_ext/priv-app/ o /product/priv-app/. Il framework verifica se il nome del pacchetto dell'implementazione corrisponde al valore dell'overlay del dispositivo per assicurarsi che vengano associate solo app preinstallate attendibili.

Supporta le interfacce HAL radio

Per attivare la funzionalità di selezione del dominio, supporta le seguenti interfacce HAL radio obbligatorie:

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

Convalida

Per verificare che il framework di telefonia risponda correttamente all'interfaccia DomainSelectionService, esegui i test CTS in DomainSelectionServiceTestOnMockModem.