Android 4.4 Kitkat Phone工作流程淺析(十)__"通話顯示"查詢流程

本文代碼以MTK平台Android 4.4為分析對象，與Google原生AOSP有些許差異，請讀者知悉。

前置文章：

《 Android 4.4 Kitkat Phone工作流程淺析(一)__概要和學習計劃 》

《Android 4.4 Kitkat Phone工作流程淺析(二)__UI結構分析》

《Android 4.4 Kitkat Phone工作流程淺析(三)__MO(去電)流程分析》

《Android 4.4 Kitkat Phone工作流程淺析(四)__RILJ工作流程簡析》

《Android 4.4 Kitkat Phone工作流程淺析(五)__MT(來電)流程分析》

《Android 4.4 Kitkat Phone工作流程淺析(六)__InCallActivity顯示更新流程》

《Android 4.4 Kitkat Phone工作流程淺析(七)__來電(MT)響鈴流程》

《Android 4.4 Kitkat Phone工作流程淺析(八)__Phone狀态分析》

《Android 4.4 Kitkat Phone工作流程淺析(九)__狀态通知流程分析》

概要

      無論是在MT (Mobile Termination Call被叫——來電)，還是MO (Mobile Origination Call主叫——去電) 流程中，通話界面上都會顯示目前通話的名稱( 後文以displayName指代 )。通常情況下，如果是一個陌生号碼，則會顯示為該陌生号碼。如果是已知聯系人，則會顯示該聯系人的名稱。當然，在會議電話( Conference Call )的情況下則直接顯示"會議電話"。但是，在某些特殊情況下，displayName還會顯示諸如"私人号碼"、"公用電話"、"未知号碼"等。

      本文主要分析displayName的擷取顯示流程及顯示"未知号碼"的原因，如圖1：

圖 1 通話界面顯示Unknown

查詢流程

開始查詢——CallCardPresenter

      displayName是隸屬于CallCardFragment的控件，當通話MO/MT流程發起時InCallActivity會顯示，此時将會觸發CallCardFragment界面更新，在CallCardPresenter的init方法中查詢displayName，關鍵代碼如下：

[java]  view plain copy

1. public void init(Context context, Call call) {  
2.     //... ...省略  
3.     if (call != null) {  
4.         mPrimary = call;  
5.         final CallIdentification identification = call.getIdentification();  
6.         // start processing lookups right away.  
7.         if (!call.isConferenceCall()) {  
8.             //... ...如果不是ConferenceCall就執行  
9.             startContactInfoSearch(identification, PRIMARY,  
10.                     call.getState() == Call.State.INCOMING);  
11.         } else {  
12.             //... ..如果是ConferenceCall則執行  
13.             updateContactEntry(null, PRIMARY, true);  
14.         }  
15.     }  
16. }  

startContactInfoSearch的具體代碼如下： [java]  view plain copy

1. private void startContactInfoSearch(final CallIdentification identification,  
2.         final boolean isPrimary, boolean isIncoming) {  
3.         final int type, boolean isIncoming) {  
4.     final ContactInfoCache cache = ContactInfoCache.getInstance(mContext);  
5.     // ContactInfoCache中開始查找  
6.     cache.findInfo(identification, isIncoming, new ContactInfoCacheCallback() {  
7.             @Override  
8.             public void onContactInfoComplete(int callId, ContactCacheEntry entry) {  
9.                 // 當查詢完畢之後回調并更新ContactEntry，這裡最終會去更新界面顯示  
10.                 updateContactEntry(entry, type, false);  
11.                 if (entry.name != null) {  
12.                     Log.d(TAG, "Contact found: " + entry);  
13.                 }  
14.                 if (entry.personUri != null) {  
15.                     CallerInfoUtils.sendViewNotification(mContext, entry.personUri);  
16.                 }  
17.             }  
18.             @Override  
19.             public void onImageLoadComplete(int callId, ContactCacheEntry entry) {  
20.                 if (getUi() == null) {  
21.                     return;  
22.                 }  
23.                 if (entry.photo != null) {  
24.                     if (mPrimary != null && callId == mPrimary.getCallId()) {  
25.                         // 設定第一路通話頭像  
26.                         getUi().setPrimaryImage(entry.photo);  
27.                     } else if (mSecondary != null && callId == mSecondary.getCallId()) {  
28.                         // 設定第二路通話頭像  
29.                         getUi().setSecondaryImage(entry.photo);  
30.                     }  
31.                 }  
32.             }  
33.         });  
34. }  

異步查詢——ContactInfoCache

      在CallCardPresenter中發起查詢之後會跳轉到ContactInfoCache.findInfo()方法中，ContactInfoCache不僅用于查詢目前通話的相關資訊，還可以将這些資訊緩存以備下次查詢相同資訊時快速傳回。findInfo關鍵代碼如下：

[java]  view plain copy

1. public void findInfo(final CallIdentification identification, final boolean isIncoming,  
2.         ContactInfoCacheCallback callback) {  
3.     //... ...省略  
4.     // 查詢caller資訊，完成之後會回調到FindInfoCallback中，會調用findInfoQueryComplete  
5.     final CallerInfo callerInfo = CallerInfoUtils.getCallerInfoForCall(  
6.             mContext, identification, new FindInfoCallback(isIncoming));  
7.     if(!mExpiredInfoMap.containsKey(callId)) {  
8.         // 查詢資訊完成之後執行  
9.         findInfoQueryComplete(identification, callerInfo, isIncoming, false);  
10.     }  
11. }  

CallerInfo中包含了目前call的基本資訊，比如号碼、類型、特殊相關服務等，在擷取到這些資訊之後再進行進一步的聯系人資料庫查詢。

擷取CallerInfo——CallerInfoUtils

      在getCallerInfoForCall()方法中，除了擷取目前Call的基本資訊之外，還會根據目前Call的phoneNumber去資料庫中查詢，關鍵代碼如下：

[java]  view plain copy

1. public static CallerInfo getCallerInfoForCall(Context context, CallIdentification call,  
2.         CallerInfoAsyncQuery.OnQueryCompleteListener listener) {  
3.     // 擷取目前Call的基本資訊并建立CallerInfo對象  
4.     CallerInfo info = buildCallerInfo(context, call);  
5.     String number = info.phoneNumber;  
6.     // 根據phoneNumber在CallerInfoAsyncQuery中開啟具體查詢  
7.     // MTK支援雙SIM卡，是以這裡做了一些修改  
8.     if (info.numberPresentation == Call.PRESENTATION_ALLOWED) {  
9.         // Start the query with the number provided from the call.  
10.         Call c = CallList.getInstance().getCall(call.getCallId());  
11.         boolean isSipPhone = (c == null ? false : (c.getPhoneType() == PhoneConstants.PHONE_TYPE_SIP));  
12.         if (GeminiConstants.SOLT_NUM >= 2 && !isSipPhone) {  
13.             CallerInfoAsyncQuery.startQueryEx(QUERY_TOKEN, context, number,  
14.                     listener, call, call.getSlotId());  
15.         } else if (isSipPhone) {  
16.             CallerInfoAsyncQuery.startQueryEx(QUERY_TOKEN, context, number, listener, call, -1);  
17.         } else {  
18.             CallerInfoAsyncQuery.startQuery(QUERY_TOKEN, context, number,  
19.                     listener, call);  
20.         }  
21.     }  
22.     return info;  
23. }  

在以上代碼中，有兩個重要的方法，即buildCallerInfo()和CallerInfoAsyncQuery.startQuery()，先查詢看buildCallerInfo()的關鍵代碼： [java]  view plain copy

