Android PowerManager功能接口详解

news2025/4/16 1:00:29

PowerManager 是 Android 系统中用于管理设备电源状态的核心服务，开发者可以通过它控制设备的唤醒、休眠、屏幕亮灭等行为。以下是对 PowerManager 核心功能接口的详细说明，包含使用场景、注意事项和代码示例。

1. 获取 PowerManager 实例

通过 Context 获取系统服务

PowerManager powerManager = (PowerManager) context.getSystemService(Context.POWER_SERVICE);

2. 唤醒锁（WakeLock）‌

‌作用‌：阻止设备进入休眠状态（如屏幕关闭或 CPU 休眠）。

‌2.1 创建 WakeLock‌

通过 newWakeLock() 方法创建：

PowerManager.WakeLock wakeLock = powerManager.newWakeLock(
        PowerManager.PARTIAL_WAKE_LOCK, "MyApp::MyWakeLockTag");

2.2 WakeLock 类型

PARTIAL_WAKE_LOCK‌
保持 CPU 运行，屏幕和键盘背光可能关闭。
‌场景‌：后台音乐播放、网络长连接。
‌注意‌：Android 6.0 (API 23) 及以上，需在代码中动态请求权限（android.permission.WAKE_LOCK）。
‌SCREEN_DIM_WAKE_LOCK‌（已废弃，API 17+）
保持屏幕亮起但可能变暗，CPU 运行。
‌FULL_WAKE_LOCK‌（已废弃，API 17+）
保持屏幕高亮，CPU 运行。
‌ACQUIRE_CAUSES_WAKEUP‌
立即唤醒设备（如用于通知亮屏）。
‌ON_AFTER_RELEASE‌
释放 WakeLock 后，保持屏幕亮起一段时间。

‌2.3 使用 WakeLock

wakeLock.acquire();  // 获取 WakeLock
wakeLock.release();  // 释放 WakeLock（必须成对调用）

注意事项‌：

避免长期持有 WakeLock，防止耗电。
在 onPause() 或 onDestroy() 中确保释放。
Android 9+ 限制后台应用获取 WakeLock，需结合前台服务使用。

3. 屏幕状态控制

3.1 判断屏幕是否亮起

boolean isScreenOn = powerManager.isInteractive();

3.2 强制唤醒屏幕（API 20+）

// 需要权限：android.permission.WAKE_LOCK
if (powerManager.isInteractive()) {
    return; // 屏幕已亮
}
PowerManager.WakeLock screenWakeLock = powerManager.newWakeLock(
        PowerManager.FULL_WAKE_LOCK | PowerManager.ACQUIRE_CAUSES_WAKEUP,
        "MyApp::ScreenWakeLock");
screenWakeLock.acquire(500); // 自动在 500ms 后释放

‌4. 省电模式适配

‌4.1 判断省电模式是否开启

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    boolean isPowerSaveMode = powerManager.isPowerSaveMode();
}

‌4.2 监听省电模式变化

IntentFilter filter = new IntentFilter(PowerManager.ACTION_POWER_SAVE_MODE_CHANGED);
context.registerReceiver(new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        boolean isPowerSaveMode = powerManager.isPowerSaveMode();
        // 更新应用逻辑
    }
}, filter);

‌5. 设备休眠控制‌

‌5.1 用户活动检测‌

触发用户活动以推迟休眠：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    powerManager.userActivity(SystemClock.uptimeMillis(), 
            PowerManager.USER_ACTIVITY_EVENT_OTHER);
}

‌5.2 强制设备进入休眠（仅系统应用）

需要系统签名权限：

powerManager.goToSleep(SystemClock.uptimeMillis());

6. 低电耗模式（Doze）和白名单‌

‌Doze 模式‌：Android 6.0+ 在设备静止时限制网络和 CPU。
‌白名单‌：允许应用在 Doze 模式下执行任务。

‌6.1 判断是否在白名单中

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    boolean isIgnoringBatteryOptimizations = powerManager.isIgnoringBatteryOptimizations(
            context.getPackageName());
}

‌6.2 请求加入白名单

引导用户手动开启：

Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
intent.setData(Uri.parse("package:" + context.getPackageName()));
context.startActivity(intent);