Saltar al contenido principal
@capgo/capacitor-keep-awake APIs de dispositivo Código abierto

Mantener activo plugin Capacitor

Evita que la pantalla se atenúe o se apague en reproductores de video, navegación y presentaciones

Instalar

bun add @capgo/capacitor-keep-awake bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-keep-awake
  • pnpm add @capgo/capacitor-keep-awake
  • yarn add @capgo/capacitor-keep-awake

Guía

Cómo usar Keep Awake en Capacitor

Probar en dispositivo

Descarga la app Capgo y escanea el QR code.

Vista previa QR del plugin Keep Awake code

Uso de @capgo/capacitor-keep-awake

Plugin Capacitor Keep Awake para evitar que la pantalla del dispositivo se atenúe o se apague.

Instalar

bun add @capgo/capacitor-keep-awake
bunx cap sync

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

import { KeepAwake } from '@capgo/capacitor-keep-awake';

API de un vistazo

Método Descripción
keepAwake Evita que la pantalla del dispositivo se atenúe.
allowSleep Permite que la pantalla se atenúe (desactivar keep awake).
isSupported Comprueba si la función keep awake es compatible con la plataforma actual.
isKeptAwake Comprueba si el dispositivo se mantiene encendido actualmente.

Ejemplos

keepAwake()

Evita que la pantalla del dispositivo se atenúe.

import { KeepAwake } from '@capgo/capacitor-keep-awake';

await KeepAwake.keepAwake();
console.log('Screen will stay awake');

allowSleep()

Permite que la pantalla se atenúe (desactivar keep awake).

import { KeepAwake } from '@capgo/capacitor-keep-awake';

await KeepAwake.allowSleep();
console.log('Screen can now dim');

isSupported()

Comprueba si la función keep awake es compatible con la plataforma actual.

import { KeepAwake } from '@capgo/capacitor-keep-awake';

const { isSupported } = await KeepAwake.isSupported();
if (isSupported) {
  console.log('Keep awake is supported');
}

isKeptAwake()

Comprueba si el dispositivo se mantiene encendido actualmente.

import { KeepAwake } from '@capgo/capacitor-keep-awake';

const { isKeptAwake } = await KeepAwake.isKeptAwake();
console.log('Is kept awake:', isKeptAwake);

Referencia completa

Sigue leyendo en Using @capgo/capacitor-keep-awake

Si estás usando Uso de @capgo/capacitor-keep-awake para planificar el comportamiento de los medios y la interfaz nativos, conéctalo con @capgo/capacitor-keep-awake para los detalles de implementación en @capgo/capacitor-keep-awake, Primeros pasos para los detalles de implementación en Primeros pasos, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-live-activities, y Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player.

FAQ

FAQ del plugin Keep Awake

¿Cómo instalo el plugin Keep Awake en una app de Capacitor?

Ejecuta "bun add @capgo/capacitor-keep-awake" (o "npm install @capgo/capacitor-keep-awake"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-keep-awake" en el code de tu app.

¿Funciona @capgo/capacitor-keep-awake con React, Vue y Angular?

Sí. Keep Awake es un paquete de Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-keep-awake?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-keep-awake gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-keep-awake/ y el paquete es gratuito para instalar desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Keep Awake sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios en JavaScript, HTML y CSS que llamen al plugin pueden publicarse al instante con las live updates de Capgo.

Lanza cambios de Keep Awake sin esperar la revisión de la app

Una vez que el plugin esté en tu build de la tienda, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo