InCallScreen是什么

InCallScreen是什么


本文来自http://blog.csdn.net/yihongyuelan 转载请务必注明出处

本文以MTK平台Android 4.2为分析对象,MTK在原生的基础之上添加了许多自己的东西,因此个别地方跟原生代码以及QCOM的代码不同,请读者知悉。

在电话的呼出流程中,我们最后需要按下拨号键,才能将电话拨打出去,那么在按下拨号键之后,我们可以看到会弹出一个界面,显示拨号信息以及一些其他信息,这个界面就是我们的InCallScreen界面。当然,在来电的时候,弹出的界面依然是InCallScreen,在我们接通电话之后显示的那个界面仍然是InCallScreen。也就是说在通话过程中,我们一直可见并操作的那个界面就是InCallScreen。

图 1 InCallScreen界面

图1中所示就是InCallScreen不同情况下所展示的界面,分别是拨号、接通、来电三种情况下InCallScreen的现实情况。

InCallScreen结构分析

经过对比后可以发现,InCallScreen的拨号以及接通时,界面表现基本一致,而来电界面主要由于多了一个滑动接听的控件,从而导致界面不太一样。这里我们队InCallScreen的结构分析,采用接通之后的界面。如图2:


图 2 来电/去电接通后InCallScreen

InCallScreen布局分析

在InCallScreen.java中,我们可以在onCreate方法中找到InCallScreen加载的布局文件,即incall_screen.xml。在incall_screen.java文件中,我们可以看到有以下几个控件:

  • call_card:显示当前通话的信息,比如来电号码,通话时间,移动运营商等等;
  • incall_touch_ui:包括挂断按钮,显示DTMF拨号盘按钮,扬声器,静音,暂停,加入通话等几个按钮,就是通话界面下方的控制按钮;
  • otaCallCardStub:CDMA模式下跟OTA相关的控件;
  • manageConferencePanelStub:多方通话管理界面;
  • vtInCallScreenStub:视屏通话控件;
  • dtmf_twelve_key_dialer_stub:这个控件为DTMF控件,也就是我们点击按钮之后,会弹出一个0~9以及*和#的拨号盘。

因为我们这里主要分析一般模式下的通话界面,因此暂不涉及到视屏通话。

总的来讲,在图2显示的界面中,我们直观能够看到的控件主要是:call_card以及incall_touch_ui这两块。当我们点击DTMF弹出按钮之后,会显示DTMF控件。当然在我们接入多方通话之后,就会看到多方通话的界面了。

call_card通话信息展示

call_card控件,实际上显示的信息主要为通话联系人的相关信息,布局如下:
[html] view plaincopy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <com.android.phone.CallCard xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:id="@+id/call_info_container"   
  4.     android:layout_width="match_parent"  
  5.     android:layout_height="match_parent"  
  6.     android:orientation="vertical">  
  7.   
  8.     <include android:id="@+id/primary_call_info"  
  9.          layout="@layout/primary_call_info" />  
  10.   
  11.     <RelativeLayout android:id="@+id/largeAreaForSharing"  
  12.         android:layout_width="match_parent"  
  13.         android:layout_height="match_parent"  
  14.         android:visibility="gone"/>  
  15. </com.android.phone.CallCard>  

整个布局情况如下图:

图 3  CallCard界面
详细信息请参看primary_call_info.xml。

incall_touch_ui通话控制界面

这里所谓的控制主要包括了在通话界面底部的一些操作按钮,比如:挂断、显示/取消显示DTMF拨号界面、开启/关闭扬声器、启动/停止静音、开启/取消来电保持、添加多路通话等一些操作按钮。当然这里并没有将所有的控制按钮或者控制控件全部显示出来,比如当来电时,我们需要滑动接听电话,这里的滑动控件即MultiWaveView也属于incall_touch_ui.xml布局。布局如图4:

图 4 InCallTouchUi

InCallScreen初始化流程

通过查看Phone.apk的AndroidManifest.xml文件可以看到:

[html] view plaincopy
  1. <activity android:name="InCallScreen"  
  2.     android:theme="@style/Theme.InCallScreen"  <!-- InCallScreen的Theme  -->  
  3.     android:label="@string/phoneIconLabel"  
  4.     android:excludeFromRecents="true"    <!-- 该Activity不会显示在最近使用列表中 -->  
  5.     android:launchMode="singleInstance"   <!-- 该Activity为单例模式 -->  
  6.     android:screenOrientation="nosensor"   <!-- 该Activity不会横竖屏切换,默认竖屏 -->  
  7.     android:configChanges="keyboardHidden"  <!-- 该Activity显示时隐藏keyboard -->  
  8.     android:exported="false">                <!-- 该Activity不能被其它调用 -->  
  9. </activity>  

查看@style/Theme.InCallScreen可以看到:

[html] view plaincopy
  1. <style name="Theme.InCallScreen" parent="@android:style/Theme.Holo.NoActionBar">  
  2.     <item name="android:windowBackground">@android:color/black</item>  
  3.     <item name="*android:windowAnimationStyle">@style/InCallAnimationStyle</item>  
  4. </style>  

可以看到InCallScreen的Theme中没有ActionBar,窗口背景为黑色,有过场动画。

因为InCallScreen为单例模式,第一次启动时调用onCreate而后面则会调用其onNewIntent方法。我们知道在onCreate方法中,一般都是对一些对象进行创建并初始化,以及设置布局文件等等。在InCallScreen的onCreate方法中,完成了PhoneApp对象的获取,以及Window参数的设置等等,在这些过程中我们需要关注以下三个方法:
  1. initInCallScreen:初始化CallCard以及InCallTouchUi等截面;
  2. registerForPhoneStates:注册关于Phone状态改变的监听事件,这也就是为什么Phone状态改变之后InCallScreen能够收到变化消息的原因,这一点我们在来电流程中也有提及;
  3. internalResolveIntent:该方法用于处理InCallScreen收到的Intent信息;

同样,在onNewIntent方法中主要调用了internalResolveIntent方法,因此下面我们着重分析以下几个方法在InCallScreen初始化的过程中作用。

initInCallScreen

该方法在InCallScreen的onCreate方法中调用,仅执行一次,代码如下:
[java] view plaincopy
  1. private void initInCallScreen() {  
  2.     ... ...省略  
  3.     // Initialize CallTime 通话时间初始化  
  4.     mCallTime = new CallTime(this);  
  5.     // Initialize the CallCard. 通话信息初始化  
  6.     mCallCard = (CallCard) findViewById(R.id.callCard);  
  7.     ... ...省略  
  8.     //第二路通话界面初始化  
  9.     mSecCallInfo = (ViewStub) findViewById(R.id.secondary_call_info);  
  10.     mCallCard.setInCallScreenInstance(this);  
  11.     //通话录音按钮初始化  
  12.     mVoiceRecorderIcon = (ImageView) findViewById(R.id.voiceRecorderIcon);  
  13.     mVoiceRecorderIcon.setBackgroundResource(R.drawable.voice_record);  
  14.     mVoiceRecorderIcon.setVisibility(View.INVISIBLE);  
  15.     // Initialize the onscreen UI elements. 通话控制布局初始化  
  16.     initInCallTouchUi();  
  17.     ... ...省略  
  18.     // The DTMF Dialpad. DTMF拨号盘初始化  
  19.     ViewStub stub = (ViewStub) findViewById(R.id.dtmf_twelve_key_dialer_stub);  
  20.     mDialer = new DTMFTwelveKeyDialer(this, stub);  
  21.     mPowerManager = (PowerManager) getSystemService(Context.POWER_SERVICE);  
  22.     // Initialize VTInCallScreen 视屏电话初始化  
  23.     mVTInCallScreen = new VTInCallScreenProxy(this, mDialer);  
  24. }  

可以看到这里全都是对InCallScreen上布局的一些初始化过程,我们继续看到其中对于InCallTouchUi初始化的代码:
[java] view plaincopy
  1. private void initInCallTouchUi() {  
  2.     ... ...省略  
  3.     mInCallTouchUi = (InCallTouchUi) findViewById(R.id.inCallTouchUi);  
  4.     mInCallTouchUi.setInCallScreenInstance(this);  
  5.     // 挂断并通话短信回复  
  6.     mRespondViaSmsManager = new RespondViaSmsManager();  
  7.     mRespondViaSmsManager.setInCallScreenInstance(this);  
  8. }  

通过代码可以知道InCallScreen上的布局显示几乎都是在initInCallScreen方法中做的,如果我们修改了InCallScreen的布局那么我们应该在这里对修改后的布局进行初始化。

registerForPhoneStates

该方法在initInCallScreen方法之后,我们在来电流程中也有分析过该方法,代码如下:
[java] view plaincopy
  1. private void registerForPhoneStates() {  
  2.     if (!mRegisteredForPhoneStates) {  
  3.         if (FeatureOption.MTK_GEMINI_SUPPORT) {  
  4.             ... ...省略  
  5.             mCMGemini.registerForIncomingRingGemini(mHandler, PHONE_INCOMING_RING, null, PhoneConstants.GEMINI_SIM_1);  
  6.             mCMGemini.registerForIncomingRingGemini(mHandler, PHONE_INCOMING_RING2, null, PhoneConstants.GEMINI_SIM_2);  
  7.             ... ...省略  
  8.         } else {  
  9.             ... ...省略  
  10.             mCM.registerForIncomingRing(mHandler, PHONE_INCOMING_RING, null);  
  11.             ... ...省略  
  12. }  

这里所用的mHandler就是InCallScreen的mHandler,这里通过register****方法注册监听实际上为观察者模式的运用。

internalResolveIntent

该方法是InCallScreen用于处理Intent的方法,代码如下:

[java] view plaincopy
  1. private void internalResolveIntent(Intent intent) {  
  2.     ... ...省略  
  3.     if (action.equals(intent.ACTION_MAIN)) {  
  4.         //是否显示Dialpad  
  5.         if (intent.hasExtra(SHOW_DIALPAD_EXTRA)) {  
  6.             boolean showDialpad = intent.getBooleanExtra(SHOW_DIALPAD_EXTRA, false);  
  7.             if (VDBG) log("- internalResolveIntent: SHOW_DIALPAD_EXTRA: " + showDialpad);  
  8.   
  9.             mApp.inCallUiState.showDialpad = showDialpad;  
  10.             final boolean hasActiveCall = mCM.hasActiveFgCall();  
  11.             final boolean hasHoldingCall = mCM.hasActiveBgCall();  
  12.             if (showDialpad && !hasActiveCall && hasHoldingCall) {  
  13.                 PhoneUtils.switchHoldingAndActive(mCM.getFirstActiveBgCall());  
  14.             }  
  15.         }  
  16.   
  17.         ... ...省略  
  18.         //强制开启扬声器  
  19.         if (FeatureOption.MTK_TB_APP_CALL_FORCE_SPEAKER_ON) {  
  20.           if (intent.hasExtra(EXTRA_FORCE_SPEAKER_ON)) {  
  21.               boolean forceSpeakerOn = intent.getBooleanExtra(EXTRA_FORCE_SPEAKER_ON, false);  
  22.               if (forceSpeakerOn)  
  23.               {  
  24.                 Log.e("MTK_TB_APP_CALL_FORCE_SPEAKER_ON""forceSpeakerOn is true");  
  25.                 if (!PhoneGlobals.getInstance().isHeadsetPlugged()   
  26.                         && !(mApp.isBluetoothHeadsetAudioOn())) {  
  27.                   //Only force the speaker ON while not video call and speaker is not ON  
  28.                   if (!intent.getBooleanExtra(Constants.EXTRA_IS_VIDEO_CALL, false)  
  29.                       && !PhoneUtils.isSpeakerOn(mApp)) {  
  30.                     Log.e("MTK_TB_APP_CALL_FORCE_SPEAKER_ON""PhoneUtils.turnOnSpeaker");  
  31.                     PhoneUtils.turnOnSpeaker(mApp, truetruetrue);  
  32.                   }  
  33.                 }  
  34.               }  
  35.           }  
  36.         }  
  37.           
  38.         //视屏通话处理  
  39.         if (FeatureOption.MTK_VT3G324M_SUPPORT) {  
  40.             if (getInVoiceAnswerVideoCall()) {  
  41.                 setInVoiceAnswerVideoCall(false);  
  42.             }  
  43.             if (mCM.getState() == PhoneConstants.State.RINGING) {  
  44.                 if (DBG) {  
  45.                     log("call manager state is ringing");  
  46.                 }  
  47.                 // When VT call incoming, use voice call incoming call GUI  
  48.                 mVTInCallScreen.setVTVisible(false);  
  49.                 mVTInCallScreen.setVTScreenMode(Constants.VTScreenMode.VT_SCREEN_CLOSE);  
  50.             } else if (intent.getBooleanExtra(Constants.EXTRA_IS_VIDEO_CALL, false)) {  
  51.                 if (DBG) {  
  52.                     log("vt extra is true");  
  53.                 }  
  54.                 // When dialing VT call, inflate VTInCallScreen  
  55.                 mVTInCallScreen.initVTInCallScreen();  
  56.                 // When dialed a VT call, but dialed failed, needs not init state for dialing  
  57.                 if (CallStatusCode.SUCCESS == mApp.inCallUiState.getPendingCallStatusCode()) {  
  58.                     mVTInCallScreen.initDialingSuccessVTState();  
  59.                 }  
  60.                 mVTInCallScreen.initDialingVTState();  
  61.                 mVTInCallScreen.initCommonVTState();  
  62.                 if (PhoneConstants.State.IDLE != PhoneGlobals.getInstance().mCM.getState() &&  
  63.                             !VTCallUtils.isVideoCall(mCM.getActiveFgCall())) {  
  64.                     // When voice is connected and place a VT call, need close VT GUI  
  65.                     mVTInCallScreen.setVTScreenMode(Constants.VTScreenMode.VT_SCREEN_CLOSE);  
  66.                 } else {  
  67.                     mVTInCallScreen.setVTScreenMode(Constants.VTScreenMode.VT_SCREEN_OPEN);  
  68.                 }  
  69.             } else {  
  70.                 // set VT open or close according the active foreground call  
  71.                 if (mCM.getState() != PhoneConstants.State.IDLE && VTCallUtils.isVideoCall(mCM.getActiveFgCall())) {  
  72.                     if (DBG) {  
  73.                         log("receive ACTION_MAIN, but active foreground call is video call");  
  74.                     }  
  75.                     mVTInCallScreen.initVTInCallScreen();  
  76.                     mVTInCallScreen.initCommonVTState();  
  77.                     mVTInCallScreen.setVTScreenMode(Constants.VTScreenMode.VT_SCREEN_OPEN);  
  78.                 } else if (!intent.getBooleanExtra(Constants.EXTRA_IS_NOTIFICATION, false)) {  
  79.                     mVTInCallScreen.setVTScreenMode(Constants.VTScreenMode.VT_SCREEN_CLOSE);  
  80.                 }  
  81.             }   
  82.             mVTInCallScreen.updateVTScreen(mVTInCallScreen.getVTScreenMode());  
  83.         }  
  84.         return;  
  85.     }  
  86.     //接听电话时触发  
  87.     if (action.equals(Intent.ACTION_ANSWER)) {  
  88.         internalAnswerCall();  
  89.         mApp.setRestoreMuteOnInCallResume(false);  
  90.         return;  
  91.     }  
  92.     //OTA相关处理  
  93.     if (action.equals(OtaUtils.ACTION_DISPLAY_ACTIVATION_SCREEN)) {  
  94.         if (!TelephonyCapabilities.supportsOtasp(mPhone)) {  
  95.             throw new IllegalStateException(  
  96.                 "Received ACTION_DISPLAY_ACTIVATION_SCREEN intent on non-OTASP-capable device: "  
  97.                 + intent);  
  98.         }  
  99.   
  100.         setInCallScreenMode(InCallScreenMode.OTA_NORMAL);  
  101.         if ((mApp.cdmaOtaProvisionData != null)  
  102.             && (!mApp.cdmaOtaProvisionData.isOtaCallIntentProcessed)) {  
  103.             mApp.cdmaOtaProvisionData.isOtaCallIntentProcessed = true;  
  104.             mApp.cdmaOtaScreenState.otaScreenState =  
  105.                     CdmaOtaScreenState.OtaScreenState.OTA_STATUS_ACTIVATION;  
  106.         }  
  107.         return;  
  108.     }  
  109.   
  110.     // 异常和未定义intent处理  
  111.     if (action.equals(OtaUtils.ACTION_PERFORM_CDMA_PROVISIONING)) {  
  112.         throw new IllegalStateException(  
  113.             "Unexpected ACTION_PERFORM_CDMA_PROVISIONING received by InCallScreen: "  
  114.             + intent);  
  115.     } else if (action.equals(Intent.ACTION_CALL)  
  116.                || action.equals(Intent.ACTION_CALL_EMERGENCY)) {  
  117.         throw new IllegalStateException("Unexpected CALL action received by InCallScreen: "  
  118.                                         + intent);  
  119.     } else if (action.equals(ACTION_UNDEFINED)) {  
  120.         Log.wtf(LOG_TAG, "internalResolveIntent: got launched with ACTION_UNDEFINED");  
  121.         return;  
  122.     } else {  
  123.         Log.wtf(LOG_TAG, "internalResolveIntent: unexpected intent action: " + action);  
  124.         return;  
  125.     }  
  126. }  


InCallScreen初始化小结

经过以上几个关键步骤之后,InCallScreen的初始化就完成了,紧接着自然是进入onResume方法执行,这里就不展开去介绍onResume方法了,其主要就是为显示InCallScreen之前做一些准备工作和检查工作。

InCallScreenUI控制流程

通过前面的分析,InCallScreen的UI控制主要包括以下6个方面:
  1. incomingCallWidget:接通/挂断/短信回复时需要使用;
  2. dialpadButton:也就是显示或隐藏拨号盘(DTMF);
  3. audioButton:开启/关闭扬声器;
  4. muteButton:开启/关闭麦克风静音,开启之后对方无法听到你的声音;
  5. holdButton:开启/关闭呼叫保持;
  6. addButton:增加多路通话;也就是在通话的过程中可以暂停当前通话,拨打另一路通话并接通;
当我们点击addButton之后,会弹出拨号盘提示添加一路通话,添加通话之后整个InCallScreen界面将会变成如图5所示:

图 5 添加一路通话界面以及添加后界面
在改变之后的界面中,我们可以看到多了两个图标:,前者表示在两路通话之间进行切换,后者表示开启视屏电话。

incomingCallWidget滑动控件

该滑动控件在来电的时候,会显示在InCallScreen界面上,默认情况下用户可以选择接听、挂断、挂断并短信回复三种模式,向右滑动为接听,向左滑动为挂断,向上滑动为挂断并选择快捷短信回复,如图6:


图 6 incomingCallWidget在来电时的显示
该控件只有在来电的时候才会显示出来,用户可以滑动中间的白色部分到图5中的三个方向:左、上、右,分别触发不同的效果。实际上该控件和解锁界面上的滑动解锁使用的是同一控件,使用滑动的方式触发不同的效果,接下来我们就来看看其控制流程吧。

控制流程

1)布局文件

Phone/res/layout/incall_touch_ui.xml

[html] view plaincopy
  1. <com.android.internal.widget.multiwaveview.GlowPadView  
  2.      android:id="@+id/incomingCallWidget"  
  3.      android:layout_width="match_parent"  
  4.      android:layout_height="wrap_content"  
  5.      android:layout_gravity="center|bottom"  
  6.      android:layout_marginTop="20dip"  
  7.      android:layout_marginBottom="-110dip"  
  8.      android:background="@android:color/black"  
  9.      android:visibility="gone"  
  10.      android:gravity="top"  
  11.   
  12.      prvandroid:targetDrawables="@array/incoming_call_widget_3way_targets"  
  13.      prvandroid:targetDescriptions="@array/incoming_call_widget_3way_target_descriptions"  
  14.      prvandroid:directionDescriptions="@array/incoming_call_widget_3way_direction_descriptions"  
  15.      prvandroid:handleDrawable="@drawable/ic_in_call_touch_handle"  
  16.      prvandroid:innerRadius="@*android:dimen/glowpadview_inner_radius"  
  17.      prvandroid:outerRadius="@*android:dimen/glowpadview_target_placement_radius"  
  18.      prvandroid:outerRingDrawable="@*android:drawable/ic_lockscreen_outerring"  
  19.      prvandroid:snapMargin="@*android:dimen/glowpadview_snap_margin"  
  20.      prvandroid:vibrationDuration="20"  
  21.      prvandroid:feedbackCount="1"  
  22.      prvandroid:glowRadius="@*android:dimen/glowpadview_glow_radius"  
  23.      prvandroid:pointDrawable="@*android:drawable/ic_lockscreen_glowdot"  
  24.      />  

(2)初始化文件

Phone/src/com/android/phone/inCallTouchUi.java

(3)工作流程

首先初始化,代码如下:

[java] view plaincopy
  1. private GlowPadView mIncomingCallWidget;  
  2. mIncomingCallWidget = (GlowPadView) findViewById(R.id.incomingCallWidget);  
  3. mIncomingCallWidget.setOnTriggerListener(this);  

通过初始化代码我们可以看到其注册了一个TriggerListener并且就在本类中就有其实现,那么我继续找到其TriggerListener的实现,代码如下:

[java] view plaincopy
  1. /** 
  2.  * Handles "Answer" and "Reject" actions for an incoming call. 
  3.  * We get this callback from the incoming call widget 
  4.  * when the user triggers an action. 
  5.  */  
  6. @Override  
  7. public void onTrigger(View view, int whichHandle) {  
  8.     ... ...省略  
  9.     mShowInCallControlsDuringHidingAnimation = false;  
  10.     switch (whichHandle) {  
  11.         //来电选择接听电话  
  12.         case ANSWER_CALL_ID:  
  13.             if (DBG) log("ANSWER_CALL_ID: answer!");  
  14.             cancelIncomingPingTime();  
  15.             mInCallScreen.handleOnscreenButtonClick(R.id.incomingCallAnswer);  
  16.             mShowInCallControlsDuringHidingAnimation = true;  
  17.             mLastIncomingCallActionTime = SystemClock.uptimeMillis();  
  18.             break;  
  19.         //来电选择挂断并通过短信回复  
  20.         case SEND_SMS_ID:  
  21.             if (DBG) log("SEND_SMS_ID!");  
  22.             mInCallScreen.handleOnscreenButtonClick(R.id.incomingCallRespondViaSms);  
  23.             break;  
  24.         //来电选择拒接  
  25.         case DECLINE_CALL_ID:  
  26.             if (DBG) log("DECLINE_CALL_ID: reject!");  
  27.             mInCallScreen.handleOnscreenButtonClick(R.id.incomingCallReject);  
  28.             mLastIncomingCallActionTime = SystemClock.uptimeMillis();  
  29.             break;  
  30.         default:  
  31.             Log.wtf(LOG_TAG, "onDialTrigger: unexpected whichHandle value: " + whichHandle);  
  32.             break;  
  33.     }  
  34.     //隐藏滑动控件  
  35.     hideIncomingCallWidget();  
  36.     // Regardless of what action the user did, be sure to clear out  
  37.     // the hint text we were displaying while the user was dragging.  
  38.     mInCallScreen.updateIncomingCallWidgetHint(00);  
  39. }  

最终根据用户的不同选择,跳转到InCallScreen.java中的handleOnscreenButtonClick方法去执行具体代码,如下:
[java] view plaincopy
  1. public void handleOnscreenButtonClick(int id) {  
  2.    ... ...省略  
  3.    switch (id) {  
  4.         //来电正常接听  
  5.        case R.id.incomingCallAnswer:  
  6.            internalAnswerCall();  
  7.            break;  
  8.        //来电拒接  
  9.        case R.id.incomingCallReject:  
  10.            ... ...省略  
  11.            hangupRingingCall();  
  12.            break;  
  13.        //来电拒接并短信回复  
  14.        case R.id.incomingCallRespondViaSms:  
  15.            internalRespondViaSms();  
  16.            break;  
  17.        ... ...省略  
  18.    //更新InCallTouchUi  
  19.    updateInCallTouchUi();  

(4)时序图

时序图以来电接听为例,如图7:

图 7 来电接听时序图

dialpadButton显示/隐藏拨号盘

这里提到的dialpadButton实际上为InCallTouchUi布局上的:

该控件的作用是点击之后显示或隐藏拨号盘,当电话接通之后如果用户点击该控件则会如图8所示:


图 8 DTMF拨号盘

当用户再次点击该控件时,拨号盘隐藏。

控制流程

(1)布局文件

Phone/res/layout/incall_touch_ui.xml
[html] view plaincopy
  1. <ToggleButton android:id="@+id/dialpadButton"  
  2.              style="@style/InCallCompoundButton"  
  3.                android:background="@drawable/btn_dialpad"  
  4.                android:contentDescription="@string/onscreenShowDialpadText"/>  

Phone/res/layout/incall_screen.xml

[html] view plaincopy
  1. <ViewStub android:id="@+id/dtmf_twelve_key_dialer_stub"  
  2.           android:layout="@layout/dtmf_twelve_key_dialer_view"  
  3.           android:layout_width="match_parent"  
  4.           android:layout_height="match_parent"  
  5.           android:layout_marginBottom="@dimen/dialpad_vertical_margin_dtmf"/>  

(2)初始化文件

Phone/src/com/android/phone/inCallTouchUi.java

Phone/src/com/android/phone/inCallScreen.java

(3)工作流程

控件初始化代码如下:

dialpadButton控件初始化:

[java] view plaincopy
  1. private CompoundButton mDialpadButton;  
  2. mDialpadButton = (CompoundButton) mInCallControls.findViewById(R.id.dialpadButton);  
  3. mDialpadButton.setOnClickListener(this);  
  4. mDialpadButton.setOnLongClickListener(this);  

这里的LongClick实际上是,在我们长按该控件时会弹出一个toast显示该控件的作用。

拨号盘控件初始化:

[java] view plaincopy
  1. private DTMFTwelveKeyDialer mDialer;  
  2. ViewStub stub = (ViewStub) findViewById(R.id.dtmf_twelve_key_dialer_stub);  
  3. mDialer = new DTMFTwelveKeyDialer(this, stub);  

我们先找到mDialpadButton的onClick实现方法,如下:
[java] view plaincopy
  1. @Override  
  2. public void onClick(View view) {  
  3.     int id = view.getId();  
  4.     ... ...省略  
  5.     switch (id) {  
  6.         ... ...省略  
  7.         case R.id.dialpadButton:  
  8.         ... ...省略  
  9.             mInCallScreen.handleOnscreenButtonClick(id);  
  10.             break;  
  11.         ... ...省略  
  12.     }  
  13. }  

这里还是调用了InCallScreen中的handleOnscreenButtonClick方法,代码如下:

[java] view plaincopy
  1. public void handleOnscreenButtonClick(int id) {  
  2.    ... ...省略  
  3.    switch (id) {  
  4.        ... ...省略  
  5.        case R.id.dialpadButton:  
  6.            onOpenCloseDialpad();  
  7.            break;  
  8.        ... ...省略  

这里最终调用onOpenCloseDialpad方法去实现打开或者关闭拨号盘,这里我们继续查看onOpenCloseDialpad方法,代码如下:

[java] view plaincopy
  1. public void onOpenCloseDialpad() {  
  2.     ... ...省略  
  3.     //判断拨号盘是否已经打开,如果是则隐藏反之则显示  
  4.     if (mDialer.isOpened()) {  
  5.         closeDialpadInternal(true);  
  6.     } else {  
  7.         openDialpadInternal(true);  
  8.     }  
  9.     mApp.updateProximitySensorMode(mCM.getState());  
  10. }  
  11. //显示拨号盘  
  12. private void openDialpadInternal(boolean animate) {  
  13.     mDialer.openDialer(animate);  
  14.     mApp.inCallUiState.showDialpad = true;  
  15. }  
  16. //以藏拨号盘  
  17. private void closeDialpadInternal(boolean animate) {  
  18.     mDialer.closeDialer(animate);  
  19.     mApp.inCallUiState.showDialpad = false;  
  20. }  

这里的拨号盘实际上是InCallScreen中一块独立的布局,也就是DTMFTwelveKeyDialer,当我们点击dialpadButton后,最终调用到openDialpadInternal或者closeDialpadInternal,通过mDialer去实现拨号盘的显示或隐藏,如mDialer.openDialer代码如下:

[java] view plaincopy
  1. public void openDialer(boolean animate) {  
  2.     ... ...省略  
  3.   
  4.     if (!isOpened()) {  
  5.         // 这里animate=true  
  6.         if (animate) {  
  7.             AnimationUtils.Fade.show(mDialerView);  
  8.         ... ...省略  
  9. }  

查看AnimationUtils.Fade.show方法如下:

[java] view plaincopy
  1. public static void show(final View view) {  
  2.         ... ...省略  
  3.         view.setVisibility(View.VISIBLE);  
  4.         ... ...省略  
  5. }  

最终使得mDialerView显示到界面上。

(4)时序图


图 9 接通后显示拨号盘时序图

audioButton开启/关闭扬声器

扬声器实际上就是手机的外放,在InCallTouchUi布局上显示为:

该控件的作用是点击之后开启或关闭扬声器,也就是使得对方的通话声音能够通过外放增大。如果我们此时连接了蓝牙耳机,那么显示界面如图10所示:


图 10 接入蓝牙耳机后InCallTouchUi上audioButton改变

我可以选择三种不同的音频输出方式:Speaker即扬声器,Handset earpiece手机听筒,Bluetooth蓝牙耳机。

控制流程

(1)布局文件

Phone/res/layout/incall_touch_ui.xml

[html] view plaincopy
  1. <ToggleButton android:id="@+id/audioButton"  
  2.              style="@style/InCallCompoundButton"  
  3.              android:background="@drawable/btn_compound_audio"  
  4.              android:contentDescription="@string/onscreenAudioText"/>  

(2)初始化文件

Phone/src/com/android/phone/inCallTouchUi.java

(3)工作流程

控件初始化代码如下:

audioButton控件初始化:

[java] view plaincopy
  1. private CompoundButton mAudioButton;  
  2. mAudioButton = (CompoundButton) mInCallControls.findViewById(R.id.audioButton);  
  3. mAudioButton.setOnClickListener(this);  
  4. mAudioButton.setOnLongClickListener(this);  

这里的LongClick实际上是,在我们长按该控件时会弹出一个toast显示该控件的作用。找到audioButton的onClick实现方法,如下:
[java] view plaincopy
  1. @Override  
  2. public void onClick(View view) {  
  3.     int id = view.getId();  
  4.     ... ...省略  
  5.     switch (id) {  
  6.         ... ...省略  
  7.         case R.id.audioButton:  
  8.         ... ...省略  
  9.             handleAudioButtonClick();  
  10.             break;  
  11.         ... ...省略  
  12.     }  
  13. }  

这里的handleAudioButtonClick方法对是否接入了蓝牙耳机进行了判断,如果是则会像图9所示那样,弹出三个选项按钮。这里我们假设没有连接蓝牙耳机,代码如下:

[java] view plaincopy
  1. private void handleAudioButtonClick() {  
  2.     ... ...省略  
  3.     //如果连接了蓝牙耳机则执行if里面的代码  
  4.     if (inCallControlState.bluetoothEnabled) {  
  5.         ... ...省略  
  6.     } else {  
  7.         ... ...省略  
  8.         mInCallScreen.toggleSpeaker();  
  9.     }  
  10. }  

这里我们继续查看InCallScreen中的toggleSpeaker方法:

[java] view plaincopy
  1. public void toggleSpeaker() {  
  2.     ... ...省略  
  3.     PhoneUtils.turnOnSpeaker(this, newSpeakerState, true);  
  4.     ... ...省略  
  5. }  

这里最终交由PhoneUtils中的turnOnSpeaker去最终负责打开扬声器。

(4)时序图


图 11 开启/关闭扬声器

muteButton开启/关闭麦克风静音

麦克风静音的作用是在通话过程中,屏蔽自己这段的声音输入,在InCallTouchUi布局上显示为:

控制流程

(1)布局文件

Phone/res/layout/incall_touch_ui.xml

[html] view plaincopy
  1. <ToggleButton android:id="@+id/muteButton"  
  2.              style="@style/InCallCompoundButton"  
  3.              android:background="@drawable/btn_compound_mute"  
  4.              android:contentDescription="@string/onscreenMuteText"/>  

(2)初始化文件

Phone/src/com/android/phone/inCallTouchUi.java

(3)工作流程

控件初始化代码如下:

muteButton控件初始化:

[java] view plaincopy
  1. private CompoundButton mMuteButton;  
  2. mMuteButton = (CompoundButton) mInCallControls.findViewById(R.id.muteButton);  
  3. mMuteButton.setOnClickListener(this);  
  4. mMuteButton.setOnLongClickListener(this);  

这里的LongClick实际上是,在我们长按该控件时会弹出一个toast显示该控件的作用。找到muteButton的onClick实现方法,如下:

[java] view plaincopy
  1. @Override  
  2. public void onClick(View view) {  
  3.     int id = view.getId();  
  4.     ... ...省略  
  5.     switch (id) {  
  6.         ... ...省略  
  7.         case R.id.muteButton:  
  8.         ... ...省略  
  9.             mInCallScreen.handleOnscreenButtonClick(id);  
  10.             break;  
  11.         ... ...省略  
  12.     }  
  13. }  

依然调用了InCallScreen中的handleOnscreenButtonClick方法,代码如下:

[java] view plaincopy
  1. public void handleOnscreenButtonClick(int id) {  
  2.    ... ...省略  
  3.    switch (id) {  
  4.        ... ...省略  
  5.        case R.id.muteButton:  
  6.            onMuteClick();  
  7.            break;  
  8.        ... ...省略  

然后调用onMuteClick方法来实现开启/关闭麦克风静音功能,代码如下:

[java] view plaincopy
  1. public void onMuteClick() {  
  2.     ... ...省略  
  3.     PhoneUtils.setMute(newMuteState);  
  4.     ... ...省略  
  5. }  

最终的实现仍然在PhoneUtils中的setMute方法,该方法将继续传递直到audioManager去执行该静音操作。

(4)时序图


图 12 麦克风静音开启/关闭

holdButton开启/关闭呼叫保持

holdButton实际上就是呼叫保持的开关,用户可以暂停当前通话,在InCallTouchUi布局上显示为:。当用户在通话过程中点击该图标之后,对方将会听到类似提示音“请稍等,现在是呼叫保持……”,该功能用于在两路通话之间进行切换,但只有一路通话时无法开启呼叫保持功能。

控制流程

(1)布局文件

Phone/res/layout/incall_touch_ui.xml

[html] view plaincopy
  1. <ToggleButton android:id="@+id/holdButton"  
  2.              style="@style/InCallCompoundButton"  
  3.              android:background="@drawable/btn_compound_hold"  
  4.              android:contentDescription="@string/onscreenHoldText"/>  

(2)初始化文件

Phone/src/com/android/phone/inCallTouchUi.java

(3)工作流程

控件初始化代码如下:

muteButton控件初始化:

[java] view plaincopy
  1. private CompoundButton mHoldButton;  
  2. mHoldButton = (CompoundButton) mInCallControls.findViewById(R.id.holdButton);  
  3. mHoldButton.setOnClickListener(this);  
  4. mHoldButton.setOnLongClickListener(this);  

这里的LongClick实际上是,在我们长按该控件时会弹出一个toast显示该控件的作用。找到holdButton的onClick实现方法,如下:

[java] view plaincopy
  1. @Override  
  2. public void onClick(View view) {  
  3.     int id = view.getId();  
  4.     ... ...省略  
  5.     switch (id) {  
  6.         ... ...省略  
  7.         case R.id.muteButton:  
  8.         ... ...省略  
  9.             mInCallScreen.handleOnscreenButtonClick(id);  
  10.             break;  
  11.         ... ...省略  
  12.     }  
  13. }  

依然调用了InCallScreen中的handleOnscreenButtonClick方法,代码如下:

[java] view plaincopy
  1. public void handleOnscreenButtonClick(int id) {  
  2.    ... ...省略  
  3.    switch (id) {  
  4.        ... ...省略  
  5.        case R.id.holdButton:  
  6.            onHoldClick();  
  7.            break;  
  8.        ... ...省略  

然后调用onHoldClick方法来实现开启/关闭呼叫保持功能,代码如下:

[java] view plaincopy
  1. private void onHoldClick() {  
  2.     ... ...省略  
  3.     if (hasActiveCall && !hasHoldingCall) {  
  4.         // 开启呼叫保持  
  5.         PhoneUtils.switchHoldingAndActive(  
  6.             mCM.getFirstActiveBgCall());  // Really means "hold" in this state  
  7.         newHoldState = true;  
  8.         holdButtonEnabled = true;  
  9.     } else if (!hasActiveCall && hasHoldingCall && !haveMultipleHoldingCall) {  
  10.         // 取消呼叫保持  
  11.         PhoneUtils.switchHoldingAndActive(  
  12.             mCM.getFirstActiveBgCall());  // Really means "unhold" in this state  
  13.         newHoldState = false;  
  14.         holdButtonEnabled = true;  
  15.     }   
  16.     ... ...省略  
  17.     // 强制关闭拨号盘  
  18.     closeDialpadInternal(true);  // do the "closing" animation  
  19. }  

继续追踪可以找到PhoneUtils中的switchHoldingAndActive方法,代码如下:

[java] view plaincopy
  1. static void switchHoldingAndActive(Call heldCall) {  
  2.     ... ...省略  
  3.     try {  
  4.         CallManager cm = PhoneGlobals.getInstance().mCM;  
  5.         ... ...省略  
  6.         cm.switchHoldingAndActive(heldCall);  
  7.         ... ...省略  
  8. }  

最终的实现会通过CallManager一层层的向下传递,并最终实现呼叫保持功能。

(4)时序图


图 13 呼叫保持开启/关闭

addButton添加一路通话

addButton的意思就是在当前通话的基础上添加一路通话,当前通话将会切换到呼叫保持状态。该图标在InCallTouchUi布局上显示为:

当用户在当前通话过程中点击该图标之后,界面出现拨号盘,如果添加一路通话成功则会如下图14所示:


图 14 添加一路通话界面以及添加后界面

控制流程

(1)布局文件

Phone/res/layout/incall_touch_ui.xml

[html] view plaincopy
  1. <ImageButton android:id="@+id/addButton"  
  2.             style="@style/InCallButton"  
  3.             android:src="@drawable/ic_add_contact_holo_dark"  
  4.             android:contentDescription="@string/onscreenAddCallText"/>  

(2)初始化文件

Phone/src/com/android/phone/inCallTouchUi.java

(3)工作流程

控件初始化代码如下:

addButton控件初始化:

[java] view plaincopy
  1. private CompoundButton mAddButton;  
  2. mAddButton = (CompoundButton) mInCallControls.findViewById(R.id.addButton);  
  3. mAddButton.setOnClickListener(this);  
  4. mAddButton.setOnLongClickListener(this);  

这里的LongClick实际上是,在我们长按该控件时会弹出一个toast显示该控件的作用。找到holdButton的onClick实现方法,如下:

[java] view plaincopy
  1. @Override  
  2. public void onClick(View view) {  
  3.     int id = view.getId();  
  4.     ... ...省略  
  5.     switch (id) {  
  6.         ... ...省略  
  7.         case R.id.addButton:  
  8.         ... ...省略  
  9.             mInCallScreen.handleOnscreenButtonClick(id);  
  10.             break;  
  11.         ... ...省略  
  12.     }  
  13. }  

依然调用了InCallScreen中的handleOnscreenButtonClick方法,代码如下:

[java] view plaincopy
  1. public void handleOnscreenButtonClick(int id) {  
  2.    ... ...省略  
  3.    switch (id) {  
  4.        ... ...省略  
  5.        case R.id.addButton:  
  6.            onAddCallClick();  
  7.            break;  
  8.        ... ...省略  

然后调用onAddClick方法来实现增加一路通话的功能,代码如下:

[java] view plaincopy
  1. private void onAddCallClick() {  
  2.     PhoneUtils.startNewCall(mCM);  
  3. }  

继续追踪可以找到PhoneUtils中的startNewCall方法,代码如下:

[java] view plaincopy
  1. /* package */ static boolean startNewCall(final CallManager cm) {  
  2.     final PhoneGlobals app = PhoneGlobals.getInstance();  
  3.     ... ...省略  
  4.     // 将当前的通话静音  
  5.     if (cm.hasActiveFgCall()) {  
  6.         setMuteInternal(cm.getActiveFgCall().getPhone(), true);  
  7.         app.setRestoreMuteOnInCallResume(true);  
  8.     }  
  9.     Intent intent = new Intent(Intent.ACTION_DIAL);  
  10.     intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);  
  11.     intent.putExtra(ADD_CALL_MODE_KEY, true);  
  12.     try {  
  13.         //跳转到拨号界面  
  14.         app.startActivity(intent);  
  15.     } catch (ActivityNotFoundException e) {  
  16.         ... ...省略