跳过主要内容
返回插件
@capgo/capacitor-alarm
教程
@capgo/capacitor-alarm

闹钟

即使应用程序关闭,仍可计划本地闹钟和通知

指南

Alarm 教程

在设备上测试

下载 Capgo 应用程序,然后扫描二维码 code。

闹钟插件预览二维码 code

使用 @capgo/capacitor-alarm

Capacitor 闹钟插件接口,用于管理本机操作系统闹钟。

安装

bun add @capgo/capacitor-alarm
bunx cap sync

此插件暴露的内容

  • createAlarm - 使用平台时钟应用创建本机操作系统闹钟。 在 Android 上,这使用闹钟意图;在 iOS 上,如果可用(iOS 16+),则使用 AlarmKit。
  • openAlarms - 打开平台的本机闹钟列表 UI,如果可用。
  • getOSInfo - 获取有关操作系统和功能的信息。
  • requestPermissions - 为闹钟使用在平台上请求相关权限。 在 Android 上,可能会将精确闹钟路由到设置中。

示例用途

createAlarm

使用平台时钟应用创建本机操作系统闹钟。 在 Android 上,这使用闹钟意图; 在 iOS 上,如果可用(iOS 16+),则使用 AlarmKit。

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

打开平台的本机闹钟列表 UI,如果可用。

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

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

getOSInfo

获取有关操作系统和功能的信息。

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

为闹钟使用在平台上请求相关权限。 在 Android 上,可能会将精确闹钟路由到设置。

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');
}

完整参考

继续使用 @capgo/capacitor-alarm

如果您正在使用 使用 @capgo/capacitor-alarm 为native插件工作做出计划,连接它 @capgo/capacitor-alarm @capgo/capacitor-alarm的实现细节 开始使用 开始使用的实现细节 @Capgo 插件目录 @Capgo 插件目录中的产品工作流 @Capacitor 由 @Capgo 提供的插件 @Capacitor 由 @Capgo 提供的插件的实现细节 添加或更新插件 添加或更新插件的实现细节