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.

domain-selection-architecture

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 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. Compatibilidade com as interfaces HAL de rádio necessárias 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": garante que apenas um processo com a permissão BIND_DOMAIN_SELECTION_SERVICE concedida a ele possa se vincular ao app. Isso impede que um app malicioso se vincule ao serviço, porque somente os 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 se vincule com segurança 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 garantir que apenas apps confiáveis e pré-instalados sejam 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 CTS em DomainSelectionServiceTestOnMockModem.