Ofereça visibilidade nativa à experiência no app de VoIP com a versão Alfa mais recente do Telecom

O lançamento inicial da biblioteca Jetpack Telecom apresentou 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, ela oferece suporte a extensões de chamada para recursos mais avançados, como gerenciamento de participantes, ícones personalizados, silenciamento de chamadas e resumo de reuniões em superfícies remotas, 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 de nível nativo para apps VoIP de terceiros. A versão mais recente apresenta novos recursos avançados, incluindo histórico de ligações unificado, exclusão de registro de chamadas e funcionalidade de retorno de chamada nativa, tornando o gerenciamento de chamadas mais simples do que nunca para os usuários.

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

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

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

E tem mais: agora os usuários podem iniciar uma chamada de retorno para um contato de 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 automaticamente a chamada.
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 a intent de retorno de chamada.
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 de registros de chamadas

Reconhecemos que nem todas as chamadas VoIP devem ficar visíveis 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 do registro de chamadas. Agora é possível 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 fica 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 retornos de chamada podem melhorar a experiência diária do usuário nos apps de 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 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 com o Google Meet. Para proteger contra spam, os discadores nativos usam listas de permissões de pacotes seguros para controlar a exibição de VoIP. Para testes locais das 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.