Android 系统设置中的休眠和屏保

最新推荐文章于 2024-07-09 18:22:48 发布

苏柘_level6

最新推荐文章于 2024-07-09 18:22:48 发布

阅读量849

点赞数 10

文章标签： android

本文链接：https://blog.csdn.net/xuanyulevel6/article/details/139958114

版权

简介

由于客户在Android 系统设置中发现Timeout设置项没有效果，因此我对此研究了一下。Timeout是定时屏幕亮度降低，而Dream则是进入屏幕保护。如果是机顶盒等设备的开发者发现这个设置项没用，别见外，因为这里的亮度调整对TV是没用的，因此 ‘Screen Timeout’ 和‘brightness’ 是没用的。

Timeout休眠

界面代码

效果：设置固定的时间之后根据根据用户活动的时间、设备的电源政策（如 mDisplayPowerRequest.policy），以及当前时间来决定设备是保持亮屏、降低亮度还是进入其他省电状态。

代码位置：

packages/apps/Settings/res/xml/display_settings.xml

<com.android.settings.display.TimeoutListPreference
    android:key="screen_timeout"
    android:title="@string/screen_timeout"
    android:summary="@string/summary_placeholder"
    android:entries="@array/screen_timeout_entries"
    android:entryValues="@array/screen_timeout_values"//当点击的时候弹出的listView显示的内容
    settings:keywords="@string/keywords_screen_timeout" />//listView显示的内容对应的时间

这是这个设置项的资源配置文件，它是一个ListPreference 具有七个设置项，具体设置项的代码如下：
packages/apps/Settings/res/values/arrays.xml

//这里是展示出来的字符
<!-- Display settings.  The delay in inactivity before the screen is turned off. These are shown in a list dialog. -->
<string-array name="screen_timeout_entries">
    <item>15 seconds</item>
    <item>30 seconds</item>
    <item>1 minute</item>
    <item>2 minutes</item>
    <item>5 minutes</item>
    <item>10 minutes</item>
    <item>30 minutes</item>
</string-array>

//这里是具体的数值
<!-- Do not translate. -->
<string-array name="screen_timeout_values" translatable="false">
    <!-- Do not translate. -->
    <item>15000</item>
    <!-- Do not translate. -->
    <item>30000</item>
    <!-- Do not translate. -->
    <item>60000</item>
    <!-- Do not translate. -->
    <item>120000</item>
    <!-- Do not translate. -->
    <item>300000</item>
    <!-- Do not translate. -->
    <item>600000</item>
    <!-- Do not translate. -->
    <item>1800000</item>
</string-array>

它的国际化适配是在每一个语言文件夹下的arrays.xml都定义了一个screen_timeout_entries。因此如果要增加一个新的设置项比如“Never”那么就需要在所有可能使用的语言下都加上，否则切换语言之后可能会空指针异常。

属性值

这里选择之后，属性值的改变是Settings.System.SCREEN_OFF_TIMEOUT
adb shell settings get System screen_off_timeout
在你改变screen_timeout_values值的时候，记得如果想要永不息屏，就设置为2147483647 。这是可以设置的最大值。

延时降低亮度的具体逻辑

延时降低亮度的具体的逻辑基本都在frameworks/base/services/core/java/com/android/server/power/PowerManagerService.java

电源省电策略：
    /** Get wake lock summary flags that correspond to the given wake lock. */
    private int getWakeLockSummaryFlags(WakeLock wakeLock) {
        switch (wakeLock.mFlags & PowerManager.WAKE_LOCK_LEVEL_MASK) {
            case PowerManager.PARTIAL_WAKE_LOCK:
                if (!wakeLock.mDisabled) {
                    // We only respect this if the wake lock is not disabled.
                    return WAKE_LOCK_CPU;
                }
                break;
            case PowerManager.FULL_WAKE_LOCK:
                return WAKE_LOCK_SCREEN_BRIGHT | WAKE_LOCK_BUTTON_BRIGHT;
            case PowerManager.SCREEN_BRIGHT_WAKE_LOCK:
                return WAKE_LOCK_SCREEN_BRIGHT;
            case PowerManager.SCREEN_DIM_WAKE_LOCK:
                return WAKE_LOCK_SCREEN_DIM;
            case PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK:
                return WAKE_LOCK_PROXIMITY_SCREEN_OFF;
            case PowerManager.DOZE_WAKE_LOCK:
                return WAKE_LOCK_DOZE;
            case PowerManager.DRAW_WAKE_LOCK:
                return WAKE_LOCK_DRAW;
        }
        return 0;
    }

    private void updatePowerStateLocked() {
这里省略一段代码.............

                updateWakeLockSummaryLocked(dirtyPhase1);
                updateUserActivitySummaryLocked(now, dirtyPhase1);
                updateAttentiveStateLocked(now, dirtyPhase1);
                if (!updateWakefulnessLocked(dirtyPhase1)) {
                    break;
                }
            }