1. public static CallerInfo buildCallerInfo(Context context, CallIdentification identification) {  
2.     CallerInfo info = new CallerInfo();  
3.     // 擷取目前Call的CNAP name  
4.     info.cnapName = identification.getCnapName();  
5.     info.name = info.cnapName;  
6.     info.numberPresentation = identification.getNumberPresentation();  
7.     info.namePresentation = identification.getCnapNamePresentation();  
8.     String number = identification.getNumber();  
9.     // 擷取目前Call的number，如果不為空則執行  
10.     if (!TextUtils.isEmpty(number)) {  
11.         final String[] numbers = number.split("&");  
12.         number = numbers[0];  
13.         if (numbers.length > 1) {  
14.               // info.forwardingNumber = numbers[1];  
15.         }  
16.         // 針對CNAP的情況特殊處理number顯示  
17.         number = modifyForSpecialCnapCases(context, info, number, info.numberPresentation);  
18.         info.phoneNumber = number;  
19.     }  
20.     return info;  
21. }  

      如果目前Call的被叫一方沒有開通該業務，則cnapName的值傳回為空。同時，在buildCallerInfo方法中也對目前Call的number是否為空做了判斷。這裡的number來自于網絡側的傳回，比如作為主叫方，當通話接通後被叫方的号碼會通過網絡傳回，在某些特殊的情況下傳回值有可能為空。

      關于CNAP

      CNAP即Calling Name Presentation的縮寫，是營運商提供的一種服務。比如，使用者開通該服務後，在營運商處設定Calling Name Presentation為"HelloSeven"。當該使用者與其他使用者通話時，如果對方的手機支援CNAP功能，那麼無論對方聯系人裡是否存入了該号碼，displayName都會顯示為"HelloSeven"。加拿大的一些營運商有使用該服務，比如Rogers，但目前國内的營運商均不支援該服務。

      As the standard says: “Calling Name Presentation (CNAP) provides the name identification of the calling party (e.g., personal name, company name, “restricted”, “not available”) to the called subscriber”. This means in practice that when somebody calls you your phone will receive not just the number of the callee but also her name information if such is available. More specifically if somebody calls you, you can see her name even if she’s number is not in the contact list stored in your mobile device.

      參考1  參考2       

查詢資料庫——CallerInfoAsyncQuery

      當buildCallerInfo()執行完成後，會根據目前Call的number查詢本機Contacts資料庫。這裡以MTK雙卡為例，是以會執行CallerInfoAsyncQuery.startQueryEx(QUERY_TOKEN, context, number,listener, call, call.getSlotId())方法，關鍵代碼如下( frameworks/base/telephony/java/com/android/internal/telephony/CallerInfoAsyncQuery.java )：

[java]  view plain copy

1. public static CallerInfoAsyncQuery startQueryEx(int token, Context context, String number,  
2.         OnQueryCompleteListener listener, Object cookie, int simId) {  
3.     //... ...省略  
4.     // 設定SIP Phone的查詢條件  
5.     if (PhoneNumberUtils.isUriNumber(number)) {  
6.         // "number" is really a SIP address.  
7.         contactRef = Data.CONTENT_URI;  
8.         selection = "upper(" + Data.DATA1 + ")=?"  
9.                 + " AND "  
10.                 + Data.MIMETYPE + "='" + SipAddress.CONTENT_ITEM_TYPE + "'";  
11.         selectionArgs = new String[] { number.toUpperCase() };  
12.     } else {  
13.         // 如果是普通号碼，則在PhoneLookup表中查詢  
14.         contactRef = Uri.withAppendedPath(PhoneLookup.CONTENT_FILTER_URI, Uri.encode(number));  
15.         selection = null;  
16.         selectionArgs = null;  
17.     }  
18.     CallerInfoAsyncQuery c = new CallerInfoAsyncQuery();  
19.     c.allocate(context, contactRef);//這裡需要注意，allocate會對mHanlder對象進行指派  
20.     //create cookieWrapper, start query  
21.     CookieWrapper cw = new CookieWrapper();  
22.     cw.listener = listener;  
23.     cw.cookie = cookie;  
24.     cw.number = number;  
25.     cw.simId = simId;  
26.     // ... ...省略  
27.     boolean isECCNumber;          
28.     if (FeatureOption.MTK_GEMINI_SUPPORT) {  
29.        int phoneType = PHONE_TYPE_GSM;  
30.        try {  
31.              ITelephony iTel = ITelephony.Stub.asInterface(ServiceManager.getService(Context.TELEPHONY_SERVICE));  
32.              phoneType = iTel.getActivePhoneTypeGemini(simId);  
33.        } catch (Exception e) {  
34.        }  
35.        isECCNumber = PhoneNumberUtils.isEmergencyNumberExt(number, phoneType);  
36.     }else {  
37.       isECCNumber = PhoneNumberUtils.isEmergencyNumber(number);  
38.     }  
39.     // 設定查詢類型包括：EMERGENCY_NUMBER、VOICEMAIL、NEW_QUERY  
40.     if (isECCNumber) {  
41.         cw.event = EVENT_EMERGENCY_NUMBER;  
42.     } else if ((originalSimId != -1) && (mPhoneNumberExt.isVoiceMailNumber(number, simId))) {  
43.         cw.event = EVENT_VOICEMAIL_NUMBER;  
44.     } else {  
45.         cw.event = EVENT_NEW_QUERY;  
46.     }  
47.     // 開始查詢  
48.     c.mHandler.startQuery(token,  
49.                           cw,  // cookie  
50.                           contactRef,  // uri  
51.                           null,  // projection  
52.                           selection,  // selection  
53.                           selectionArgs,  // selectionArgs  
54.                           null);  // orderBy  
55.     return c;  
56. }  

      以上代碼中主要完成：設定查詢對應的資料庫表；設定查詢類型(緊急号碼、語音号碼、普通查詢)；發起資料庫查詢。其中c.allocate()方法會對mHandler進行指派，關鍵代碼如下：

