Filtrar chamadas

Dispositivos com o Android 10 (nível 29 da API) ou versões mais recentes permitem que o app identifique chamadas de números que não estão no catálogo de endereços do usuário como um possível spam chamadas. Os usuários podem optar por rejeitar chamadas de spam silenciosamente. Para oferecer transparência aos usuários quando eles perdem ligações, informações sobre é registrado no registro de chamadas. Usar a API do Android 10 elimina a requisito para receber READ_CALL_LOG permissão do usuário para fornecer o filtro de ligações e o identificador de chamadas funcionalidade de armazenamento.

Você usa um CallScreeningService implementação para filtrar chamadas. Chame o método onScreenCall() para novas chamadas recebidas ou efetuadas quando o número não estiver no lista de contatos do usuário. Confira a Objeto Call.Details para informações sobre a ligação. Especificamente, a getCallerNumberVerificationStatus() inclui informações da provedora de rede sobre o outro número. Se o status de verificação falhou, esta é uma boa indicação de que a ligação foi de um número inválido ou uma possível ligação 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
            }
        }
    }
}

Definir a função onScreenCall() para chamar respondToCall() para informar ao sistema como responder à nova chamada. Essa função toma CallResponse que pode ser usado para dizer ao sistema para bloquear a chamada, rejeitá-la como se fosse o que o usuário fez ou silenciá-lo. Você também pode dizer ao sistema para pular a adição dessa a chamada para o 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());

Registre a implementação de CallScreeningService no manifesto com o filtro de intent e a permissão adequados para que o sistema acione corretamente.

<service
    android:name=".ScreeningService"
    android:permission="android.permission.BIND_SCREENING_SERVICE">
    <intent-filter>
        <action android:name="android.telecom.CallScreeningService" />
    </intent-filter>
</service>