Выберите правильный API, чтобы устройство оставалось в активном состоянии
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Когда пользователь оставляет свое устройство под управлением Android бездействующим, оно быстро переходит в состояние ожидания, чтобы избежать разрядки аккумулятора. Однако бывают случаи, когда приложению необходимо предотвратить переход процессора в состояние ожидания. В некоторых случаях приложению может потребоваться оставить экран включенным во время работы. В других случаях приложению не нужно держать экран включенным, но процессор все равно должен быть активным.
Выбор подхода зависит от потребностей вашего приложения. Однако общее правило заключается в том, что вам следует использовать максимально упрощенный подход, чтобы минимизировать влияние вашего приложения на системные ресурсы. Этот документ поможет вам выбрать правильную технологию Android для вашей ситуации.
Выбирайте правильную технологию
Лучший вариант сохранения режима сна вашего устройства зависит от потребностей вашего приложения. Этот раздел поможет вам выбрать правильный подход.
Нужно ли вашему приложению держать экран включенным?
Если да , см. раздел Не отключать экран . Может существовать специальный API, который делает то, что вам нужно; например, если вы реализуете пользовательский интерфейс для телефонных звонков, вы можете использовать телекоммуникационную платформу Android , которая сохраняет экран включенным, когда это необходимо. Если для вашей ситуации нет специального API-интерфейса, вы можете использовать API keepScreenOn .
В вашем приложении работает служба переднего плана, и вам нужно, чтобы устройство не спало, когда экран выключен, пока служба работает?
Если «Нет» , вам не нужно держать устройство в активном режиме. Если пользователь активно взаимодействует с приложением, устройство не будет спать. Если пользователь не взаимодействует с вашим приложением и вы не запускаете службу приоритетного плана, при необходимости следует перевести устройство в режим ожидания. Если вам просто нужно убедиться, что какая-то работа выполняется, пока пользователь находится вне приложения, см. документацию по фоновым задачам , чтобы найти лучший вариант.
Если да , сначала подтвердите, что вам действительно нужно использовать службу приоритетного плана. В зависимости от вашей ситуации может существовать какой-то специальный API, который вы можете использовать для удовлетворения своих потребностей вместо службы переднего плана. Информацию об этом можно найти в документации Foreground Service . Например, если вам нужно отслеживать местоположение пользователя, вы можете использовать API геозон вместо службы переднего плана определения location .
Будет ли это вредно для работы пользователя, если устройство приостанавливается во время работы службы переднего плана и экран устройства выключен? (Например, если вы используете службу переднего плана для обновления уведомлений, приостановка работы устройства не будет плохой работой пользователя.)
Если Нет , не используйте Wakelock. Действие возобновляется автоматически, как только пользователь взаимодействует со своим устройством, что выводит его из режима ожидания.
Если ваше приложение выполняет любое из следующих действий, вам не нужно самостоятельно устанавливать блокировку пробуждения. Следующие действия и API не дают устройству спать.
Если вы воспроизводите аудио, аудиосистема устанавливает и управляет блокировкой пробуждения за вас; вам не нужно делать это самостоятельно.
Если вы используете API или библиотеки планирования задач, такие как WorkManager , JobScheduler или DownloadManager , система или библиотека получает блокировку пробуждения, приписываемую вашему приложению.
Некоторые датчики устройства являются датчиками пробуждения; вы можете использовать SensorManager , чтобы эти датчики выводили устройство из спящего режима, когда у них есть данные для отчета. Чтобы проверить, является ли датчик датчиком пробуждения, вызовите Sensor.isWakeUpSensor .
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[null,null,["Последнее обновление: 2025-07-29 UTC."],[],[],null,["# Choose the right API to keep the device awake\n\nWhen the user leaves their Android-powered device idle, it quickly goes into the\nsuspend state to avoid draining the battery. However, there are times when an\napp needs to prevent the CPU from going to the suspend state. In some cases, the\napp may need to keep the screen on while it's working. In other cases, the app\ndoesn't need to keep the screen on but still needs the CPU to be active.\n\nThe approach you take depends on the needs of your app. However, a general rule\nis that you should use the most lightweight approach possible, to minimize your\napp's impact on system resources. This document helps you choose the correct\nAndroid technology for your situation.\n| **Note:** You may be familiar with **wake locks**. An app can set a wake lock to keep the device from suspending. However, using a wake lock can quickly drain the device battery. You should only use a wake lock if there's no other option that will do what you need. If you do use a wake lock, you should release it as soon as possible.\n\nChoose the right technology\n---------------------------\n\nThe best option for keeping your device awake depends on your app's needs. This\nsection helps you choose the right approach.\n\n- Does your app need to keep the screen on?\n - If **Yes** , see [Keep the screen on](/develop/background-work/background-tasks/awake/screen-on). There may be a special-purpose API that does what you need; for example, if you're implementing a phone-call UI, you can use the [Android telecom\n framework](/reference/android/telecom/package-summary), which keeps the screen on when needed. If there's no special purpose API for your situation, you can use the `keepScreenOn` API.\n- Is your app running a foreground service, and you need to keep the device awake when screen is off while the service is running?\n - If **No** , you do not need to keep the device awake. If the user is actively interacting with the app, the device will stay awake. If the user is not interacting with your app and you are not running a foreground service, you should let the device go into suspend mode when necessary. If you just need to make sure some work gets done while the user is away from the app, see the [background tasks](/develop/background-work/background-tasks) documentation to find the best option.\n - If **Yes** , first confirm that you actually need to use a foreground service. Depending on your situation, there may be some special-purpose API you can use to accomplish your need instead of a foreground service. You can find information about these [in the Foreground Service\n documentation](/develop/background-work/services/fgs/service-types). For example, if you need to track the user's location, you might be able to use the [geofencing API](/develop/sensors-and-location/location/geofencing) instead of a `location` foreground service.\n- Would it be detrimental to the user experience if the device suspends while the foreground service is running and the device screen is off? (For example, if you're using a foreground service to update notifications, it wouldn't be a bad user experience if the device is suspended.)\n - If **No**, do not use a wakelock. The action resumes automatically once the user engages with their device, which takes it out of suspend.\n - If **Yes** , you might need to [use a wake lock](/develop/background-work/background-tasks/awake/wakelock). However, you should still check to see if you're already using an API or doing an action that declares a wake lock on your behalf, as discussed in [Actions that keep the device awake](#actions-keep).\n\nActions that keep the device awake\n----------------------------------\n\nIf your app is doing any of the following, you don't need to set a wake lock\nyourself. The following actions and APIs all keep the device awake for you.\n\n- If you're playing audio, the audio system sets and manages a wake lock for you; you don't need to do it yourself.\n- If you're using task scheduling APIs or libraries such as [WorkManager](/develop/background-work/background-tasks/persistent), [`JobScheduler`](/reference/android/app/job/JobScheduler), or [`DownloadManager`](/reference/android/app/DownloadManager), the system or library acquires a wake lock that is attributed to your app.\n- If you're using [Media3 ExoPlayer](/media/media3/exoplayer), you can use [`ExoPlayer.setWakeMode()`](/reference/androidx/media3/exoplayer/ExoPlayer#setWakeMode(int)) to have the player set a wake lock for you.\n- Certain device sensors are wake-up sensors; you can use [`SensorManager`](/reference/android/hardware/SensorManager) to have those sensors wake up the device when they have data to report. To check if a sensor is a wake-up sensor, call [`Sensor.isWakeUpSensor`](/reference/android/hardware/Sensor#isWakeUpSensor())).\n\nSee also\n--------\n\n- [Use wake locks](/develop/background-work/background-tasks/awake/wakelock)\n- [Keep the screen on](/develop/background-work/background-tasks/awake/screen-on)"]]