[java]  view plain copy

1. private void allocate(Context context, Uri contactRef) {  
2.     //... ...省略  
3.     //其中CallerInfoAsyncQueryHandler extends AsyncQueryHandler，是CallerInfoAsyncQuery的内部類  
4.     mHandler = new CallerInfoAsyncQueryHandler(context);  
5.     mHandler.mQueryContext = context;  
6.     mHandler.mQueryUri = contactRef;  
7. }  

      當執行c.mHandler.startQuery的時候，會先查詢CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler中是否有startQuery方法，之後再跳轉到父類AsyncQueryHandler的startQuery方法中( frameworks/base/core/java/android/content/AsyncQueryHandler.java )：

[java]  view plain copy

1. public void startQuery(int token, Object cookie, Uri uri,  
2.         String[] projection, String selection, String[] selectionArgs,  
3.         String orderBy) {  
4.     Message msg = mWorkerThreadHandler.obtainMessage(token);  
5.     //類型為EVENT_ARG_QUERY  
6.     msg.arg1 = EVENT_ARG_QUERY;  
7.     WorkerArgs args = new WorkerArgs();  
8.     //從CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler跳轉到AsyncQueryHandler，是以這裡的this是CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler對象  
9.     args.handler = this;  
10.     args.uri = uri;  
11.     args.projection = projection;  
12.     args.selection = selection;  
13.     args.selectionArgs = selectionArgs;  
14.     args.orderBy = orderBy;  
15.     args.cookie = cookie;  
16.     msg.obj = args;  
17.     //這裡的mWorkerThreadHandler的執行個體在  
18.     mWorkerThreadHandler.sendMessage(msg);  
19. }  

以上代碼有幾個需要注意的地方：

①. args.handler = this

因為代碼是從CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler調用到AsyncQueryHandler.startQuery方法的，是以這裡的this對象是CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler而不是AsyncQueryHandler。

②. mWorkThreadHandler實際上是CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler的對象

通過圖2和圖3可以看到mWorkThreadHandler的執行個體化流程：

圖 2 CallerInfoAsyncQueryHandler以及AsyncQueryHandler關系類圖

圖 3 mWorkThreadHandler執行個體化流程

      最後通過mWorkerThreadHandler.sendMessage()方法跳轉到CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler.CallerInfoWorkerHandler的handleMessage方法中，關鍵代碼如下：

[java]  view plain copy

1. protected class CallerInfoWorkerHandler extends WorkerHandler {  
2.     public CallerInfoWorkerHandler(Looper looper) {  
3.         super(looper);  
4.     }  
5.     @Override  
6.     public void handleMessage(Message msg) {  
7.         WorkerArgs args = (WorkerArgs) msg.obj;  
8.         CookieWrapper cw = (CookieWrapper) args.cookie;  
9.         //這裡的cw在startQueryEx中進行了設定，不為null  
10.         if (cw == null) {  
11.             super.handleMessage(msg);  
12.         } else {  
13.             switch (cw.event) {  
14.                 //此時event為NEW_QUERY  
15.                 case EVENT_NEW_QUERY:  
16.                     //直接回調父類中的handleMessage方法  
17.                     super.handleMessage(msg);  
18.                     break;  
19.                 // shortcuts to avoid query for recognized numbers.  
20.                 case EVENT_EMERGENCY_NUMBER:  
21.                 case EVENT_VOICEMAIL_NUMBER:  
22.                 case EVENT_ADD_LISTENER:  
23.                 case EVENT_END_OF_QUEUE:  
24.                     // query was already completed, so just send the reply.  
25.                     // passing the original token value back to the caller  
26.                     // on top of the event values in arg1.  
27.                     Message reply = args.handler.obtainMessage(msg.what);  
28.                     reply.obj = args;  
29.                     reply.arg1 = msg.arg1;  
30.                     reply.sendToTarget();  
31.                     break;  
32.                 default:  
33.             }  
34.         }  
35.     }  
36. }  

      如果隻是普通的号碼查詢，則執行case EVENT_NEW_QUERY，回調到父類AsyncQueryHandler.WorkerHandler的handleMessage方法中：

