Android筆記:Wake Lock

import android.app.Service;
import android.content.Context;
import android.os.PowerManager;

/**
 * Wake Lock是一種鎖的機制, 只要有人拿著這個鎖,系統就無法進入休眠，
 * 可以被用戶態程序和內核獲得. 這個鎖可以是有超時的或者是沒有超時的,
 * 超時的鎖會在時間過去以后自動解鎖. 如果沒有鎖了或者超時了, 內核就
 * 會啟動休眠的那套機制來進入休眠.
 * 
 * 一、關于int flags 各種鎖的類型對CPU 、屏幕、鍵盤的影響： 
 * 1.PARTIAL_WAKE_LOCK:保持CPU運轉，屏幕和鍵盤燈有可能是關閉的。 
 * 2.SCREEN_DIM_WAKE_LOCK：保持CPU 運轉，允許保持屏幕顯示但有可能是灰的，允許關閉鍵盤燈
 * 3.SCREEN_BRIGHT_WAKE_LOCK：保持CPU 運轉，允許保持屏幕高亮顯示，允許關閉鍵盤燈 
 * 4.FULL_WAKE_LOCK：保持CPU運轉，保持屏幕高亮顯示，鍵盤燈也保持亮度 
 * 5.ACQUIRE_CAUSES_WAKEUP：Normal wake 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. 
 * 6.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.
 * 
 * 你能加兩個以上的標志，這些僅能影響屏幕的行為。這些標志當組合中有一個PARTIAL_WAKE_LOCK時將沒有效果。
 * 
 * 二、權限獲取 要進行電源的操作需要在AndroidManifest.xml中聲明該應用有設置電源管理的權限。 
 * <uses-permission android:name="android.permission.WAKE_LOCK" /> 
 * 你可能還需要 
 * <uses-permission android:name="android.permission.DEVICE_POWER" />
 * 
 * 三、WakeLock的設置是 Activiy 級別的，不是針對整個Application應用的。
 * 
 **/

abstract class WakeLockService extends Service
{
    private android.os.PowerManager.WakeLock mWakeLock;
    
    WakeLockService()
    {
    }
    
    /**
     * 獲取鎖，保持屏幕亮度。 Android中通過各種Lock鎖對電源進行控制，需要注意的是加鎖和解鎖必須成對出現。
     * 一般使用:這個函數在Activity的 onResume中被調用。releaseWakeLock()方法則是釋放該鎖,在Activity的onPause中被調用。
     */
    protected void acquireWakeLock()
    {
        if (mWakeLock == null)
        {
            //通過PowerManager的newWakeLock((int flags, String tag)方法來生成WakeLock實例。 
            //int Flags指示要獲取哪種WakeLock，不同的Lock對cpu、屏幕、鍵盤燈有不同影響。
            PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
            mWakeLock = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, getClass().getCanonicalName());
            mWakeLock.setReferenceCounted(false);
            mWakeLock.acquire();
        }
    }
    
    protected void acquireWakeLock(long timeout)
    {
        if (mWakeLock == null)
        {
            PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
            mWakeLock = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, getClass().getCanonicalName());
            mWakeLock.setReferenceCounted(false);
            mWakeLock.acquire(timeout);
        }
    }
    
    /**
     * 釋放鎖，顯示的釋放，如果申請的鎖不釋放系統就不會進入休眠。
     */
    protected void releaseWakeLock()
	{
		
		if(mWakeLock == null || !mWakeLock.isHeld())
		{
		    mWakeLock.release();
		    mWakeLock = null;
		}
	}
}