Anleitung
So nutzt man Alarm in Capacitor
Verwendung von @capgo/capacitor-alarm
Capacitor Alarm Plugin zur Verwaltung nativer OS-Alarme.
Installieren
bun add @capgo/capacitor-alarm
bunx cap sync
bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.
Importieren
import { CapgoAlarm } from '@capgo/capacitor-alarm';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
createAlarm |
Erstelle einen nativen OS-Alarm über die Uhr-App der Plattform. Auf Android wird der Alarm Clock Intent genutzt; auf iOS wird AlarmKit verwendet (iOS 16+). |
openAlarms |
Öffne die native Alarm-Liste der Plattform, sofern verfügbar. |
getOSInfo |
Rufe Informationen über das OS und dessen Funktionen ab. |
requestPermissions |
Fordere die erforderlichen Berechtigungen für die Alarm-Nutzung an. Auf Android kann dies zu den Einstellungen für exakte Alarme führen. |
checkPermissions |
Prüfe den aktuellen Berechtigungsstatus für den nativen Alarm-Zugriff, ohne ein UI zu triggern. Auf iOS wird die AlarmKit-Bereitschaft gemeldet; auf Android die Kapazitätsdetails. |
getAlarms |
Rufe eine Liste der von dieser App geplanten Alarme ab. Auf iOS 26+ werden Alarme aus AlarmKit zurückgegeben. Auf Android wird dies nicht unterstützt, da das System kein API zur Abfrage bereitstellt. |
cancelAlarm |
Storniere einen geplanten Alarm über seine ID. Auf iOS 26+ wird der Alarm aus AlarmKit entfernt. Auf Android/Web wird dies nicht unterstützt. |
Beispiele
createAlarm()
Erstelle einen nativen OS-Alarm über die Uhr-App der Plattform. Auf Android wird der Alarm Clock Intent genutzt; auf iOS wird AlarmKit verwendet, sofern verfügbar (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()
Öffne die native Alarm-Liste der Plattform, falls verfügbar.
import { CapgoAlarm } from '@capgo/capacitor-alarm';
const result = await CapgoAlarm.openAlarms();
if (result.success) {
console.log('Alarms UI opened');
}
getOSInfo()
Rufe Informationen über das OS und dessen Funktionen ab.
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()
Fordere die erforderlichen Berechtigungen für die Alarm-Nutzung an. Auf Android kann dies zur Einstellung für exakte Alarme führen.
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()
Prüfe den aktuellen Berechtigungsstatus für den nativen Alarm-Zugriff, ohne ein UI zu triggern. Auf iOS wird die AlarmKit-Bereitschaft gemeldet; auf Android die Details zur Funktionalität.
import { CapgoAlarm } from '@capgo/capacitor-alarm';
const status = await CapgoAlarm.checkPermissions();
console.log('AlarmKit allowed?', status.details?.alarmKit);
getAlarms()
Rufe eine Liste der von dieser App geplanten Alarme ab. Auf iOS 26+ werden Alarme aus AlarmKit zurückgegeben. Auf Android wird dies nicht unterstützt, da das System keinen API zur Abfrage von Alarmen bereitstellt.
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}`);
});
Die obige Tabelle listet die 7 Kernmethoden auf. Listener, Version-Helper und der vollständige Contract jeder Methode sind in der GitHub Repository.
Vollständige Referenz
Weiterlesen unter Verwendung von @capgo/capacitor-alarm
Wenn du es nutzt Verwendung von @capgo/capacitor-alarm Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-alarm für die Implementierungsdetails in @capgo/capacitor-alarm, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.