Diretriz do AEP: framework de telecomunicações do Android

Faça a integração com o framework de telecomunicações do Android usando a biblioteca Core-Telecom do Jetpack para garantir que as chamadas de voz sobre IP (VoIP) sejam tratadas como um recurso principal pelo sistema operacional, em pé de igualdade com as chamadas tradicionais baseadas em SIM. Essa integração unifica o gerenciamento de chamadas, melhora o tratamento de áudio e permite a compatibilidade com dispositivos remotos, como fones de ouvido e relógios.

Implementação necessária

Para se qualificar para o AEP, seu app precisa obedecer aos seguintes requisitos:

  • Registro de chamadas: todas as chamadas VoIP recebidas e feitas precisam ser registradas no framework de telecomunicações usando a API CallsManager#addCall.
  • Gerenciamento de estado: use o CallControlScope e outras construções de biblioteca para refletir e gerenciar com precisão o ciclo de vida do estado da chamada, incluindo os estados de discagem, toque, ativo, em espera e desconectado.
  • Tratamento de áudio: não use diretamente as APIs de áudio ou Bluetooth para gerenciar a seleção de áudio e o roteamento. Em vez disso, confie no framework de telecomunicações para lidar com cenários de chamadas simultâneas e mudanças de dispositivos de áudio.
  • Notificações: use a API callStyle para mostrar notificações de estilo de chamada que sejam consistentes com o sistema Android.
  • Ciclo de vida do serviço em primeiro plano: gerencie o ciclo de vida de todos os serviços em primeiro plano necessários para a chamada de acordo com as práticas recomendadas e limitações do Android.
  • Integração de superfície remota: sincroniza o estado e os controles de chamadas com superfícies remotas conectadas, como fones de ouvido Bluetooth, dispositivos Wear OS e Android Auto.
  • Cenários de várias chamadas: processa interações com outras chamadas, como chamadas SIM recebidas ou chamadas de outros aplicativos VoIP, garantindo um comportamento de áudio e uma experiência do usuário previsíveis.

Aplicabilidade das diretrizes

Esta diretriz se aplica a:

  • Apps que oferecem recursos de chamadas de voz sobre IP (VoIP).
  • Todos os formatos em que o app está disponível.

Isenções

As seguintes isenções se aplicam a esta diretriz:

  • Apps que não podem usar dependências do AndroidX devido a barreiras técnicas, como:
    • Conflitos de dependência do SDK
    • Restrições do Android Open Source Project (AOSP)
    • Restrições do sistema de build do fabricante do equipamento original (OEM)
  • Isenções temporárias podem ser concedidas para apps que encontram problemas significativos de plataforma ou biblioteca que impedem uma migração estável, desde que haja um cronograma claro para a resolução e o problema tenha sido aceito pelo Google.
  • Os apps podem usar um framework alternativo equivalente que ofereça qualidade, recursos do usuário, estabilidade e compatibilidade semelhantes em todo o ecossistema. Entre em contato com o suporte se você tiver um framework adequado para consideração.

Documentação e recursos de recursos

Os recursos a seguir fornecem orientações de implementação e detalhes técnicos sobre o framework de telecomunicações do Android. Esses recursos são apenas para referência e não contêm outros requisitos do programa.