Android-WakeLock(唤醒锁与CPU休眠/屏幕常亮)

参考:
https://blog.csdn.net/wh_19910525/article/details/8287202
http://landerlyoung.github.io/blog/2014/10/31/androidzhong-de-wakelockshi-yong/

一.使用

PowerManager pm = (PowerManager) context.getSystemService(Context.POWER_SERVICE);
PowerManager.WakeLock wakeLock = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyTAG");
wakeLock.acquire();

在Manifest中添加如下权限
<uses-permission android:name="android.permission.WAKE_LOCK" />

WakeLock级别:
    PARTIAL_WAKE_LOCK       保持CPU运转,屏幕和键盘背光可能关闭
    SCREEN_DIM_WAKE_LOCK    保持CPU运转,保持屏幕常亮(亮度低),键盘背光可能关闭
    SCREEN_BRIGHT_WAKE_LOCK 保持CPU运转,保持屏幕和键盘背光高亮
    FULL_WAKE_LOCK          保持CPU运转,保持屏幕和键盘背光高亮(亮度最高)
    
    ACQUIRE_CAUSES_WAKEUP            强制亮屏,针对一些必须通知用户的操作
    ON_AFTER_RELEASE                 当锁被释放时,保持亮屏一段时间(如果释放时屏幕没亮,则不会亮屏)
    PROXIMITY_SCREEN_OFF_WAKE_LOCK   和接近传感器配合,当用户接近屏幕时黑屏,离开时亮屏(例如打电话),该API在API21后开放,以前被hide
    
    保持屏幕长亮的WakeLock被建议弃用,系统推荐如下方法(当Activity或view可见时,屏幕才保持常亮):
        在Activity.onCreate()中:  getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
        或在xml布局中: android:keepScreenOn="true"
        或对View设置:  view.setKeepScreenOn(true);
        
        FLAG_KEEP_SCREEN_ON实际就是一个SCREEN_BRIGHT_WAKE_LOCK级别的WakeLock
        创建和释放锁都由系统自动管理,更加方便和安全,在后面通过adb命令验证         
        
        屏幕相关的其它FLAG:
        WindowManager.LayoutParams.FLAG_DISMISS_KEYGUARD    解锁屏幕
        WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON      点亮屏幕
        WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED    屏幕锁定时也能显示
        WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON   屏幕打开时允许锁屏
        
        屏幕锁屏和解锁(需要权限"android.permission.DISABLE_KEYGUARD")
        KeyguardManager keyguardManager = (KeyguardManager) context.getSystemService(KEYGUARD_SERVICE);
        KeyguardManager.KeyguardLock keyguardLock = keyguardManager.newKeyguardLock("unLock");          
        keyguardLock.reenableKeyguard(); // 锁屏
        //keyguardLock.disableKeyguard();// 解锁          

!注意:
    如果申请partial wakelock,那么即使用户按Power键,系统也不会Sleep
    如果申请其它wakelocks,用户按Power键,系统还是会Sleep
    
PowerManager方法
    boolean isScreenOn()       判断屏幕是否亮着,在API20被弃用,推荐isInteractive()
    void goToSleep(long time)  强制休眠(系统APP权限"android.permission.DEVICE_POWER",按下电源键锁屏时调用该方法)
    void wakeUp(long time)     强制唤醒(权限同上,按下电源键时调用该方法)
    void reboot(String reason) 重启手机(系统APP权限"android.permission.REBOOT"),参数:"recovery","fastboot"
    
WakeLock方法:
    void acquire()              获得WakeLock,除非显式释放,否则不会解锁(经测试,APP进程被杀死后,锁会失效)
    void acquire(long timeOut)  当超过timeOut之后系统自动释放WakeLock
    void release()              释放WakeLock
    boolean isHeld()            是否已经获取WakeLock  
    void setReferenceCounted(boolean value) 是否使用引用计数(默认ture): 一个WakeLock调用acquire()多次,也必须release()多次才能释放,
    如果释放次数比acquire()多,则抛出异常: java.lang.RuntimeException: WakeLock under-locked MyTAG

二.原理

通过adb命令查看WakeLock锁的个数:
adb shell dumpsys power

