!10699 提醒代理错误码整改

Merge pull request !10699 from 廖康康/master

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)
@@ -120,6 +119,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)
 - 定制管理
@@ -271,6 +271,7 @@
   - [@ohos.bytrace (性能打点)](js-apis-bytrace.md)
   - [@ohos.data.storage (轻量级存储)](js-apis-data-storage.md)
   - [@ohos.prompt (弹窗)](js-apis-prompt.md)
+  - [@ohos.reminderAgent (后台代理提醒)](js-apis-reminderAgent.md)
   - [@system.app (应用上下文)](js-apis-system-app.md)
   - [@system.battery (电量信息)](js-apis-system-battery.md)
   - [@system.bluetooth (蓝牙)](js-apis-system-bluetooth.md)

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开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
 
 

zh-cn/application-dev/reference/errorcodes/errcode-reminderAgentManager.md

+# reminderAgentManager错误码
+
+## 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. 应用未安装。
+
+**处理步骤**
+
+检查应用包名是否存在。

zh-cn/application-dev/task-management/background-agent-scheduled-reminder-guide.md

@@ -7,11 +7,11 @@
 
 ## 接口说明
 
-reminderAgent：封装了发布、取消提醒类通知的方法。
+reminderAgentManager：封装了发布、取消提醒类通知的方法。
 
-具体后台提醒相关功能接口请见[后台代理提醒](../reference/apis/js-apis-reminderAgent.md)。
+具体后台提醒相关功能接口请见[后台代理提醒](../reference/apis/js-apis-reminderAgentManager.md)。
 
-**表1** reminderAgent主要接口
+**表1** reminderAgentManager主要接口
 
 | 接口名 | 描述 |
 | -------- | -------- |
@@ -36,17 +36,17 @@ reminderAgent：封装了发布、取消提醒类通知的方法。
 2、发布相应的提醒代理。
 
 ```ts
-import reminderAgent from '@ohos.reminderAgent';
+import reminderAgentManager from '@ohos.reminderAgentManager';
 import notification from '@ohos.notification';
 
 // 倒计时实例定义：
-let timer : reminderAgent.ReminderRequestTimer = {
-    reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER,
+let timer : reminderAgentManager.ReminderRequestTimer = {
+    reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_TIMER,
     triggerTimeInSeconds: 10,
     actionButton: [
         {
             title: "close",
-            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
+            type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
         }
     ],
     wantAgent: {
@@ -65,8 +65,8 @@ let timer : reminderAgent.ReminderRequestTimer = {
 }
 
 // 日历实例定义：
-let calendar : reminderAgent.ReminderRequestCalendar = {
-    reminderType: reminderAgent.ReminderType.REMINDER_TYPE_CALENDAR,
+let calendar : reminderAgentManager.ReminderRequestCalendar = {
+    reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_CALENDAR,
     dateTime: {
         year: 2050,
         month: 7,
@@ -80,11 +80,11 @@ let calendar : reminderAgent.ReminderRequestCalendar = {
     actionButton: [
         {
             title: "close",
-            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
+            type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
         },
         {
             title: "snooze",
-            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_SNOOZE
+            type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_SNOOZE
         },
     ],
     wantAgent: {
@@ -107,19 +107,19 @@ let calendar : reminderAgent.ReminderRequestCalendar = {
 }
 
 // 闹钟实例定义：
-let alarm : reminderAgent.ReminderRequestAlarm = {
-    reminderType: reminderAgent.ReminderType.REMINDER_TYPE_ALARM,
+let alarm : reminderAgentManager.ReminderRequestAlarm = {
+    reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_ALARM,
     hour: 11,
     minute: 14,
     daysOfWeek: [0],
     actionButton: [
         {
             title: "close",
-            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
+            type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
         },
         {
             title: "snooze",
-            type: reminderAgent.ActionButtonType.ACTION_BUTTON_TYPE_SNOOZE
+            type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_SNOOZE
         },
     ],
     wantAgent: {
@@ -147,9 +147,15 @@ struct Index {
   @State message: string = 'test'
 
   publishReminder() {
-      reminderAgent.publishReminder(timer, (err, reminderId) => {
-        console.log("callback, reminderId = " + reminderId);
-    });
+    try {
+        reminderAgentManager.publishReminder(timer).then(res => {
+            console.log("publishReminder promise reminderId:" + res);
+        }).catch(err => {
+            console.log("publishReminder err code:" + err.code + " message:" + err.message);
+        })
+    } catch (error) {
+        console.log("publishReminder code:" + error.code + " message:" + error.message);
+    };
   }
 
   build() {