Serviço de seleção de domínio

Em dispositivos com Android 15 ou mais recente, é possível implementar a seleção de domínio entre o serviço IMS e serviços legados em redes com comutação de circuitos usando a API do sistema DomainSelectionService. DomainSelectionService é uma interface bem definida entre a plataforma Android e uma implementação de seleção de domínio fornecida por um fornecedor. Essa interface permite que a implementação do fornecedor forneça informações de sinalização, como o domínio em que as chamadas e os SMS são feitos e a preferência de tipo de rede na verificação de rede, para a plataforma.

Diagrama da arquitetura do Serviço de seleção de domínio mostrando a interação dele com a plataforma Android e implementações de fornecedores

Figura 1. Diagrama de arquitetura para o recurso de seleção de domínio

Exemplos e origem

O Android oferece uma implementação de referência para o recurso de seleção de domínio no Android Open Source Project (AOSP) em TelephonyDomainSelectionService. Para ver a documentação detalhada da API DomainSelectionService, consulte DomainSelectionService e as outras classes na API.

Implementação

Para implementar o recurso de seleção de domínio em um dispositivo Android, siga estas etapas:

  1. Crie um app de seleção de domínio. O serviço precisa ser definido no arquivo AndroidManifest.xml.

  2. Adicione uma configuração à sobreposição de dispositivo para permitir que a plataforma se vincule à implementação DomainSelectionService.

  3. Suporte às interfaces necessárias da camada de abstração de hardware (HAL) de rádio para o recurso de seleção de domínio.

Esta seção fornece mais detalhes sobre essas etapas.

Adicionar entrada de serviço em AndroidManifest.xml

Para que seu app de seleção de domínio registre o serviço DomainSelectionService com o framework, adicione uma entrada de serviço no arquivo de manifesto usando o seguinte 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>

A definição de serviço em AndroidManifest.xml precisa definir os seguintes atributos para que o recurso de seleção de domínio funcione:

  • directBootAware="true": permite que o serviço seja descoberto e executado pela telefonia antes de o usuário desbloquear o dispositivo. O serviço não pode acessar o armazenamento criptografado pelo dispositivo antes que o usuário desbloqueie o dispositivo. Para mais informações, consulte Suporte ao modo de inicialização direta e Criptografia baseada em arquivos.
  • persistent="true": permite que o serviço seja executado de forma persistente e não seja interrompido pelo sistema para recuperar memória. Esse atributo funciona somente se o app for criado como um app do sistema.
  • permission="android.permission.BIND_DOMAIN_SELECTION_SERVICE": verifica se apenas um processo com a permissão BIND_DOMAIN_SELECTION_SERVICE concedida a ele pode se vincular ao app. Isso impede que um app malicioso se vincule ao serviço, porque somente apps do sistema podem receber a permissão do framework.

O serviço também precisa especificar o elemento intent-filter com a ação android.telephony.DomainSelectionService. Isso permite que o framework encontre o serviço DomainSelectionService.

Definir configuração na sobreposição do dispositivo

Para que a plataforma faça a vinculação segura ao serviço DomainSelectionService, adicione a seguinte configuração à sobreposição do dispositivo:

Como o Android não oferece suporte a apps com implementações DomainSelectionService para download de terceiros, o app de seleção de domínio precisa ser um app do sistema que reside na pasta /system_ext/priv-app/ ou /product/priv-app/. O framework verifica se o nome do pacote da implementação corresponde ao valor da sobreposição do dispositivo para verificar se apenas apps confiáveis e pré-instalados estão vinculados.

Compatibilidade com interfaces HAL de rádio

Para ativar o recurso de seleção de domínio, ofereça suporte às seguintes interfaces HAL de rádio necessárias:

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

Validação

Para testar se a estrutura de telefonia responde corretamente à interface DomainSelectionService, execute os testes do conjunto de teste de compatibilidade (CTS) em DomainSelectionServiceTestOnMockModem.