מכשירים עם Android מגרסה 10 ומעלה (רמת API 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
במניפסט
עם הרשאה ומסנן Intent מתאימים, כדי שהמערכת תוכל להפעיל
אותו כמו שצריך.
<service
android:name=".ScreeningService"
android:permission="android.permission.BIND_SCREENING_SERVICE">
<intent-filter>
<action android:name="android.telecom.CallScreeningService" />
</intent-filter>
</service>