[java]  view plain copy

1. protected class WorkerHandler extends Handler {  
2.     //... ...省略  
3.     @Override  
4.     public void handleMessage(Message msg) {  
5.         //... ...省略  
6.         switch (event) {  
7.             case EVENT_ARG_QUERY:  
8.                 Cursor cursor;  
9.                 try {  
10.                     // 查詢Contacts資料庫中的PhoneLookup表  
11.                     cursorcursor = resolver.query(args.uri, args.projection,  
12.                             args.selection, args.selectionArgs,  
13.                             args.orderBy);  
14.                     // Calling getCount() causes the cursor window to be filled,  
15.                     // which will make the first access on the main thread a lot faster.  
16.                     if (cursor != null) {  
17.                         cursor.getCount();  
18.                     }  
19.                 } catch (Exception e) {  
20.                     Log.w(TAG, "Exception thrown during handling EVENT_ARG_QUERY", e);  
21.                     cursor = null;  
22.                 }  
23.                 // 将查詢結果儲存到args中  
24.                 args.result = cursor;  
25.                 break;  
26.             case EVENT_ARG_INSERT:  
27.                 args.result = resolver.insert(args.uri, args.values);  
28.                 break;  
29.             case EVENT_ARG_UPDATE:  
30.                 args.result = resolver.update(args.uri, args.values, args.selection,  
31.                         args.selectionArgs);  
32.                 break;  
33.             case EVENT_ARG_DELETE:  
34.                 args.result = resolver.delete(args.uri, args.selection, args.selectionArgs);  
35.                 break;  
36.         }  
37.         //注意：這裡的args.handler對象實際上是CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler的執行個體  
38.         Message reply = args.handler.obtainMessage(token);  
39.         reply.obj = args;  
40.         reply.arg1 = msg.arg1;  
41.         reply.sendToTarget();  
42.     }  
43. }  

      在WorkHandler中查詢完畢之後，執行args.handler.obtainMessage()，這裡的args.handler實際上是CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler的執行個體，但在CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler中并沒有handleMessage方法，是以回調其父類AsyncQueryHandler的handleMessage方法：

[java]  view plain copy

1. @Override  
2. public void handleMessage(Message msg) {  
3.     //... ...省略  
4.     switch (event) {  
5.         // 查詢完畢之後執行  
6.         case EVENT_ARG_QUERY:  
7.             onQueryComplete(token, args.cookie, (Cursor) args.result);  
8.             break;  
9.         case EVENT_ARG_INSERT:  
10.             onInsertComplete(token, args.cookie, (Uri) args.result);  
11.             break;  
12.         case EVENT_ARG_UPDATE:  
13.             onUpdateComplete(token, args.cookie, (Integer) args.result);  
14.             break;  
15.         case EVENT_ARG_DELETE:  
16.             onDeleteComplete(token, args.cookie, (Integer) args.result);  
17.             break;  
18.     }  
19. }  

      onQueryComplete方法可以看做this.onQueryComplete，而this來源于CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler。是以，這裡會回調到CallerInfoAsyncQuery.CallerInfoAsyncQueryHandler的onQueryComplete方法中，關鍵代碼如下：

[java]  view plain copy

