Utilizza @capgo/capacitor-allarme
Interfaccia del plugin Capacitor per la gestione degli allarmi nativi del sistema operativo.
Installa
bun add @capgo/capacitor-alarm
bunx cap sync
bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { CapgoAlarm } from '@capgo/capacitor-alarm';
Vedi API in un colpo d'occhio
| Metodo | Descrizione |
|---|---|
createAlarm |
Crea un allarme nativo del sistema utilizzando l'app orologio del sistema. Su Android utilizza l'intento dell'orologio; su iOS utilizza AlarmKit se disponibile (iOS 16+). |
openAlarms |
Apri la lista UI degli allarmi nativi del sistema, se disponibile. |
getOSInfo |
Ottieni informazioni sul sistema e sulle sue capacità. |
requestPermissions |
Richiedi le autorizzazioni rilevanti per l'utilizzo degli allarmi sul sistema. Su Android, potrebbe essere diretto ai parametri per gli allarmi esatti. |
checkPermissions |
Controlla lo stato delle autorizzazioni per l'accesso agli allarmi nativi senza attivare la UI. Su iOS, questo riferisce la prontezza di AlarmKit; su Android, riferisce i dettagli delle capacità. |
getAlarms |
Ottieni l'elenco degli allarmi programmato da questa app. Su iOS 26+, restituisce gli allarmi da AlarmKit. Su Android, questo non è supportato poiché il sistema non fornisce un API per interrogare gli allarmi. |
cancelAlarm |
Annulla un allarme programmato dal suo ID. Su iOS 26+, elimina l'allarme da AlarmKit. Su Android/web, restituisce non supportato. |
Esempi
createAlarm()
Creare un allarme nativo del sistema utilizzando l'app orologio del sistema. Su Android, questo utilizza l'intento dell'orologio dell'allarme; su iOS, questo utilizza AlarmKit se disponibile (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()
Apre la lista UI degli allarmi nativi del sistema, se disponibile.
import { CapgoAlarm } from '@capgo/capacitor-alarm';
const result = await CapgoAlarm.openAlarms();
if (result.success) {
console.log('Alarms UI opened');
}
getOSInfo()
Ottenere informazioni sul sistema e sulle sue capacità.
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()
Richiedere le autorizzazioni pertinenti per l'utilizzo degli allarmi sul sistema. Su Android, può essere diretto ai impostazioni per gli allarmi esatti.
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()
Controlla lo stato di autorizzazione corrente per l'accesso all'allarme nativo senza attivare l'interfaccia utente. Su iOS, questo riferisce la prontezza di AlarmKit; su Android, riferisce i dettagli della capacità.
import { CapgoAlarm } from '@capgo/capacitor-alarm';
const status = await CapgoAlarm.checkPermissions();
console.log('AlarmKit allowed?', status.details?.alarmKit);
getAlarms()
Ottenere l'elenco degli allarmi programmati da questa app. Su iOS 26+, restituisce gli allarmi da AlarmKit. Su Android, questo non è supportato poiché il sistema non fornisce un API per interrogare gli allarmi.
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 tabella sopra elenca le 7 metodi di base. Gli ascoltatori e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository GitHub.
Riferimento completo
Continua da Utilizzo di @capgo/capacitor-alarm
Se stai utilizzando Utilizzo di @capgo/capacitor-alarm Per pianificare il lavoro del plugin nativo, connettilo con @capgo/capacitor-allarme per i dettagli di implementazione in @capgo/capacitor-alarm, Getting Started per i dettagli di implementazione in Iniziare, Directory dei plugin Capgo per il workflow del prodotto nella Capgo Directory dei Plugin Plugin Capacitor di Capgo per il dettaglio di implementazione in Capacitor Plugin da Capgo, e Aggiungere o Aggiornare Plugin per il dettaglio di implementazione in Aggiungere o Aggiornare Plugin.