鸿蒙开发接口公共事件与通知：【@ohos.reminderAgent (后台代理提醒)】

jf_46214456 2024-05-25 718

电子说

1.3w人已加入

描述

后台代理提醒

本模块提供后台代理提醒的能力。

开发应用时，开发者可以调用后台提醒发布的接口创建定时提醒，包括倒计时、日历、闹钟三种提醒类型。使用后台代理提醒能力后，应用可以被冻结或退出，计时和弹出提醒的功能将被后台系统服务代理。
说明： 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import reminderAgent from'@ohos.reminderAgent';

开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]点击或者复制转到。

reminderAgent.publishReminder

publishReminder(reminderReq: ReminderRequest, callback: AsyncCallback): void

发布一个后台代理提醒，使用callback方式实现异步调用。

需要权限 ： ohos.permission.PUBLISH_AGENT_REMINDER

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
reminderReq[ReminderRequest]是需要发布的提醒实例。
callbackAsyncCallback是异步回调，返回当前发布的提醒的reminderId。

示例 ：

let timer = {
      reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER,
      triggerTimeInSeconds: 10
  }
  reminderAgent.publishReminder(timer, (err, reminderId) = > {
      console.log("callback, reminderId = " + reminderId);
  });

reminderAgent.publishReminder

publishReminder(reminderReq: ReminderRequest): Promise

发布一个后台代理提醒，使用Promise方式实现异步调用。

需要权限 ： ohos.permission.PUBLISH_AGENT_REMINDER

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
reminderReq[ReminderRequest]是需要发布的提醒实例。

返回值 ：

类型说明
Promise返回提醒的reminderId。

示例 ：

let timer = {
      reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER,
      triggerTimeInSeconds: 10
  }
  reminderAgent.publishReminder(timer).then((reminderId) = > {
      console.log("promise, reminderId = " + reminderId);
  });

reminderAgent.cancelReminder

cancelReminder(reminderId: number, callback: AsyncCallback): void

取消指定id的提醒，使用callback方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
reminderIdnumber是目标reminder的id号。
callbackAsyncCallback是异步回调。

示例 ：

reminderAgent.cancelReminder(1, (err, data) = > {
    console.log("cancelReminder callback");
});

reminderAgent.cancelReminder

cancelReminder(reminderId: number): Promise

取消指定id的提醒，使用Promise方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
reminderIdnumber是目标reminder的id号。

返回值 ：

类型说明
PromisePromise类型异步回调。

示例 ：

reminderAgent.cancelReminder(1).then(() = > {
    console.log("cancelReminder promise");
});

reminderAgent.getValidReminders

getValidReminders(callback: AsyncCallback>): void

获取当前应用已设置的所有有效（未过期）的提醒，使用callback方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
callbackAsyncCallback>是异步回调，返回当前应用已设置的所有有效（未过期）的提醒。

示例 ：

reminderAgent.getValidReminders((err, reminders) = > {
    console.log("callback, getValidReminders length = " + reminders.length);
    for (let i = 0; i < reminders.length; i++) {
        console.log("getValidReminders = " + reminders[i]);
        console.log("getValidReminders, reminderType = " + reminders[i].reminderType);
        for (let j = 0; j < reminders[i].actionButton.length; j++) {
            console.log("getValidReminders, actionButton.title = " + reminders[i].actionButton[j].title);
            console.log("getValidReminders, actionButton.type = " + reminders[i].actionButton[j].type);
        }
        console.log("getValidReminders, wantAgent.pkgName = " + reminders[i].wantAgent.pkgName);
        console.log("getValidReminders, wantAgent.abilityName = " + reminders[i].wantAgent.abilityName);
        console.log("getValidReminders, maxScreenWantAgent.pkgName = " + reminders[i].maxScreenWantAgent.pkgName);
        console.log("getValidReminders, maxScreenWantAgent.abilityName = " + reminders[i].maxScreenWantAgent.abilityName);
        console.log("getValidReminders, ringDuration = " + reminders[i].ringDuration);
        console.log("getValidReminders, snoozeTimes = " + reminders[i].snoozeTimes);
        console.log("getValidReminders, timeInterval = " + reminders[i].timeInterval);
        console.log("getValidReminders, title = " + reminders[i].title);
        console.log("getValidReminders, content = " + reminders[i].content);
        console.log("getValidReminders, expiredContent = " + reminders[i].expiredContent);
        console.log("getValidReminders, snoozeContent = " + reminders[i].snoozeContent);
        console.log("getValidReminders, notificationId = " + reminders[i].notificationId);
        console.log("getValidReminders, slotType = " + reminders[i].slotType);
    }
})

