实现电话号码屏蔽功能

电话是一种开放的通信渠道，任何人都可以随时向任何电话号码致电或者发送短信，因此 Android 用户需要能够轻松屏蔽骚扰电话和短信。

在 Android N 推出之前，Android 用户只能依靠下载的应用来限制来自骚扰电话号码的来电和短信。但是，由于没有适当的 API 来屏蔽来电和短信，这些应用大部分要么达不到预期效果，要么用户体验不佳。

一些制造商可能会提供他们自己的开箱即用型屏蔽解决方案，但是如果用户更换设备，由于缺乏互用性，他们的屏蔽列表可能会完全丢失。最后，即便用户采用了提供此类功能的拨号应用和短信客户端，他们可能仍需在每个应用中执行屏蔽操作，才能有效屏蔽来电和短信。

功能

Android 7.0 版本引入了 BlockedNumberProvider 内容提供程序，用于存储用户指定的电话号码列表，这些号码不应该通过电话通讯（通话、短信、彩信）与用户联系。系统会参考屏蔽列表中的号码，限制来自这些号码的来电和短信。Android 7.0 不仅会显示屏蔽号码列表，还可让用户添加和删除号码。

此外，借助号码屏蔽功能，系统能够与平台上的相关应用协同工作，有助于保护用户并为用户提供便捷体验。默认拨号器、默认短信客户端、UICC 授权应用以及与系统具有相同签名的应用都可以直接对屏蔽列表执行读写操作。由于屏蔽号码存储在系统中，无论用户使用哪种拨号或短信应用，这些号码始终会被屏蔽。最后，用户可在任何制造商的任何新设备中恢复屏蔽号码列表。

确保用户可以使用开箱即用的屏蔽功能，并且在切换应用或更换新手机时不会丢失屏蔽列表。系统中所有相关应用均可共享同一个列表，为用户提供最流畅的体验。
应用开发者无需自行开发功能来管理屏蔽列表、来电和短信。他们只需使用平台提供的功能即可。
用户选择的默认拨号器/短信应用可以直接对提供程序执行读写操作。其他应用可以使用 createManageBlockedNumbersIntent() 启动屏蔽列表管理界面
原始设备制造商 (OEM) 可以利用平台提供的功能来实现开箱即用型屏蔽功能。OEM 可以放心，当用户从其他 OEM 的设备切换到当前设备时，他们将拥有更好的入门体验，因为屏蔽列表也将转移到当前设备。
如果运营商有自己的拨号器或即时通讯应用，他们可以重复使用平台功能，从而让用户继续使用屏蔽列表。他们可以放心，即使用户使用新设备，在新设备中仍可使用屏蔽列表。最后，所有运营商授权应用都可以读取该屏蔽列表，因此，如果运营商希望基于该屏蔽列表向用户提供更强大的额外屏蔽功能，现在已可以基于此功能来实现该目的。

数据流

图 1. 屏蔽电话号码数据流

示例和源代码

以下是使用号码屏蔽新功能的调用示例：

从应用启动屏蔽号码管理程序

Context.startActivity(telecomManager.createManageBlockedNumbersIntent(), null);

查询屏蔽号码

Cursor c = getContentResolver().query(BlockedNumbers.CONTENT_URI,
         new String[]{BlockedNumbers.COLUMN_ID,
         BlockedNumbers.COLUMN_ORIGINAL_NUMBER,
         BlockedNumbers.COLUMN_E164_NUMBER}, null, null, null);

添加屏蔽号码

ContentValues values = new ContentValues();
values.put(BlockedNumbers.COLUMN_ORIGINAL_NUMBER, "1234567890");
Uri uri = getContentResolver().insert(BlockedNumbers.CONTENT_URI, values);

删除屏蔽号码

ContentValues values = new ContentValues();
values.put(BlockedNumbers.COLUMN_ORIGINAL_NUMBER, "1234567890");
Uri uri = getContentResolver().insert(BlockedNumbers.CONTENT_URI, values);
getContentResolver().delete(uri, null, null);

实现

以下是使用号码屏蔽功能前必须完成的高级任务：

OEM 使用 BlockedNumberProvider 在其设备上实现呼叫/短信限制功能
如果运营商有拨号器或即时通讯应用，请使用 BlockedNumberProvider 实现呼叫/短信限制功能
第三方拨号器和即时通讯应用供应商使用 BlockedNumberProvider 实现屏蔽功能

面向 OEM 的建议

如果设备之前从未配备任何其他呼叫/短信限制功能，请在所有此类设备上使用 Android 开源项目 (AOSP) 中的号码屏蔽功能。建议支持合理的屏蔽入口点，如从通话记录中或短信会话中屏蔽号码。

如果设备在之前出厂时就具备呼叫/短信限制功能，请调整这些功能，以确保将所有严格匹配的被屏蔽电话号码都存储在 BlockedNumberProvider, 中，并确保围绕该提供程序发生的行为满足 Android 兼容性定义文档 (CDD) 中针对此功能列出的要求。

只要满足 CDD 中有关屏蔽严格匹配的电话号码的要求，便可以通过自定义提供程序和自定义界面/控件来实现其他高级功能。建议将其他功能标记为“高级”功能，以避免与基本号码屏蔽功能相混淆。

API

以下是使用的 API：

TelecomManager API
- Intent createManageBlockedNumbersIntent()
Carrier Config
- KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT
请参阅 BlockedNumberContract
- 由 BlockedNumberContract 提供的 API
- boolean isBlocked(Context context, String phoneNumber)
- int unblock(Context context, String phoneNumber)
- boolean canCurrentUserBlockNumbers(Context context)

界面

AOSP 中提供的 BlockedNumbersActivity.java 界面可以按原样使用。只要符合相关 CDD 要求，设备实现人员也可以实现自己的界面版本。

请注意，如需使用 BlockedNumberProvider 实现屏蔽列表恢复功能，可能需要合作伙伴的 PC 备份和恢复应用。如需查看 AOSP 中提供的屏蔽号码界面，请参见下图。

图 2. 屏蔽电话号码界面

验证

实现人员可以运行以下 CTS 测试，从而确保其功能版本能够按预期运行：

android.provider.cts.BlockedNumberContractTest
com.android.cts.numberblocking.hostside.NumberBlockingTest
android.telecom.cts.ExtendedInCallServiceTest#testIncomingCallFromBlockedNumber_IsRejected
android.telephony.cts.SmsManagerTest#testSmsBlocking

在运行 $ adb root 之后，可以使用 adb 命令来操作 BlockedNumberProvider。例如：

adb root
adb shell content query --uri content://com.android.blockednumber/blocked
adb shell content insert --uri / content://com.android.blockednumber/blocked --bind / original_number:s:'6501002000'
adb shell content delete --uri / content://com.android.blockednumber/blocked/1