美文网首页
按键 | Power 按键处理流程

按键 | Power 按键处理流程

作者: 力卉编程 | 来源:发表于2019-12-28 20:34 被阅读0次

    Power按键的处理逻辑由PhoneWindowManager来完成,本文只关注PhoneWindowManager中与Power键相关的内容,其他系统按键的处理类似也是在PhoneWindowManager中处理的。理解了power按键的处理再看其他系统按键的逻辑会容易的多也简单的多。

    一、Power按键的上报

    Power按键的上报流程与其余的按键处理流程一致,在按下power按键后驱动上报按键经InputManagerService处理按键事件,最终将会传递到PhoneWindowManager的interceptKeyBeforeQueueing函数来做具体的业务逻辑。(具体处理 Input system 做详细介绍)本篇侧重power的业务逻辑处理,这里简单介绍下power 按键的上报流程如下图:


    POWER键流程

    1-4:在power 按键按下时驱动会上报按键事件,EventHub读取到事件后转给InputReader来做处理。
    5-9:InputReader根据上报的事件类型(此处是按键事件),交给KeyBoardInputMapper来做按键映射,根据驱动上报的按键值来映射为android framework的按键值(即KeyEvent.KEYCODE_POWER 和相应的flag),并通知上层。
    10-16:经过层调用最后到PhoneWindowManager的interceptKeyBeforeQueueing()函数来做具体的业务处理。这是本文的重点,下面具体分析。
    17-18:通过PowerManagerService来唤醒系统。

    二、Power 按键处理

    PhoneWindowManager的interceptKeyBeforeQueueing()函数处理具体的业务逻辑,从这个函数开始进行分析。
    按键的事件分为按下和抬起两个,framework的处理也是分为按下和抬起来不同的事件分别由不同的函数来处理。

    public int interceptKeyBeforeQueueing(KeyEvent event, int policyFlags) {
        if (!mSystemBooted) {
            // If we have not yet booted, don't let key events do anything.
            return 0;
        }
        //是否点亮屏幕
        final boolean interactive = (policyFlags & FLAG_INTERACTIVE) != 0;
        final boolean down = event.getAction() == KeyEvent.ACTION_DOWN;
        final boolean canceled = event.isCanceled();
        //获取按键对应的android framework层的按键编码
        final int keyCode = event.getKeyCode();
        .................
        switch (keyCode) {
            ...........
            case KeyEvent.KEYCODE_POWER: {
                result &= ~ACTION_PASS_TO_USER;
                isWakeKey = false; // wake-up will be handled separately
                if (down) {
                    //处理Power键按下
                    interceptPowerKeyDown(event, interactive);
                } else {
                    //处理Power键松开
                    interceptPowerKeyUp(event, interactive, canceled);
                }
                 break;
            }
        }
        ..............
        if (isWakeKey) {
            //按power键时,isWakeKey置为false,于是不会调用wakeUp函数,即不会唤醒系统点亮屏幕
            wakeUp(event.getEventTime(), mAllowTheaterModeWakeFromKey, "android.policy:KEY");
        }
        return result;
    }
    

    扩展:由上可知 isWakeKey 用来控制是否唤醒系统并点亮屏幕,如果需要添加按键需要实现点亮屏幕功能,可以在此处理 。
    接下来,我们分别看一下interceptPowerKeyDown和interceptPowerKeyUp函数。

    1、Power按键按下(interceptPowerKeyDown)

    interceptPowerKeyDown()用于处理按下Power键(还未抬起)对应的事件。

    Power按键按下处理时序图
    Power按键按下处理时序图
    处理流程:

    1) 判断是否power按键与音量按键“同时”按下需要做截屏动作,是则触发截屏。
    2) 是否为响铃或通话状态,是则执行与之相关配置的动作(默认响铃会静音,如果设置按power挂断电话则挂断)。
    3) 判断是否为长按,是则根据配置执行长按行为的动作。

    代码分析:
    private void interceptPowerKeyDown(KeyEvent event, boolean interactive) {
        // Hold a wake lock until the power key is released.
        // mPowerKeyWakeLock为PARTIAL_WAKE_LOCK级别的锁
        if (!mPowerKeyWakeLock.isHeld()) {
            //将调用到PMS的acquire WakeLock流程
            mPowerKeyWakeLock.acquire();
        }
        // Cancel multi-press detection timeout.
        //处理多次按power键的场景
        //每次power up时,发送MSG_POWER_DELAYED_PRESS的延迟消息
        //如果延迟消息被处理,说明一次完整的Power键处理结束(按下去,弹起来)
        if (mPowerKeyPressCounter != 0) {
            mHandler.removeMessages(MSG_POWER_DELAYED_PRESS);
        }
    
        // Detect user pressing the power button in panic when an application has
        // taken over the whole screen.
        boolean panic = mImmersiveModeConfirmation.onPowerKeyDown(interactive,
            SystemClock.elapsedRealtime(), isImmersiveMode(mLastSystemUiFlags));
        if (panic) {
            mHandler.post(mHiddenNavPanic);
        }
        // Latch power key state to detect screenshot chord.
        //屏状态,满足触发截屏的条件则触发截屏功能
        if (interactive && !mScreenshotChordPowerKeyTriggered
                && (event.getFlags() & KeyEvent.FLAG_FALLBACK) == 0) {
            mScreenshotChordPowerKeyTriggered = true;
            mScreenshotChordPowerKeyTime = event.getDownTime();
            //触发截屏功能
            interceptScreenshotChord();
        }
        // Stop ringing or end call if configured to do so when power is pressed.
        TelecomManager telecomManager = getTelecommService();
        boolean hungUp = false;
        if (telecomManager != null) {
            if (telecomManager.isRinging()) {
                // Pressing Power while there's a ringing incoming
                // call should silence the ringer.
                //有电话拨入且响铃状态,默认设置静音
                telecomManager.silenceRinger();
            } else if ((mIncallPowerBehavior &Settings.Secure.INCALL_POWER_BUTTON_BEHAVIOR_HANGUP) != 0&& telecomManager.isInCall() && interactive) {
                // Otherwise, if "Power button ends call" is enabled,
                // the Power button will hang up any current active call.
                //如果正在接听电话,且配置了Power键挂断电话的话,按Power按键挂断正在接听的电话
                hungUp = telecomManager.endCall();
            }
        } 
        GestureLauncherService gestureService = LocalServices.getService(
                GestureLauncherService.class);
        boolean gesturedServiceIntercepted = false;
        if (gestureService != null) {
            //手势对应的服务,尝试拦截处理Power键动作事件
            gesturedServiceIntercepted = gestureService.interceptPowerKeyDown(event, interactive,mTmpBoolean);
            if (mTmpBoolean.value && mGoingToSleep) {
                mCameraGestureTriggeredDuringGoingToSleep = true;
            }
        }
    
        // If the power key has still not yet been handled, then detect short
        // press, long press, or multi press and decide what to do.
        mPowerKeyHandled = hungUp ||mScreenshotChordVolumeDownKeyTriggered||mScreenshotChordVolumeUpKeyTriggered || gesturedServiceIntercepted;
    
        //Power键事件未被消耗掉
        if (!mPowerKeyHandled) {
           //屏幕还是亮的
            if (interactive) {
                // When interactive, we're already awake.
                // Wait for a long press or for the button to be released to decide what to do.
                //1、 判断是否支持长按的行为
                if (hasLongPressOnPowerBehavior()) {
                //2、 亮屏状态,长按Power键将触发MSG_POWER_LONG_PRESS消息
    
                    Message msg = mHandler.obtainMessage(MSG_POWER_LONG_PRESS);
    
                    msg.setAsynchronous(true);
                    mHandler.sendMessageDelayed(msg,
                            ViewConfiguration.get(mContext).getDeviceGlobalActionKeyTimeout());
                }
            } else {
                //3、灭屏状态先唤醒系统,这个会调用到PMS的wakeUp
                wakeUpFromPowerKey(event.getDownTime());
                //支持熄屏长按,mSupportLongPressPowerWhenNonInteractive读资源文件得到,默认为false
                if (mSupportLongPressPowerWhenNonInteractive && hasLongPressOnPowerBehavior()) {
                    Message msg = mHandler.obtainMessage(MSG_POWER_LONG_PRESS);
                    msg.setAsynchronous(true);
                    mHandler.sendMessageDelayed(msg,                   ViewConfiguration.get(mContext).getDeviceGlobalActionKeyTimeout());
                    mBeganFromNonInteractive = true;
                } else {
                    //默认返回1
                    final int maxCount = getMaxMultiPressPowerCount();
                    if (maxCount <= 1) {
                        //息屏时,按下power键(不弹起),仅消耗掉该事件
                        mPowerKeyHandled = true;
                    } else {
                        mBeganFromNonInteractive = true;
    
                    }
                }
            }
        }
    }
    
    1)是否支持长按hasLongPressOnPowerBehavior ()

    hasLongPressOnPowerBehavior负责判断终端是否支持长按的行为,通过读取系统的配置文件来判断。

    private boolean hasLongPressOnPowerBehavior() {
    
        return getResolvedLongPressOnPowerBehavior() != LONG_PRESS_POWER_NOTHING;
    
    }
    
    private int getResolvedLongPressOnPowerBehavior() {
        //取决与系统属性"factory.long_press_power_off",此处默认为false
        if (FactoryTest.isLongPressOnPowerOffEnabled()) {
            return LONG_PRESS_POWER_SHUT_OFF_NO_CONFIRM;
        }
        return mLongPressOnPowerBehavior;
    }
    

    从上面的代码可以看出,终端是否支持长按行为,最终将由mLongPressOnPowerBehavior决定。

    mLongPressOnPowerBehavior = mContext.getResources().getInteger(      com.android.internal.R.integer.config_longPressOnPowerBehavior);
    

    mLongPressOnPowerBehavior将在PhoneWindowManager初始化时,通过读取资源文件(定义在frameworks/base/res/res/values/config.xm 中)得到,一般情况下应该为1。 于是,hasLongPressOnPowerBehavior的值返回true,即终端支持Power键长按。
    config.xm 中定义的power按键的长按、短按、双击 、三联按的行为

    长按MSG_POWER_LONG_PRESS的处理

    从上面的代码,在亮屏时按Power键,会触发延迟的MSG_POWER_LONG_PRESS消息。 如果在MSG_POWER_LONG_PRESS超时前,Power键未被释放掉,那么此次操作被定义为长按Power键。

    image

    MSG_POWER_LONG_PRESS对应的处理函数为powerLongPress:

    private void powerLongPress() {
        //也是由资源文件得到,默认为1,即LONG_PRESS_POWER_GLOBAL_ACTIONS
    
        final int behavior = getResolvedLongPressOnPowerBehavior();
        switch (behavior) {
            case LONG_PRESS_POWER_NOTHING:
                break;
            case LONG_PRESS_POWER_GLOBAL_ACTIONS:
                mPowerKeyHandled = true;
                //performHapticFeedbackLw进行震动反馈,不同的事件,定义了不同的震动模式
                if (!performHapticFeedbackLw(null, HapticFeedbackConstants.LONG_PRESS, false)) {
                    //如果没有震动反馈,尝试声音反馈,例如响一下按键音
                    performAuditoryFeedbackForAccessibilityIfNeed();
                }
                //弹出选择关机还是重启的对话框
                showGlobalActionsInternal();
                break;
            case LONG_PRESS_POWER_SHUT_OFF:
            case LONG_PRESS_POWER_SHUT_OFF_NO_CONFIRM:
                mPowerKeyHandled = true;
                performHapticFeedbackLw(null, HapticFeedbackConstants.LONG_PRESS, false);
                //弹出系统关机界面
         sendCloseSystemWindows(SYSTEM_DIALOG_REASON_GLOBAL_ACTIONS);
                //调关机接口
                mWindowManagerFuncs.shutdown(behavior == LONG_PRESS_POWER_SHUT_OFF);
                break;
            .........
        }
    }
    
    3)唤醒系统点亮屏幕wakeUpFromPowerKey ()

    在息屏的状态下按下Power键,将调用wakeUpFromPowerKey函数唤醒系统:

    private void wakeUpFromPowerKey(long eventTime) {
        //从config.xml读mAllowTheaterModeWakeFromPowerKey默认为true
        wakeUp(eventTime, mAllowTheaterModeWakeFromPowerKey, "android.policy:POWER");
    } 
    private boolean wakeUp(long wakeTime, boolean wakeInTheaterMode, String reason) {
        //取数据库的值
        final boolean theaterModeEnabled = isTheaterModeEnabled();
        //按Power键时,条件返回false
        if (!wakeInTheaterMode && theaterModeEnabled) {
            return false;
        }
    
        if (theaterModeEnabled) {
            Settings.Global.putInt(mContext.getContentResolver(),
                    Settings.Global.THEATER_MODE_ON, 0);
        }
        //最终将调用到PMS的wakeUp函数
        mPowerManager.wakeUp(wakeTime, reason);
        return true;
    }
    //我们跟进一下PMS的wakeUp函数:
    public void wakeUp(long eventTime, String reason, String opPackageName) {
        ..........
        try {
            wakeUpInternal(eventTime, reason, uid, opPackageName, uid);
        } finally {
            ...............
        }
    }
    private void wakeUpInternal(long eventTime, String reason, int uid, String opPackageName,
            int opUid) {
        synchronized (mLock) {
            //更新Wakefullness的状态为WAKEFULNESS_AWAKE,记录一次UserActivity
            if (wakeUpNoUpdateLocked(eventTime, reason, uid, opPackageName, opUid)) {
                //如之前博客所述,对整个电源状态进行一次调整,将在需要时点亮屏幕
                updatePowerStateLocked();
            }
        }
    }
    

    B: Power抬起代码分析(略)

    2)finishPowerKeyPress
    每当处理一次完整的Power键按下、弹出操作后,interceptPowerKeyUp调用finishPowerKeyPress进行最后的状态复位操作:

    private void finishPowerKeyPress() {
    
        mBeganFromNonInteractive = false;
        mPowerKeyPressCounter = 0;
        if (mPowerKeyWakeLock.isHeld()) {
            mPowerKeyWakeLock.release();
        }
    }
    

    从代码可以看出,主要的工作其实就是将状态变量恢复为初始值,同时释放掉最初申请的锁。

    三、Power按键处理总流程

    按键处理的总流程如下图:

    image

    完~~~
    文 | 力卉编程

    相关文章

      网友评论

          本文标题:按键 | Power 按键处理流程

          本文链接:https://www.haomeiwen.com/subject/xxfeoctx.html