Aproveite a visibilidade nativa na experiência do app VoIP com a versão Alfa mais recente do Telecom

O lançamento inicial da biblioteca Jetpack Telecom introduziu CallsManager, substituindo a API legada ConnectionService para simplificar a integração de VoIP. O CallsManager simplifica o gerenciamento do ciclo de vida da chamada e o roteamento de áudio, permitindo interações com superfícies remotas, como smartwatches, dispositivos Bluetooth e Android Auto. Além disso, ele oferece suporte a extensões de chamada para recursos mais avançados, como tratamento de participantes, ícones personalizados, silenciamento de chamadas e resumo de reuniões em superfícies remotas, 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 nativas para apps VoIP de terceiros. Essa 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 Telefone: histórico de ligações unificado e chamadas de retorno

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

Melhor ainda, os usuários agora podem iniciar um callback 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. Registre-se para callbacks:seu app VoIP precisa registrar um novo intent protegido pelo sistema: TelecomManager.ACTION_CALL_BACK.
2. Registre a chamada:use TelecomManager.addCall (ou APIs relacionadas do Jetpack) para garantir que o sistema registre a chamada automaticamente.
3. Gerencie IDs de chamadas:quando uma chamada é registrada, CallControlScope.getCallId fornece um UUID exclusivo. O discador do sistema usa esse TelecomManager.EXTRA_UUID exato ao criar o intent de callback.
4. Inicie 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 precisam 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 apresentando 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 a 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 este link para compilar seu app com o SDK 36.1 do Android.

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 seus aplicativos VoIP.

Para ajudar você a começar e conferir 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 se 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 registro, recomendamos usar o app de discador de exemplo do Telecom de código aberto como ambiente de emulador.