Android来电监听

Posted 2023-02-06 摸爬滚打的程序媛

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Android来电监听相关的知识，希望对你有一定的参考价值。

android 来电监听

⭐ 最近项目中有个需求是：监听手机来电，如果是来电号码是本地已存储的联系人，则显示本地联系人的名字；否则，就直接显示来电号码。

🖊🖊🖊因为这个需求平时遇到的少，所以这里记录一下🖊🖊🖊。

1 依据来电号码查询本地联系人

先来看看如何根据来电号码查询本地联系人呢？

1.1 权限

这里需要访问手机通讯录的权限READ_CONTACTS，分别在配置文件中静态申请以及代码中动态申请。

<!--读取手机通讯录-->
<uses-permission android:name="android.permission.READ_CONTACTS"/>

动态权限申请在后面的代码中。

1.2 实现

	/**
     * 获取来电号码对应的联系人名称
     * @param context        上下文
     * @param phoneNumber   电话号码
     * @return    联系人名称（如果来电号码没有对应联系人名称，则直接返回电话号码）
     */
    public static String getIncomingCallName(Context context,String phoneNumber)
        //格式化电话号码
        if(phoneNumber == null)
            return null;
        
        phoneNumber = phoneNumber.trim().replace(" ","").replace("-","");

        //是否查询到
        boolean isSuccess = false;
        String phoneName = null;

        //联系人的Uri，也就是content://com.android.contacts/contacts
        Uri uri = ContactsContract.Contacts.CONTENT_URI;
        //指定获取_id和display_name两列数据，display_name即为姓名
        String[] projection = new String[]
                ContactsContract.Contacts._ID,
                ContactsContract.Contacts.DISPLAY_NAME
        ;
        //根据Uri查询相应的ContentProvider，cursor为获取到的数据集
        Cursor cursor = context.getContentResolver().query(uri, projection, null, null, null);

        if (cursor != null && cursor.moveToFirst()) 
            do 
                try 
                    Long id = cursor.getLong(0);
                    //获取姓名
                    String name = cursor.getString(1);
                    //指定获取NUMBER这一列数据
                    String[] phoneProjection = new String[]
                            ContactsContract.CommonDataKinds.Phone.NUMBER
                    ;

                    //根据联系人的ID获取此人的电话号码
                    Cursor phonesCursor = context.getContentResolver().query(
                            ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                            phoneProjection,
                            ContactsContract.CommonDataKinds.Phone.CONTACT_ID + "=" + id,
                            null,
                            null);

                    //因为每个联系人可能有多个电话号码，所以需要遍历
                    if (phonesCursor != null && phonesCursor.moveToFirst()) 
                        do 
                            String num = phonesCursor.getString(0);
                            num = num.trim().replace(" ","").replace("-","");
                            if(num.equals(phoneNumber))
                                //查询到号码
                                isSuccess = true;
                                phoneName = name;
                                break;  //退出
                            
                         while (phonesCursor.moveToNext());
                    

                    //已经找到，退出大循环
                    if(isSuccess)
                        break;
                    

                catch (Exception e) 
                    e.printStackTrace();
                
             while (cursor.moveToNext());
        

        //如果来电号码没有对应联系人名称，则直接返回电话号码
        if(isSuccess) 
            return phoneName;
        else
            return phoneNumber;

2 来电监听方法（有两种）

监听手机来电的方法一般有两种：使用系统广播监听 和使用PhoneStateListener 监听器。
下面分别来讲解这两种方法的使用。

2.1 系统广播监听

2.1.1 权限

通过监听广播的方式来监听来电时，必须需要以下两个权限.READ_PHONE_STATE和READ_CALL_LOG，因为是危险权限，除了静态表明外，Android6.0以后还必须要动态申请。

<!--读取手机状态-->
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<!--读取手机通话记录：Android 9.0没有此权限，获取不到来电号码-->
<uses-permission android:name="android.permission.READ_CALL_LOG"/>
<!--读取手机通讯录-->
<uses-permission android:name="android.permission.READ_CONTACTS"/>

