Saring panggilan

Perangkat yang menjalankan Android 10 (API level 29) atau yang lebih baru memungkinkan aplikasi Anda untuk mengidentifikasi panggilan dari nomor yang tidak ada di buku alamat pengguna sebagai berpotensi spam panggilan telepon. Pengguna dapat memilih agar panggilan telepon spam ditolak secara diam-diam. Untuk menyediakan transparansi kepada pengguna saat mereka melewatkan panggilan, informasi tentang hal ini yang diblokir panggilan dicatat dalam log panggilan. Menggunakan Android 10 API akan menghilangkan persyaratan untuk memperoleh READ_CALL_LOG izin dari pengguna untuk memberikan penyaringan panggilan dan ID penelepon fungsionalitasnya.

Anda menggunakan CallScreeningService untuk menyaring panggilan. Panggil onScreenCall() untuk setiap panggilan masuk atau keluar baru bila nomor tersebut tidak ada dalam daftar kontak pengguna. Anda dapat memeriksa Objek Call.Details untuk informasi mengenai panggilan tersebut. Secara khusus, opsi getCallerNumberVerificationStatus() berisi informasi dari penyedia jaringan tentang nomor lainnya. Jika status verifikasi gagal, ini merupakan indikasi yang baik bahwa panggilan telah dari nomor yang tidak valid atau panggilan telepon yang berpotensi 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
            }
        }
    }
}

Setel fungsi onScreenCall() untuk memanggil respondToCall() untuk memberi tahu sistem bagaimana merespons panggilan baru itu. Fungsi ini mengambil CallResponse yang dapat digunakan untuk memberi tahu sistem agar memblokir panggilan, menolaknya seolah-olah dilakukan pengguna, atau membisukannya. Anda juga dapat memberi tahu sistem untuk melewati penambahan ini ke log panggilan perangkat secara keseluruhan.

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

Anda harus mendaftarkan implementasi CallScreeningService dalam manifes dengan filter intent dan izin yang sesuai sehingga sistem dapat memicu data dengan benar.

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