updateUserActivitySummaryLocked 来更新用户活动状态，这个方法特别重要。这是一个更新用户活动状态的函数。它根据当前时间 (now)、用户活动的最后时间 (mLastUserActivityTime) 以及各种超时设置（如屏幕关闭超时、睡眠超时等），来决定接下来设备的行为（如屏幕变暗、关闭等）。

    private void updateUserActivitySummaryLocked(long now, int dirty) {
        // Update the status of the user activity timeout timer.
        if ((dirty & (DIRTY_WAKE_LOCKS | DIRTY_USER_ACTIVITY
                | DIRTY_WAKEFULNESS | DIRTY_SETTINGS)) != 0) {
            mHandler.removeMessages(MSG_USER_ACTIVITY_TIMEOUT);

            long nextTimeout = 0;
            if (getWakefulnessLocked() == WAKEFULNESS_AWAKE
                    || getWakefulnessLocked() == WAKEFULNESS_DREAMING
                    || getWakefulnessLocked() == WAKEFULNESS_DOZING) {
                final long attentiveTimeout = getAttentiveTimeoutLocked();//超时时间用于检测用户是否仍然关注设备
                final long sleepTimeout = getSleepTimeoutLocked(attentiveTimeout);//时时间表示设备在用户不活动后进入休眠状态的时间
                final long screenOffTimeout = getScreenOffTimeoutLocked(sleepTimeout,
                        attentiveTimeout);//表示设备在用户不活动后屏幕关闭的时间。它综合考虑了attentiveTimeout和sleepTimeout，
                final long screenDimDuration = getScreenDimDurationLocked(screenOffTimeout);
                final boolean userInactiveOverride = mUserInactiveOverrideFromWindowManager;
                final long nextProfileTimeout = getNextProfileTimeoutLocked(now);
.....................................
                if (mLastUserActivityTime >= mLastWakeTime) {
                    nextTimeout = mLastUserActivityTime
                            + screenOffTimeout - screenDimDuration;
                    if (now < nextTimeout) {
                        mUserActivitySummary = USER_ACTIVITY_SCREEN_BRIGHT;//这里将屏幕设成亮的
                    } else {
                        nextTimeout = mLastUserActivityTime + screenOffTimeout;
                        if (now < nextTimeout) {
                            mUserActivitySummary = USER_ACTIVITY_SCREEN_DIM;//这里将屏幕设成暗的
                        }
                    }
                }
    }

这里面还有很多种其他条件我就不一一介绍了。如果想要在时间到的时候执行其他操作，就在这里增加逻辑。

变量和方法解释

Attentive Timeout (attentiveTimeout)
- 变量：mAttentiveTimeoutSetting
- 方法：getAttentiveTimeoutLocked()
- 解释：这个超时时间用于检测用户是否仍然关注设备。即使用户没有直接与设备交互，系统也可能通过一些方式（如面部识别）检测到用户的注意力。这种超时策略可以延长屏幕亮起时间，避免在用户依然关注设备时屏幕过早熄灭。
- 返回值：返回一个非负整数，表示配置的时间（单位：毫秒），如果超时设置为0或负数，返回-1，表示不使用这个超时策略。
Sleep Timeout (sleepTimeout)
- 变量：mSleepTimeoutSetting
- 方法：getSleepTimeoutLocked(long attentiveTimeout)
- 解释：这个超时时间表示设备在用户不活动后进入休眠状态的时间。它依赖于attentiveTimeout，如果attentiveTimeout有效（非负），则sleepTimeout不会超过attentiveTimeout。
- 返回值：返回一个非负整数，表示配置的时间（单位：毫秒），如果超时设置为0或负数，返回-1，表示不使用这个超时策略。这里实际上他返回的就是我们设置中的settings get System screen_off_timeout拿到的值
Screen Off Timeout (screenOffTimeout)
- 变量：mScreenOffTimeoutSetting
- 方法：getScreenOffTimeoutLocked(long sleepTimeout, long attentiveTimeout)
- 解释：这个超时时间表示设备在用户不活动后屏幕关闭的时间。它综合考虑了attentiveTimeout和sleepTimeout，并受一些额外设置的影响，如设备管理员强制的最大屏幕关闭时间。
- 返回值：返回一个非负整数，表示配置的时间（单位：毫秒）。

关系分析

attentiveTimeout 与 sleepTimeout

attentiveTimeout 是用户是否仍在关注设备的超时策略。sleepTimeout依赖于attentiveTimeout，即如果attentiveTimeout有效（非负），则sleepTimeout不会超过attentiveTimeout。这意味着只要系统检测到用户还在关注设备，设备就不会进入休眠状态。

sleepTimeout 与 screenOffTimeout

screenOffTimeout 表示屏幕关闭的超时时间，它依赖于sleepTimeout。如果sleepTimeout有效（非负），则screenOffTimeout不会超过sleepTimeout。这意味着在用户不活动且系统决定设备应该休眠前，屏幕会先关闭。

screenOffTimeout 的其他影响因素

screenOffTimeout 还受其他设置影响，如设备管理员设置的最大屏幕关闭时间（mMaximumScreenOffTimeoutFromDeviceAdmin）和窗口管理器覆盖的用户活动超时（mUserActivityTimeoutOverrideFromWindowManager）。这些设置会进一步约束screenOffTimeout的值，确保设备在合规的时间范围内关闭屏幕。

调试信息

如果想要打印这里的调试信息，系统中给了现成的
frameworks/base/services/core/java/com/android/server/power/PowerManagerService.java
            if (DEBUG_SPEW) {
                Slog.d(TAG, "updateUserActivitySummaryLocked: mWakefulness="
                        + PowerManagerInternal.wakefulnessToString(getWakefulnessLocked())
                        + ", mUserActivitySummary=0x" + Integer.toHexString(mUserActivitySummary)
                        + ", nextTimeout=" + TimeUtils.formatUptime(nextTimeout));
            }

效果如下

updateUserActivitySummaryLocked: mWakefulness=Awake, mUserActivitySummary=0x1, nextTimeout=920990 (in 892906 ms)

永不休眠

在 PowerManagerService 和 PhoneWindowManager 处理
直接配置 Settings.System.SCREEN_OFF_TIMEOUT 为Integer.MAX_VALUE（ 2147483647 = 24.855 天一般没有这么长时间亮屏待机）

screensaver屏幕保护

界面代码
packages/apps/Settings/res/xml/display_settings.xml

<Preference
        android:key="screensaver"
        android:title="@string/screensaver_settings_title"
        android:fragment="com.android.settings.dream.DreamSettings" />

我们可以看到其中定义了android:fragment，也就是说当点击该item的时候会跳转到DreamSettings这个fragment。

packages/apps/Settings/src/com/android/settings/display/ScreenSaverPreferenceController.java

public boolean isAvailable() {
    return mContext.getResources().getBoolean(
            com.android.internal.R.bool.config_dreamsSupported);
}

public void updateState(Preference preference) {
    preference.setSummary(DreamSettings.getSummaryTextWithDreamName(mContext));//获取当前的屏保的名称
}

此处读取com.android.internal.R.bool.config_dreamsSupported的值，true表示支持屏保，false表示不支持
更深入的代码没有去研究了，等待更新。

苏柘_level6

关注

10
点赞
踩
19

收藏

觉得还不错? 一键收藏
0
评论
Android 系统设置中的休眠和屏保

由于客户在Android 系统设置中发现Timeout设置项没有效果，因此我对此研究了一下。Timeout是定时屏幕亮度降低，而Dream则是进入屏幕保护。如果是机顶盒等设备的开发者发现这个设置项没用，别见外，因为这里的亮度调整对TV是没用的，因此 ‘Screen Timeout’ 和‘brightness’ 是没用的。
复制链接

扫一扫