Guida
Come usare Alarm in Capacitor
Utilizzo di @capgo/capacitor-alarm
Plugin Capacitor Alarm: l'interfaccia per gestire le sveglie native del sistema operativo.
Installa
bun add @capgo/capacitor-alarm
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapgoAlarm } from '@capgo/capacitor-alarm';
API in breve
| Metodo | Descrizione |
|---|---|
createAlarm |
Crea una sveglia nativa del sistema operativo usando l'app orologio della piattaforma. Su Android utilizza l'intent Alarm Clock; su iOS utilizza AlarmKit se disponibile (iOS 16+). |
openAlarms |
Apri l'interfaccia nativa dell'elenco sveglie della piattaforma, se disponibile. |
getOSInfo |
Ottieni informazioni sul sistema operativo e sulle sue funzionalità. |
requestPermissions |
Richiedi i permessi necessari per l'uso delle sveglie sulla piattaforma. Su Android, potrebbe reindirizzare alle impostazioni per le sveglie esatte. |
checkPermissions |
Verifica lo stato attuale dei permessi per l'accesso alle sveglie native senza attivare la UI. Su iOS riporta la disponibilità di AlarmKit; su Android riporta i dettagli sulle capacità. |
getAlarms |
Ottieni l'elenco delle sveglie programmate da questa app. Su iOS 26+, restituisce le sveglie di AlarmKit. Su Android non è supportato, poiché il sistema non fornisce un API per interrogare le sveglie. |
cancelAlarm |
Cancella una sveglia programmata tramite il suo ID. Su iOS 26+, rimuove la sveglia da AlarmKit. Su Android/web, restituisce non supportato. |
Esempi
createAlarm()
Crea una sveglia nativa del sistema operativo usando l'app orologio della piattaforma. Su Android utilizza l'intent Alarm Clock; su iOS 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()
Apri l'interfaccia nativa dell'elenco sveglie della piattaforma, se disponibile.
import { CapgoAlarm } from '@capgo/capacitor-alarm';
const result = await CapgoAlarm.openAlarms();
if (result.success) {
console.log('Alarms UI opened');
}
getOSInfo()
Ottieni informazioni sul sistema operativo e sulle sue funzionalità.
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()
Richiedi i permessi necessari per l'uso delle sveglie sulla piattaforma. Su Android, potrebbe reindirizzare alle impostazioni per le sveglie esatte.
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()
Verifica lo stato attuale dei permessi per l'accesso alle sveglie native senza attivare la UI. Su iOS riporta la disponibilità di AlarmKit; su Android riporta i dettagli sulle capacità.
import { CapgoAlarm } from '@capgo/capacitor-alarm';
const status = await CapgoAlarm.checkPermissions();
console.log('AlarmKit allowed?', status.details?.alarmKit);
getAlarms()
Ottieni l'elenco delle sveglie programmate da questa app. Su iOS 26+, restituisce le sveglie di AlarmKit. Su Android non è supportato, poiché il sistema non fornisce un API per interrogare le sveglie.
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 i 7 metodi core. Gli helper per listener e versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Riferimento completo
Continua da Using @capgo/capacitor-alarm
Se stai usando Utilizzo di @capgo/capacitor-alarm per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-alarm per i dettagli di implementazione in @capgo/capacitor-alarm, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.