O lançamento inicial da biblioteca Jetpack Telecom introduziu o CallsManager, substituindo a API ConnectionService legada para simplificar a integração de VoIP. O CallsManager simplifica o gerenciamento do ciclo de vida das chamadas e o roteamento de áudio, além de permitir interações com superfícies remotas, como smartwatches, dispositivos Bluetooth e Android Auto. Além disso, ele é compatível com extensões de chamada para recursos mais avançados, como gerenciamento de participantes, ícones personalizados, silenciamento de chamadas e resumo de reuniões em dispositivos remotos. Tudo isso mantendo a compatibilidade com versões anteriores até o Android O (nível 26 da API).

Com base nisso, o Jetpack Telecom v1.1.0 oferece visibilidade e conveniência no nível nativo para apps VoIP de terceiros. Esta versão mais recente apresenta novos recursos avançados, incluindo histórico de ligações unificado, exclusão de registros de chamadas e funcionalidade de callback nativa, tornando o gerenciamento de chamadas mais fácil do que nunca para os usuários.

Confira mais detalhes sobre as novidades e como implementar esses recursos nos seus aplicativos.

Bridging the Dialer Gap: Unified call history and Callbacks (em inglês)

Antes, os usuários precisavam abrir apps de terceiros individuais para ver o histórico de ligações VoIP ou retornar uma ligação perdida. Com o novo recurso integrado de registro de chamadas, os apps de discador do sistema agora podem mostrar registros de chamadas diretamente de apps VoIP de terceiros.

Melhor ainda, agora os usuários podem iniciar uma ligação de retorno para um contato VoIP diretamente do discador nativo do sistema, simplificando a experiência de comunicação.

Como funciona:

Para ativar esse recurso, faça o seguinte:

1. Registrar callbacks:seu app VoIP precisa registrar uma nova intent protegida pelo sistema: TelecomManager.ACTION_CALL_BACK.
2. Registrar a chamada:use TelecomManager.addCall ou APIs Jetpack relacionadas para garantir que o sistema registre a chamada automaticamente.
3. Gerenciar IDs de chamada:quando uma chamada é registrada, o CallControlScope.getCallId fornece um UUID exclusivo. O discador do sistema usa exatamente esse TelecomManager.EXTRA_UUID ao criar o intent de callback.
4. Iniciar o callback:seu aplicativo precisa armazenar e gerenciar os detalhes da chamada associados a esse UUID. Quando o discador do sistema aciona o intent de callback com o EXTRA_UUID, seu app pode resolver o ID sem problemas e iniciar a chamada com os detalhes corretos.

Controle refinado: exclusão de registros de chamadas

Sabemos que nem todas as chamadas VoIP precisam aparecer no histórico do discador nativo do sistema. Seja por motivos de privacidade, comunicação efêmera ou comportamento específico do app, você precisa controlar o que aparece.

Para resolver isso, estamos lançando a Exclusão de registros de chamadas. Agora você pode impedir que chamadas específicas sejam registradas nos registros de chamadas do sistema definindo o booleano isLogExcluded como true em CallAttributesCompat. Ao configurar essa flag, a chamada permanece completamente oculta dos registros do sistema, e o discador nativo não a mostra.

Observação importante sobre compatibilidade

Esses recursos integrados de geração de registros e callback estão disponíveis para dispositivos com Android 16.1 (SDK 36.1) e versões mais recentes. Consulte aqui para compilar seu app com o SDK do Android 36.1.

Começar

Recomendamos que os desenvolvedores testem essas integrações e descubram como o histórico de ligações unificado e os callbacks podem melhorar a experiência diária dos usuários dos aplicativos VoIP.

Para ajudar você a começar e ver essas APIs em ação, criamos um aplicativo de exemplo que demonstra as novas integrações.

• Confira o app de exemplo aqui: https://github.com/android/platform-samples/tree/main/samples/connectivity/telecom

Confira as notas da versão e a documentação para começar a implementar esses recursos hoje mesmo.

Observação: embora as APIs do Jetpack Telecom v1.1.0 estejam acessíveis para integração, a capacidade do discador do sistema de renderizar registros de chamadas nativos está sendo introduzida em fases, começando pelo Google Meet. Para evitar spam, os discadores nativos usam listas de permissões de pacotes seguros para controlar a exibição de VoIP. Para testar localmente suas implementações de callback e geração de registros, recomendamos usar o app de discagem de amostra do Telecom de código aberto como ambiente de emulador.