android的PowerManager和PowerManager.WakeLock

前言　　學習android一段時間了，為了進一步瞭解android的應用是如何設計開發的，決定詳細研究幾個開源的android應用。從一些開源應用中吸收點東西，一邊進行量的積累，一邊探索android的學習研究方向。這裡我首先選擇了jwood的 Standup Timer 項目。本文將把研究的內容筆記整理，建立一個索引列表。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裡的代碼然後進行說明。代碼

privatevoid 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();
}

}

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

}

 

acquireWakeLock()方法中擷取了 SCREEN_DIM_WAKE_LOCK鎖，該鎖使 CPU 保持運轉，螢幕保持亮度（可以變灰）。這個函數在Activity的 onResume中被調用。releaseWakeLock()方法則是釋放該鎖。它在Activity的 onPause中被調用。利用Activiy的生命週期，巧妙的讓 acquire()和release()成對出現。

@Override
protectedvoid onResume()
{
super.onResume();
//擷取鎖，保持螢幕亮度
acquireWakeLock();
startTimer();
}代碼

protectedvoid 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：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.

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應用的。
系列索引　　
Android 開源項目-StandupTimer學習筆記索引