Cuando el usuario deja su dispositivo Android inactivo, este entra rápidamente en el estado de suspensión para evitar que se agote la batería. Sin embargo, hay ocasiones en las que una app necesita evitar que la CPU entre en el estado de suspensión. En algunos casos, es posible que la app necesite mantener la pantalla encendida mientras funciona. En otros casos, la app no necesita mantener la pantalla encendida, pero sí que la CPU esté activa.
El enfoque que elijas dependerá de las necesidades de tu app. Sin embargo, como regla general, te recomendamos que uses el enfoque más ligero posible para tu app a fin de minimizar su impacto en los recursos del sistema. En este documento, se te ayuda a elegir la tecnología de Android correcta para tu situación.
Elige la tecnología adecuada
La mejor opción para mantener el dispositivo activo depende de las necesidades de tu app. Esta sección te ayuda a elegir el enfoque correcto.
- ¿Tu app necesita mantener la pantalla encendida?
- Si la respuesta es Sí, consulta Mantén la pantalla encendida. Puede haber una API de propósito especial que haga lo que necesitas. Por ejemplo, si implementas una IU de llamada telefónica, puedes usar el framework de telecomunicaciones de Android, que mantiene la pantalla encendida cuando es necesario. Si no hay una API de propósito especial para tu situación, puedes usar la API de
keepScreenOn.
- Si la respuesta es Sí, consulta Mantén la pantalla encendida. Puede haber una API de propósito especial que haga lo que necesitas. Por ejemplo, si implementas una IU de llamada telefónica, puedes usar el framework de telecomunicaciones de Android, que mantiene la pantalla encendida cuando es necesario. Si no hay una API de propósito especial para tu situación, puedes usar la API de
- ¿Tu app ejecuta un servicio en primer plano y necesitas mantener el dispositivo despierto cuando la pantalla está apagada mientras se ejecuta el servicio?
- Si la respuesta es No, no es necesario que mantengas el dispositivo activo. Si el usuario interactúa de forma activa con la app, el dispositivo permanecerá activo. Si el usuario no interactúa con tu app y no estás ejecutando un servicio en primer plano, debes permitir que el dispositivo entre en modo suspendido cuando sea necesario. Si solo necesitas asegurarte de que se realice alguna tarea mientras el usuario no está en la app, consulta la documentación de tareas en segundo plano para encontrar la mejor opción.
- Si la respuesta es Sí, primero confirma que realmente necesitas usar un servicio en primer plano. Según tu situación, es posible que haya alguna API con un propósito especial que puedas usar para satisfacer tu necesidad en lugar de un servicio en primer plano.
Puedes encontrar información sobre estos en la documentación del servicio en primer plano. Por ejemplo, si necesitas hacer un seguimiento de la ubicación del usuario, es posible que puedas usar la API de Geofencing en lugar de un servicio en primer plano de
location.
- ¿Sería perjudicial para la experiencia del usuario que el dispositivo se suspenda mientras el servicio en primer plano se está ejecutando y la pantalla del dispositivo está apagada? (Por ejemplo, si usas un servicio en primer plano para actualizar notificaciones, no sería una mala experiencia del usuario si el dispositivo se suspendiera).
- Si la respuesta es No, no uses un bloqueo de activación. La acción se reanuda automáticamente una vez que el usuario interactúa con su dispositivo, lo que lo quita de la suspensión.
- Si la respuesta es Sí, es posible que debas usar un bloqueo de activación. Sin embargo, debes verificar si ya usas una API o realizas una acción que declara un bloqueo de activación en tu nombre, como se explica en Acciones que mantienen el dispositivo activo.
Acciones que mantienen el dispositivo activo
Si tu app realiza alguna de las siguientes acciones, no es necesario que configures un bloqueo de activación por tu cuenta. Las siguientes acciones y APIs mantienen el dispositivo activo.
- Si reproduces audio, el sistema de audio establece y administra un bloqueo de activación por ti, no es necesario que lo hagas por tu cuenta.
- Si usas APIs o bibliotecas de programación de tareas, como WorkManager,
JobScheduleroDownloadManager, el sistema o la biblioteca adquieren un bloqueo de activación que se atribuye a tu app. - Si usas Media3 ExoPlayer, puedes usar
ExoPlayer.setWakeMode()para que el reproductor establezca un bloqueo de activación. - Ciertos sensores del dispositivo son sensores de activación. Puedes usar
SensorManagerpara que esos sensores activen el dispositivo cuando tengan datos para informar. Para verificar si un sensor es un sensor de activación, llama aSensor.isWakeUpSensor.