官方资料
http://developer.android.com/intl/zh-CN/reference/android/os/PowerManager.WakeLock.html
http://developer.android.com/intl/zh-CN/reference/android/os/PowerManager.html
示例
PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); PowerManager.WakeLock wl = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, "My Tag"); wl.acquire(); ..screen will stay on during this section.. wl.release();
Tips
Dim:逐渐变暗
Bright:保持亮度
类型
持锁后唤醒屏幕,其他的类型锁不会唤醒屏幕,而只是保持屏幕常亮,Dim 或 Bright。与PARTIAL_WAKE_LOCK互斥。
在Android4.2(API 17)后被废弃,建议采用 FLAG_KEEP_SCREEN_ON代替。
保持屏幕与键盘背光均为最大亮度,当Power键按下后,此锁会被系统释放。屏幕与CPU均关闭,与PARTIAL_WAKE_LOCK相反。
当此锁被释放时,将重置用户Activity计时器,能够让屏幕亮的更久些。但是当屏幕没有点亮时,不会唤醒屏幕,如果想这样,请使用ACQUIRE_CAUSES_WAKEUP。与PARTIAL_WAKE_LOCK互斥。
持有此锁会使CPU处于运行状态,而屏幕和键盘背光将可以熄灭。如果Power键按下,屏幕会关闭,而CPU会被保持,直到此锁被释放。
在Android3.2(API 13)后被废弃,使用 FLAG_KEEP_SCREEN_ON代替。
持锁将保持屏幕背光为最大亮度,而键盘背光可以熄灭。按下Power键后,此锁将会被系统自动释放,释放后屏幕与CPU均关闭。
在Android4.2(API 17)后被废弃,使用 FLAG_KEEP_SCREEN_ON代替。
持锁将保持屏幕背光常亮,但可以Dim,键盘背光可以熄灭。同样,在按下Power键后会被系统自动释放,CPU与屏幕均关闭。
使用方法
首先,使用PowerManager的newWakelock方法:
PowerManager.WakeLock newWakeLock(int levelAndFlags, String tag)
作用:新建一个名为tag的levelAndFlags类型的wakelock。
参数:
levelAndFlags:即为上边所介绍的类型;
tag:锁的名字,每个wakelock有唯一的名字。
例: PowerManager pm = (PowerManager)mContext.getSystemService( Context.POWER_SERVICE); PowerManager.WakeLock wl = pm.newWakeLock( PowerManager.SCREEN_DIM_WAKE_LOCK | PowerManager.ON_AFTER_RELEASE, TAG);
新建成功后,可以使用wakelock的API接口进行操作了。
接口操作
void acquire() 持锁;
void acquire(long timeout) 持锁,timeout毫秒后自动释放;
boolean isHeld() 返回锁的状态,true为正被持锁,false为被释放或未被持锁;
void release() 释放锁;
void setReferenceCounted(boolean value) 设置wakelock的计数机制,默认为计数。true为计数,false为不计数。
计数:每一个acquire必须对应一个release;
不计数:无论有多少个acquire,一个release就可以释放。
void setWorkSource(WorkSource ws) 设置工作域。可能有多个应用将会用到同一个wakelock,这个是用来确认这个wakelock是给哪个应用使用。如service;
String toString() 返回当前目标的一些描述。
关于FLAG_KEEP_SCREEN_ON
当前窗口在显示给用户的时候,屏幕会保持常亮,Bright。
用法:
Window w = activity.getWindow(); // in Activity's onCreate() for instance w.setFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON, WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON );