Filtrowanie połączeń

Urządzenia z Androidem 10 (poziom interfejsu API 29) lub nowszym umożliwiają aplikacji identyfikowanie połączeń z numerów, których nie ma w książce adresowej użytkownika, jako potencjalnych połączeń spamowych. Użytkownicy mogą włączyć dyskretne odrzucanie połączeń spamowych. Aby zapewnić użytkownikom większą przejrzystość informacji o nieodebranych połączeniach, informacje o tych zablokowanych połączeniach są rejestrowane w rejestrze połączeń. Korzystanie z interfejsu Android 10 API eliminuje konieczność uzyskiwania od użytkownika uprawnień do READ_CALL_LOG, aby zapewnić filtrowanie połączeń i funkcje identyfikatora rozmówcy.

Do filtrowania połączeń używasz implementacji CallScreeningService. Wywołaj funkcję onScreenCall() w przypadku każdego nowego połączenia przychodzącego lub wychodzącego, gdy numeru nie ma na liście kontaktów użytkownika. Informacje o wywołaniu znajdziesz w obiekcie Call.Details. W szczególności funkcja getCallerNumberVerificationStatus() zawiera informacje o drugim numerze od dostawcy sieci. Jeśli weryfikacja się nie powiodła, oznacza to, że połączenie jest z nieprawidłowego numeru lub może być spamem.

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.
                }
            }
        }
    }
}

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

Ustaw funkcję onScreenCall() tak, aby wywoływała respondToCall(), aby poinformować system, jak ma odpowiedzieć na nowe wywołanie. Ta funkcja przyjmuje parametr CallResponse, który pozwala systemowi blokować wywołanie, odrzucać je tak, jak gdyby to robił użytkownik, lub je wyciszać. Możesz też sprawić, że system całkowicie pominie dodawanie tego wywołania do rejestru połączeń urządzenia.

// 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)

// 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());

Aby system mógł ją prawidłowo aktywować, musisz zarejestrować w pliku manifestu implementację CallScreeningService, używając odpowiedniego filtra intencji i uprawnień.

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