From 6922d80efc0efd25ac01b5a59ba034ae6f06eca1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BB=96=E5=BA=B7=E5=BA=B7?= Date: Mon, 17 Oct 2022 20:08:44 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E9=86=92=E4=BB=A3=E7=90=86=E9=94=99?= =?UTF-8?q?=E8=AF=AF=E7=A0=81=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 廖康康 --- .../reference/apis/Readme-CN.md | 3 +- .../reference/apis/js-apis-reminderAgent.md | 115 ++++-------------- .../apis/js-apis-reminderAgentManager.md | 49 ++++---- .../errcode-reminderAgentManager.md | 54 ++++++-- ...ckground-agent-scheduled-reminder-guide.md | 2 +- 5 files changed, 95 insertions(+), 128 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md index ab65cc28da..f45486b6b3 100755 --- a/zh-cn/application-dev/reference/apis/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis/Readme-CN.md @@ -63,7 +63,6 @@ - [@ohos.commonEvent (公共事件模块)](js-apis-commonEvent.md) - [@ohos.events.emitter (Emitter)](js-apis-emitter.md) - [@ohos.notification (Notification模块)](js-apis-notification.md) - - [@ohos.reminderAgent (后台代理提醒)](js-apis-reminderAgent.md) - application/[EventHub (EventHub)](js-apis-eventhub.md) - 应用程序包管理 - [@ohos.bundle (Bundle模块)](js-apis-Bundle.md) @@ -119,6 +118,7 @@ - 资源调度 - [@ohos.backgroundTaskManager (后台任务管理)](js-apis-backgroundTaskManager.md) - [@ohos.distributedMissionManager (分布式任务管理)](js-apis-distributedMissionManager.md) + - [@ohos.reminderAgentManager (后台代理提醒)](js-apis-reminderAgentManager.md) - [@ohos.workScheduler (延迟任务调度)](js-apis-workScheduler.md) - [@ohos.WorkSchedulerExtensionAbility (延迟任务调度回调)](js-apis-WorkSchedulerExtensionAbility.md) - 定制管理 @@ -284,6 +284,7 @@ - [@system.notification (通知消息)](js-apis-system-notification.md) - [@system.package (应用管理)](js-apis-system-package.md) - [@system.prompt (弹窗)](js-apis-system-prompt.md) + - [@ohos.reminderAgent (后台代理提醒)](js-apis-reminderAgent.md) - [@system.request (上传下载)](js-apis-system-request.md) - [@system.router (页面路由)](js-apis-system-router.md) - [@system.sensor (传感器)](js-apis-system-sensor.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-reminderAgent.md b/zh-cn/application-dev/reference/apis/js-apis-reminderAgent.md index ff6f931d33..8e0d56e259 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-reminderAgent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-reminderAgent.md @@ -4,7 +4,10 @@ 开发应用时，开发者可以调用后台提醒发布的接口创建定时提醒，包括倒计时、日历、闹钟三种提醒类型。使用后台代理提醒能力后，应用可以被冻结或退出，计时和弹出提醒的功能将被后台系统服务代理。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** +> +> 从API Version 9 开始，该接口不再维护，推荐使用新接口[@ohos.reminderAgentManager (后台代理提醒)](js-apis-reminderAgentManager.md) +> > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 @@ -15,14 +18,11 @@ import reminderAgent from'@ohos.reminderAgent'; ``` -## reminderAgent.publishReminder(deprecated) +## reminderAgent.publishReminder publishReminder(reminderReq: ReminderRequest, callback: AsyncCallback<number>): void 发布一个后台代理提醒，使用callback方式实现异步调用，该方法需要申请通知弹窗[Notification.requestEnableNotification](js-apis-notification.md#notificationrequestenablenotification8)后才能调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.publishReminder](js-apis-reminderAgentManager.md#reminderagentmanagerpublishreminder9) -> -> 从 API version 7开始支持。 **需要权限**： ohos.permission.PUBLISH_AGENT_REMINDER @@ -47,14 +47,11 @@ publishReminder(reminderReq: ReminderRequest, callback: AsyncCallback<number& ``` -## reminderAgent.publishReminder(deprecated) +## reminderAgent.publishReminder publishReminder(reminderReq: ReminderRequest): Promise<number> 发布一个后台代理提醒，使用Promise方式实现异步调用，该方法需要申请通知弹窗[Notification.requestEnableNotification](js-apis-notification.md#notificationrequestenablenotification8)后才能调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.publishReminder](js-apis-reminderAgentManager.md#reminderagentmanagerpublishreminder9-1) -> -> 从 API version 7开始支持。 **需要权限**： ohos.permission.PUBLISH_AGENT_REMINDER @@ -82,14 +79,11 @@ publishReminder(reminderReq: ReminderRequest): Promise<number> ``` -## reminderAgent.cancelReminder(deprecated) +## reminderAgent.cancelReminder cancelReminder(reminderId: number, callback: AsyncCallback<void>): void 取消指定id的提醒，使用callback方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.cancelReminder](js-apis-reminderAgentManager.md#reminderagentmanagercancelreminder9) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -109,14 +103,11 @@ reminderAgent.cancelReminder(1, (err, data) => { ``` -## reminderAgent.cancelReminder(deprecated) +## reminderAgent.cancelReminder cancelReminder(reminderId: number): Promise<void> 取消指定id的提醒，使用Promise方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.cancelReminder](js-apis-reminderAgentManager.md#reminderagentmanagercancelreminder9-1) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -141,14 +132,11 @@ reminderAgent.cancelReminder(1).then(() => { ``` -## reminderAgent.getValidReminders(deprecated) +## reminderAgent.getValidReminders getValidReminders(callback: AsyncCallback<Array<ReminderRequest>>): void 获取当前应用已设置的所有有效（未过期）的提醒，使用callback方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.getValidReminders](js-apis-reminderAgentManager.md#reminderagentmanagergetvalidreminders9) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -188,14 +176,11 @@ reminderAgent.getValidReminders((err, reminders) => { ``` -## reminderAgent.getValidReminders(deprecated) +## reminderAgent.getValidReminders getValidReminders(): Promise<Array<ReminderRequest>> 获取当前应用已设置的所有有效（未过期）的提醒，使用Promise方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.getValidReminders](js-apis-reminderAgentManager.md#reminderagentmanagergetvalidreminders9-1) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -235,14 +220,11 @@ reminderAgent.getValidReminders().then((reminders) => { ``` -## reminderAgent.cancelAllReminders(deprecated) +## reminderAgent.cancelAllReminders cancelAllReminders(callback: AsyncCallback<void>): void 取消当前应用所有的提醒，使用callback方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.cancelAllReminders](js-apis-reminderAgentManager.md#reminderagentmanagercancelallreminders9) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -261,14 +243,11 @@ reminderAgent.cancelAllReminders((err, data) =>{ ``` -## reminderAgent.cancelAllReminders(deprecated) +## reminderAgent.cancelAllReminders cancelAllReminders(): Promise<void> 取消当前应用所有的提醒，使用Promise方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.cancelAllReminders](js-apis-reminderAgentManager.md#reminderagentmanagercancelallreminders9-1) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -287,14 +266,11 @@ reminderAgent.cancelAllReminders().then(() => { ``` -## reminderAgent.addNotificationSlot(deprecated) +## reminderAgent.addNotificationSlot addNotificationSlot(slot: NotificationSlot, callback: AsyncCallback<void>): void 添加一个NotificationSlot，使用callback方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.addNotificationSlot](js-apis-reminderAgentManager.md#reminderagentmanageraddnotificationslot9) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -319,14 +295,11 @@ reminderAgent.addNotificationSlot(mySlot, (err, data) => { ``` -## reminderAgent.addNotificationSlot(deprecated) +## reminderAgent.addNotificationSlot addNotificationSlot(slot: NotificationSlot): Promise<void> 添加一个NotificationSlot，使用Promise方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.addNotificationSlot](js-apis-reminderAgentManager.md#reminderagentmanageraddnotificationslot9-1) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -356,14 +329,11 @@ reminderAgent.addNotificationSlot(mySlot).then(() => { ``` -## reminderAgent.removeNotificationSlot(deprecated) +## reminderAgent.removeNotificationSlot removeNotificationSlot(slotType: notification.SlotType, callback: AsyncCallback<void>): void 删除目标NotificationSlot，使用callback方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#reminderagentmanagerremovenotificationslot9) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -385,14 +355,11 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION, ``` -## reminderAgent.removeNotificationSlot(deprecated) +## reminderAgent.removeNotificationSlot removeNotificationSlot(slotType: notification.SlotType): Promise<void> 删除目标NotificationSlot，使用Promise方式实现异步调用。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#reminderagentmanagerremovenotificationslot9-1) -> -> 从 API version 7开始支持。 **系统能力**： SystemCapability.Notification.ReminderAgent @@ -419,12 +386,9 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION). ``` -## ActionButtonType(deprecated) +## ActionButtonType 按钮的类型。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#actionbuttontype9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent @@ -434,12 +398,9 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION). | ACTION_BUTTON_TYPE_SNOOZE | 1 | 表示延迟提醒的按钮。 | -## ReminderType(deprecated) +## ReminderType 提醒的类型。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#remindertype9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent @@ -450,12 +411,9 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION). | REMINDER_TYPE_ALARM | 2 | 表示提醒类型：闹钟。 | -## ActionButton(deprecated) +## ActionButton 用于设置弹出的提醒通知信息上显示的按钮类型和标题。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#actionbutton9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent @@ -465,12 +423,9 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION). | type | [ActionButtonType](#actionbuttontype) | 是 | 按钮的类型。 | -## WantAgent(deprecated) +## WantAgent 点击提醒通知后跳转的目标ability信息。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#wantagent9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent @@ -480,12 +435,9 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION). | abilityName | string | 是 | 指明点击提醒通知栏后跳转的目标ability名称。 | -## MaxScreenWantAgent(deprecated) +## MaxScreenWantAgent 全屏显示提醒到达时自动拉起的目标ability信息，该接口预留。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#maxscreenwantagent9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent @@ -495,12 +447,9 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION). | abilityName | string | 是 | 指明提醒到达时自动拉起的目标ability名（如果设备在使用中，则只弹出通知横幅框）。 | -## ReminderRequest(deprecated) +## ReminderRequest 提醒实例对象，用于设置提醒类型、响铃时长等具体信息。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#reminderrequest9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent @@ -521,14 +470,11 @@ reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION). | slotType | [notification.SlotType](js-apis-notification.md#slottype) | 否 | 指明提醒的slot类型。 | -## ReminderRequestCalendar(deprecated) +## ReminderRequestCalendar ReminderRequestCalendar extends ReminderRequest 日历实例对象，用于设置提醒的时间。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#reminderrequestcalendar9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent @@ -539,14 +485,11 @@ ReminderRequestCalendar extends ReminderRequest | repeatDays | Array<number> | 否 | 指明重复提醒的日期。 | -## ReminderRequestAlarm(deprecated) +## ReminderRequestAlarm ReminderRequestAlarm extends ReminderRequest 闹钟实例对象，用于设置提醒的时间。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#reminderrequestalarm9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent @@ -557,14 +500,11 @@ ReminderRequestAlarm extends ReminderRequest | daysOfWeek | Array<number> | 否 | 指明每周哪几天需要重复提醒。 | -## ReminderRequestTimer(deprecated) +## ReminderRequestTimer ReminderRequestTimer extends ReminderRequest 倒计时实例对象，用于设置提醒的时间。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#reminderrequesttimer9) -> -> 从 API version 7开始支持。 **系统能力**：SystemCapability.Notification.ReminderAgent @@ -573,12 +513,9 @@ ReminderRequestTimer extends ReminderRequest | triggerTimeInSeconds | number | 是 | 指明倒计时的秒数。 | -## LocalDateTime(deprecated) +## LocalDateTime 用于日历类提醒设置时指定时间信息。 -> **说明：** 从API version 9开始废弃，建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#localdatetime9) -> -> 从 API version 7开始支持。 **系统能力**：以下各项对应的系统能力均为SystemCapability.Notification.ReminderAgent diff --git a/zh-cn/application-dev/reference/apis/js-apis-reminderAgentManager.md b/zh-cn/application-dev/reference/apis/js-apis-reminderAgentManager.md index 59459eaf47..057845d486 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-reminderAgentManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-reminderAgentManager.md @@ -4,8 +4,9 @@ 开发应用时，开发者可以调用后台提醒发布的接口创建定时提醒，包括倒计时、日历、闹钟三种提醒类型。使用后台代理提醒能力后，应用可以被冻结或退出，计时和弹出提醒的功能将被后台系统服务代理。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> **说明：** +> +> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 @@ -15,7 +16,7 @@ import reminderAgentManager from'@ohos.reminderAgentManager'; ``` -## reminderAgentManager.publishReminder9+ +## reminderAgentManager.publishReminder publishReminder(reminderReq: ReminderRequest, callback: AsyncCallback<number>): void @@ -52,7 +53,7 @@ try { ``` -## reminderAgentManager.publishReminder9+ +## reminderAgentManager.publishReminder publishReminder(reminderReq: ReminderRequest): Promise<number> @@ -90,7 +91,7 @@ try { ``` -## reminderAgentManager.cancelReminder9+ +## reminderAgentManager.cancelReminder cancelReminder(reminderId: number, callback: AsyncCallback<void>): void @@ -122,7 +123,7 @@ try { ``` -## reminderAgentManager.cancelReminder9+ +## reminderAgentManager.cancelReminder cancelReminder(reminderId: number): Promise<void> @@ -157,7 +158,7 @@ try { ``` -## reminderAgentManager.getValidReminders9+ +## reminderAgentManager.getValidReminders getValidReminders(callback: AsyncCallback<Array<ReminderRequest>>): void @@ -209,7 +210,7 @@ try { ``` -## reminderAgentManager.getValidReminders9+ +## reminderAgentManager.getValidReminders getValidReminders(): Promise<Array<ReminderRequest>> @@ -259,7 +260,7 @@ try { ``` -## reminderAgentManager.cancelAllReminders9+ +## reminderAgentManager.cancelAllReminders cancelAllReminders(callback: AsyncCallback<void>): void @@ -290,7 +291,7 @@ try { ``` -## reminderAgentManager.cancelAllReminders9+ +## reminderAgentManager.cancelAllReminders cancelAllReminders(): Promise<void> @@ -319,7 +320,7 @@ try { ``` -## reminderAgentManager.addNotificationSlot9+ +## reminderAgentManager.addNotificationSlot addNotificationSlot(slot: NotificationSlot, callback: AsyncCallback<void>): void @@ -356,7 +357,7 @@ try { ``` -## reminderAgentManager.addNotificationSlot9+ +## reminderAgentManager.addNotificationSlot addNotificationSlot(slot: NotificationSlot): Promise<void> @@ -396,7 +397,7 @@ try { ``` -## reminderAgentManager.removeNotificationSlot9+ +## reminderAgentManager.removeNotificationSlot removeNotificationSlot(slotType: notification.SlotType, callback: AsyncCallback<void>): void @@ -430,7 +431,7 @@ try { ``` -## reminderAgentManager.removeNotificationSlot9+ +## reminderAgentManager.removeNotificationSlot removeNotificationSlot(slotType: notification.SlotType): Promise<void> @@ -466,7 +467,7 @@ try { }; ``` -## ActionButtonType9+ +## ActionButtonType 按钮的类型。 @@ -478,7 +479,7 @@ try { | ACTION_BUTTON_TYPE_SNOOZE | 1 | 表示延迟提醒的按钮。 | -## ReminderType9+ +## ReminderType 提醒的类型。 @@ -491,7 +492,7 @@ try { | REMINDER_TYPE_ALARM | 2 | 表示提醒类型：闹钟。 | -## ActionButton9+ +## ActionButton 用于设置弹出的提醒通知信息上显示的按钮类型和标题。 @@ -503,7 +504,7 @@ try { | type | [ActionButtonType](#actionbuttontype) | 是 | 按钮的类型。 | -## WantAgent9+ +## WantAgent 点击提醒通知后跳转的目标ability信息。 @@ -515,7 +516,7 @@ try { | abilityName | string | 是 | 指明点击提醒通知栏后跳转的目标ability名称。 | -## MaxScreenWantAgent9+ +## MaxScreenWantAgent 全屏显示提醒到达时自动拉起的目标ability信息，该接口预留。 @@ -527,7 +528,7 @@ try { | abilityName | string | 是 | 指明提醒到达时自动拉起的目标ability名（如果设备在使用中，则只弹出通知横幅框）。 | -## ReminderRequest9+ +## ReminderRequest 提醒实例对象，用于设置提醒类型、响铃时长等具体信息。 @@ -550,7 +551,7 @@ try { | slotType | [notification.SlotType](js-apis-notification.md#slottype) | 否 | 指明提醒的slot类型。 | -## ReminderRequestCalendar9+ +## ReminderRequestCalendar ReminderRequestCalendar extends ReminderRequest @@ -565,7 +566,7 @@ ReminderRequestCalendar extends ReminderRequest | repeatDays | Array<number> | 否 | 指明重复提醒的日期。 | -## ReminderRequestAlarm9+ +## ReminderRequestAlarm ReminderRequestAlarm extends ReminderRequest @@ -580,7 +581,7 @@ ReminderRequestAlarm extends ReminderRequest | daysOfWeek | Array<number> | 否 | 指明每周哪几天需要重复提醒。 | -## ReminderRequestTimer9+ +## ReminderRequestTimer ReminderRequestTimer extends ReminderRequest @@ -593,7 +594,7 @@ ReminderRequestTimer extends ReminderRequest | triggerTimeInSeconds | number | 是 | 指明倒计时的秒数。 | -## LocalDateTime9+ +## LocalDateTime 用于日历类提醒设置时指定时间信息。 diff --git a/zh-cn/application-dev/reference/errorcodes/errcode-reminderAgentManager.md b/zh-cn/application-dev/reference/errorcodes/errcode-reminderAgentManager.md index 9bc9cd5ce1..6087eb0f9b 100644 --- a/zh-cn/application-dev/reference/errorcodes/errcode-reminderAgentManager.md +++ b/zh-cn/application-dev/reference/errorcodes/errcode-reminderAgentManager.md @@ -2,50 +2,78 @@ ## 1700001 通知使能未开启 -### 错误信息 +**错误信息** + Notification does not enable. -### 可能原因 +**错误描述** + +当调用发布提醒接口时，未允许应用发送通知。 + +**可能原因** + 1. 未申请通知使能。 2. 通知使能被关闭。 -### 处理步骤 +**处理步骤** + 1. 申请通知使能弹窗[Notification.requestEnableNotification](../apis/js-apis-notification.md#notificationrequestenablenotification8)。 2. 检查通知使能是否被关闭。 ## 1700002 提醒数量超出限制 -### 错误信息 +**错误信息** + The number of reminders exceeds the limit. -### 可能原因 +**错误描述** + +当调用发布提醒接口时，提醒数量超出最大限制。 + +**可能原因** + 1. 当前系统提醒超过2000个。 2. 当前应用提醒超过30个。 -### 处理步骤 -删除不必要的提醒 +**处理步骤** + +删除不必要的提醒。 ## 1700003 提醒不存在 -### 错误信息 +**错误信息** + The reminder does not exist. -### 可能原因 +**错误描述** + +当调用取消提醒接口时，未找到对应的提醒。 + +**可能原因** + 1. 提醒已过期。 2. 提醒已被删除。 -### 处理步骤 +**处理步骤** + 1. 检查提醒是否有效。 2. 检查提醒是否已被删除。 ## 1700004 包名不存在 -### 错误信息 +**错误信息** + The package name does not exist. -### 可能原因 +**错误描述** + +未找到传入的包名信息。 + +**可能原因** + 1. 包名不正确。 2. 应用未安装。 -### 处理步骤 +**处理步骤** + 检查应用包名是否存在。 diff --git a/zh-cn/application-dev/task-management/background-agent-scheduled-reminder-guide.md b/zh-cn/application-dev/task-management/background-agent-scheduled-reminder-guide.md index 7f86cafc3c..918b5d918a 100644 --- a/zh-cn/application-dev/task-management/background-agent-scheduled-reminder-guide.md +++ b/zh-cn/application-dev/task-management/background-agent-scheduled-reminder-guide.md @@ -9,7 +9,7 @@ reminderAgentManager：封装了发布、取消提醒类通知的方法。 -具体后台提醒相关功能接口请见[后台代理提醒](../reference/apis/js-apis-reminderAgent.md)。 +具体后台提醒相关功能接口请见[后台代理提醒](../reference/apis/js-apis-reminderAgentManager.md)。 **表1** reminderAgentManager主要接口 -- GitLab