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的例子，并进行总结。