Android 7.0 虛擬按鍵(NavigationBar)源碼分析 之 點擊事件的實現流程

第二部分: Let's go!!!

【點擊事件的實現流程】

1、初始化

    虛擬按鍵點擊效果的實現和實體按鍵相似,也是通過上報一個keyCode值,來判斷哪個按鈕被點擊。不同的是,實體按鍵的keyCode值是硬件驅動層傳遞到上層的。而虛擬按鍵的keyCode值是應用層自己定義的。
    首先來看KeyButtonView的構造函數。由此可見,最終都會調用到有三個參數的構造方法。最重要的是變量 mCode,它接收了在佈局文件中定義的 keyCode 值。

    public KeyButtonView(Context context, AttributeSet attrs) {
        this(context, attrs, 0);
    }

    public KeyButtonView(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs);

        TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.KeyButtonView,
                defStyle, 0);
        //在佈局xml文件中定義的keyCode值,用於分發點擊事件時唯一標記一個按鍵
        mCode = a.getInteger(R.styleable.KeyButtonView_keyCode, 0);
        //在佈局xml文件中定義的值,定義該按鈕是否支持長按。
        mSupportsLongpress = a.getBoolean(R.styleable.KeyButtonView_keyRepeat, true);

        TypedValue value = new TypedValue();
        //如果定義了android:contentDescription屬性,則給該按鈕添加描述
        if (a.getValue(R.styleable.KeyButtonView_android_contentDescription, value)) {
            mContentDescriptionRes = value.resourceId;
        }

        a.recycle();


        setClickable(true); //因爲繼承的ImageView,所以設置下它的Clickable爲true,不然不能點擊
        mTouchSlop = ViewConfiguration.get(context).getScaledTouchSlop(); //該變量控制虛擬按鍵的可點擊區域
        mAudioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE); //獲取音頻服務,用於播放按鍵音
        setBackground(new KeyButtonRipple(context, this)); //設置背景
    }

2、事件的發送   

    之前說過KeyButtonView繼承自ImageView,間接父類是View類,所以它的觸摸事件可以通過 onTouchEvent() 回調方法來接收,單擊和長按事件的發送,也是通過重寫該方法實現的。

    最重要的MotionEvent就是ACTION_DOWN事件,單擊和長按事件主要是在這裏處理的。

    首先是單擊事件。首先判斷當前按鈕的mCode,即keyCode的值。如果不爲0,則通過 sendEvent() 發送ACTION_DOWN的事件。

    然後把一個Runnable:mCheckLongPress 放入隊列,延時0.5s執行,用與檢查是否滿足長按的條件。

注:ViewConfiguration.getLongPressTimeout() 的值爲500ms,即0.5s。

    其他MotionEvent就不細說了,代碼裏都寫了註釋。

    public boolean onTouchEvent(MotionEvent ev) {
        final int action = ev.getAction();
        int x, y;
        if (action == MotionEvent.ACTION_DOWN) {
            mGestureAborted = false;
        }
        if (mGestureAborted) {
            return false;
        }

        switch (action) {
            case MotionEvent.ACTION_DOWN:
                mDownTime = SystemClock.uptimeMillis();//記錄按下的時間
                mLongClicked = false;
                setPressed(true); //設置當前按鈕爲按下的狀態
                if (mCode != 0) {
                    //如果mCode不爲零,則發送一個ACTION_DOWN類型的點擊事件
                    sendEvent(KeyEvent.ACTION_DOWN, 0, mDownTime);
                } else {
                    // Provide the same haptic feedback that the system offers for virtual keys.
                    performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
                }
                //再次進入MotionEvent.ACTION_DOWN時,移除檢查長按狀態的的Runnable
                removeCallbacks(mCheckLongPress);
                //發送一個延時0.5s的Runnable。用於檢查當前按鈕是否滿足長按條件
                postDelayed(mCheckLongPress, ViewConfiguration.getLongPressTimeout());
                break;
            case MotionEvent.ACTION_MOVE:
                x = (int)ev.getX();
                y = (int)ev.getY();
                //獲取當前觸屏座標,當手指移動出按鍵範圍,將Pressed狀態設爲false
                setPressed(x >= -mTouchSlop
                        && x < getWidth() + mTouchSlop
                        && y >= -mTouchSlop
                        && y < getHeight() + mTouchSlop);
                break;
            case MotionEvent.ACTION_CANCEL:
                setPressed(false);
                //發送CANCELED類型的點擊事件
                if (mCode != 0) {
                    sendEvent(KeyEvent.ACTION_UP, KeyEvent.FLAG_CANCELED);
                }
                removeCallbacks(mCheckLongPress);
                break;
            case MotionEvent.ACTION_UP:
                final boolean doIt = isPressed() && !mLongClicked;
                setPressed(false);
                if (mCode != 0) {
                    if (doIt) {
                        sendEvent(KeyEvent.ACTION_UP, 0); //發送ACTION_UP事件
                        sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);
                        playSoundEffect(SoundEffectConstants.CLICK); //播放按鍵音
                    } else {
                        sendEvent(KeyEvent.ACTION_UP, KeyEvent.FLAG_CANCELED);
                    }
                } else {
                    // no key code, just a regular ImageView
                    if (doIt) {
                        performClick();
                    }
                }
                removeCallbacks(mCheckLongPress);
                break;
        }

        return true;
    }

    來看看這個mCheckLongPress的實現。當接收到 MotionEvent.ACTION_DOWN 事件0.5s後,run()就會被執行。但前提是,在這期間,沒有再次接收到 ACTION_DOWN,ACTION_CANCEL,ACTION_UP 其中的任一事件,否則 mCheckLongPress 會被移除。

    如果執行到了run(),判斷當前按鈕是否仍然爲按下的狀態,如果爲true,表示滿足長按的條件,因爲從接收到ACTION_DOWN到現在一共0.5s,按鈕一直處於pressed的狀態。由此可見,系統默認按下按鍵持續0.5s即爲長按動作。

    通過isLongClickable()判斷當前按鈕是否支持長按,如果爲true,則通過父類View的方法performLongClick()去發送一個長按的事件。

    變量mSupportsLongpress默認值爲true。用於確保當isLongClickable()爲false時,也能發送出長按事件。

    private final Runnable mCheckLongPress = new Runnable() {
        public void run() {
            if (isPressed()) { //判斷當前按鈕是否仍爲按下的狀態
                if (isLongClickable()) { //判斷是否支持長按
                    // Just an old-fashioned ImageView
                    performLongClick(); //發送長按事件
                    mLongClicked = true;
                } else if (mSupportsLongpress) {
                    sendEvent(KeyEvent.ACTION_DOWN, KeyEvent.FLAG_LONG_PRESS);
                    sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_LONG_CLICKED);
                    mLongClicked = true;
                }
            }
        }
    };

細心的筒子們可能發現了。發送事件大部分都是通過 sendEvent() 來實現的。看下它的源碼。

它將包含了keyCode,action和repeatCount等數據的KeyEvent,通過系統服務類InputManager,把事件發送了出去。

事件發送出去了,在哪處理呢?往下看。

    public void sendEvent(int action, int flags) {
        sendEvent(action, flags, SystemClock.uptimeMillis());
    }

    void sendEvent(int action, int flags, long when) {
        final int repeatCount = (flags & KeyEvent.FLAG_LONG_PRESS) != 0 ? 1 : 0;
        final KeyEvent ev = new KeyEvent(mDownTime, when, action, mCode, repeatCount,
                0, KeyCharacterMap.VIRTUAL_KEYBOARD, 0,
                flags | KeyEvent.FLAG_FROM_SYSTEM | KeyEvent.FLAG_VIRTUAL_HARD_KEY,
                InputDevice.SOURCE_KEYBOARD);
        InputManager.getInstance().injectInputEvent(ev,
                InputManager.INJECT_INPUT_EVENT_MODE_ASYNC);
    }

3、事件的處理

    由於虛擬按鍵需要在系統所有界面都能響應,所以點擊事件也跟一般View的處理不太一樣。我們知道,一個界面的點擊事件發生時,是由當前Activity的dispatchTouchEvent()去分發,但具體的工作是由其內部的Window去完成的。所以要想在所有界面中都響應某個按鍵,則必須在Window的管理類中去處理。

    路徑是 frameworks/base/services/core/java/com/android/server/policy/PhoneWindowManager.java

    當有點擊事件發生時,首先都會在該類中進行處理,然後向下分發。來看看interceptKeyBeforeDispatching()。光看方法的名字,都可以推測,這個方法會在key事件被分發前被調用。

    到這裏,之前設置的keyCode就派上用場了。首先來看HOME鍵,通過keyCode確定當前按下了虛擬按鍵的HOME鍵。