1. @Override  
2. protected void onQueryComplete(int token, Object cookie, Cursor cursor) {  
3.     CookieWrapper cw = (CookieWrapper) cookie;  
4.     // ... ...省略  
5.     //查詢完畢，将查詢結果傳回.  
6.     if (cw.listener != null) {  
7.         cw.listener.onQueryComplete(token, cw.cookie, mCallerInfo);  
8.     }  
9.     // ... ...省略  
10. }  

      以上代碼中的cw.listener來自于CallerInfoAsyncQuery.startQueryEx()，在ContactInfoCache.findInfo()中可以看到，listener實際為ContactInfoCache.FindInfoCallback的對象： [java]  view plain copy

1. final CallerInfo callerInfo = CallerInfoUtils.getCallerInfoForCall(  
2.         mContext, identification, new FindInfoCallback(isIncoming));  
3. private class FindInfoCallback implements CallerInfoAsyncQuery.OnQueryCompleteListener {  
4.     private final boolean mIsIncoming;  
5.     public FindInfoCallback(boolean isIncoming) {  
6.         mIsIncoming = isIncoming;  
7.     }  
8.     @Override  
9.     public void onQueryComplete(int token, Object cookie, CallerInfo callerInfo) {  
10.         final CallIdentification identification = (CallIdentification) cookie;  
11.         findInfoQueryComplete(identification, callerInfo, mIsIncoming, true);  
12.     }  
13. }  

      也就是說查詢完成之後會回調到ContactInfoCache.FindInfoCallback的onQueryComplete()方法中，并執行ContactInfoCache.findInfoQueryComplete()。

完善查詢結果——ContactInfoCache

      經過各種回調之後，終于将查詢結果傳回到ContactInfoCache.findInfoQueryComplete方法中，該方法主要用于将查詢結果封裝為ContactCacheEntry對象，并發起查詢完畢的回調，關鍵代碼如下：

[java]  view plain copy

1. private void findInfoQueryComplete(CallIdentification identification,  
2.         CallerInfo callerInfo, boolean isIncoming, boolean didLocalLookup) {  
3.     //将查詢結果儲存到ContactCacheEntry中  
4.     final ContactCacheEntry cacheEntry = buildEntry(mContext, callId,  
5.             callerInfo, presentationMode, isIncoming);  
6.     //将cacheEntry對應與之相對的callId  
7.     mInfoMap.put(callId, cacheEntry);  
8.     if(!mExpiredInfoMap.containsKey(callId)) {  
9.         //将查詢完成的消息通知到相應的回調方法  
10.         sendInfoNotifications(callId, cacheEntry);  
11.     }  
12.     //... ...省略  
13. }  

注意以下兩點：

①. buildEntry()會将最終的顯示内容準備好，以供後續使用；

②. sendInfoNotifications()發起回調，通知相關listener“查詢完畢可供顯示”；

檢視buildEntry()的關鍵代碼如下：

[java]  view plain copy

1. private ContactCacheEntry buildEntry(Context context, int callId,  
2.         CallerInfo info, int presentation, boolean isIncoming) {  
3.     //... ...省略  
4.     //構造ContatcCacheEntry  
5.     populateCacheEntry(context, info, cce, presentation, isIncoming);  
6.     //... ...省略  
7.     return cce;  
8. }  

      在buildEntry方法中，主要是調用populateCacheEntry()完成ContactCacheEntry對象的構造，同時會對緊急号碼做一些處理。populateCacheEntry()關鍵代碼如下： [java]  view plain copy

