iOS已实现来电识别，求Android自定义来电识别及自有应用来电显示方案

1. 如何为自有应用提供来电的Caller ID？ #

不同平台的实现路径差异挺大的，结合你提到iOS已经搞定的情况，我分平台给你拆解：

iOS端 #

你已经用到了Call Directory Extension，这是苹果官方推荐的原生方案，它能直接让系统通话应用从你的扩展里获取来电号码对应的标识信息，不需要额外弹窗，体验更贴合系统原生逻辑，后续只需要维护好扩展里的号码数据同步就行。

Android端 #

目前主要有两种主流方案：

• 弹窗提示方案：就是你提到的通过BroadcastReceiver监听来电广播，在原生通话界面上方弹出自定义窗口展示联系人信息，优点是开发快、不需要复杂的系统权限，但缺点是体验不够原生，部分厂商的系统可能会限制弹窗显示。
• 自定义联系人目录方案：也就是你关注的ContactsContract.Directory，这是Android官方提供的原生来电识别扩展能力，能让系统通话应用直接从你的应用数据库里查询号码信息，体验和系统自带联系人完全一致，下面我重点讲这个方案的可行性和实现步骤。

2. ContactsContract.Directory方案的可行性及实现方法 #

可行性结论 #

完全可行！这是Android官方为第三方应用开放的原生来电识别通道，只要你的应用正确实现相关组件并获取必要权限，系统通话应用就会自动把你的自定义目录纳入查询范围，来电时会直接显示你数据库里的联系人信息，比弹窗方案体验更流畅，适配性也更稳定（只要遵循官方规范）。

具体实现步骤 #

第一步：申请必要权限

在AndroidManifest.xml中添加权限（注意Android 6.0+需要动态申请）：

<!-- 读取联系人权限，系统用于验证目录合法性 -->
<uses-permission android:name="android.permission.READ_CONTACTS" />
<!-- 写入联系人权限，若需要同步数据到系统联系人库则添加，可选 -->
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<!-- Android 10+ 需要后台访问权限以支持数据同步 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

第二步：实现自定义ContentProvider

ContactsContract.Directory本质是通过ContentProvider暴露你的应用数据，系统通话应用会通过这个Provider查询号码对应的信息。你需要继承ContentProvider并实现核心查询方法：

class CustomCallerIdProvider : ContentProvider() {
    private lateinit var dbHelper: YourSQLiteHelper

    override fun onCreate(): Boolean {
        dbHelper = YourSQLiteHelper(context)
        return true
    }

    override fun query(
        uri: Uri,
        projection: Array<String>?,
        selection: String?,
        selectionArgs: Array<String>?,
        sortOrder: String?
    ): Cursor? {
        // 提取来电号码作为查询条件
        val phoneNumber = selectionArgs?.get(0) ?: return null
        // 从本地SQLite数据库查询匹配的联系人信息
        // 返回的Cursor需包含ContactsContract.CommonDataKinds.Phone的必要字段（如DISPLAY_NAME、NUMBER）
        return dbHelper.readableDatabase.query(
            "your_caller_table",
            projection,
            "number = ?",
            arrayOf(phoneNumber),
            null,
            null,
            sortOrder
        )
    }

    // 不需要的方法返回默认值即可
    override fun insert(uri: Uri, values: ContentValues?): Uri? = null
    override fun update(uri: Uri, values: ContentValues?, selection: String?, selectionArgs: Array<String>?): Int = 0
    override fun delete(uri: Uri, selection: String?, selectionArgs: Array<String>?): Int = 0
    override fun getType(uri: Uri): String? = null
}

第三步：注册ContentProvider和Directory

在AndroidManifest.xml中注册你的Provider，并声明为联系人目录：

<provider
    android:name=".CustomCallerIdProvider"
    android:authorities="com.yourpackage.callerid.provider"
    android:exported="true"
    android:permission="android.permission.READ_CONTACTS">
    <!-- 标记为联系人目录 -->
    <meta-data
        android:name="android.content.ContactsDirectory"
        android:value="true" />
    <!-- 配置目录显示信息 -->
    <meta-data
        android:name="android.provider.CONTACTS_DIRECTORY_NAME"
        android:value="你的应用来电识别" />
    <meta-data
        android:name="android.provider.CONTACTS_DIRECTORY_ICON"
        android:resource="@drawable/ic_caller_id" />
</provider>

第四步：测试验证

安装应用并授予权限后，打开系统通话应用的设置，找到「联系人来源」或「来电识别」选项，应该能看到你的应用目录。用测试号码模拟来电，系统就会自动显示你数据库里的联系人信息了。

注意事项 #

• 确保数据库中的号码格式与系统来电号码格式一致（比如统一带国家码），否则会出现匹配失败的情况。
• Android 11+对权限的限制更严格，需确保动态权限申请流程合规。
• 即使应用被杀死，只要Provider组件未被销毁，系统依然能查询到你的数据（Provider是独立运行的组件）。

内容的提问来源于stack exchange，提问作者AndreasSt