Alarmas plugin de Capacitor

Usando @capgo/capacitor-alarm

Interface del plugin de Alarmas Capacitor para gestionar alarmas nativas del sistema.

Instalar

bun add @capgo/capacitor-alarm
bunx cap sync

bunx cap sync Copia el código nativo del plugin code en tus proyectos nativos. Correlo nuevamente después de cada actualización del plugin.

Importar

import { CapgoAlarm } from '@capgo/capacitor-alarm';

Vista general de API

Ejemplos

createAlarm()

Crear un alarma nativa del sistema utilizando la aplicación de reloj del sistema. En Android, utiliza la intención de la Alarma; en iOS, utiliza AlarmKit si está disponible (iOS 16+).

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const result = await CapgoAlarm.createAlarm({
  hour: 7,
  minute: 30,
  label: 'Wake up',
  skipUi: false,
  vibrate: true
});
console.log('Alarm created:', result.success);

openAlarms()

Abrir la lista de alarmas nativas del sistema, si está disponible.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const result = await CapgoAlarm.openAlarms();
if (result.success) {
  console.log('Alarms UI opened');
}

getOSInfo()

Obtener información sobre el sistema y sus capacidades.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const info = await CapgoAlarm.getOSInfo();
console.log('Platform:', info.platform);
console.log('Supports native alarms:', info.supportsNativeAlarms);
if (info.platform === 'android') {
  console.log('Can schedule exact alarms:', info.canScheduleExactAlarms);
}

requestPermissions()

Solicite permisos relevantes para el uso de la alarma en la plataforma. En Android, puede redirigir a ajustes para alarmas exactas.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const result = await CapgoAlarm.requestPermissions({ exactAlarm: true });
if (result.granted) {
  console.log('Permissions granted');
} else {
  console.log('Permissions denied');
}

checkPermissions()

Verifique el estado de permiso actual para acceso a alarmas nativas sin desencadenar la interfaz de usuario. En iOS, informa sobre la disponibilidad de AlarmKit; en Android, proporciona detalles de capacidad.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const status = await CapgoAlarm.checkPermissions();
console.log('AlarmKit allowed?', status.details?.alarmKit);

getAlarms()

Obtenga una lista de alarmas programadas por esta aplicación. En iOS 26+, devuelve alarmas de AlarmKit. En Android, esto no está soportado ya que el sistema no proporciona un API para consultar alarmas.

import { CapgoAlarm } from '@capgo/capacitor-alarm';

const { alarms } = await CapgoAlarm.getAlarms();
console.log('Scheduled alarms:', alarms);
alarms.forEach(alarm => {
  console.log(`Alarm ${alarm.id}: ${alarm.hour}:${alarm.minute} - ${alarm.label}`);
});

La tabla anterior enumera los 7 métodos básicos. Los ayudantes de escucha y versión, y el contrato completo de cada método, se documentan en el repositorio GitHub.

Referencia completa

• repositorio GitHub
• Documentación
• API referencia

Sigue adelante desde Usando @capgo/capacitor-alarma

Si está utilizando Usando @capgo/capacitor-alarma para planificar el trabajo de plugin nativo, conecte con @capgo/capacitor-alarma para los detalles de implementación en @capgo/capacitor-alarma, Getting Started para los detalles de implementación en Inicio, Directorio de Plugins de Capgo para el flujo de trabajo del producto en el directorio de plugins Capgo Plugins de Capacitor por Capgo para los detalles de implementación en Plugins de Capacitor por Capgo, y Agregar o Actualizar Plugins para los detalles de implementación en Agregar o Actualizar Plugins.