Wake Locks: size=4
    mLock:346803 PARTIAL_WAKE_LOCK         'MyTAG' ACQ=-1s175ms (uid=10201 pid=3862)
    mLock:141928 SCREEN_DIM_WAKE_LOCK      'MyTAG' ACQ=-1s174ms (uid=10201 pid=3862)
    mLock:402427 SCREEN_BRIGHT_WAKE_LOCK   'MyTAG' ACQ=-1s173ms (uid=10201 pid=3862)
    mLock:124789 SCREEN_BRIGHT_WAKE_LOCK   'WindowManager' ON_AFTER_RELEASE ACQ=-1s70ms (uid=1000 pid=1196 ws=WorkSource{10201})
注:最后一个Lock是由FLAG_KEEP_SCREEN_ON创建的,由系统用户进程管理(uid=1000是系统用户)  
  
在创建了 PowerManager.WakeLock 后,有两种机制,第一种是不计数锁机制,另一种是计数锁机制。
可以通过 setReferenceCounted(boolean value) 来指定,一般默认为计数机制。
这两种机制的区别在于,前者无论 acquire() 了多少次,只要通过一次 release()即可解锁。
而后者正真解锁是在( --count == 0 )的时候,同样当 (count == 0) 的时候才会去申请加锁。
所以 PowerManager.WakeLock 的计数机制并不是正真意义上的对每次请求进行申请/释放每一把锁,
它只是对同一把锁被申请/释放的次数进行了统计,然后再去操作。

Wakelock框架的大致流程:
    1).应用层  /frameworks/base/core/java/android/os/PowerManager.java
    WakeLock.acquire() -> PowerManagerService.acquireWakeLock()
    
    2).frameworks层  /frameworks/base/services/java/com/android/server/PowerManagerService.java
    管理所有APP申请的wakelock,比如音视、频播放器、camera等        
    static final String PARTIAL_NAME ="PowerManagerService";
    public static native void nativeAcquireWakeLock(int lock, String id);       
    nativeAcquireWakeLock(PARTIAL_WAKE_LOCK_ID, PARTIAL_NAME);
    
    3).JNI层 /frameworks/base/core/jni/android_os_Power.cpp
    static void acquireWakeLock(JNIEnv *env, jobject clazz,  jint lock, jstring idObj){
        ...
        const char *id = env->GetStringUTFChars(idObj, NULL);
        acquire_wake_lock(lock, id);
        env->ReleaseStringUTFChars(idObj, id);
    }
 
    4).kernel层 /hardware/libhardware_legacy/power/power.c       
    int acquire_wake_lock(int lock, const char* id){
        ...
        return write(fd, id, strlen(id));
    }
    fd是文件描述符: "/sys/power/wake_lock"
    id是从frameworks层传来的参数: "PowerManagerService"  

简书: https://www.jianshu.com/p/2cfd179ef8dc
CSDN: https://blog.csdn.net/qq_32115439/article/details/80169222
GitHub博客: http://lioil.win/2018/05/02/Android-WakeLock.html
Coding博客: http://c.lioil.win/2018/05/02/Android-WakeLock.html

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 143,639评论 1 302
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 61,591评论 1 258
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 95,050评论 0 213
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 41,169评论 0 180
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 48,976评论 1 258
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 38,876评论 1 178
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 30,476评论 2 273
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,229评论 0 167
  • 想象着我的养父在大火中拼命挣扎,窒息,最后皮肤化为焦炭。我心中就已经是抑制不住地欢快,这就叫做以其人之道,还治其人...
    爱写小说的胖达阅读 29,095评论 6 234
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 32,579评论 0 213
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,356评论 2 215
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 30,698评论 1 232
  • 白月光回国,霸总把我这个替身辞退。还一脸阴沉的警告我。[不要出现在思思面前, 不然我有一百种方法让你生不如死。]我...
    爱写小说的胖达阅读 24,272评论 0 32
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,168评论 2 214
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 31,605评论 3 210
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,645评论 0 9
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,035评论 0 166
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 33,609评论 2 232
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 33,698评论 2 233

推荐阅读更多精彩内容