NoticationMgr对于未接来电的处理

NoticationMgr 对于未接来电的处理
通过本文档将要学习 Android KK 和 Android L 两大版本对于未接来电逻辑处理上的差异，这个差异主要体现在架构设计。 主要是通过以下三个方面： ? 取消未接来电的通知； ? 有未接来电时的通知； ? 开机显示未接来电的能知；
Android KK 版本对未接来电（Missed call）的处理
取消未接来电的通知
当有未接来电时显示未接来电的通知
当有未接来电时显示未接来电的通知是由 CallNotifier 的 onDisconnect 方法调用 NotificationMgr 的 notifyMissedCall 方法， 第 8 行调 用 PhoneGlobals.createCallLogIntent 方法获得拉起通话记录的 intent，第 16 行的 mNumberMissedCalls++未接来电计数器自增 1， 第 20 至第 27 行是设置显示的信息

只有一个未接来电时，会显示“未接来电/XX” ，XX 是联系人的姓名或号码，有多个未接来电时，会显示“未接来电/n 个未接来电” ，
当只有一个未接来电时，且号码有效时，增加两个 action，即“回拨” 、 “发信息” ，当参数 phoneIcon 或 photo 不为 null 时，还可以设 置在托盘中显示的大图标。

最后调用 NotificationManager 的 notify 方法在托盘中显示未接来电通知
开机后显示未接来电通知
当 Phone 应 用 启 动 的 时 候 在 PhoneGlobals 的 onCreate 方 法 中 调 用 NotificationMgr 的 init 方 法 进 行 初 始 化 ， 接 着 调 用 updateNotificationAtStartup 方法
在 NotificationMgr 的 updateNotificationAtStartup 方法中实例化 QueryHandler，主要用于查询通话记录、联系人等信息，第 10 至 12 行是设置查询的条件，第 16 行调用 QueryHandler 的 startQuery 方法执行查询，注意在调用 startQuery 方法的第一个参数 CALL_LOG_TOKEN，此查询是异步执行的。

整体介绍一个 QueryHandler 的结构，QueryHandler 是异常查询处理器，主要完成查询通话记录，根据通话记录查询联系人，加载联系 人的头像
NotificationInfo 用于存储查询出来的未接来电的基本信息

通话记录完成后回调 onQueryComplete 方法，在调用 startQuery 时传入的第一个参数是 CALL_LOG_TOKEN ，所以此时 case CALL_LOG_TOKEN 满足， 调用 getNotificationInfo 方法， 将 cursor 中的信息构造一个 NotificationInfo 的实例， 再次调用 QueryHandler 的 startQuery 方法查询通话记录是否存在对应的联系人信息，传入的第一个参数是 CONTACT_TOKEN，
调用 getNotificationInfo 方法，将 cursor 中的信息构造一个 NotificationInfo 的实例
联系人信息查询完成后回调 onQueryComplete 方法，token 是 CONTACT_TOKEN，对于是一个默生的号码（通讯录人不存在对应的联 系人信息）时直接调用 notifyMissedCall 方法在托盘显示未接来电通知，如果存在对应的联系人信息通过调 ContactAsyncHelper 的 startObtainPhotoAsync 方 法 获 取 对 应 联 系 人 的 头 像 ， QueryHandler 已 实 现 了 ContactAsyncHelper 的
OnImageLoadCompleteListener 接口，所以联系人头像加载完成后回调 QueryHandler 的 onImageLoadComplete 方法，

当联系人的头像加载完成后，回调 onImageLoadComplete 方法，最终调用 notifyMissedCall 方法在托盘中显示未接来电通知。

Android L 未接来电的处理
未接来电的处理逻辑由 Android KK 版本的 TeleService 转移到 Android L 版本的 Telecom 中处理，但是在 TeleService 中仍然保留了 KK 版本的 NotificationMgr 类的代码，但如 Android KK 版本对外的接口已经不存在了。
取消未接来电的通知
第三方的应用可以通过调用 TelecomManager 类的 cancelMissedCallsNotification 方法取消未接来电的消息通知，看到 cancelMissedCallsNotification 的方法的命名应该感到很 nice 吧，这个就是将 Android KK 中 TelephonyManager 中移植过来的。
publicclass TelecomManager { ...... publicvoid cancelMissedCallsNotification(){ ITelecomService service = getTelecomService(); if(service !=null){ try{ service.cancelMissedCallsNotification(); }catch(RemoteException e){ } } } } 代码 x-x
TelecomManager 调用 TelecomServiceImpl 的 cancelMissedCallsNotification 方法后，向内部的 MainThreadHandler 发送 MSG_CANCEL_MISSED_CALLS_NOTIFICATION 消息，处理此消息时调用了 MissedCallNotifier 的 clearMissedCalls 方法。
publicclass TelecomServiceImpl extends ITelecomService ... publicvoid cancelMissedCallsNotification(){ enforceModifyPermissionOrDefaultDialer(); sendRequestAsync(MSG_CANCEL_MISSED_CALLS_NOTIFICATION,0); } } privatefinalclass MainThreadHandler extends Handler { @Override publicvoid handleMessage(Message msg){ if(msg.obj instanceof MainThreadRequest){ MainThreadRequest request =(MainThreadRequest) msg.obj; Object result =null; switch(msg.what){ ....... caseMSG_CANCEL_MISSED_CALLS_NOTIFICATION: mMissedCallNotifier.clearMissedCalls(); break; ....... } }

} } 代码 x-x
MissedCallNotifier 的 clearMissedCalls 做了两件事件： ? 将通话记录数据库中的未接来电记录的未读状态变更为已读状态； ? 清除在通知栏中的通知； 通话记录未接来电的未读状态->已读状态，通过一个多线程异步任务的方法更新通话记录的 provider。 publicclass MissedCallNotifier { .... /** Clears missed call notification and marks the call log's missed calls as read. */ void clearMissedCalls(){ AsyncTask.execute(new Runnable(){ @Override publicvoid run(){ // Clear the list of new missed calls from the call log. try{ ContentValues values =new ContentValues(); values.put(Calls.NEW,0); values.put(Calls.IS_READ,1); StringBuilder where =new StringBuilder(); where.append(Calls.NEW); where.append(" = 1 AND "); where.append(Calls.TYPE); where.append(" = ?"); mContext.getContentResolver().update(Calls.CONTENT_URI, values, where.toString(), new String[]{ Integer.toString(Calls.MISSED_TYPE)}); }catch(Exception e){ e.printStackTrace(); Log.e("MissedCallNotifier", e,""); } } }); cancelMissedCallNotification(); } ... } 代码 x-x
接着调用 cancelMissedCallNotification 方法，内部通过调用 NotificationManager 的 cancel 方法清除通知栏中的未接来电 notification，并将未接来电计数器 mMissedCallCount 重置为 0。 publicclass MissedCallNotifier { .... /** Cancels the "missed call" notification. */ privatevoid cancelMissedCallNotification(){ // Reset the number of missed calls to 0. mMissedCallCount =0; mNotificationManager.cancel(MISSED_CALL_NOTIFICATION_ID); } ... } 代码 x-x

来电未接时在通知栏中显示 Missed call 通知
在 CallsManager 的构造方法中注册了回调。 public CallsManager(Context context, MissedCallNotifier missedCallNotifier, PhoneAccountRegistrar phoneAccountRegistrar){ ..... mMissedCallNotifier = missedCallNotifier; mListeners.add(missedCallNotifier); } 代码 x-x
MissedCallNotifier 继承了 CallsManagerListenerBase，重构了 onCallStateChanged 方法，当 call 的状态发生变化时被回调。如果新 的状态是 DISCONNECTED， 表示有通话断开了， 如果断开的原因是 MISSED， 表示有一个未接来电， 然后调用 showMissedCallNotification 方法。 publicclass MissedCallNotifier extends CallsManagerListenerBase{ .... publicvoidonCallStateChanged(Call call,int oldState,int newState){ if(oldState == CallState.RINGING && newState == CallState.DISCONNECTED && call.getDisconnectCause().getCode()== DisconnectCause.MISSED){ showMissedCallNotification(call); } } } 代码 x-x

在 showMissedCallNotification 方法，主要是准备显示 notfication 相关的信息（如来电号码或联系人名称，头像） ，最终调用 NotificationManager 的 notifyAsUser 方法在通知栏中显示 missed-call 通知。 publicclass MissedCallNotifier extends CallsManagerListenerBase { .... void showMissedCallNotification(Call call){ mMissedCallCount++; ...... // Create the notification. Notification.Builder builder =new Notification.Builder(mContext); builder.setSmallIcon(android.R.drawable.stat_notify_missed_call) .setColor(mContext.getResources().getColor(R.color.theme_color)) .setWhen(call.getCreationTimeMillis()) .setContentTitle(mContext.getText(titleResId)) .setContentText(expandedText) .setContentIntent(createCallLogPendingIntent()) .setAutoCancel(true) .setDeleteIntent(createClearMissedCallsPendingIntent()); ...... Notification notification = builder.build(); mNotificationManager.notifyAsUser( null/* tag */, MISSED_CALL_NOTIFICATION_ID, notification, UserHandle.CURRENT); } } 代码 x-x 在 showMissedCallNotification 中调用了 Notification.Builder 的 setContentIntent 和 setDeleteIntent 方法，其参数分别是 createCallLogPendingInteng 和 createClearMissedCallsPendingIntent 的返回值，setXXXIntent 的作用： ? 点击通知栏中的这条通知时执行； ? 当通知从通知栏中移除时执行； 这两个方法的返回类型都是 PendingInteng，先来看一下 PendingInteng 是什么 PendingIntent Intent 英文意思是意图，Pending 表示即将发生或来临的事情。 PendingIntent 这个类用于处理即将发生的事情。比如在通 知 Notification 中用于跳转页面，但不是马上跳转。 Intent 是及时启动，intent 随所在的 activity 消失而消失。 PendingIntent 可以看作是对 intent 的包装，通常通过 getActivity,getBroadcast ,getService 来得到 pendingintent 的 实例，当前 activity 并不能马上启动它所包含的 intent,而是在外部执行 pendingintent 时，调用 intent 的。正由于 pendingintent 中 保存有当前 App 的 Context，使它赋予外部 App 一种能力，使得外部 App 可以如同当前 App 一样的执行 pendingintent 里的 Intent， 就算在执行时当前 App 的进程已经不存在了，也能通过存在 pendingintent 里的 Context 照 样执行 Intent。另外还可以处理 intent 执行后的操作。常和 AlerManger 和 NotificationManager 一起使用。 Intent 一般是用作 Activity、Sercvice、BroadcastReceiver 之间传递数据，而 Pendingintent，一般用在 Notification 上，可以理解为延迟执行的 intent，PendingIntent 是对 Intent 一个包装。
createCallLogPendingInteng 方法，返回的是打开通话记录的 intent /** * Creates a new pending intent that sends the user to the call log. * * @return The pending intent. */ private PendingIntent createCallLogPendingIntent(){ Intent intent =new Intent(Intent.ACTION_VIEW,null); intent.setType(CallLog.Calls.CONTENT_TYPE); TaskStackBuilder taskStackBuilder = TaskStackBuilder.create(mContext); taskStackBuilder.addNextIntent(intent);

return taskStackBuilder.getPendingIntent(0,0); } 代码 x-x
createClearMissedCallsPendingIntent 方法的注释已经说的很清楚了， missed-call 通知清除时被调用的 intent， 此方法的内部接着调用 了 createTelecomPendingIntent 方法，传入字符串 TelecomBroadcastReceiver.ACTION_CLEAR_MISSED_CALLS。 /** * Creates an intent to be invoked when the missed call notification is cleared. */ private PendingIntent createClearMissedCallsPendingIntent(){ return createTelecomPendingIntent( TelecomBroadcastReceiver.ACTION_CLEAR_MISSED_CALLS,null); } 代码 x-x 接着看 createTelecomPendingIntent 方法的实现，其实就是返回 broadcast 的 intent。看到这一步其实大家应该已经很明白了吧，当未 接来电的通知被清除的时候是发送了一个广播，那么这个广播发送给哪个类处理了呢，带着疑问我们接着往下看。 /** * Creates generic pending intent from the specified parameters to be received by * {@link TelecomBroadcastReceiver}. * * @param action The intent action. * @param data The intent data. */ private PendingIntent createTelecomPendingIntent(String action, Uri data){ Intent intent =new Intent(action, data, mContext, TelecomBroadcastReceiver.class); return PendingIntent.getBroadcast(mContext,0, intent,0); } 代码 x-x
找到 TelecomBroadcastReceiver 类的定义，原来它真的是 broadcast receiver，一切就都明白了吧，当未接来电的通知被清除的时候是 发送一个广播，而广播的 receiver 就是 TelecomBroadcastReceiver，从这个类的定义可以看出除了清除未接来电，还有发送短信和回拨 等。 publicfinalclass TelecomBroadcastReceiver extends BroadcastReceiver { /** The action used to send SMS response for the missed call notification. */ staticfinal String ACTION_SEND_SMS_FROM_NOTIFICATION = "com.android.server.telecom.ACTION_SEND_SMS_FROM_NOTIFICATION"; /** The action used to call a handle back for the missed call notification. */ staticfinal String ACTION_CALL_BACK_FROM_NOTIFICATION = "com.android.server.telecom.ACTION_CALL_BACK_FROM_NOTIFICATION"; /** The action used to clear missed calls. */ staticfinal String ACTION_CLEAR_MISSED_CALLS = "com.android.server.telecom.ACTION_CLEAR_MISSED_CALLS"; /** {@inheritDoc} */ @Override publicvoid onReceive(Context context, Intent intent){ ...... } } 代码 x-x

下面我们重点看一下收到 action 为“com.android.server.telecom.ACTION_CLEAR_MISSED_CALLS”的广播的逻辑处理，看到 onReceive 方法的实现，最终就是调用 MissedCallNotifier 的 clearMissedCalls 方法，在上节中讲清除未接来电通知时最终也是调用了 此方法，当未接来电通知清除时会自动的将通话记录数据库中的未接来电数据标识为已读状态。 publicfinalclass TelecomBroadcastReceiver extends BroadcastReceiver { .... /** The action used to clear missed calls. */ staticfinal String ACTION_CLEAR_MISSED_CALLS = "com.android.server.telecom.ACTION_CLEAR_MISSED_CALLS"; /** {@inheritDoc} */ @Override publicvoid onReceive(Context context, Intent intent){ String action = intent.getAction(); Log.v(this,"Action received: %s.", action); MissedCallNotifier missedCallNotifier = CallsManager.getInstance().getMissedCallNotifier(); .... // Clear the missed call notification and call log entries. }elseif(ACTION_CLEAR_MISSED_CALLS.equals(action)){ missedCallNotifier.clearMissedCalls(); } } } 代码 x-x

开机查询未接来电
code
代码 x-x