1. public static void populateCacheEntry(Context context, CallerInfo info, ContactCacheEntry cce,  
2.         int presentation, boolean isIncoming) {  
3.     Preconditions.checkNotNull(info);  
4.     String displayName = null;  
5.     String displayNumber = null;  
6.     String displayLocation = null;  
7.     String label = null;  
8.     boolean isSipCall = false;  
9.         String number = info.phoneNumber;  
10.         if (!TextUtils.isEmpty(number)) {  
11.             isSipCall = PhoneNumberUtils.isUriNumber(number);  
12.             if (number.startsWith("sip:")) {  
13.                 number = number.substring(4);  
14.             }  
15.         }  
16.         // 如果CallerInfo的name為空則執行  
17.         // 通過前面的分析可以知道，CallerInfo的name預設指派為cnapName，而  
18.         // cnapName并不是每個營運商都會支援。是以大多數情況下傳回為空  
19.         if (TextUtils.isEmpty(info.name)) {  
20.             if (TextUtils.isEmpty(number)) {  
21.                 // 如果CallerInfo的number也為空則表明目前通話為特殊通話  
22.                 // 特殊通話需要顯示Unknown PayPhone Private等特殊字段  
23.                 displayName = getPresentationString(context, presentation);  
24.             } else if (presentation != Call.PRESENTATION_ALLOWED) {  
25.                 // This case should never happen since the network should never send a phone #  
26.                 // AND a restricted presentation. However we leave it here in case of weird  
27.                 // network behavior  
28.                 displayName = getPresentationString(context, presentation);  
29.             } else if (!TextUtils.isEmpty(info.cnapName)) {  
30.                 // 如果cnapName不為空，則将displayName設定未cnapName  
31.                 displayName = info.cnapName;  
32.                 info.name = info.cnapName;  
33.                 displayNumber = number;  
34.             } else {  
35.                 // 如果目前通話的号碼并未存儲到使用者的聯系人清單中，将displayNumber設定為  
36.                 // 對應的号碼，後面顯示的時候會判斷，如果displayName為空的話，就顯示displayNumber  
37.                 displayNumber = number;  
38.                   if (isIncoming) {  
39.                     // 如果是來電，則顯示号碼歸屬地相關資訊  
40.                       displayLocation = info.geoDescription; // may be null  
41.                   }  
42.             }  
43.         } else {  
44.             // 如果info.name不為空，則表示之前的cnapName指派成功，則将結果直接顯示  
45.             if (presentation != Call.PRESENTATION_ALLOWED) {  
46.                 displayName = getPresentationString(context, presentation);  
47.             } else {  
48.                 displayName = info.name;  
49.                 displayNumber = number;  
50.                 label = info.phoneLabel;  
51.             }  
52.         }  
53.     // 最後将顯示結果存放到ContactCacheEntry對象中  
54.     cce.name = displayName;  
55.     cce.number = displayNumber;  
56.     cce.location = displayLocation;  
57.     cce.label = label;  
58.     cce.isSipCall = isSipCall;  
59. }  

      通過以上方法将ContactCacheEntry對象構造完成之後，InCallActivity顯示界面所需要的内容已經準備好，此時會調用sendInfoNotifications()發起回調通知，關鍵代碼如下： [java]  view plain copy

1. private void sendInfoNotifications(int callId, ContactCacheEntry entry) {  
2.     final Set<ContactInfoCacheCallback> callBacks = mCallBacks.get(callId);  
3.     if (callBacks != null) {  
4.         for (ContactInfoCacheCallback callBack : callBacks) {  
5.             // 回調所有的onContactInfoComplete方法  
6.             callBack.onContactInfoComplete(callId, entry);  
7.         }  
8.     }  
9. }  
10. //在CallCardPresenter的startContactInfoSearch方法裡，發起聯系人查詢時  
11. //在new ContactInfoCacheCallback()中匿名實作了onContactInfoComplete()  
12. private void startContactInfoSearch(final CallIdentification identification,  
13.         final int type, boolean isIncoming) {  
14.     cache.findInfo(identification, isIncoming, new ContactInfoCacheCallback() {  
15.         @Override  
16.         public void onContactInfoComplete(int callId, ContactCacheEntry entry) {  
17.             // 更新界面  
18.             updateContactEntry(entry, type, false);  
19.             //... ...省略  
20.         }  
21.         @Override  
22.         public void onImageLoadComplete(int callId, ContactCacheEntry entry) {  
23.             //... ...省略  
24.         }  
25.     });  
26. }  
27. //在ContactInfoCache的findInfo方法中添加ContactInfoCacheCallback  
28. public void findInfo(final CallIdentification identification, final boolean isIncoming,  
29.         ContactInfoCacheCallback callback) {  
30.     //... ...省略  
31.     callBacks.add(callback);//添加callback  
32.     mCallBacks.put(callId, callBacks);  
33.     //... ...省略  
34. }  

      當資料庫查詢結束後，最終會通過CallCardPresenter.updateContactEntry()方法來更新界面，關鍵代碼如下： [java]  view plain copy