reminderAgent.getValidReminders

getValidReminders(): Promise>

获取当前应用已设置的所有有效（未过期）的提醒，使用Promise方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

返回值 ：

类型说明
Promise>返回当前应用已设置的所有有效（未过期）的提醒。

示例 ：

reminderAgent.getValidReminders().then((reminders) = > {
    console.log("promise, getValidReminders length = " + reminders.length);
    for (let i = 0; i < reminders.length; i++) {
        console.log("getValidReminders = " + reminders[i]);
        console.log("getValidReminders, reminderType = " + reminders[i].reminderType);
        for (let j = 0; j < reminders[i].actionButton.length; j++) {
            console.log("getValidReminders, actionButton.title = " + reminders[i].actionButton[j].title);
            console.log("getValidReminders, actionButton.type = " + reminders[i].actionButton[j].type);
        }
        console.log("getValidReminders, wantAgent.pkgName = " + reminders[i].wantAgent.pkgName);
        console.log("getValidReminders, wantAgent.abilityName = " + reminders[i].wantAgent.abilityName);
        console.log("getValidReminders, maxScreenWantAgent.pkgName = " + reminders[i].maxScreenWantAgent.pkgName);
        console.log("getValidReminders, maxScreenWantAgent.abilityName = " + reminders[i].maxScreenWantAgent.abilityName);
        console.log("getValidReminders, ringDuration = " + reminders[i].ringDuration);
        console.log("getValidReminders, snoozeTimes = " + reminders[i].snoozeTimes);
        console.log("getValidReminders, timeInterval = " + reminders[i].timeInterval);
        console.log("getValidReminders, title = " + reminders[i].title);
        console.log("getValidReminders, content = " + reminders[i].content);
        console.log("getValidReminders, expiredContent = " + reminders[i].expiredContent);
        console.log("getValidReminders, snoozeContent = " + reminders[i].snoozeContent);
        console.log("getValidReminders, notificationId = " + reminders[i].notificationId);
        console.log("getValidReminders, slotType = " + reminders[i].slotType);
    }
})

reminderAgent.cancelAllReminders

cancelAllReminders(callback: AsyncCallback): void

取消当前应用所有的提醒，使用callback方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
callbackAsyncCallback是异步回调。

示例 ：

reminderAgent.cancelAllReminders((err, data) = >{
    console.log("cancelAllReminders callback")
})

reminderAgent.cancelAllReminders

cancelAllReminders(): Promise

取消当前应用所有的提醒，使用Promise方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

返回值 ：

类型说明
PromisePromise类型异步回调。

示例 ：

reminderAgent.cancelAllReminders().then(() = > {
    console.log("cancelAllReminders promise")
})

reminderAgent.addNotificationSlot

addNotificationSlot(slot: NotificationSlot, callback: AsyncCallback): void

添加一个NotificationSlot，使用callback方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
slot[NotificationSlot]是notification slot实例，仅支持设置其type属性。
callbackAsyncCallback是异步回调。

示例 ：

import notification from '@ohos.notification'

let mySlot = {
    type: notification.SlotType.SOCIAL_COMMUNICATION
}
reminderAgent.addNotificationSlot(mySlot, (err, data) = > {
    console.log("addNotificationSlot callback");
});

reminderAgent.addNotificationSlot

addNotificationSlot(slot: NotificationSlot): Promise

添加一个NotificationSlot，使用Promise方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
slot[NotificationSlot]是notification slot实例，仅支持设置其type属性。

返回值 ：

类型说明
PromisePromise类型异步回调。

示例 ：

import notification from '@ohos.notification'

let mySlot = {
    type: notification.SlotType.SOCIAL_COMMUNICATION
}
reminderAgent.addNotificationSlot(mySlot).then(() = > {
   console.log("addNotificationSlot promise");
});

reminderAgent.removeNotificationSlot

removeNotificationSlot(slotType: notification.SlotType, callback: AsyncCallback): void

删除目标NotificationSlot，使用callback方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
slotType[notification.SlotType]是目标notification slot的类型。
callbackAsyncCallback是异步回调。

示例 ：

import notification from '@ohos.notification'

reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION, (err, data) = > {
    console.log("removeNotificationSlot callback");
});

reminderAgent.removeNotificationSlot

removeNotificationSlot(slotType: notification.SlotType): Promise

删除目标NotificationSlot，使用Promise方式实现异步调用。

系统能力 ： SystemCapability.Notification.ReminderAgent

参数 ：

参数名类型必填说明
slotType[notification.SlotType]是目标notification slot的类型。

返回值 ：

类型说明
PromisePromise类型异步回调。

示例 ：

import notification from '@ohos.notification'

reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION).then(() = > {
    console.log("removeNotificationSlot promise");
});

ActionButtonType

按钮的类型。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称默认值说明
ACTION_BUTTON_TYPE_CLOSE0表示关闭提醒的按钮。
ACTION_BUTTON_TYPE_SNOOZE1表示延迟提醒的按钮。

ReminderType

提醒的类型。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称默认值说明
REMINDER_TYPE_TIMER0表示提醒类型：倒计时。
REMINDER_TYPE_CALENDAR1表示提醒类型：日历。
REMINDER_TYPE_ALARM2表示提醒类型：闹钟。

ActionButton

用于设置弹出的提醒通知信息上显示的按钮类型和标题。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称参数类型必填说明
titlestring是按钮显示的标题。
type[ActionButtonType]是按钮的类型。

WantAgent

点击提醒通知后跳转的目标ability信息。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称参数类型必填说明
pkgNamestring是指明点击提醒通知栏后跳转的目标hap包名。
abilityNamestring是指明点击提醒通知栏后跳转的目标ability名称。

MaxScreenWantAgent

提醒到达时自动拉起的目标ability信息。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称参数类型必填说明
pkgNamestring是指明提醒到达时自动拉起的目标hap包名（如果设备在使用中，则只弹出通知横幅框）。
abilityNamestring是指明提醒到达时自动拉起的目标ability名（如果设备在使用中，则只弹出通知横幅框）。

ReminderRequest

提醒实例对象，用于设置提醒类型、响铃时长等具体信息。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称参数类型必填说明
reminderTypeReminderType是指明提醒类型。
actionButton[ActionButton?, ActionButton?]否弹出的提醒通知栏中显示的按钮（参数可选，支持0/1/2个按钮）。
wantAgentWantAgent否点击通知后需要跳转的目标ability信息。
maxScreenWantAgentMaxScreenWantAgent否提醒到达时跳转的目标包。如果设备正在使用中，则弹出一个通知框。
ringDurationnumber否指明响铃时长。
snoozeTimesnumber否指明延迟提醒次数。
timeIntervalnumber否执行延迟提醒间隔。
titlestring否指明提醒标题。
contentstring否指明提醒内容。
expiredContentstring否指明提醒过期后需要显示的内容。
snoozeContentstring否指明延迟提醒时需要显示的内容。
notificationIdnumber否指明提醒使用的通知的id号，相同id号的提醒会覆盖。
slotType[notification.SlotType]否指明提醒的slot类型。

ReminderRequestCalendar

ReminderRequestCalendar extends ReminderRequest

日历实例对象，用于设置提醒的时间。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称参数类型必填说明
dateTime[LocalDateTime]是指明提醒的目标时间。
repeatMonthsArray否指明重复提醒的月份。
repeatDaysArray否指明重复提醒的日期。

ReminderRequestAlarm

ReminderRequestAlarm extends ReminderRequest

闹钟实例对象，用于设置提醒的时间。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称参数类型必填说明
hournumber是指明提醒的目标时刻。
minutenumber是指明提醒的目标分钟。
daysOfWeekArray否指明每周哪几天需要重复提醒。

ReminderRequestTimer

ReminderRequestTimer extends ReminderRequest

倒计时实例对象，用于设置提醒的时间。

系统能力 ：SystemCapability.Notification.ReminderAgent

名称参数类型必填说明HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿
triggerTimeInSecondsnumber是指明倒计时的秒数。

HarmonyOS

LocalDateTime

用于日历类提醒设置时指定时间信息。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent

名称参数类型必填说明
yearnumber是年
monthnumber是月
daynumber是日
hournumber是时
minutenumber是分
secondnumber否秒
打开APP阅读更多精彩内容
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

下载APP
|投诉反馈|电子发烧友网
© 2021 elecfans.com
湘ICP备2023018690号
×
20
完善资料，
赚取积分