Saltare al contenuto principale
@capgo/capacitor-allarme API dei dispositivi Open source

Allarme Plugin Capacitor

Installa gli allarmi nativi e le notifiche anche quando l'app è chiusa

Installa

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

Guida

Come utilizzare l'allarme in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansione il QR code.

Collegamento QR anteprima code allarme

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.

FAQ

FAQ del plugin Alarm

Come posso installare il plugin Alarm in un'app Capacitor?

Esegui "bun add @capgo/capacitor-alarm" (o "npm install @capgo/capacitor-alarm"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il code nativo. Importalo da "@capgo/capacitor-alarm" nella tua app code.

Funziona @capgo/capacitor-alarm con React, Vue e Angular?

Sì. Alarm è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-alarm?

I pacchetti Capgo seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-alarm?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-alarm/ e il pacchetto è gratuito da installare su npm. Sono accetti i rapporti di bug e le richieste di pull.

Posso aggiornare code che utilizza Alarm senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il code nativo, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con Capgo live updates.

Invia modifiche all'Alarm senza attendere la revisione dell'app

Una volta che il plugin è presente nella tua store build, Capgo aggiornamenti in tempo reale inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo