تصفية المكالمات

إنّ الأجهزة التي تعمل بنظام التشغيل Android 10 (المستوى 29 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث تتيح لتطبيقك التعرّف على المكالمات الواردة من أرقام غير موجودة في دفتر عناوين المستخدم كأرقام غير مرغوب فيها محتملة الاتصالات. يمكن للمستخدمين اختيار رفض المكالمات غير المرغوب فيها تلقائيًا. لتوفير قيم أكبر الشفافية للمستخدمين عند تفويت مكالمات، والمعلومات حول المكالمات المحظورة في سجل المكالمات. يؤدي استخدام واجهة برمجة التطبيقات Android 10 API إلى القضاء على الحصول على READ_CALL_LOG إذن من المستخدم لتوفير فحص المكالمات وإظهار رقم المتّصل الأخرى.

يمكنك استخدام CallScreeningService التنفيذ لفحص المكالمات. عليك استدعاء onScreenCall() لأي مكالمات واردة أو صادرة جديدة عندما لا يكون الرقم قائمة جهات اتصال المستخدم. يمكنك الاطّلاع على عنصر Call.Details للمعلومات بشأن المكالمة. وعلى وجه التحديد، getCallerNumberVerificationStatus() معلومات من مزود الشبكة حول الرقم الآخر. إذا فشلت حالة التحقق، فهذا مؤشر جيد على أن المكالمة من رقم غير صالح أو من مكالمة محتملة غير مرغوب فيها

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

ضبط الدالة onScreenCall() لطلب البيانات respondToCall() لإعلام النظام بكيفية الاستجابة للمكالمة الجديدة. تأخذ هذه الدالة CallResponse يمكنك استخدامها لإعلام النظام بحظر المكالمة، ورفضها كما لو المستخدم أو كتم صوته. يمكنك أيضًا الطلب من النظام تخطّي عملية إضافة هذه البيانات. إلى سجل مكالمات الجهاز تمامًا.

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

يجب تسجيل تنفيذ CallScreeningService في البيان. يحتوي على الإذن وفلتر الأهداف المناسبَين حتى يتمكن النظام من تشغيل بشكل صحيح.

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