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

Mantener despierto plugin Capacitor

Evita que la pantalla del dispositivo 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 el dispositivo

Descarga la app Capgo y escanea el QR code.

QR de vista previa del plugin Keep Awake code

Usando @capgo/capacitor-keep-awake

Plugin Capacitor Keep Awake para evitar que la pantalla del dispositivo se atenúe o entre en suspensión.

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 el dispositivo atenúe la pantalla.
allowSleep Permite que el dispositivo atenúe la pantalla (desactiva el keep awake).
isSupported Comprueba si la función keep awake es compatible con la plataforma actual.
isKeptAwake Comprueba si el dispositivo se mantiene despierto actualmente.

Ejemplos

keepAwake()

Evita que el dispositivo atenúe la pantalla.

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

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

allowSleep()

Permite que el dispositivo atenúe la pantalla (desactiva el 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 despierto actualmente.

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

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

Referencia completa

Continuar desde Usando @capgo/capacitor-keep-awake

Si estás usando Usando @capgo/capacitor-keep-awake para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con @capgo/capacitor-keep-awake para el detalle 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

Preguntas frecuentes 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") y luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android incorporen el código nativo code. 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 soporta @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 code está publicado en GitHub en https://github.com/Cap-go/capacitor-keep-awake/ y el paquete se puede instalar gratis desde npm. Se aceptan informes de errores y pull requests.

¿Puedo actualizar code que usa Keep Awake sin una 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 de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

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

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

Empieza con Capgo