From f47bed49bf7edb7167211b5e00e2a89abb366a96 Mon Sep 17 00:00:00 2001 From: zengsiyu Date: Tue, 10 May 2022 21:34:11 +0800 Subject: [PATCH] add publishasbundle and cancelasbundle Signed-off-by: zengsiyu Change-Id: Ief18ca0b154c91eaefd4da0e312e07d55f64caa3 Signed-off-by: zengsiyu --- .../reference/apis/js-apis-notification.md | 152 +++++++++++++++++- 1 file changed, 151 insertions(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-notification.md b/zh-cn/application-dev/reference/apis/js-apis-notification.md index 7af0eb6360..ad552f645b 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-notification.md +++ b/zh-cn/application-dev/reference/apis/js-apis-notification.md @@ -2492,6 +2492,156 @@ Notification.getDeviceRemindType() }); ``` +## Notification.publishAsBundle9+ + +publishAsBundle(request: NotificationRequest, representativeBundle: string, userId: number, callback: AsyncCallback\): void + +发布代理通知（callback形式）。 + +**系统能力**：SystemCapability.Notification.Notification + +**参数：** + + +| 参数名 | 类型 | 必填 | 说明 | +| -------------------- | ------------------------------------------- | ---- | --------------------------------------------- | +| request | [NotificationRequest](#notificationrequest) | 是 | 设置要发布通知内容的NotificationRequest对象。 | +| representativeBundle | string | 是 | 被代理应用的包名。 | +| userId | number | 是 | 接收通知用户的Id。 | +| callback | AsyncCallback | 是 | 发布代理通知的回调方法。 | + +**示例：** + +```js +//publishAsBundle回调 +function publishAsBundleCallback(err) { + console.info("==========================>publishAsBundleCallback=======================>"); +} +// 被代理应用的包名 +let representativeBundle = "com.example.demo" +// 接收通知的用户ID +let userId = 100 +//通知Request对象 +let notificationRequest = { + id: 1, + content: { + contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, + normal: { + title: "test_title", + text: "test_text", + additionalText: "test_additionalText" + } + } +} + +Notification.publishAsBundle(notificationRequest, representativeBundle, userId, publishCallback); +``` + +## Notification.publishAsBundle9+ + +publishAsBundle(request: NotificationRequest, representativeBundle: string, userId: number): Promise\ + +发布代理通知（Promise形式）。 + +**系统能力**：SystemCapability.Notification.Notification + +**参数：** + + +| 参数名 | 类型 | 必填 | 说明 | +| -------------------- | ------------------------------------------- | ---- | --------------------------------------------- | +| request | [NotificationRequest](#notificationrequest) | 是 | 设置要发布通知内容的NotificationRequest对象。 | +| representativeBundle | string | 是 | 被代理应用的包名。 | +| userId | number | 是 | 接收通知用户的Id。 | + +**示例：** + +```js +// 被代理应用的包名 +let representativeBundle = "com.example.demo" +// 接收通知的用户ID +let userId = 100 +//通知Request对象 +var notificationRequest = { + id: 1, + content: { + contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, + normal: { + title: "test_title", + text: "test_text", + additionalText: "test_additionalText" + } + } +} + +Notification.publishAsBundle(notificationRequest, representativeBundle, userId).then(() => { + console.info("==========================>publishAsBundleCallback=======================>"); +}); +``` + +## Notification.cancelAsBundle9+ + +cancelAsBundle(id: number, representativeBundle: string, userId: number, callback: AsyncCallback\): void + +取消代理通知（callback形式）。 + +**系统能力**：SystemCapability.Notification.Notification + +**参数：** + + +| 参数名 | 类型 | 必填 | 说明 | +| -------------------- | ------------- | ---- | ------------------------ | +| id | number | 是 | 通知ID。 | +| representativeBundle | string | 是 | 被代理应用的包名。 | +| userId | number | 是 | 接收通知用户的Id。 | +| callback | AsyncCallback | 是 | 取消代理通知的回调方法。 | + +**示例：** + +```js +//cancelAsBundle +function cancelAsBundleCallback(err) { + console.info("==========================>cancelAsBundleCallback=======================>"); +} +// 被代理应用的包名 +let representativeBundle = "com.example.demo" +// 接收通知的用户ID +let userId = 100 + +Notification.cancelAsBundle(0, representativeBundle, userId, publishCallback); +``` + +## Notification.cancelAsBundle9+ + +cancelAsBundle(request: NotificationRequest, representativeBundle: string, userId: number): Promise\ + +发布代理通知（Promise形式）。 + +**系统能力**：SystemCapability.Notification.Notification + +**参数：** + + +| 参数名 | 类型 | 必填 | 说明 | +| -------------------- | ------ | ---- | ------------------ | +| id | number | 是 | 通知ID。 | +| representativeBundle | string | 是 | 被代理应用的包名。 | +| userId | number | 是 | 接收通知用户的Id。 | + +**示例：** + +```js +// 被代理应用的包名 +let representativeBundle = "com.example.demo" +// 接收通知的用户ID +let userId = 100 + +Notification.cancelAsBundle(0, representativeBundle, userId).then(() => { + console.info("==========================>cancelAsBundleCallback=======================>"); +}); +``` + ## NotificationSubscriber ### onConsume @@ -3123,4 +3273,4 @@ Notification.subscribe(subscriber, subscribeCallback); | IDLE_DONOT_REMIND | 0 | 设备未被使用，无需提醒。 | | IDLE_REMIND | 1 | 提醒设备未被使用。 | | ACTIVE_DONOT_REMIND | 2 | 设备正在使用，无需提醒。 | -| ACTIVE_REMIND | 3 | 提醒设备正在使用。 | \ No newline at end of file +| ACTIVE_REMIND | 3 | 提醒设备正在使用。 | -- GitLab