Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-alarm
Tutorial
von github.com/Cap-go

Alarm

Sende native Alarmanzeigen und -benachrichtigungen, auch wenn die App geschlossen ist

Richtlinie

Tutorial zu Alarm

Mit @capgo/capacitor-alarm verwenden

Capacitor-Alarm-Plugin-Schnittstelle für die Verwaltung von native OS-Alarms

Installieren

bun add @capgo/capacitor-alarm
bunx cap sync

Was diese Plugin- Schnittstelle enthüllt

  • createAlarm - Erstelle einen native OS-Alarm mithilfe der Plattform-Uhr-App. Bei Android wird die Alarm-Uhr-Intent verwendet; bei iOS wird AlarmKit verwendet, wenn verfügbar (iOS 16+).
  • openAlarms - Öffne die native Alarm-Liste-UI der Plattform, wenn verfügbar.
  • getOSInfo - Erhalte Informationen über die OS und die verfügbaren Funktionen.
  • requestPermissions - Die erforderlichen Berechtigungen für die Alarmnutzung auf der Plattform anfordern. Auf Android kann dies zu den Einstellungen für genaue Alarms führen.

Beispielverwendung

createAlarm

Erstellen Sie einen nativen OS-Alarm mithilfe der Plattform-Uhr-App. Auf Android wird der Alarm Clock-Intent verwendet; auf iOS wird AlarmKit verwendet, wenn 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

Öffnen Sie die native Alarmliste der Plattform, wenn verfügbar.

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

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

getOSInfo

Ermitteln Sie Informationen über die OS und die verfügbaren Funktionen.

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

Die erforderlichen Berechtigungen für die Alarmnutzung auf der Plattform anfordern. Auf Android kann dies zu den Einstellungen für genaue Alarms 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');
}

Vollständige Referenz