KeyguardManager和PowerManager

 

PowerManager.WakeLock

　　PowerManager.WakerLock是我分析Standup Timer源代码时发现的一个小知识点，Standup Timer 用WakeLock保证程序运行时保持手机屏幕的恒亮（程序虽小但也做得相当的细心，考虑的很周到）。PowerManager 和PowerManager.WakerLock7用于对Android设备的电源进行管理。

　　 PowerManager:This class gives you control of the power state of the device.

　　 PowerManager.WakeLock: lets you say that you need to have the device on.

　　Android中通过各种 Lock锁对电源进行控制，需要注意的是加锁和解锁必须成对出现。先上一段Standup Timer里的代码然后进行说明。

    
    

     
     <!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

    
    
    
    

     
     //保持屏幕一直亮着，不会锁屏，这个函数在Activity的 onResume中被调用。如果人为按power键，此时黑屏，如果再次按power，屏幕则锁，但还是会一直亮着。
-->
     
     private
     
      
     
     void
     
      acquireWakeLock() {
         
     
     if
     
      (wakeLock 
     
     ==
     
      
     
     null
     
     ) {
                Logger.d(
     
     "
     
     Acquiring wake lock
     
     "
     
     );
                PowerManager pm 
     
     =
     
      (PowerManager) getSystemService(Context.POWER_SERVICE);
                wakeLock 
     
     =
     
      pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, 
     
     this
     
     .getClass().getCanonicalName());
                wakeLock.acquire();
            }
        
    }


     
     //取消屏幕一直亮的锁，会锁屏，这个函数在Activity的 onPause中被调用。如果人为按power键，此时黑屏，如果再次按power，屏幕则锁，但到时会自动黑屏。

     
     private
     
      
     
     void
     
      releaseWakeLock() {
        
     
     if
     
      (wakeLock 
     
     !=
     
      
     
     null
     
      
     
     &&
     
      wakeLock.isHeld()) {
            wakeLock.release();
            wakeLock 
     
     =
     
      
     
     null
     
     ;
        }

    }
    
    

 

acquireWakeLock()方法中获取了 SCREEN_DIM_ WAKE_ LOCK锁，该锁使 CPU 保持运转，屏幕保持亮度（可以变灰）。这个函数在Activity的 onResume中被调用。releaseWakeLock()方法则是释放该锁。它在Activity的 onPause中被调用。利用Activiy的生命周期，巧妙的让 acquire()和release()成对出现。

   
   

    
    <!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->
    
        @Override
    
    
    protected
    
     
    
    void
    
     onResume()
    {
        
    
    super
    
    .onResume();
                
    
    //
    
    获取锁，保持屏幕亮度
    
    

    
            acquireWakeLock();
        startTimer();
    }
   
   

代码

    
    

     
     <!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->
     
     protected
     
      
     
     void
     
      onPause()
    {
        
     
     super
     
     .onPause();
         
     
     synchronized
     
     (
     
     this
     
     ) {
                cancelTimer();
                releaseWakeLock();

                
     
     if
     
      (finished) {
                    clearState();
                } 
     
     else
     
      {
                    saveState();
                }
            }
    }
    
    

 

PowerManager和WakeLock的操作步骤

1. 　　PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);通过 Context.getSystemService().方法获取PowerManager实例。
2. 　　然后通过PowerManager的newWakeLock((int flags, String tag)来生成WakeLock实例。int Flags指示要获取哪种WakeLock，不同的Lock对cpu 、屏幕、键盘灯有不同影响。
3. 　　获取WakeLock实例后通过acquire()获取相应的锁，然后进行其他业务逻辑的操作，最后使用release()释放（释放是必须的）。

关于int flags

　　各种锁的类型对CPU 、屏幕、键盘的影响：

PARTIAL_WAKE_LOCK:保持CPU 运转，屏幕和键盘灯有可能是关闭的。

SCREEN_DIM_WAKE_LOCK：保持CPU 运转，允许保持屏幕显示但有可能是灰的，允许关闭键盘灯

SCREEN_BRIGHT_WAKE_LOCK：保持CPU 运转，允许保持屏幕高亮显示，允许关闭键盘灯

FULL_WAKE_LOCK：保持CPU 运转，保持屏幕高亮显示，键盘灯也保持亮度

ACQUIRE_CAUSES_WAKEUP：Normalwake locks don't actually turn on the illumination. Instead, they cause the illumination to remain on once it turns on (e.g. from user activity). This flag will force the screen and/or keyboard to turn on immediately, when the WakeLock is acquired. A typical use would be for notifications which are important for the user to see immediately.

ON_AFTER_RELEASE：f this flag is set, the user activity timer will be reset when the WakeLock is released, causing the illumination to remain on a bit longer. This can be used to reduce flicker if you are cycling between wake lock conditions.

权限获取

要进行电源的操作需要在AndroidManifest.xml中声明该应用有设置电源管理的权限。

    
    

     
     <
     
     uses-permission 
     
     android:name
     
     ="android.permission.WAKE_LOCK"
     
      
     
     />
     
     
你可能还需要

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

另外WakeLock的设置是 Activiy 级别的，不是针对整个Application应用的。

 

不同的Lock对cpu 、屏幕、键盘灯有不同影响。加锁和解锁必须成对出现

获取WakeLock实例后通过acquire()获取相应的锁，然后进行其他业务逻辑的操作，最后使用release()释放（释放是必须的）。

PARTIAL_WAKE_LOCK:保持CPU 运转，屏幕和键盘灯有可能是关闭的。

SCREEN_DIM_WAKE_LOCK：保持CPU 运转，允许保持屏幕显示但有可能是灰的，允许关闭键盘灯

SCREEN_BRIGHT_WAKE_LOCK：保持CPU 运转，允许保持屏幕高亮显示，允许关闭键盘灯

FULL_WAKE_LOCK：保持CPU 运转，保持屏幕高亮显示，键盘灯也保持亮度

要进行电源的操作需要在AndroidManifest.xml中声明该应用有设置电源管理的权限。

<uses-permission android:name="android.permission.WAKE_LOCK" />
你可能还需要
<uses-permission android:name="android.permission.DEVICE_POWER" />

可以在activity的onResume方法里面操作WakeLock,  在onPause方法里面释放。

 

下面的代码用来设定键盘锁和解锁

//声明键盘管理器并获取键盘的服务

KeyguardManager keyguardManager =  (KeyguardManager)

getSystemService(Context.KEYGUARD_SERVICE);

//声明键盘锁并初始化键盘锁用于锁定或解开键盘锁
KeyguardLock keyguardLock = keyguardManager.newKeyguardLock("");

//禁用显示键盘锁定

keyguardLock.disableKeyguard();//解锁

keyguardLock. reenableKeyguard();//锁

 

使用这两段代码，需要在AndroidManifest文件中加入

//解锁权限
<uses-permission android:name="android.permission.DISABLE_KEYGUARD"></uses-permission>

亮屏权限

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

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

 

 

下面的代码可以用来点亮屏幕:

//声明电源管理器并获取电源的服务

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

//点亮屏幕

PowerManager.WakeLock  wl  =  pm.newWakeLock

(PowerManager.SCREEN_DIM_WAKE_LOCK|PowerManager.ACQUIRE_CAUSES_WAKEUP,"MyTag");

 wl.acquire();

   ..screen will stay on during this section..

 wl.release();