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 enthalten sind, als potenzielle Spamanrufe erkennen. Nutzer können Spamanrufe automatisch ablehnen lassen. Um Nutzern mehr Transparenz zu bieten, wenn Anrufe verpasst werden, werden Informationen zu diesen blockierten Anrufen in der Anrufliste gespeichert. Wenn du die Android 10 API verwendest, musst du nicht die Berechtigung READ_CALL_LOG vom Nutzer einholen, um Funktionen für den Anruf-Filter und die Anrufer-ID nutzen zu können.

Sie verwenden eine CallScreeningService-Implementierung, um Aufrufe zu filtern. Rufen Sie die Funktion onScreenCall() für alle neuen eingehenden oder ausgehenden Anrufe auf, wenn sich die Nummer nicht in der Kontaktliste des Nutzers befindet. Informationen zum Aufruf findest du im Objekt Call.Details. Konkret enthält die Funktion getCallerNumberVerificationStatus() vom Netzwerkanbieter Informationen zu der anderen Nummer. Wenn der Bestätigungsstatus fehlgeschlagen ist, weist dies darauf hin, dass der Anruf von einer ungültigen Nummer oder einem potenziellen Spamanruf stammt.

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

Legen Sie die onScreenCall()-Funktion so fest, dass respondToCall() aufgerufen wird, um dem System mitzuteilen, wie der neue Aufruf beantwortet werden soll. Diese Funktion verwendet einen CallResponse-Parameter, mit dem Sie das System anweisen können, den Aufruf zu blockieren, ihn so abzulehnen, als er ihn der Nutzer tat, oder ihn stummzuschalten. Sie können das System auch anweisen, diesen Aufruf gar nicht zur Anrufliste des Geräts hinzuzufügen.

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

Du musst die CallScreeningService-Implementierung in der Manifestdatei mit dem entsprechenden Intent-Filter und der entsprechenden Berechtigung registrieren, damit das System sie korrekt auslösen kann.

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