开发指导

场景介绍

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

接口说明

reminderAgent：封装了发布、取消提醒类通知的方法

表1 reminderAgent主要接口

enum ActionButtonType: 在提醒弹出的通知界面上的按钮的类型。

表2 ActionButtonType 枚举类型

enum ReminderType: 提醒类型

表3 ReminderType 提醒类型枚举

interface ActionButton：在提醒弹出的通知界面上的按钮实例

表4 ActionButton

interface WantAgent: 设置点击通知后需要跳转的目标ability信息

表5 WantAgent

interface MaxScreenWantAgent: 设置提醒到达时跳转的目标包。如果设备正在使用中，则弹出一个通知框

表6 MaxScreenWantAgent

interface ReminderRequest: 需要发布的提醒实例的信息

表7 ReminderRequest

interface ReminderRequestCalendar extends ReminderRequest: 日历类提醒实例。

如果没有指定重复的月或天，那么第一次指定的目标时间必须大于当前时间，否则应用将异常退出。

表8 ReminderRequestCalendar

interface ReminderRequestAlarm extends ReminderRequest: 闹钟类提醒实例。

表9 ReminderRequestAlarm

interface ReminderRequestTimer extends ReminderRequest：倒计时提醒实例

表10 ReminderRequestTimer

interface LocalDateTime：时间信息实例

表11 LocalDateTime

开发步骤

说明： 应用需要配置权限：ohos.permission.PUBLISH_AGENT_REMINDER

发布一个10秒倒计时提醒

1. 定义一个倒计时实例

   import reminderAgent from '@ohos.reminderAgent';
   import notification from '@ohos.notification';
   export default {
      // JS工程写法：
      // timer: {
      // eTS工程写法：
      let timer : reminderAgent.ReminderRequestTimer = {
          reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER,
          triggerTimeInSeconds: 10,
          actionButton: [
              {
                  title: "close",
                  type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
              }
          ],
          wantAgent: {
              pkgName: "com.example.device",
              abilityName: "com.example.device.MainAbility"
          },
          maxScreenWantAgent: {
              pkgName: "com.example.device",
              abilityName: "com.example.device.MainAbility"
          },
          title: "this is title",
          content: "this is content",
          expiredContent: "this reminder has expired",
          notificationId: 100,
          slotType: notification.SlotType.SOCIAL_COMMUNICATION
      }
   }
   

2. 发布提醒

   startTimer() {
      reminderAgent.publishReminder(this.timer, (err, reminderId) =>{
          this.printInfo(JSON.stringify(err));
          this.printInfo("reminderId:" + reminderId);
      });
   }
   

HML页面：

   <div class="container">
       <button type="text" value="publishReminder" onclick="startTimer"></button>
   </div>

日历实例定义：

// JS工程写法：
// calendar: {
// eTS工程写法：
let calendar : reminderAgent.ReminderRequestCalendar = {
    reminderType: reminderAgent.ReminderType.REMINDER_TYPE_CALENDAR,
    dateTime: {
        year: 2050,
        month: 7,
        day: 30,
        hour: 11,
        minute: 14,
        second: 30
    },
    repeatMonths: [1],
    repeatDays: [1],
    actionButton: [
        {
            title: "close",
            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
        },
        {
            title: "snooze",
            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_SNOOZE
        },
    ],
    wantAgent: {
        pkgName: "com.example.device",
        abilityName: "com.example.device.MainAbility"
    },
    maxScreenWantAgent: {
        pkgName: "com.example.device",
        abilityName: "com.example.device.MainAbility"
    },
    ringDuration: 5,
    snoozeTimes: 2,
    timeInterval: 5,
    title: "this is title",
    content: "this is content",
    expiredContent: "this reminder has expired",
    snoozeContent: "remind later",
    notificationId: 100,
    slotType: notification.SlotType.SOCIAL_COMMUNICATION
}

闹钟实例定义：

// JS工程写法：
// alarm: {
// eTS工程写法：
let alarm : reminderAgent.ReminderRequestAlarm = {
    reminderType: reminderAgent.ReminderType.REMINDER_TYPE_ALARM,
    hour: 11,
    minute: 14,
    daysOfWeek: [0],
    actionButton: [
        {
            title: "close",
            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
        },
        {
            title: "snooze",
            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_SNOOZE
        },
    ],
    wantAgent: {
        pkgName: "com.example.device",
        abilityName: "com.example.device.MainAbility"
    },
    maxScreenWantAgent: {
        pkgName: "com.example.device",
        abilityName: "com.example.device.MainAbility"
    },
    ringDuration: 5,
    snoozeTimes: 2,
    timeInterval: 5,
    title: "this is title",
    content: "this is content",
    expiredContent: "this reminder has expired",
    snoozeContent: "remind later",
    notificationId: 100,
    slotType: notification.SlotType.SOCIAL_COMMUNICATION
}

相关实例

基于后台代理提醒开发，有以下相关实例可供参考：

• AlarmClock：后台代理提醒（eTS）（API8）

• FlipClock：翻页时钟（eTS）（API8）

• 闹钟应用（eTS）（API9）

你可能感兴趣的文章

开源鸿蒙 公共事件与通知

开源鸿蒙 调试助手使用指导

开源鸿蒙 概述

开源鸿蒙 公共事件开发指导

开源鸿蒙 公共事件与通知开发概述

开源鸿蒙 通知开发指导