O framework do Android Telecom (também conhecido como "Telecom") gerencia chamadas de áudio e
vídeo em um dispositivo Android. Isso inclui chamadas baseadas em SIM, como
chamadas
que usam o framework de telefonia, e chamadas VoIP que implementam a
biblioteca Core-Telecom
do Jetpack.
Os principais componentes que a Telecom gerencia são ConnectionService
e
InCallService
.
Uma implementação de ConnectionService
se baseia em tecnologias como a PSTN para conectar
chamadas a outras partes. A implementação de ConnectionService
mais comum em um
smartphone é a ConnectionService
de telefonia. Ele conecta chamadas da operadora.
Uma implementação de InCallService
fornece uma interface do usuário para chamadas gerenciadas por
Telecom e permite que o usuário controle e interaja com essas chamadas. A implementação mais
comum de um InCallService
é o app de smartphone que acompanha
um dispositivo.
A empresa de telecomunicações atua como uma central telefônica. Ele encaminha chamadas que as implementações de ConnectionService
oferecem para as interfaces do usuário que as implementações de InCallService
oferecem.
Talvez você queira implementar as APIs de telecomunicações pelos seguintes motivos:
- Para criar uma substituição do app de telefone do sistema.
- Para integrar uma solução de chamada à experiência de chamada do Android.
Criar um app telefone substituto
Para criar um substituto para o app de telefone padrão em um dispositivo Android,
implemente a API InCallService
. A implementação precisa atender aos seguintes
requisitos:
- Ele não pode ter nenhum recurso de chamada e precisa consistir apenas da interface do usuário para chamadas.
- Ele precisa processar todas as chamadas que o framework de telecomunicações conhece e não fazer
suposições sobre a natureza das chamadas. Por exemplo, não é possível presumir
que as chamadas são baseadas em SIM nem implementar restrições de chamada
com base em um
ConnectionService
, como a aplicação de restrições de telefonia para chamadas de vídeo.
Para saber mais, consulte
InCallService
.
Integrar uma solução de chamada
Para integrar sua solução de chamadas ao Android, você tem as seguintes opções:
Implementar a biblioteca Core-Telecom Jetpack autogerenciada:essa opção é ideal para desenvolvedores de apps de chamada independentes que não querem mostrar as chamadas no app de telefone padrão nem outras chamadas na interface do usuário.
Ao integrar com a biblioteca Jetpack
Core-Telecom
, você ajuda o app a interagir não apenas com as chamadas de telefonia do sistema no dispositivo, mas também com outros apps de chamada independentes que se integram ao Telecom. A bibliotecaCore-Telecom
também gerencia o roteamento e a seleção de áudio. Para mais detalhes, consulte Criar um app de chamada.Implementar a API ConnectionService gerenciada:essa opção facilita o desenvolvimento de uma solução de chamada que depende do aplicativo de telefone do dispositivo para fornecer a interface do usuário para chamadas. Exemplos incluem uma implementação de terceiros de serviços de chamadas SIP e VoIP. Para ver mais detalhes, consulte
getDefaultDialerPackage()
.Um
ConnectionService
sozinho fornece apenas os meios de conexão de chamadas. Ele não tem uma interface do usuário associada.Implementar a API InCallService e a ConnectionService:essa opção é ideal se você quiser criar sua própria solução de chamada baseada em
ConnectionService
, com a própria interface do usuário, e também mostrar todas as outras chamadas do Android na mesma interface do usuário. Ao usar essa abordagem, a implementação deInCallService
não pode fazer suposições sobre as origens das chamadas exibidas. Além disso, a implementação deConnectionService
precisa continuar funcionando sem o app de smartphone padrão definido comoInCallService
personalizado.
Filtrar chamadas
Dispositivos com o Android 10 (nível 29 da API) ou versões mais recentes permitem que seu app identifique
chamadas de números que não estão no catálogo de endereços do usuário como possíveis chamadas
de spam. Os usuários podem optar por rejeitar ligações de spam silenciosamente. Para oferecer maior
transparência aos usuários quando eles perdem chamadas, as informações sobre essas chamadas
bloqueadas são registradas no registro de chamadas. O uso da API do Android 10 elimina a
necessidade de receber a permissão
READ_CALL_LOG
do usuário para oferecer a funcionalidade de filtro de ligações e identificador de chamadas.
Você usa uma
implementação de
CallScreeningService
para filtrar chamadas. Chame a função
onScreenCall()
para qualquer nova chamada recebida ou feita quando o número não estiver na
lista de contatos do usuário. Você pode conferir o objeto
Call.Details
para saber mais
sobre a chamada. Especificamente, a função
getCallerNumberVerificationStatus()
inclui informações do provedor de rede sobre o outro número.
Se o status de verificação tiver falhado, isso é uma boa indicação de que a chamada
é de um número inválido ou de uma possível chamada de spam.
Kotlin
class ScreeningService : CallScreeningService() { // This function is called when an ingoing or outgoing call // is from a number not in the user's contacts list override fun onScreenCall(callDetails: Call.Details) { // Can check the direction of the call val isIncoming = callDetails.callDirection == Call.Details.DIRECTION_INCOMING if (isIncoming) { // the handle (e.g. phone number) that the Call is currently connected to val handle: Uri = callDetails.handle // determine if you want to allow or reject the call when (callDetails.callerNumberVerificationStatus) { Connection.VERIFICATION_STATUS_FAILED -> { // Network verification failed, likely an invalid/spam call. } Connection.VERIFICATION_STATUS_PASSED -> { // Network verification passed, likely a valid call. } else -> { // Network could not perform verification. // This branch matches Connection.VERIFICATION_STATUS_NOT_VERIFIED. } } } } }
Java
class ScreeningService extends CallScreeningService { @Override public void onScreenCall(@NonNull Call.Details callDetails) { boolean isIncoming = callDetails.getCallDirection() == Call.Details.DIRECTION_INCOMING; if (isIncoming) { Uri handle = callDetails.getHandle(); switch (callDetails.getCallerNumberVerificationStatus()) { case Connection.VERIFICATION_STATUS_FAILED: // Network verification failed, likely an invalid/spam call. break; case Connection.VERIFICATION_STATUS_PASSED: // Network verification passed, likely a valid call. break; default: // Network could not perform verification. // This branch matches Connection.VERIFICATION_STATUS_NOT_VERIFIED } } } }
Defina a função onScreenCall()
para chamar
respondToCall()
e informar ao sistema como responder à nova chamada. Essa função recebe um parâmetro
CallResponse
que pode ser usado para informar ao sistema que a chamada deve ser bloqueada, rejeitada como se
o usuário tivesse feito isso ou silenciada. Também é possível pedir para o sistema pular a adição dessa
ligação ao registro de chamadas do dispositivo.
Kotlin
// Tell the system how to respond to the incoming call // and if it should notify the user of the call. val response = CallResponse.Builder() // Sets whether the incoming call should be blocked. .setDisallowCall(false) // Sets whether the incoming call should be rejected as if the user did so manually. .setRejectCall(false) // Sets whether ringing should be silenced for the incoming call. .setSilenceCall(false) // Sets whether the incoming call should not be displayed in the call log. .setSkipCallLog(false) // Sets whether a missed call notification should not be shown for the incoming call. .setSkipNotification(false) .build() // Call this function to provide your screening response. respondToCall(callDetails, response)
Java
// Tell the system how to respond to the incoming call // and if it should notify the user of the call. CallResponse.Builder response = new CallResponse.Builder(); // Sets whether the incoming call should be blocked. response.setDisallowCall(false); // Sets whether the incoming call should be rejected as if the user did so manually. response.setRejectCall(false); // Sets whether ringing should be silenced for the incoming call. response.setSilenceCall(false); // Sets whether the incoming call should not be displayed in the call log. response.setSkipCallLog(false); // Sets whether a missed call notification should not be shown for the incoming call. response.setSkipNotification(false); // Call this function to provide your screening response. respondToCall(callDetails, response.build());
É necessário registrar a implementação CallScreeningService
no arquivo de manifesto
com o filtro de intent e a permissão adequados para que o sistema possa acionar
corretamente.
<service
android:name=".ScreeningService"
android:permission="android.permission.BIND_SCREENING_SERVICE">
<intent-filter>
<action android:name="android.telecom.CallScreeningService" />
</intent-filter>
</service>
Redirecionar uma chamada
Dispositivos com o Android 10 ou mais recente gerenciam intents de chamada de maneira diferente dos
dispositivos com o Android 9 ou versões anteriores. No Android 10 e versões mais recentes, a transmissão
ACTION_NEW_OUTGOING_CALL
foi descontinuada e substituída pela
API
CallRedirectionService
. O CallRedirectionService
fornece interfaces para você usar e
modificar chamadas de saída feitas pela plataforma Android. Por exemplo, apps de terceiros
podem cancelar chamadas e redirecioná-las por VoIP.
Kotlin
class RedirectionService : CallRedirectionService() { override fun onPlaceCall( handle: Uri, initialPhoneAccount: PhoneAccountHandle, allowInteractiveResponse: Boolean ) { // Determine if the call should proceed, be redirected, or cancelled. val callShouldProceed = true val callShouldRedirect = false when { callShouldProceed -> { placeCallUnmodified() } callShouldRedirect -> { // Update the URI to point to a different phone number or modify the // PhoneAccountHandle and redirect. redirectCall(handle, initialPhoneAccount, true) } else -> { cancelCall() } } } }
Java
class RedirectionService extends CallRedirectionService { @Override public void onPlaceCall( @NonNull Uri handle, @NonNull PhoneAccountHandle initialPhoneAccount, boolean allowInteractiveResponse ) { // Determine if the call should proceed, be redirected, or cancelled. // Your app should implement this logic to determine the redirection. boolean callShouldProceed = true; boolean callShouldRedirect = false; if (callShouldProceed) { placeCallUnmodified(); } else if (callShouldRedirect) { // Update the URI to point to a different phone number or modify the // PhoneAccountHandle and redirect. redirectCall(handle, initialPhoneAccount, true); } else { cancelCall(); } } }
É necessário registrar esse serviço no manifesto para que o sistema possa iniciá-lo corretamente.
<service
android:name=".RedirectionService"
android:permission="android.permission.BIND_CALL_REDIRECTION_SERVICE">
<intent-filter>
<action android:name="android.telecom.CallRedirectionService"/>
</intent-filter>
</service>
Para usar um serviço de redirecionamento, seu app precisa solicitar o papel de redirecionamento de chamadas
do RoleManager
. Isso vai perguntar
ao usuário se ele quer permitir que seu app processe redirecionamentos de chamada. Se o app
não receber essa função, o serviço de redirecionamento não será usado.
Verifique se o app tem essa função quando o usuário o inicia para
que você possa solicitá-la conforme necessário. Você inicia uma intent criada pelo RoleManager
.
Por isso, substitua a função
onActivityResult()
para processar a seleção do usuário.
Kotlin
class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // Tell the system that you want your app to handle call redirects. This // is done by using the RoleManager to register your app to handle redirects. if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) { val roleManager = getSystemService(Context.ROLE_SERVICE) as RoleManager // Check if the app needs to register call redirection role. val shouldRequestRole = roleManager.isRoleAvailable(RoleManager.ROLE_CALL_REDIRECTION) && !roleManager.isRoleHeld(RoleManager.ROLE_CALL_REDIRECTION) if (shouldRequestRole) { val intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_CALL_REDIRECTION) startActivityForResult(intent, REDIRECT_ROLE_REQUEST_CODE) } } } companion object { private const val REDIRECT_ROLE_REQUEST_CODE = 1 } }
Java
class MainActivity extends AppCompatActivity { private static final int REDIRECT_ROLE_REQUEST_CODE = 0; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // Tell the system that you want your app to handle call redirects. This // is done by using the RoleManager to register your app to handle redirects. if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) { RoleManager roleManager = (RoleManager) getSystemService(Context.ROLE_SERVICE); // Check if the app needs to register call redirection role. boolean shouldRequestRole = roleManager.isRoleAvailable(RoleManager.ROLE_CALL_REDIRECTION) && !roleManager.isRoleHeld(RoleManager.ROLE_CALL_REDIRECTION); if (shouldRequestRole) { Intent intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_CALL_REDIRECTION); startActivityForResult(intent, REDIRECT_ROLE_REQUEST_CODE); } } } }