android 管理设备唤醒状态

记录官方文档的，以官方的为主！
当 Android 设备空闲时，它会首先调暗屏幕，然后关闭屏幕，最终关闭 CPU。这可以防止设备的电池电量快速耗尽。不过，有时您的应用可能需要采取不同的行为：

• 游戏或电影应用等应用可能需要使屏幕保持开启状态。
• 其他应用可能不需要屏幕始终处于开启状态，但可能需要 CPU 持续运行，直到某项关键操作完成。
  以下课程介绍了如何在必要时使设备保持唤醒状态，而不大量消耗电池电量

为避免消耗电池电量，处于空闲状态的 Android 设备会快速进入休眠模式。不过，有时应用需要唤醒屏幕或 CPU 并使之保持唤醒状态，以完成某项工作。

所采用的方法取决于应用的需求。但是，一般而言，您应该为应用使用尽可能轻量的方法，以便最大限度减少应用对系统资源的影响。以下几个部分介绍了如何处理设备的默认休眠行为不符合应用要求的情况
使用唤醒锁定的替代方案
在为您的应用添加唤醒锁定支持之前，请考虑应用用例是否支持以下某种替代解决方案：

• 如果您的应用正在执行长时间运行的 HTTP 下载，请考虑使用DownloadManager。
• 如果您的应用同步来自外部服务器的数据，请考虑创建同步适配器。
• 如果您的应用依赖后台服务，请考虑使用 JobScheduler 或 Firebase 云消息传递，以便以特定的时间间隔触发这些服务。
  使屏幕保持开启状态
  某些应用需要使屏幕保持开启状态，例如游戏或电影应用。要实现此目标，最好的方法是在您的 Activity 中（仅在 Activity 中，切勿在服务或其他应用组件中）使用 FLAG_KEEP_SCREEN_ON

class MainActivity:Activity(){
 override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContentView(R.layout.activity_main)
            window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)

}

第二种实现方式
在布局文件中使用属性

android:keepScreenOn="true"

示例

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:keepScreenOn="true">
        ...
    </RelativeLayout>

优缺点：
xml文件中直接布局文件就可以使用，缺点是不能使用编程方式消除印记，关闭屏幕。
编程方式优点 可以在activity中直接使用编程方式消除印记，关闭屏幕，缺点是 相对于xml布局文件代码稍微长了一点点？ 其实都差不多 看个人选择

使 CPU 保持运行状态
如果您需要使 CPU 保持运行状态，以便在设备进入休眠模式之前完成某项工作，可以使用一项称为“唤醒锁定”的 PowerManager 系统服务功能。唤醒锁定可使应用控制主机设备的电源状态。

创建和持有唤醒锁定会对主机设备的电池续航时间产生重大影响。因此，您应仅在绝对必要时使用唤醒锁定，并持有尽可能短的时间。例如，您绝不需要在 Activity 中使用唤醒锁定。如上所述，如果您希望屏幕在 Activity 中保持开启状态，请使用 FLAG_KEEP_SCREEN_ON。

使用唤醒锁定的一种合理情形是，某项后台服务需要获取唤醒锁定，以便 CPU 在屏幕关闭时保持运行状态，可以完成相关工作。再次声明，由于这种做法会影响电池续航时间，因此应尽量减少其使用频率。

如需使用唤醒锁定，首先要将 WAKE_LOCK 权限添加到应用的清单文件中

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

如果您的应用包含使用服务来完成相关工作的广播接收器，您可以根据使用可使设备保持唤醒状态的广播接收器部分所述，通过 WakefulBroadcastReceiver 管理唤醒锁定。这是首选方法。如果您的应用未采用该模式，您可以使用以下方法直接设置唤醒锁定：

    val wakeLock: PowerManager.WakeLock =
            (getSystemService(Context.POWER_SERVICE) as PowerManager).run {
                newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyApp::MyWakelockTag").apply {
                    acquire()
                }
            }
    

要释放唤醒锁定，请调用 wakelock.release()。这会释放您对 CPU 的声明。请务必在应用结束对唤醒锁定的使用后立即将其释放，以避免消耗电池电量。
使用可使设备保持唤醒状态的广播接收器

通过将广播接收器与服务结合使用，您可以管理后台任务的生命周期。

WakefulBroadcastReceiver 是一种特殊类型的广播接收器，负责为您的应用创建和管理 PARTIAL_WAKE_LOCK。WakefulBroadcastReceiver 将工作看作是 Service（通常为 IntentService），同时确保设备不会在转换期间重新进入休眠模式。如果您未在将工作转换为服务的过程中保持唤醒锁定，那么您实际上允许设备在完成工作之前重新进入休眠模式。最终结果是，应用可能直到未来的某个时间点才能完成工作，而这并不是您所希望的。

与其他任何广播接收器一样，使用 WakefulBroadcastReceiver 的第一步是将其添加到清单中：

<receiver android:name=".MyWakefulReceiver"></receiver>

以下代码使用方法 startWakefulService() 方法启动 MyIntentService。该方法与 startService() 大致相同，区别在于 WakefulBroadcastReceiver 会在服务启动时保持唤醒锁定。通过 startWakefulService() 传递的 intent 包含标识唤醒锁定的其他信息：

    class MyWakefulReceiver : WakefulBroadcastReceiver() {

        override fun onReceive(context: Context, intent: Intent) {

            //启动服务，在服务启动时保持设备清醒
			//启动。这是启动服务的意图是什么
            Intent(context, MyIntentService::class.java).also { service ->
                WakefulBroadcastReceiver.startWakefulService(context, service)
            }
        }
    }
    

当服务完成时，会调用 MyWakefulReceiver.completeWakefulIntent() 以释放唤醒锁定。completeWakefulIntent() 方法与其参数具有从 WakefulBroadcastReceiver 传入的同一 intent：

    const val NOTIFICATION_ID = 1

    class MyIntentService : IntentService("MyIntentService") {

        private val notificationManager: NotificationManager? = null
        internal var builder: NotificationCompat.Builder? = null

        override fun onHandleIntent(intent: Intent) {
            val extras: Bundle = intent.extras
            // 做需要你的应用程序保持CPU运行的工作。
            // ...
            //释放WakefulBroadcastReceiver提供的唤醒锁。
            MyWakefulReceiver.completeWakefulIntent(intent)
        }
    }
    

转载自android官方文档