Anruf-Filter

Auf Geräten mit Android 10 (API-Level 29) oder höher kann deine App Anrufe von Nummern, die nicht im Adressbuch des Nutzers stehen, als potenzieller Spam Anrufe. Nutzer können festlegen, dass Spamanrufe automatisch abgelehnt werden. Um eine bessere Transparenz für Nutzer, wenn sie Anrufe verpassen, Informationen zu diesen blockierten Anrufe werden in der Anrufliste gespeichert. Die Android 10 API eliminiert die die Anforderung, die READ_CALL_LOG Berechtigung des Nutzers, um Anruf-Filter und Anrufer-IDs zu ermöglichen Funktionalität.

Sie verwenden eine CallScreeningService um Anrufe zu filtern. Rufen Sie die Methode onScreenCall() für neue ein- oder ausgehende Anrufe, wenn die Nummer nicht im in der Kontaktliste des Nutzers. Sie können die Objekt Call.Details für Informationen über den Anruf. Konkret bedeutet das getCallerNumberVerificationStatus() enthält Informationen des Netzbetreibers über die andere Nummer. Ist der Bestätigungsstatus fehlgeschlagen, ist dies ein Hinweis darauf, dass der Anruf von einer ungültigen Nummer oder einem potenziellen Spamanruf stammt.

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

Die aufzurufende onScreenCall()-Funktion festlegen respondToCall() um dem System mitzuteilen, wie auf den neuen Anruf reagiert werden soll. Diese Funktion verwendet eine CallResponse Parameter, mit dem Sie das System anweisen können, den Anruf zu blockieren und ihn so abzulehnen, als ob die der Nutzer getan hat, oder ihn stumm schalten. Sie können das System auch anweisen, das Hinzufügen Anruf in die Anrufliste des Geräts ein.

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

Sie müssen die CallScreeningService-Implementierung im Manifest registrieren Datei mit dem entsprechenden Intent-Filter und der entsprechenden Berechtigung, damit das System es richtig machen.

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