android 电源管理(PowerManager)

1. 概述

PowerManager 管理设备的电源状态。它的使用会显著地影响到设备电池寿命,除非的确需要,轻易不要获取PowerManager唤醒锁(PowerManager.WakeLock),而且尽可能使用最小级别,一定要尽快释放。

您可以通过调用Context.getSystemService()获取PowerManager 的实例,以及使用newWakeLock()方法创建PowerManager唤醒锁(PowerManager.WakeLock)对象,然后使用唤醒锁(WakeLock)对象中的方法去控制设备电源的状态。

在实践中,这很简单:

PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
 PowerManager.WakeLock wl = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, "My Tag");
 wl.acquire();
   ... 
   ... //在acquire() 和 release()之间这屏幕将一直灰暗地亮着
 wl.release();


以下是唤醒锁级别的定义,它们的不同对系统电源的影响也不同。这些级别是互斥的,您只能指定其中一个

Flag ValueCPUScreenKeyboard
PARTIAL_WAKE_LOCKOn*OffOff
SCREEN_DIM_WAKE_LOCKOnDimOff
SCREEN_BRIGHT_WAKE_LOCKOnBrightOff
FULL_WAKE_LOCKOnBrightBright


* 如果您持有partial唤醒锁(PARTIAL_WAKE_LOCK), 不管任何显示超时或屏幕的状态如何以及甚至用户按电源按钮, CPU 将持续运行。至于其他所有唤醒锁,CPU将运行,但是用户使用电源按钮,依然能够将设备置入睡眠状态。

此外,您可以增加两个额外的标志,他们仅影响屏幕的行为,当和PARTIAL_WAKE_LOCK 组合时,没有任何影响,也即无效

Flag ValueDescription
ACQUIRE_CAUSES_WAKEUP正常唤醒锁实际上没有亮屏,相反,一旦点亮它们将使屏幕一直亮着(例如:来自user activity) ,当获取到唤醒锁的时候,这个标志将迫使屏幕或键盘立即打开 ,一个典型的使用将是,立即让用户看到的重要通知。
ON_AFTER_RELEASE如果这个标志被置,当唤醒锁被释放,user activity 定时器将被复位保持屏幕亮稍微长一点,如果您来回循环地切换唤醒锁条件,它可用于减少闪烁。

任何使用唤醒锁的应用必须在该应用的manifest 添加“android.permission.WAKE_LOCK” 权限, 例如:

... ...    
<uses-permission android:name="android.permission.WAKE_LOCK" />
... ...


2. PowerManager 类常量定义


一些位控制的私有成员:

    private static final int WAKE_BIT_CPU_STRONG = 1;
    private static final int WAKE_BIT_CPU_WEAK = 2;
    private static final int WAKE_BIT_SCREEN_DIM = 4;
    private static final int WAKE_BIT_SCREEN_BRIGHT = 8;
    private static final int WAKE_BIT_KEYBOARD_BRIGHT = 16;
    private static final int WAKE_BIT_PROXIMITY_SCREEN_OFF = 32;



1)public static final int ACQUIRE_CAUSES_WAKEUP = 0x10000000(268435456);


 唤醒锁级别:当获取到唤醒锁的时候点亮屏。

通常唤醒锁实际上不唤醒设备,一旦已经点亮,它们只是使屏幕保持亮着。将视频播放器应用看作正常行为,弹出的通知和想要设备点亮是个例外,使用此标志就是像它们一样。

注: 该标志不能和PARTIAL_WAKE_LOCK一起使用。



2). public static final int FULL_WAKE_LOCK =0x0000001a(WAKE_BIT_CPU_WEAK | WAKE_BIT_SCREEN_BRIGHT |WAKE_BIT_KEYBOARD_BRIGHT =26);

唤醒锁级别:确保屏幕和键盘背光全亮.

如果用户按power按钮,FULL_WAKE_LOCK被系统完全释放,使得屏幕和CPU被关,和PARTIAL_WAKE_LOCK截然不同。

多数应用应该使用FLAG_KEEP_SCREEN_ON 替代该类唤醒锁,因为它将被平台正确管理,用户在应用使用中不需要特殊的权限。



3). public static final int ON_AFTER_RELEASE = 0x20000000;

 唤醒锁级别:当该锁被释放,将触发user activity定时器,因此屏幕会再亮一会。如果屏幕没有点亮,将不会亮屏。


4). public static final int PARTIAL_WAKE_LOCK = WAKE_BIT_CPU_STRONG;

 唤醒锁级别: 确保CPU正在运行,屏幕和键盘允许off 。

如果用户按下power 按钮,将灭屏但是CPU保持运行,直到所有的PARTIAL_WAKE_LOCK 锁都被release。


5). public static final int SCREEN_BRIGHT_WAKE_LOCK = WAKE_BIT_CPU_WEAK | WAKE_BIT_SCREEN_BRIGHT;

唤醒锁级别: 确保屏幕全亮,键盘的背光允许关掉。如果用户按下power键,SCREEN_BRIGHT_WAKE_LOCK将被系统完全释放,使得屏幕和CPU被关。

多数应用应该使用FLAG_KEEP_SCREEN_ON 替代该类唤醒锁, 因为它将被平台正确管理,用户在应用使用中不需要特殊的权限。
 

6). public static final int SCREEN_DIM_WAKE_LOCK = WAKE_BIT_CPU_WEAK | WAKE_BIT_SCREEN_DIM;

唤醒锁级别:确保屏幕点亮(但是可能是暗淡的),键盘背光允许被关。
多数应用应该使用FLAG_KEEP_SCREEN_ON 替代该类唤醒锁, 因为它将被平台正确管理,用户在应用使用中不需要特殊的权限。

如果用户按下power键,该锁将被系统release,使得屏幕和CPU都被关。跟PARTIAL_WAKE_LOCK截然不同。

3.PowerManager 对外接口方法


1) .public void goToSleep(long time)

迫使设备进入睡眠。持有所有唤醒锁,当power键按下的时候灭屏。
需要DEVICE_POWER( android.permission.DEVICE_POWER)权限。

参数:time

是以uptimeMillis()为时间基准,请求睡眠时的时间,这个时间戳被用来和其他电源管理功能一起正确排序睡眠请求。应该设置睡眠请求输入事件的时间戳。


2). public boolean isScreenOn()
返回当前屏幕是否点亮。

仅仅表示是否屏幕点亮,要不是全亮(bright)要不就是暗淡亮(dim)。

用法:

PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
 boolean isScreenOn = pm.isScreenOn();


3).public PowerManager.WakeLock newWakeLock(int flags, String tag)

使用指定的级别和标志创建新的唤醒锁

参数:

levelAndFlags : 指定一个使用“或”运算操作组合的唤醒锁级别和可选标志.

唤醒锁所有级别如下:

PARTIAL_WAKE_LOCK
FULL_WAKE_LOCK
SCREEN_DIM_LOCK
SCREEN_BRIGHT_WAKE_LOCK

这些唤醒锁级别中某个唤醒锁必须被明确地指定为 levelAndFlags参数的一部分。

唤醒锁标志如下:
ACQUIRE_CAUSES_WAKEUP
ON_AFTER_RELEASE

这些标志组合成为 levelAndFlags参数的一部分。

调用acquire()获取唤醒锁,当完成的时候调用release()释放唤醒锁。

用法:

PowerManager pm = (PowerManager)mContext.getSystemService(
                                          Context.POWER_SERVICE);
 PowerManager.WakeLock wl = pm.newWakeLock(
                                      PowerManager.SCREEN_DIM_WAKE_LOCK
                                      | PowerManager.ON_AFTER_RELEASE,
                                      TAG);
 wl.acquire(); 
 // ... do work...
 wl.release();

尽管在没有指定权限的条件下唤醒锁能够被创建,但是返回的唤醒锁在实际acquire和release时需要WAKE_LOCK( android.permission.WAKE_LOCK)权限。如果使用它去保持亮屏,强烈推荐考虑使用FLAG_KEEP_SCREEN 替代它,这个windows标志能够被平台正确管理,在应用中不需要特殊的权限。

4).public void reboot(String reason)

重启设备,如果重启成功不会返回。需要REBOOT( android.permission.REBOOT)权限。

参数:reason

传给Kernel请求指定boot 模式的码(例如:“recovery”)或 null。


5).public void userActivity(long when, boolean noChangeLights)


用户行为(user activity)发生通知电源管理。
当一个键或触摸屏被按下或者一些其他用户行为发生,如果设备没有进入睡眠模式,复位自动关机定时器点亮屏幕。 如果设备已进入睡眠模式,该方法不会唤醒设备。

需要DEVICE_POWER ( android.permission.DEVICE_POWER)权限。

参数:

when: 用户行为时间,以uptimeMillis()为时间基准,这个时间戳被用来和其他电源管理功能正确排序用户行为请求。应该设置用户行为输入事件的时间戳。

noChangeLights : 如果设置成true ,键盘背光不会因为该事件打开。当power键被按下的时候被置,我们想要这设备常亮而按键关掉,但是我们希望灭屏因此我们不想键盘背光再次打开,否则将会闪屏,看上去很奇怪。

6). public void wakeUp(long time)


使设备从睡眠中唤醒。如果设备当前处于睡眠中,唤醒它,否则不做任何事情。发生在电源键按下亮屏的时候。


需要DEVICE_POWER ( android.permission.DEVICE_POWER)权限。

参数:time

请求唤醒的时间,以uptimeMillis()为时间基准。该时间戳被用于和其他电源管理功能正确地排序唤醒请求。应该设置唤醒请求输入事件的时间戳



评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值