1. private void updateContactEntry(ContactCacheEntry entry, int type, boolean isConference) {  
2.     if (type == PRIMARY) {  
3.         mPrimaryContactInfo = entry;  
4.         updatePrimaryDisplayInfo(entry, isConference);  
5.     } else if (type == SECONDARY) {  
6.         mSecondaryContactInfo = entry;  
7.         updateSecondaryDisplayInfo(isConference);  
8.     } else if (type == SECONDARY_ONHOLD) {  
9.         updateSecondaryHoldCallDisplayInfo(isConference);  
10.     } else if (type == SECONDARY_INCOMING) {  
11.         updateSecondaryIncomingCallDisplayInfo(isConference);  
12.     }  
13. }  

界面顯示Unknown的原因

      在前面的分析中已經提到，在特殊情況下會顯示特殊的displayName：

[java]  view plain copy

1. displayName = getPresentationString(context, presentation);  
2. private static String getPresentationString(Context context, int presentation) {  
3.     String name = context.getString(R.string.unknown);//Unknown 位置号碼  
4.     if (presentation == Call.PRESENTATION_RESTRICTED) {  
5.         name = context.getString(R.string.private_num);// Private 私人号碼  
6.     } else if (presentation == Call.PRESENTATION_PAYPHONE) {  
7.         name = context.getString(R.string.payphone); //Pay Phone 共用電話  
8.     }  
9.     return name;  
10. }  

      這裡所說的特殊情況一般指的是營運商提供的一些服務，比如COLP 即Connected Line identification Presentation。該服務國内營運商稱為——号碼隐藏服務，即當使用者開通該業務後，網絡側傳回資料中不會包含該使用者的号碼資訊。該服務目前國内營運商均已不再受理，以前辦理過該業務的号碼持續有效。

      比如一名使用者開啟了該服務，呼叫該使用者，當該使用者接通來電後，主叫裝置上不會顯示對方的号碼或者聯系人資訊，取而代之的是Unknown( 未知号碼 )。如果遇到這種情況，可以通過檢視相應的AT日志以及Modem日志來分析(注：MTK使用使用的AT Command，QCom使用的ShareMemory與Modem通信)，如圖4：

圖 4 被叫開啟COLP服務，主叫MO AT傳回

      關于AT +ECPI指令說明請參看《Android 4.4 Kitkat Phone工作流程淺析(六)__InCallActivity顯示更新流程》。這裡可以看到當被叫接通後，即+ECPI狀态從2->132->6時，Modem側沒有将被叫的号碼傳回。同時，檢視Modem日志資訊也反映出被叫開啟了COLP服務，如圖5：

圖 5 Modem傳回日志

總結

關于InCallUI中displayName的擷取需要注意以下三點：

1. 發起點在CallCardPresenter的init方法中，通過startContactInfoSearch()方法開始查詢；

2. 查詢過程主要分為四步：

      ①. CallerInfo擷取

      在CallerInfoUtils.getCallerInfoForCall()方法中擷取CallerInfo對象。

      ②. 聯系人資料庫查詢

      在CallerInfoUtils.getCallerInfoForCall()方法中調用CallerInfoAsyncQuery.startQueryEx開啟聯系人資料庫查詢。注意：因為MTK在原生AOSP的基礎上修改了代碼，用以支援雙SIM卡，是以有些地方與原生AOSP有些許不同。這裡MTK的代碼會執行frameworks/base/telephony/java/com/android/internal/telephony/CallerInfoAsyncQuery.java中的startQueryEx，而原生AOSP的代碼則會執行packages/app/InCallUI/src/com/android/incallui/CallerInfoAsyncQuery.java中的startQuery。

      ③. 将查詢結果傳回

      聯系人資料庫查詢完畢之後需要将查詢結果傳回，并最終回調到ContactInfoCache.FindInfoCallback的onQueryComplete()方法中。

      ④. 顯示displayName

      最後通過ContactInfoCache.sendInfoNotifications()方式回調到CallCardPresenter中，并更新界面displayName。

3. 界面顯示Unknown的原因，是因為号碼為特殊号碼，displayName的特殊号碼包括：Unknown( 未知号碼 )、Private( 私人号碼 )、Pay Phone( 共用電話 )。具體原因則有可能是網絡傳回異常或營運商特殊服務(COLP/CNAP)等。

      整個displayName擷取并顯示流程如圖6所示：

圖 6 displayName查詢顯示流程