Android息屏显示功能原理与实现

Android息屏显示功能原理与实现

引用

CSDN

1.

https://blog.csdn.net/iceFreedom/article/details/141265089

Android息屏显示功能允许用户在手机黑屏状态下查看时间、日期等信息，这一功能的实现涉及系统底层的多个组件。本文将从原理到实现，深入解析Android息屏显示功能的运作机制。

什么是息屏显示

息屏显示是Android设备的一项实用功能，它允许用户在手机黑屏状态下查看当前时间、日期等信息，无需点亮整个屏幕。这一功能主要利用了OLED屏幕像素点自发光的特性，仅显示时间的像素点发光，相比LCD屏幕功耗更低。

Android原生的主动显示

在Android系统设置中，有一个名为“主动显示”的开关项，位于“设置 - 显示”菜单下。当设备在息屏时接收到新通知时，会显示类似息屏显示的效果：

但是，这种显示方式需要在息屏后有通知才会触发，并且会自动消失回归黑屏。那么，如何才能实现息屏后一直显示呢？

源码分析

从Settings的源码来看，主动显示开关对应的Preference配置如下：

<Preference
    android:key="ambient_display"
    android:title="@string/ambient_display_screen_title"
    android:fragment="com.android.settings.display.AmbientDisplaySettings" />

在AmbientDisplaySettings中注册了一些controller：

private static List<AbstractPreferenceController> buildPreferenceControllers(Context context,
        Lifecycle lifecycle, AmbientDisplayConfiguration config,
        MetricsFeatureProvider metricsFeatureProvider,
        AmbientDisplayAlwaysOnPreferenceController.OnPreferenceChangedCallback aodCallback) {
    final List<AbstractPreferenceController> controllers = new ArrayList<>();
    controllers.add(new AmbientDisplayNotificationsPreferenceController(context, config,
            metricsFeatureProvider));
    controllers.add(new AmbientDisplayAlwaysOnPreferenceController(context, config,
            aodCallback));
    controllers.add(new DoubleTapScreenPreferenceController(context, lifecycle, config,
            MY_USER_ID, KEY_AMBIENT_DISPLAY_DOUBLE_TAP));
    controllers.add(new PickupGesturePreferenceController(context, lifecycle, config,
            MY_USER_ID, KEY_AMBIENT_DISPLAY_PICK_UP));
    return controllers;
}

其中，AmbientDisplayAlwaysOnPreferenceController负责处理“始终开启”功能：

public class AmbientDisplayAlwaysOnPreferenceController extends
        AbstractPreferenceController implements PreferenceControllerMixin,
        Preference.OnPreferenceChangeListener {
    private final int ON = 1;
    private final int OFF = 0;
    ...
    @Override
    public void updateState(Preference preference) {
        ((SwitchPreference) preference).setChecked(isAlwaysOnEnabled(mConfig));
    }
    public static boolean isAlwaysOnEnabled(AmbientDisplayConfiguration config) {
        return config.alwaysOnEnabled(MY_USER);
    }
    @Override
    public boolean onPreferenceChange(Preference preference, Object newValue) {
        int enabled = (boolean) newValue ? ON : OFF;
        Settings.Secure.putInt(
                mContext.getContentResolver(), Settings.Secure.DOZE_ALWAYS_ON, enabled);
        if (mCallback != null) {
            mCallback.onPreferenceChanged();
        }
        return true;
    }
    @Override
    public boolean isAvailable() {
        return isAvailable(mConfig);
    }
    public static boolean isAvailable(AmbientDisplayConfiguration config) {
        return config.alwaysOnAvailableForUser(MY_USER);
    }
    ...
}

分析发现，AlwaysOn的enable和available状态需要通过AmbientDisplayConfiguration类来获得。这个类中与alwaysOn有关的几个函数如下：

public boolean alwaysOnEnabled(int user) {
     return boolSettingDefaultOn(Settings.Secure.DOZE_ALWAYS_ON, user) && alwaysOnAvailable()
             && !accessibilityInversionEnabled(user);
 }
 public boolean alwaysOnAvailable() {
     return (alwaysOnDisplayDebuggingEnabled() || alwaysOnDisplayAvailable())
             && ambientDisplayAvailable();
 }
 private boolean alwaysOnDisplayAvailable() {
     return mContext.getResources().getBoolean(R.bool.config_dozeAlwaysOnDisplayAvailable);
 }
 public boolean accessibilityInversionEnabled(int user) {
     return boolSettingDefaultOff(Settings.Secure.ACCESSIBILITY_DISPLAY_INVERSION_ENABLED, user);
 }
 private boolean ambientDisplayAvailable() {
     return !TextUtils.isEmpty(ambientDisplayComponent());
 }
 public String ambientDisplayComponent() {
     return mContext.getResources().getString(R.string.config_dozeComponent);
 }
 private boolean boolSettingDefaultOn(String name, int user) {
     return boolSetting(name, user, 1);
 }
 private boolean boolSetting(String name, int user, int def) {
     return Settings.Secure.getIntForUser(mContext.getContentResolver(), name, def, user) != 0;
 }

要使AlwaysOn功能可用，需要满足以下条件：

1. 处于debug模式，或者config_dozeAlwaysOnDisplayAvailable为true
2. config_dozeComponent取值不为空

要使AlwaysOn功能开启，需要满足以下条件：

1. DOZE_ALWAYS_ON值写入了1
2. alwaysOnAvailable为true
3. 没有开启颜色反转

如何开启息屏显示

原生Android系统中，息屏显示功能默认是关闭的。如果想启用这个功能，可以通过以下方式：

1. 修改系统配置文件frameworks/base/core/res/res/values/config.xml中的两个值：

• config_dozeAlwaysOnDisplayAvailable设置为true
• config_dozeComponent设置为非空值

2. 或者通过修改代码强制alwaysOnAvailable返回true

完成上述修改后，设置里的“主动显示”一栏就会多出一项“始终开启”可以勾选，这样一来设备在息屏之后就能自动开启主动显示功能了。

参考：https://www.jianshu.com/p/0c3641e83ab9