HarmonyOS之后台代理定时提醒的功能使用

一、简介

• 在应用开发时，可以调用后台代理提醒类 ReminderRequest 去创建定时提醒，包括倒计时、日历、闹钟三种提醒类型。
• 使用后台代理提醒能力后，应用可以被冻结或退出，计时和弹出提醒的功能将被后台系统服务代理。

二、API 说明

• ReminderRequest 涉及的基础类包括 ReminderHelper、ReminderRequestTimer、ReminderRequestCalendar、ReminderRequestAlarm，基础类之间的关系如下图所示：

• ReminderHelper：封装了发布、取消提醒类通知的方法。ReminderHelper 主要接口：

• ReminderRequest：后台代理提醒类基类，封装了提醒相关的属性查询和设置的操作。ReminderRequest 主要接口：

• ReminderRequestTimer：提醒类子类，用于倒计时提醒。ReminderRequestTimer 主要接口：

• ReminderRequestCalendar：提醒类子类，用于日历类提醒。可以指定提醒时间精确为：年月日时分，可以指定哪些月份的哪些天的同一时间重复提醒。ReminderRequestCalendar 主要接口：

• ReminderRequestAlarm：提醒类子类，用于闹钟类提醒，可以指定几点几分提醒，或者每周哪几天指定时间提醒。ReminderRequestAlarm 主要接口：

三、后台代理定时提醒

• 声明使用权限：使用后台代理提醒需要在配置文件中声明需要此权限：

  "reqPermissions": [  {"name": "ohos.permission.PUBLISH_AGENT_REMINDER"  }]

  
 

  
1
 

• 创建一个提醒的步骤如下：

	// 1. 设置渠道信息
	NotificationSlot slot = new NotificationSlot("slot_id", "slot_name", NotificationSlot.LEVEL_HIGH);
	slot.setEnableLight(false);
	slot.setEnableVibration(true);
	// 2. 向代理服务添加渠道对象
	try {
	    ReminderHelper.addNotificationSlot(slot);
	} catch (RemoteException e) {
	    e.printStackTrace();
	}
	// 3. 创建提醒类通知对象
	int[] repeatDay = {};
	ReminderRequest reminder = new ReminderRequestAlarm(10, 30, repeatDay);
	// 4. 设置提醒内容
	reminder.setTitle("set title here").setContent("set content here");
	// 5. 设置提醒时长等属性
	reminder.setSnoozeTimes(1).setTimeInterval(5 * 60).setRingDuration(10);
	// 6. 设置IntentAgent, （假设包名为：com.ohos.aaa，Ability类名为FirstAbility）
	reminder.setIntentAgent("com.ohos.aaa", FirstAbility.class.getName());
	// 7. 设置提醒信息框中的“延迟提醒”和“关闭”按钮（可选）（ActionButton）
	reminder.setActionButton("snooze", ReminderRequest.ACTION_BUTTON_TYPE_SNOOZE).setActionButton("close", ReminderRequest.ACTION_BUTTON_TYPE_CLOSE);
	// 8. 发布提醒类通知
	try {
	    ReminderHelper.publishReminder(reminder);
	} catch (ReminderManager.AppLimitExceedsException e) {
	    e.printStackTrace();
	} catch (ReminderManager.SysLimitExceedsException e) {
	    e.printStackTrace();
	} catch (RemoteException e) {
	    e.printStackTrace();
	}

  
 

  
1
  
2
  
3
  
4
  
5
  
6
  
7
  
8
  
9
  
10
  
11
  
12
  
13
  
14
  
15
  
16
  
17
  
18
  
19
  
20
  
21
  
22
  
23
  
24
  
25
  
26
  
27
  
28
  
29
  
30
  
31
 

• 创建一个倒计时提醒示例如下：

	// 经过1分钟后提醒
	ReminderRequest reminderRequestTimer = new ReminderRequestTimer(60);

  
 

  
1
  
2
 

• 创建一个一次性日历提醒的示例如下：

	// 2021年3月2日14点30分提醒
	int[] repeatMonths = {};
	int[] repeatDays = {};
	ReminderRequestCalendar reminderRequestCalendar = new ReminderRequestCalendar( LocalDateTime.of(2021, 3, 2, 14, 30), repeatMonths, repeatDays);

  
 

  
1
  
2
  
3
  
4
 

• 创建一个重复的日历提醒的示例如下：

	// 3月份，5月份的9号和15号 14点30分提醒，延迟10分钟后再次提醒，默认延迟次数为3次
	
	int[] repeatMonths = {3, 5};
	int[] repeatDaysOfMonth = {9, 15};
	ReminderRequestCalendar reminderRequestCalender = new ReminderRequestCalendar( LocalDateTime.of(2021, 3, 2, 14, 30), repeatMonths, repeatDaysOfMonth);
	reminderRequestCalender.setTimeInterval(10 * 60);

  
 

  
1
  
2
  
3
  
4
  
5
  
6
 

• 创建一个一次性闹钟提醒的示例如下：

	// 13点59分提醒，如果当前时间大于13点59分，则取后一天的13点59分
	int[] repeatDay = {};
	ReminderRequest reminderRequestAlarm = new ReminderRequestAlarm(13, 59, repeatDay);

  
 

  
1
  
2
  
3
 

• 创建一个重复的闹钟提醒的示例如下：

	// 每周1，2，3，4的13点59分提醒
	int[] repeatDay = {1, 2, 3, 4};
	ReminderRequest reminderRequestAlarm = new ReminderRequestAlarm(13, 59, repeatDay);

  
 

  
1
  
2
  
3
 

• 创建一个用于延迟提醒的 ActionButton 界面的示例如下：

	reminderRequest.setActionButton("snooze", ReminderRequest.ACTION_BUTTON_TYPE_SNOOZE);

  
 

  
1
 

• 创建一个用于关闭提醒的 ActionButton 界面的示例如下：

	reminderRequest.setActionButton("close", ReminderRequest.ACTION_BUTTON_TYPE_CLOSE);

  
 

  
1
 

• 注意：
• • notificationId 相同的不同 NotificationRequest 请求，在通知栏展示的内容会被覆盖，对于提醒来说，可能不希望被覆盖，开发时可以注意设置不同的 notificationId；
• • 倒计时不支持持久化，系统重启后，所有倒计时失效。

文章来源: blog.csdn.net，作者：Serendipity·y，版权归原作者所有，如需转载，请联系作者。

原文链接：blog.csdn.net/Forever_wj/article/details/119187359