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

Integre-se ao Android Telecom Framework usando a biblioteca Core-Telecom 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 smartwatches.

Implementação necessária

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

ID Diretriz
AEP-TC-GAA Registro de chamadas: todas as chamadas VoIP recebidas e feitas precisam ser registradas no Telecom Framework usando a API CallsManager#addCall.
AEP-TC-GAB 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.
AEP-TC-GAC Tratamento de áudio: não use diretamente as APIs de áudio ou Bluetooth para gerenciar a seleção e o roteamento de áudio. Em vez disso, confie no Telecom Framework para lidar com cenários de chamadas simultâneas e mudanças de dispositivos de áudio.
AEP-TC-GAD Notificações: use a API callStyle para mostrar notificações de estilo de chamada que sejam consistentes com o sistema Android.
AEP-TC-GAE 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.
AEP-TC-GAF 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.
AEP-TC-GAG 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 da diretriz

Esta diretriz se aplica a:

  • Apps que oferecem recursos de chamada 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:

ID Isenção
Apps que não podem usar dependências do AndroidX devido a barreiras técnicas, como:
AEP-TC-EAA Conflitos de dependência do SDK.
AEP-TC-EAB Restrições do Android Open Source Project (AOSP).
AEP-TC-EAC Restrições do sistema de build do fabricante do equipamento original (OEM).
AEP-TC-EAD 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.
AEP-TC-EAE 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 Android Telecom Framework. Esses recursos são apenas para referência e não contêm outros requisitos do programa.