鸿蒙(HarmonyOS)应用开发——后台代理提醒

layman05282023-12-15 17:42

简述

在日常使用手机的过程，我们经常使用闹钟、日历提醒。在harmonyOS 提供后台代理提醒功能。在应用退出后，提醒功能被系统后台代理接管。

类型

类型倒计时日历闹钟

倒计时类：基于倒计时的提醒功能，适用于短时的计时提醒业务。
日历类：基于日历的提醒功能，适用于较长时间的提醒业务。
闹钟类：基于时钟的提醒功能，适用于指定时刻的提醒业务

实现

harmonyOS提供了reminderAgentManager模块提供提醒定义、创建提醒、取消提醒等能力。

添加权限

在开发前，需要在module5.json中添加权限

javascript 复制代码

"module": {
  "requestPermissions": [
    {
     "name": "ohos.permission.PUBLISH_AGENT_REMINDER"
    }
  ]
}

导入模块

javascript 复制代码

import reminderAgent from '@ohos.reminderAgentManager';

新增

javascript 复制代码

public addReminder(alarmItem: ReminderItem, callback?: (reminderId: number) => void) {
    let reminder = this.initReminder(alarmItem);
    reminderAgent.publishReminder(reminder, (err, reminderId) => {
      if (callback != null) {
        callback(reminderId);
      }
    });
  }

删除

javascript 复制代码

public deleteReminder(reminderId: number) {
    reminderAgent.cancelReminder(reminderId);
  }