1.1K Star，一个完整的鸿蒙闹钟

Hi，骚年，我是大 G，公众号「 GitHub指北 」会推荐 GitHub 上有趣有用的项目，一分钟 get 一个优秀的开源项目，挖掘开源的价值，欢迎关注。

2024年将是鸿蒙关键的一年，也可能是移动开发者的春天来了，今天分享鸿蒙如何来实现闹钟的，会有完整的案例。

后台代理提醒简介

随着生活节奏的加快，我们有时会忘记一些重要的事情或日子，所以提醒功能必不可少。应用可能需要在指定的时刻，向用户发送一些业务提醒通知。例如购物类应用，希望在指定时间点提醒用户有优惠活动。为满足此类业务诉求，HarmonyOS提供后台代理提醒功能，在应用退居后台或退出后，计时和提醒通知功能被系统后台代理接管。

后台代理提醒业务类型：

后台代理提醒就是由系统后台进程代理应用的提醒功能。后台代理提醒服务通过reminderAgentManager模块提供 提醒定义、创建提醒、取消提醒 等能力。

后台代理提醒服务提供统一的提醒管理能力，在应用退居后台或退出后，计时和提醒通知功能被系统后台代理接管。

以新增一个9点的喝水提醒为例：

假设用户在8点新增这个喝水提醒，应用根据用户设置的信息生成提醒实例并发布提醒。由后台代理提醒服务调用系统服务启动计时。

到9点时，系统唤醒后台代理提醒服务发布通知，最终由通知服务触发桌面显示通知。

在整个流程中，应用仅需：

1. 使用reminderAgentManager模块的ReminderRequest类定义提醒实例；

2. 使用reminderAgentManager模块的publishReminder接口发布提醒。

无需关注计时和通知发布等功能如何实现。

若是删除提醒流程，需要使用reminderAgentManager模块的cancelReminder接口取消提醒；若是修改提醒流程，则需要先删除旧的提醒，再新增新的提醒。

给你的应用添加提醒

以闹钟应用为例，实现提醒功能有以下前置条件：

如果是 新增提醒 ，实现步骤如下：

1. 用reminderAgent.ReminderRequest类定义提醒实例。

   import reminderAgent from '@ohos.reminderAgentManager';
...
export class ReminderService {
public addReminder(alarmItem: ReminderItem, callback?: (reminderId: number) => void) {
let reminder = this.initReminder(alarmItem);
reminderAgent.publishReminder(reminder, (err, reminderId) => {
if (callback != null) {
callback(reminderId);
}
});
}
private initReminder(item: ReminderItem): reminderAgent.ReminderRequestAlarm {
return {
reminderType: item.remindType,
hour: item.hour,
minute: item.minute,
daysOfWeek: item.repeatDays,
title: item.name,
ringDuration: item.duration * Constants.DEFAULT_TOTAL_MINUTE,
snoozeTimes: item.intervalTimes,
timeInterval: item.intervalMinute,
actionButton: [
{
title: '关闭',
type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
},
...
],
wantAgent: {
pkgName: globalThis.bundleName,
abilityName: globalThis.abilityName
},
notificationId: item.notificationId,
...
}
}
...
}



2. 发布提醒。

   import reminderAgent from '@ohos.reminderAgentManager';
...
export class ReminderService {
public addReminder(alarmItem: ReminderItem, callback?: (reminderId: number) => void) {
let reminder = this.initReminder(alarmItem);
reminderAgent.publishReminder(reminder, (err, reminderId) => {
if (callback != null) {
callback(reminderId);
}
});
}
private initReminder(item: ReminderItem): reminderAgent.ReminderRequestAlarm {
...
}
...
}



如果需要 删除提醒 ，可以调用cancelReminder()接口实现。

import reminderAgent from '@ohos.reminderAgentManager';
...
export class ReminderService {
public deleteReminder(reminderId: number) {
reminderAgent.cancelReminder(reminderId);
}
...
}


如果需要 修改提醒 ，则需要先进行旧提醒的删除，再新增新的提醒。

public async setAlarmRemind(alarmItem: AlarmItem) {
let index = await this.findAlarmWithId(alarmItem.id);
if (index !== Constants.DEFAULT_NUMBER_NEGATIVE) {
this.reminderService.deleteReminder(alarmItem.id);
} else {
...
}
this.reminderService.addReminder(alarmItem, (newId) => {
alarmItem.id = newId;
...
})
}

案例：闹钟

介绍

本篇Codelab将介绍如何使用后台代理提醒，实现一个简易闹钟。要求完成以下功能：

1. 展示指针表盘或数字时间。

2. 添加、修改和删除闹钟。

3. 展示闹钟列表，并可打开和关闭单个闹钟。

4. 闹钟到设定的时间后弹出提醒。

5. 将闹钟的定时数据保存到轻量级数据库。

相关概念

相关权限

本篇Codelab需要在module.json5中配置如下权限：

"requestPermissions": [
{
"name": "ohos.permission.PUBLISH_AGENT_REMINDER",
"reason": "$string:reason",
"usedScene": {
"abilities": [
"EntryAbility"
],
"when": "inuse"
}
}
]


使用说明

1. 打开应用，添加一个闹钟，闹钟到设定的时间后弹出提醒。

2. 修改闹钟的时间，闹钟到设定的时间后弹出提醒。

3. 删除闹钟。

4. 展示闹钟列表，并可打开和关闭单个闹钟。

约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机。

2. 本示例为Stage模型，支持API version 9。

3. 本示例需要使用DevEco Studio 3.1 Release版本进行编译运行。

源码地址

1. 点击下方的公众号；

2. 在后台发消息「 闹钟 」即可获取。