学而实习之 不亦乐乎

Android 中 PowerManager 和 PowerManager.WakeLock 用法

2023-09-27 08:22:38

一、概述

Android 中有时候需要保持屏幕常亮,可以使用 PowerManager.WakeLock 来实现要求的功能。使用需要获取权限,如下:

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

其他可能需要的权限

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

注意:WakeLock 的设置是 Activiy 级别的,不是针对整个 Application 应用的。

二、实例

public class Wake_lockActivity extends Activity {

    private boolean iswakeLock = true;// 是否常亮
    private WakeLock wakeLock;

    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    }

    @Override
    protected void onResume() {
        // TODO Auto-generated method stub
        PowerManager pm = (PowerManager) getSystemService(POWER_SERVICE);
        wakeLock = pm.newWakeLock(PowerManager.SCREEN_BRIGHT_WAKE_LOCK
                | PowerManager.ON_AFTER_RELEASE, "DPA");

        if (iswakeLock) {
            wakeLock.acquire();
        }

        super.onResume();
    }

    @Override
    protected void onPause() {
        // TODO Auto-generated method stub
        super.onDestroy();
        if (wakeLock != null) {
            wakeLock.release();
        }
        android.os.Process.killProcess(android.os.Process.myPid());
    }
}

通常在 onRusume() 方法中将获得到的锁使用 acquire() 方法来保持唤醒,在 onPause() 方法中使用 release() 方法来释放掉该锁,利用 Activity 的生命周期来巧妙的使这两种方法成对的出现。

三、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()释放(释放是必须的)。

各 flags 对CPU 、屏幕、键盘的影响如下:

  • PARTIAL_WAKE_LOCK:保持CPU 运转,屏幕和键盘灯有可能是关闭的。
  • SCREEN_DIM_WAKE_LOCK:保持CPU 运转,允许保持屏幕显示但有可能是灰的,允许关闭键盘灯
  • SCREEN_BRIGHT_WAKE_LOCK:保持CPU 运转,允许保持屏幕高亮显示,允许关闭键盘灯
  • FULL_WAKE_LOCK:保持CPU 运转,保持屏幕高亮显示,键盘灯也保持亮度
  • ACQUIRE_CAUSES_WAKEUP:正常唤醒锁实际上并不打开照明。相反,一旦打开他们会一直仍然保持(例如来世user的activity)。当获得wakelock,这个标志会使屏幕或/和键盘立即打开。一个典型的使用就是可以立即看到那些对用户重要的通知。
  • ON_AFTER_RELEASE:设置了这个标志,当wakelock释放时用户activity计时器会被重置,导致照明持续一段时间。如果你在wacklock条件中循环,这个可以用来减少闪烁。