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 plataformas 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 da reunião 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.

Preenchendo a lacuna do discador: histórico de ligações unificado e callbacks

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 discadores 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 esse TelecomManager.EXTRA_UUID exato 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 e iniciar a chamada com os detalhes corretos.

Controle refinado: exclusão do registro 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 é mostrado.

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 registro 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

Incentivamos os desenvolvedores a testar essas integrações e descobrir como o histórico de ligações unificado e os callbacks podem melhorar a experiência diária do usuário 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 discador de amostra do Telecom de código aberto como ambiente de emulador.