Android 电源管理PowerManager

jopen 12年前

PowerManager这个类提供了电源管理的一些功能,比如可以让屏幕或者键盘亮起来等。还有对设备的重启的api

官网是这么解释的

PowerManager Class Overview


这个类提供了控制设备电源状态的管理功能。

设备的电池的持续时间(寿命)会受到使用这个API的重要影响。在非必要的情况下不要使用WakeLock,即使必须使用,也要最低限度使用这个api,使用完之后应确保立即释放掉。

通过 Context.getSystemService()获得PowerManager的实例。

使用PowerManager的实例去获得一个WakeLock对象,使用这个方法:newWakeLock() 创建一个PowerManager.WakeLock 对象.使用WakeLock对象可以去管理设备电源的状态,使用方法特别简单:如下例子

PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);  PowerManager.WakeLock wl = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, "My Tag");  wl.acquire();  //在释放之前,屏幕一直亮着(有可能会变暗,但是还可以看到屏幕内容)  wl.release();  

下面定义的这些标记不同程度的影响系统电源。这些标记都是独占的,并且每次只能指定其中一个。

Flag Value CPU Screen Keyboard
PARTIAL_WAKE_LOCK On* Off(关闭) Off(关闭)
SCREEN_DIM_WAKE_LOCK On Dim(变暗) Off(关闭)
SCREEN_BRIGHT_WAKE_LOCK On Bright(高亮) Off(关闭)
FULL_WAKE_LOCK On Bright(高亮) Bright(高亮)

如果你使用的是局部唤醒锁的话(使用PARTIAL_WAKE_LOCK标志),CPU会继续运行,将忽略任何的计时器,甚至按下电源按钮。其他的唤醒锁话,CPU也会继续运转,但是使用者仍然可以按电源按钮让设备睡眠。

另外,你可以使用两个以上的标记,但是他只影响屏幕的行为。和 PARTIAL_WAKE_LOCK 同时使用的话,没有任何影响。

Flag Value Description
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.正常情况下是不会是屏幕等变亮,相反,当获得wakeLock之后需要一个触发事件才会使屏幕或者键盘变亮。典型应用是一个对用户来说比较重要的通知时,使用这个锁。
ON_AFTER_RELEASE If 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.帮忙翻译一下吧
最后啰嗦一句,这个电源管理是activity级别的。

 


一个小例子

package com.example.powers;    import android.os.Bundle;  import android.os.PowerManager;  import android.os.PowerManager.WakeLock;  import android.app.Activity;  import android.content.Context;  import android.util.Log;  import android.view.Menu;  import android.view.MenuItem;  import android.support.v4.app.NavUtils;    public class MainActivity extends Activity {     private WakeLock wakeLock;     @Override   public void onCreate(Bundle savedInstanceState) {    super.onCreate(savedInstanceState);    setContentView(R.layout.activity_main);     }     @Override   protected void onResume() {    super.onResume();    // 开始获得唤醒锁    acquireWakeLock();   }     @Override   public void finish() {    super.finish();    // 释放锁    releaseWakeLock();   }     private void acquireWakeLock() {    if (wakeLock == null) {     Log.d("debug", "Acquiring wake lock");     PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);     wakeLock = pm.newWakeLock(PowerManager.SCREEN_DIM_WAKE_LOCK, this       .getClass().getCanonicalName());     wakeLock.acquire();    }     }     private void releaseWakeLock() {    if (wakeLock != null && wakeLock.isHeld()) {     wakeLock.release();     wakeLock = null;    }     }     @Override   public boolean onCreateOptionsMenu(Menu menu) {    getMenuInflater().inflate(R.menu.activity_main, menu);    return true;   }    }