动态申请权限（此处使用郭霖的开源库PermissionX权限库进行权限申请）

//PermissionX权限库
implementation 'com.permissionx.guolindev:permissionx:1.4.0'

//广播监听方式监听来电，需要检测的权限
    private void checkBroadcastCallPermission() 
        PermissionX.init(this)
                .permissions(   //传入需要申请的权限
                        Manifest.permission.READ_PHONE_STATE,
                        Manifest.permission.READ_CONTACTS,
                        Manifest.permission.READ_CONTACTS)
                .onExplainRequestReason(new ExplainReasonCallbackWithBeforeParam() 
                    @Override
                    public void onExplainReason(ExplainScope scope, List<String> deniedList, boolean beforeRequest) 
                        scope.showRequestReasonDialog(deniedList, "来电监听需要授予'获取设备信息和访问手机通话记录'的权限，依据来电号码查询联系人需要'读取手机通讯录'权限,否则应用无法正常使用", "我已明白");
                    
                )
                .onForwardToSettings(new ForwardToSettingsCallback() 
                    @Override
                    public void onForwardToSettings(ForwardScope scope, List<String> deniedList) 
                        scope.showForwardToSettingsDialog(deniedList, "您需要去应用程序设置当中手动开启权限", "我已明白");
                    
                )
                .request(new RequestCallback() 
                    @Override
                    public void onResult(boolean allGranted, List<String> grantedList, List<String> deniedList) 
                        if (allGranted) 
                            Log.d(TAG, "所有申请的权限都已通过");
                         else 
                            Toast.makeText(MainActivity.this, "您拒绝了如下权限：" + deniedList, Toast.LENGTH_SHORT).show();
                        
                    
                );

2.1.2 注册电话状态系统广播接收器

	 //电话状态的广播
    private final String PHONE_STATE_ACTION = "android.intent.action.PHONE_STATE";

    //自定义广播接收器
    private BroadcastReceiver comingCallBR = new BroadcastReceiver() 
        @Override
        public void onReceive(Context context, Intent intent) 
            Log.d(TAG, "onReceive(): action = " + intent.getAction());
            if(intent.getAction() != null
                    && intent.getAction().equals(PHONE_STATE_ACTION))
                //电话状态
                String state = intent.getStringExtra(TelephonyManager.EXTRA_STATE);
                Log.d(TAG, "onReceive(): phone state = " + state);
                // 电话正在响铃，即来电
                if (state.equalsIgnoreCase(TelephonyManager.EXTRA_STATE_RINGING)) 
                    //正在响铃...
                    //来电号码
                    String comingNumber = intent.getStringExtra(TelephonyManager.EXTRA_INCOMING_NUMBER);
                    if(comingNumber == null ||comingNumber.isEmpty())
                        return;
                    
                    Log.d(TAG, "onReceive(): 来电号码 = " + comingNumber);
                    if(comingCallListener != null)
                        comingCallListener.onCalling(curTimeToFormatNoYearMills(),comingNumber,null);
                    
                else if(state.equalsIgnoreCase(TelephonyManager.EXTRA_STATE_OFFHOOK))
                    //正在通话...
                else if(state.equalsIgnoreCase(TelephonyManager.EXTRA_STATE_IDLE))
                    //电话挂断
                

            
        
    ;

    //注册监听来电的广播接收者
    public boolean initBroadcastReceiver()
        IntentFilter intentFilter = new IntentFilter();
        intentFilter.addAction(PHONE_STATE_ACTION);
        registerReceiver(comingCallBR, intentFilter);
        return true;
    

    //注销广播
    public boolean unregisterReceiver()
        unregisterReceiver(comingCallBR);
        return true;

2.2 PhoneStateListener 监听器

2.2.1 权限

通过PhoneStateListener 监听器的方式来监听来电时，只需要一个权限READ_CALL_LOG，因为是危险权限，除了静态表明外，Android6.0以后同样需要动态申请。

<!--读取手机通话记录：Android 9.0没有此权限，获取不到来电号码-->
<uses-permission android:name="android.permission.READ_CALL_LOG"/>
<!--读取手机通讯录-->
<uses-permission android:name="android.permission.READ_CONTACTS"/>

//PhoneStateListener监听方式监听来电，需要检测的权限
    private void checkPhoneStateListenerCallPermission() 
        PermissionX.init(this)
                .permissions(   //传入需要申请的权限
                        Manifest.permission.READ_CALL_LOG,
                        Manifest.permission.READ_CONTACTS)
                .onExplainRequestReason(new ExplainReasonCallbackWithBeforeParam() 
                    @Override
                    public void onExplainReason(ExplainScope scope, List<String> deniedList, boolean beforeRequest) 
                        scope.showRequestReasonDialog(deniedList, "来电监听需要授予'访问手机通话记录'的权限，依据来电号码查询联系人需要'读取手机通讯录'权限,否则应用无法正常使用", "我已明白");
                    
                )
                .onForwardToSettings(new ForwardToSettingsCallback() 
                    @Override
                    public void onForwardToSettings(ForwardScope scope, List<String> deniedList) 
                        scope.showForwardToSettingsDialog(deniedList, "您需要去应用程序设置当中手动开启权限", "我已明白");
                    
                )
                .request(new RequestCallback() 
                    @Override
                    public void onResult(boolean allGranted, List<String> grantedList, List<String> deniedList) 
                        if (allGranted) 
                            Log.d(TAG, "所有申请的权限都已通过");
                            Toast.makeText(MainActivity.this, "权限已授予", Toast.LENGTH_SHORT).show();
                            //权限授予成功之后，开启广播监听
                            ComingCallListenManager.getManager(MainActivity.this).initBroadcastReceiver();
                         else 
                            Toast.makeText(MainActivity.this, "您拒绝了如下权限：" + deniedList, Toast.LENGTH_SHORT).show();
                        
                    
                );

2.2.2 初始化PhoneStateListener

PhoneStateListener监听器类，用于监视设备上特定电话状态的变化，包括服务状态、信号强度、消息等待指示器(语音邮件)等。

TelephonyManager 提供对设备上电话服务的信息的访问。应用程序可以使用该类中的方法来确定电话服务和状态，以及访问某些类型的订阅者信息。应用程序还可以注册侦听器来接收电话状态更改的通知。

    // 电话管理者对象
    private TelephonyManager mTelephonyManager;
    // 电话状态监听者
    private PhoneStateListener mPhoneStateListener;

    //初始化PhoneStateListener
    public boolean initPhoneStateListener() 
        mTelephonyManager = (TelephonyManager) getSystemService(Context.TELEPHONY_SERVICE);
        mPhoneStateListener = new PhoneStateListener()
            @Override
            public void onCallStateChanged(int state, String phoneNumber) 
                switch(state)
                    case TelephonyManager.CALL_STATE_IDLE:
                        //电话挂断
                        break;
                    case TelephonyManager.CALL_STATE_OFFHOOK:
                        //正在通话...
                        break;
                    case TelephonyManager.CALL_STATE_RINGING:
                        //正在响铃...
                        if(phoneNumber == null ||phoneNumber.isEmpty())
                            return;
                        
                        Log.d(TAG, "onCallStateChanged(): 来电号码 = " + phoneNumber);
                        if(comingCallListener != null)
                            comingCallListener.onCalling(curTimeToFormatNoYearMills(),phoneNumber,null);
                        
                        break;
                

            
        ;
        //开启监听
        mTelephonyManager.listen(mPhoneStateListener, PhoneStateListener.LISTEN_CALL_STATE);
        return true;
    


    public boolean cancelPhoneStateListener()
        // 取消来电的电话状态监听服务
        if (mTelephonyManager != null && mPhoneStateListener != null) 
            mTelephonyManager.listen(mPhoneStateListener, PhoneStateListener.LISTEN_NONE);
            return true;
        
        return false;

3 完整Demo

下载地址：https://download.csdn.net/download/qq_38950819/60265473

以上是关于Android来电监听的主要内容，如果未能解决你的问题，请参考以下文章