先處理單擊事件,把除了 KeyEvent.ACTION_DOWN 之外的key類型,作爲單擊事件結束的標誌。中間加了一些條件,在某些條件下,不響應HOME鍵的點擊操作。

    關鍵方法是 handleShortPressOnHome(),下面細說。

    接着是長按事件。 如果 repeatCount > 0 ,且事件裏包含了 KeyEvent.FLAG_LONG_PRESS 這個FLAG,則說明是長按事件。在 handleLongPressOnHome(event.getDeviceId()) 中去處理。詳情往下滑。

    這裏還有個雙擊事件,就不多說了,因爲一般不用雙擊這個效果,而且原理也差不多。

    @Override
    public long interceptKeyBeforeDispatching(WindowState win, KeyEvent event, int policyFlags) {
        final boolean keyguardOn = keyguardOn();
        final int keyCode = event.getKeyCode();
        final int repeatCount = event.getRepeatCount();
        final int metaState = event.getMetaState();
        final int flags = event.getFlags();
        final boolean down = event.getAction() == KeyEvent.ACTION_DOWN;
        final boolean canceled = event.isCanceled();
        ...

        // First we always handle the home key here, so applications
        // can never break it, although if keyguard is on, we do let
        // it handle it, because that gives us the correct 5 second
        // timeout.
        if (keyCode == KeyEvent.KEYCODE_HOME) {

            // If we have released the home key, and didn't do anything else
            // while it was pressed, then it is time to go home!
            if (!down) {
                cancelPreloadRecentApps(); //如果當前爲顯示最近使用APP列表界面,則隱藏掉

                mHomePressed = false;
                if (mHomeConsumed) {
                    mHomeConsumed = false;
                    return -1;
                }

                if (canceled) {
                    Log.i(TAG, "Ignoring HOME; event canceled.");
                    return -1;
                }

                // If an incoming call is ringing, HOME is totally disabled.
                // (The user is already on the InCallUI at this point,
                // and his ONLY options are to answer or reject the call.)
                TelecomManager telecomManager = getTelecommService();
                if (telecomManager != null && telecomManager.isRinging()) {
                    Log.i(TAG, "Ignoring HOME; there's a ringing incoming call.");
                    return -1;
                }

                // Delay handling home if a double-tap is possible.
                if (mDoubleTapOnHomeBehavior != DOUBLE_TAP_HOME_NOTHING) {
                    mHandler.removeCallbacks(mHomeDoubleTapTimeoutRunnable); // just in case
                    mHomeDoubleTapPending = true;
                    mHandler.postDelayed(mHomeDoubleTapTimeoutRunnable,
                            ViewConfiguration.getDoubleTapTimeout());
                    return -1;
                }

                handleShortPressOnHome();
                return -1;
            }

            // Remember that home is pressed and handle special actions.
            if (repeatCount == 0) {
                mHomePressed = true;
                if (mHomeDoubleTapPending) {
                    mHomeDoubleTapPending = false;
                    mHandler.removeCallbacks(mHomeDoubleTapTimeoutRunnable);
                    handleDoubleTapOnHome();
                } else if (mLongPressOnHomeBehavior == LONG_PRESS_HOME_RECENT_SYSTEM_UI
                        || mDoubleTapOnHomeBehavior == DOUBLE_TAP_HOME_RECENT_SYSTEM_UI) {
                    preloadRecentApps();
                }
            } else if ((event.getFlags() & KeyEvent.FLAG_LONG_PRESS) != 0) {
                if (!keyguardOn) {
                    handleLongPressOnHome(event.getDeviceId());
                }
            }
            return -1;
        }
    ...
    }

先講單擊的具體邏輯。一步步調用,來到了帶兩個參數的 launchHomeFromHotKey

這裏分了兩種情況。鎖屏狀態和非鎖屏狀態。

在鎖屏狀態下,不響應HOME鍵的點擊操作,直接返回。

只有在非鎖屏狀態下,才能響應HOME鍵的操作。關鍵是 startDockOrHome(true, awakenFromDreams);

    private void handleShortPressOnHome() {
        ...
        // Go home!
        launchHomeFromHotKey();
    }

    void launchHomeFromHotKey() {
        launchHomeFromHotKey(true /* awakenFromDreams */, true /*respectKeyguard*/);
    }

    /**
     * A home key -> launch home action was detected.  Take the appropriate action
     * given the situation with the keyguard.
     */
    void launchHomeFromHotKey(final boolean awakenFromDreams, final boolean respectKeyguard) {
        if (respectKeyguard) {
            if (isKeyguardShowingAndNotOccluded()) {
                // don't launch home if keyguard showing
                return;
            }

            if (!mHideLockScreen && mKeyguardDelegate.isInputRestricted()) {
                // when in keyguard restricted mode, must first verify unlock
                // before launching home
                mKeyguardDelegate.verifyUnlock(new OnKeyguardExitResult() {
                    @Override
                    public void onKeyguardExitResult(boolean success) {
                        if (success) {
                            try {
                                ActivityManagerNative.getDefault().stopAppSwitches();
                            } catch (RemoteException e) {
                            }
                            sendCloseSystemWindows(SYSTEM_DIALOG_REASON_HOME_KEY);
                            startDockOrHome(true /*fromHomeKey*/, awakenFromDreams);
                        }
                    }
                });
                return;
            }
        }

        // no keyguard stuff to worry about, just launch home!
        try {
            ActivityManagerNative.getDefault().stopAppSwitches();
        } catch (RemoteException e) {
        }
        if (mRecentsVisible) {
            // Hide Recents and notify it to launch Home
            if (awakenFromDreams) {
                awakenDreams();
            }
            hideRecentApps(false, true);
        } else {
            // Otherwise, just launch Home
            sendCloseSystemWindows(SYSTEM_DIALOG_REASON_HOME_KEY);
            startDockOrHome(true /*fromHomeKey*/, awakenFromDreams);
        }
    }

startDockOrHome(true, awakenFromDreams) 完成了界面的切換,從當前界面跳轉到桌面。

每個桌面應用的主Activity會在AndroidManifest文件中設置一個 Intent.CATEGORY_HOME 的標籤,通過這個標籤,就可以通過intent匹配跳轉到到桌面主界面。

    mHomeIntent =  new Intent(Intent.ACTION_MAIN, null);
    mHomeIntent.addCategory(Intent.CATEGORY_HOME);
    mHomeIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
            | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);

    void startDockOrHome(boolean fromHomeKey, boolean awakenFromDreams) {
        if (awakenFromDreams) {
            awakenDreams();
        }

        Intent dock = createHomeDockIntent();
        if (dock != null) {
            try {
                if (fromHomeKey) {
                    dock.putExtra(WindowManagerPolicy.EXTRA_FROM_HOME_KEY, fromHomeKey);
                }
                startActivityAsUser(dock, UserHandle.CURRENT);
                return;
            } catch (ActivityNotFoundException e) {
            }
        }

        Intent intent;

        if (fromHomeKey) {
            intent = new Intent(mHomeIntent);
            intent.putExtra(WindowManagerPolicy.EXTRA_FROM_HOME_KEY, fromHomeKey);
        } else {
            intent = mHomeIntent;
        }

        startActivityAsUser(intent, UserHandle.CURRENT);
    }

到此,單擊事件告一段落。下面是長按事件。

關鍵方法 handleLongPressOnHome。

這裏有個變量 mLongPressOnHomeBehavior,作用是控制按鍵長按所需要進行的操作。如果需要客製化,則改動mLongPressOnHomeBehavior的值,並在對應的值下進行響應的處理即可。

    private void handleLongPressOnHome(int deviceId) {
        if (mLongPressOnHomeBehavior == LONG_PRESS_HOME_NOTHING) {
            return;
        }
        mHomeConsumed = true;
        //振動反饋
        performHapticFeedbackLw(null, HapticFeedbackConstants.LONG_PRESS, false);

        switch (mLongPressOnHomeBehavior) {
            case LONG_PRESS_HOME_RECENT_SYSTEM_UI:
                toggleRecentApps(); //啓動最近打開過的App列表界面
                break;
            case LONG_PRESS_HOME_ASSIST:
                launchAssistAction(null, deviceId); //啓動助手類應用
                break;
            default:
                Log.w(TAG, "Undefined home long press behavior: " + mLongPressOnHomeBehavior);
                break;
        }
    }


OK。到此虛擬按鍵事件的發送和處理都已經完成了。

下面準備分享一個客製化修改NavigationBar的例子,並進行總結。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章