diff --git a/zh-cn/application-dev/reference/apis/js-apis-emitter.md b/zh-cn/application-dev/reference/apis/js-apis-emitter.md
index c8835a17faea6c66851bffa4de81850547387833..705e3ae995cb9b80bfb14ad287951f794916c542 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-emitter.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-emitter.md
@@ -8,12 +8,6 @@
import emitter from '@ohos.events.emitter'
```
-## 系统能力
-
-```javascript
-SystemCapability.Notification.Emitter
-```
-
## 权限列表
无
@@ -24,10 +18,10 @@ SystemCapability.Notification.Emitter
| 名称 | 值 | 说明 |
| --------- | ---- | ------------------------------------------------- |
-| IMMEDIATE | 0 | 表示事件被立即投递 |
-| HIGH | 1 | 表示事件先于LOW优先级投递 |
-| LOW | 2 | 表示事件优于IDLE优先级投递,事件的默认优先级是LOW |
-| IDLE | 3 | 表示在没有其他事件的情况下,才投递该事件 |
+| IMMEDIATE | 0 | 表示事件被立即投递。
**系统能力**: SystemCapability.Notification.Emitter |
+| HIGH | 1 | 表示事件先于LOW优先级投递。
**系统能力**: SystemCapability.Notification.Emitter |
+| LOW | 2 | 表示事件优于IDLE优先级投递,事件的默认优先级是LOW。
**系统能力**: SystemCapability.Notification.Emitter |
+| IDLE | 3 | 表示在没有其他事件的情况下,才投递该事件。
**系统能力**: SystemCapability.Notification.Emitter |
## emitter.on
@@ -35,6 +29,8 @@ on(event: [InnerEvent](#innerevent), callback: Callback\<[EventData](#eventdata)
持续订阅某个事件以及接收事件的回调处理。
+**系统能力**: SystemCapability.Notification.Emitter
+
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
@@ -60,6 +56,8 @@ once(event: [InnerEvent](#innerevent), callback: Callback\<[EventData](#eventdat
单次订阅某个事件以及接收事件的回调处理,接收到回调处理后自动取消订阅。
+**系统能力**: SystemCapability.Notification.Emitter
+
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
@@ -85,6 +83,8 @@ off(eventId: number): void
取消订阅某个事件。
+**系统能力**: SystemCapability.Notification.Emitter
+
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
@@ -103,6 +103,8 @@ emit(event: InnerEvent, data?: EventData): void
发送一个事件到事件队列。
+**系统能力**: SystemCapability.Notification.Emitter
+
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
@@ -131,8 +133,8 @@ emitter.emit(innerEvent, eventData);
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | ------------------------------- | ---- | ---- | ---------------------------------- |
-| eventId | number | 是 | 是 | 事件的ID,由开发者定义用来辨别事件 |
-| priority | [EventPriority](#eventpriority) | 是 | 是 | 事件被投递的优先级 |
+| eventId | number | 是 | 是 | 事件的ID,由开发者定义用来辨别事件。
**系统能力**: SystemCapability.Notification.Emitter |
+| priority | [EventPriority](#eventpriority) | 是 | 是 | 事件被投递的优先级。
**系统能力**: SystemCapability.Notification.Emitter |
## EventData
@@ -140,4 +142,4 @@ emitter.emit(innerEvent, eventData);
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| ---- | ------------------ | ---- | ---- | -------------- |
-| data | [key: string]: any | 是 | 是 | 事件携带的数据 |
+| data | [key: string]: any | 是 | 是 | 发送事件时传递的数据,数据类型支持字符串、整型和布尔型。
**系统能力**: SystemCapability.Notification.Emitter |
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 b5afd3db1313e7bec144dd1d74e110f9467fe8f0..e721e5f4cc74b067ba10d9154c715d1d317818b3 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-notification.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-notification.md
@@ -6,31 +6,22 @@
import Notification from '@ohos.notification';
```
-## 系统能力
+## Notification.publish
-```js
-SystemCapability.Notification.Notification
-```
-
-## Notification.publish(request: NotificationRequest, callback: AsyncCallback\)
-
-- 接口说明
+publish(request: NotificationRequest, callback: AsyncCallback\): void
- 发布通知(callback形式)
+发布通知(callback形式)。
-- publish参数描述
+**系统能力**:SystemCapability.Notification.Notification
+**参数:**
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ------------------------------------------- | ---- | ------------------------------------------- |
-| request | 只读 | [NotificationRequest](#notificationrequest) | 是 | 设置要发布通知内容的NotificationRequest对象 |
-| callback | 只读 | AsyncCallback\ | 是 | 被指定的回调方法 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | ---- | ------------------------------------------- | ---- | ------------------------------------------- |
+| request | 是 | 否 |[NotificationRequest](#notificationrequest) | 是 | 设置要发布通知内容的NotificationRequest对象。 |
+| callback | 是 | 否 |AsyncCallback\ | 是 | 被指定的回调方法。 |
-- 返回值
-
- void
-
-- 示例
+**示例:**
```js
//publish回调
@@ -54,17 +45,15 @@ Notification.publish(notificationRequest, publishCallback)
-## Notification.publish(request: NotificationRequest)
+## Notification.publish
-- 接口说明
+publish(request: NotificationRequest): Promise\
- 发布通知(Promise形式)
+发布通知(Promise形式)。
-- 返回值
+**系统能力**:SystemCapability.Notification.Notification
- Promise\
-
-- 示例
+**示例:**
```js
//通知Request对象
@@ -87,25 +76,23 @@ Notification.publish(notificationRequest).then(() => {
-## Notification.cancel(id: number, label: string, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.cancel
- 取消与指定id和label相匹配的已发布通知(callback形式)
+cancel(id: number, label: string, callback: AsyncCallback\): void
-- cancel参数描述
+取消与指定id和label相匹配的已发布通知(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| id | 只读 | number | 是 | 通知ID |
-| label | 只读 | string | 是 | 通知标签 |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | --- | ---- | --------------------- | ---- | -------------------- |
+| id | 是 | 否 | number | 是 | 通知ID。 |
+| label | 是 | 否 | string | 是 | 通知标签。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
-- 示例
+**示例:**
```js
//cancel回调
@@ -117,24 +104,22 @@ Notification.cancel(0, "label", cancelCallback)
-## Notification.cancel(id:number, label?:string)
+## Notification.cancel
-- 接口说明
+cancel(id:number, label?:string): Promise\
- 取消与指定id相匹配的已发布通知,label可以指定也可以不指定(Promise形式)
+取消与指定id相匹配的已发布通知,label可以指定也可以不指定(Promise形式)。
-- cancel参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ----- | -------- | ------ | ---- | -------- |
-| id | 只读 | number | 是 | 通知ID |
-| label | 只读 | string | 否 | 通知标签 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ----- | --- | ---- | ------ | ---- | -------- |
+| id | 是 | 否 | number | 是 | 通知ID。 |
+| label | 是 | 否 | string | 否 | 通知标签。 |
- Promise\
-
-- 示例
+**示例:**
```js
Notification.cancel(0).then(() => {
@@ -144,24 +129,22 @@ Notification.cancel(0).then(() => {
-## Notification.cancel(id: number, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.cancel
- 取消与指定id相匹配的已发布通知(callback形式)
+cancel(id: number, callback: AsyncCallback\): void
-- cancel参数描述
+取消与指定id相匹配的已发布通知(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| id | 只读 | number | 是 | 通知ID |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| id | 是 | 否 | number | 是 | 通知ID。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
-- 示例
+**示例:**
```js
//cancel回调
@@ -173,23 +156,21 @@ Notification.cancel(0, cancelCallback)
-## Notification.cancelAll(callback: AsyncCallback\)
+## Notification.cancelAll
-- 接口说明
+cancelAll(callback: AsyncCallback\): void
- 取消所有已发布的通知(callback形式)
+取消所有已发布的通知(callback形式)。
-- cancelAll参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
- void
-
-- 示例
+**示例:**
```js
//cancel回调
@@ -201,21 +182,15 @@ Notification.cancelAll(cancelAllCallback)
-## Notification.cancelAll()
-
-- 接口说明
+## Notification.cancelAll
- 取消所有已发布的通知(Promise形式)
+cancelAll(): Promise\
-- 参数描述
+取消所有已发布的通知(Promise形式)。
- 无参数
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
-
- Promise\
-
-- 示例
+**示例:**
```js
Notification.cancelAll().then(() => {
@@ -225,24 +200,22 @@ Notification.cancelAll().then(() => {
-## Notification.addSlot(slot: NotificationSlot, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.addSlot
- 创建通知通道(callback形式)
+addSlot(slot: NotificationSlot, callback: AsyncCallback\): void
-- addSlot参数描述
+创建通知通道(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| slot | 只读 | NotificationSlot | 是 | 要创建的通知通道对象 |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| slot | 是 | 否 | NotificationSlot | 是 | 要创建的通知通道对象。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
-* 示例
+**示例:**
```js
//addslot回调
@@ -258,23 +231,21 @@ Notification.addSlot(notificationSlot, addSlotCallBack)
-## Notification.addSlot(slot: NotificationSlot)
+## Notification.addSlot
-- 接口说明
+addSlot(slot: NotificationSlot): Promise\
- 创建通知通道(Promise形式)
+创建通知通道(Promise形式)。
-- addSlot参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---- | -------- | ---------------- | ---- | -------------------- |
-| slot | 只读 | NotificationSlot | 是 | 要创建的通知通道对象 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---- | ---- | --- | ---------------- | ---- | -------------------- |
+| slot | 是 | 否 | NotificationSlot | 是 | 要创建的通知通道对象。 |
- Promise\
-
-- 示例
+**示例:**
```js
//通知slot对象
@@ -288,24 +259,22 @@ Notification.addSlot(notificationSlot).then(() => {
-## Notification.addSlot(type: SlotType, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.addSlot
- 创建通知通道(callback形式)
+addSlot(type: SlotType, callback: AsyncCallback\): void
-- addSlot参数描述
+创建通知通道(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | ---------------------- |
-| type | 只读 | [SlotType](#slottype) | 是 | 要创建的通知通道的类型 |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | ---------------------- |
+| type | 是 | 否 | [SlotType](#slottype) | 是 | 要创建的通知通道的类型。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
-- 示例
+**示例:**
```js
//addslot回调
@@ -317,23 +286,21 @@ Notification.addSlot(Notification.SlotType.SOCIAL_COMMUNICATION, addSlotCallBack
-## Notification.addSlot(type: SlotType)
+## Notification.addSlot
-- 接口说明
+addSlot(type: SlotType): Promise\
- 创建通知通道(Promise形式)
+创建通知通道(Promise形式)。
-- addSlot参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---- | -------- | -------- | ---- | ---------------------- |
-| type | 只读 | [SlotType](#slottype) | 是 | 要创建的通知通道的类型 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---- | ---- | --- | -------- | ---- | ---------------------- |
+| type | 是 | 否 | [SlotType](#slottype) | 是 | 要创建的通知通道的类型。 |
- Promise\
-
-- 示例
+**示例:**
```js
Notification.addSlot(Notification.SlotType.SOCIAL_COMMUNICATION).then(() => {
@@ -343,24 +310,22 @@ Notification.addSlot(Notification.SlotType.SOCIAL_COMMUNICATION).then(() => {
-## Notification.addSlots(slots: Array\, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.addSlots
- 创建多个通知通道(callback形式)
+addSlots(slots: Array\, callback: AsyncCallback\): void
-- addSlots数描述
+创建多个通知通道(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ------------------------- | ---- | ------------------------ |
-| slots | 只读 | Array\ | 是 | 要创建的通知通道对象数组 |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ------------------------- | ---- | ------------------------ |
+| slots | 是 | 否 | Array\ | 是 | 要创建的通知通道对象数组。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
-- 示例
+**示例:**
```js
//addSlots回调
@@ -380,23 +345,21 @@ Notification.addSlots(notificationSlotArray, addSlotsCallBack)
-## Notification.addSlots(slots: Array\)
+## Notification.addSlots
-- 接口说明
+addSlots(slots: Array\): Promise\
- 创建多个通知通道(Promise形式)
+创建多个通知通道(Promise形式)。
-- addSlots数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ----- | -------- | ------------------------- | ---- | ------------------------ |
-| slots | 只读 | Array\ | 是 | 要创建的通知通道对象数组 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ----- | ---- | --- | ------------------------- | ---- | ------------------------ |
+| slots | 是 | 否 | Array\ | 是 | 要创建的通知通道对象数组。 |
- Promise\
-
-- 示例
+**示例:**
```js
//通知slot对象
@@ -414,24 +377,22 @@ Notification.addSlots(notificationSlotArray).then(() => {
-## Notification.getSlot(slotType: SlotType, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.getSlot
- 获取一个通知通道(callback形式)
+getSlot(slotType: SlotType, callback: AsyncCallback\): void
-- getSlot参数描述
+获取一个通知通道(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------------------- | ---- | ----------------------------------------------------------- |
-| slotType | 只读 | [SlotType](#slottype) | 是 | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型 |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------------------- | ---- | ----------------------------------------------------------- |
+| slotType | 是 | 否 | [SlotType](#slottype) | 是 | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
-- 示例
+**示例:**
```js
//getSlot回调
@@ -444,23 +405,27 @@ Notification.getSlot(slotType, getSlotCallback)
-## Notification.getSlot(slotType)
+## Notification.getSlot
-- 接口说明
+getSlot(slotType): Promise\
- 获取一个通知通道(Promise形式)
+获取一个通知通道(Promise形式)。
-- getSlot参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | -------- | ---- | ----------------------------------------------------------- |
-| slotType | 只读 | [SlotType](#slottype) | 是 | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | -------- | ---- | ----------------------------------------------------------- |
+| slotType | 是 | 否 | [SlotType](#slottype) | 是 | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型。 |
- Promise\
+**返回值:**
-- 示例
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取一个通知通道。 |
+
+**示例:**
```js
var slotType = Notification.SlotType.SOCIAL_COMMUNICATION;
@@ -471,23 +436,21 @@ Notification.getSlot(slotType).then((data) => {
-## Notification.getSlots(callback: AsyncCallback>)
-
-- 接口说明
+## Notification.getSlots
- 获取此应用程序的所有通知通道(callback形式)
+getSlots(callback: AsyncCallback>): void
-- getSlots参数描述
+获取此应用程序的所有通知通道(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------------------- | ---- | -------------------- |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------------------- | ---- | -------------------- |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
-- 示例
+**示例:**
```js
//getSlots回调
@@ -499,21 +462,21 @@ Notification.getSlots(getSlotsCallback)
-## Notification.getSlots()
+## Notification.getSlots
-- 接口说明
+getSlots()
- 获取此应用程序的所有通知通道(Promise形式)
+获取此应用程序的所有通知通道(Promise形式)。
-- getSlots参数描述
+**系统能力**:SystemCapability.Notification.Notification
- 无参数
+**返回值:**
-- 返回值
-
- Promise\\>
-
-- 示例
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\\> | 以Promise形式返回获取此应用程序的所有通知通道的结果。 |
+
+**示例:**
```js
Notification.getSlots().then((data) => {
@@ -523,24 +486,22 @@ Notification.getSlots().then((data) => {
-## Notification.removeSlot(slotType: SlotType, callback: AsyncCallback\)
+## Notification.removeSlot
-- 接口说明
+removeSlot(slotType: SlotType, callback: AsyncCallback\): void
- 根据通知通道类型删除创建的通知通道(callback形式)
+根据通知通道类型删除创建的通知通道(callback形式)。
-- removeSlot参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | ----------------------------------------------------------- |
-| slotType | 只读 | [SlotType](#slottype) | 是 | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型 |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | ----------------------------------------------------------- |
+| slotType | 是 | 否 | [SlotType](#slottype) | 是 | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
- void
-
-- 示例
+**示例:**
```js
//removeSlot回调
@@ -553,23 +514,21 @@ Notification.removeSlot(slotType,removeSlotCallback)
-## Notification.removeSlot(slotType: SlotType)
-
-- 接口说明
+## Notification.removeSlot
- 根据通知通道类型删除创建的通知通道(Promise形式)
+removeSlot(slotType: SlotType): Promise\
-- removeSlot参数描述
+根据通知通道类型删除创建的通知通道(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | -------- | ---- | ----------------------------------------------------------- |
-| slotType | 只读 | [SlotType](#slottype) | 是 | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | -------- | ---- | ----------------------------------------------------------- |
+| slotType | 是 | 否 | [SlotType](#slottype) | 是 | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型。 |
-- 示例
+**示例:**
```js
var slotType = Notification.SlotType.SOCIAL_COMMUNICATION;
@@ -580,23 +539,21 @@ Notification.removeSlot(slotType).then(() => {
-## Notification.removeAllSlots(callback: AsyncCallback\)
+## Notification.removeAllSlots
-- 接口说明
+removeAllSlots(callback: AsyncCallback\): void
- 删除所有通知通道(callback形式)
+删除所有通知通道(callback形式)。
-- removeAllSlots参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| callback | 只读 | AsyncCallback\ | 是 | 表示被指定的回调方法 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 表示被指定的回调方法。 |
- void
-
-- 示例
+**示例:**
```js
function removeAllCallBack(err) {
@@ -607,21 +564,15 @@ Notification.removeAllSlots(removeAllCallBack)
-## Notification.removeAllSlots()
-
-- 接口说明
-
- 删除所有通知通道(Promise形式)
+## Notification.removeAllSlots
-- removeAllSlots参数描述
+removeAllSlots(): Promise\
- 参数无
+删除所有通知通道(Promise形式)。
-- 返回值
+**系统能力**:SystemCapability.Notification.Notification
- Promise\
-
-- 示例
+**示例:**
```js
Notification.removeAllSlots().then(() => {
@@ -631,25 +582,23 @@ Notification.removeAllSlots().then(() => {
-## Notification.subscribe(subscriber: NotificationSubscriber, info: NotificationSubscribeInfo, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.subscribe
- 订阅通知并指定订阅信息(callback形式)
+subscribe(subscriber: NotificationSubscriber, info: NotificationSubscribeInfo, callback: AsyncCallback\): void
-- subscribe参数描述
+订阅通知并指定订阅信息(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---------- | -------- | ------------------------- | ---- | ---------------- |
-| subscriber | 只读 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象 |
-| info | 只读 | [NotificationSubscribeInfo](#notificationsubscribeinfo) | 是 | 订阅信息 |
-| callback | 只读 | AsyncCallback\ | 是 | 订阅动作回调函数 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---------- | ---- | --- | ------------------------- | ---- | ---------------- |
+| subscriber | 是 | 否 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象。 |
+| info | 是 | 否 | [NotificationSubscribeInfo](#notificationsubscribeinfo) | 是 | 订阅信息。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 订阅动作回调函数。 |
-- 示例
+**示例:**
```js
//subscribe回调
@@ -670,24 +619,22 @@ Notification.subscribe(subscriber, info, subscribeCallback);
-## Notification.subscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\)
+## Notification.subscribe
-- 接口说明
+subscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\); void
- 订阅通知并指定订阅信息(callback形式)
+订阅通知并指定订阅信息(callback形式)。
-- subscribe参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---------- | -------- | ---------------------- | ---- | ---------------- |
-| subscriber | 只读 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象 |
-| callback | 只读 | AsyncCallback\ | 是 | 订阅动作回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---------- | ---- | --- | ---------------------- | ---- | ---------------- |
+| subscriber | 是 | 否 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 订阅动作回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function subscribeCallback(err) {
@@ -704,24 +651,22 @@ Notification.subscribe(subscriber, subscribeCallback);
-## Notification.subscribe(subscriber: NotificationSubscriber, info?: NotificationSubscribeInfo)
-
-- 接口说明
+## Notification.subscribe
- 订阅通知并指定订阅信息(Promise形式)
+subscribe(subscriber: NotificationSubscriber, info?: NotificationSubscribeInfo): Promise\
-- subscribe参数描述
+订阅通知并指定订阅信息(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---------- | -------- | ------------------------- | ---- | ------------ |
-| subscriber | 只读 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象 |
-| info | 只读 | [NotificationSubscribeInfo](#notificationsubscribeinfo) | 否 | 订阅信息 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---------- | ---- | --- | ------------------------- | ---- | ------------ |
+| subscriber | 是 | 否 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象。 |
+| info | 是 | 否 | [NotificationSubscribeInfo](#notificationsubscribeinfo) | 否 | 订阅信息。 |
-- 示例
+**示例:**
```js
function onConsumeCallback(err, data) {
@@ -737,24 +682,22 @@ Notification.subscribe(subscriber).then(() => {
-## Notification.unsubscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\)
+## Notification.unsubscribe
-- 接口说明
+unsubscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\): void
- 取消订阅(callbcak形式)
+取消订阅(callbcak形式)。
-- unsubscribe参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---------- | -------- | ---------------------- | ---- | -------------------- |
-| subscriber | 只读 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象 |
-| callback | 只读 | AsyncCallback\ | 是 | 取消订阅动作回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---------- | ---- | --- | ---------------------- | ---- | -------------------- |
+| subscriber | 是 | 否 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 取消订阅动作回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function unsubscribeCallback(err) {
@@ -771,23 +714,21 @@ Notification.unsubscribe(subscriber, unsubscribeCallback);
-## Notification.unsubscribe(subscriber: NotificationSubscriber)
-
-- 接口说明
+## Notification.unsubscribe
- 取消订阅(Promise形式)
+unsubscribe(subscriber: NotificationSubscriber): Promise\
-- unsubscribe参数描述
+取消订阅(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---------- | -------- | ---------------------- | ---- | ------------ |
-| subscriber | 只读 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---------- | ---- | --- | ---------------------- | ---- | ------------ |
+| subscriber | 是 | 否 | [NotificationSubscriber](#notificationsubscriber) | 是 | 通知订阅对象。 |
-- 示例
+**示例:**
```js
function onConsumeCallback(err, data) {
@@ -803,25 +744,23 @@ Notification.unsubscribe(subscriber).then(() => {
-## Notification.enableNotification(bundle: BundleOption, enable: boolean, callback: AsyncCallback\)
+## Notification.enableNotification
-- 接口说明
+enableNotification(bundle: BundleOption, enable: boolean, callback: AsyncCallback\): void
- 设定指定包的通知使能状态(Callback形式)
+设定指定包的通知使能状态(Callback形式)。
-- enableNotification参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| enable | 只读 | boolean | 是 | 使能状态 |
-| callback | 只读 | AsyncCallback\ | 是 | 设定通知使能回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| enable | 是 | 否 | boolean | 是 | 使能状态。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 设定通知使能回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function enableNotificationCallback(err) {
@@ -835,24 +774,22 @@ Notification.enableNotification(bundle, false, enableNotificationCallback);
-## Notification.enableNotification(bundle: BundleOption, enable: boolean)
-
-- 接口说明
+## Notification.enableNotification
- 设定指定包的通知使能状态(Promise形式)
+enableNotification(bundle: BundleOption, enable: boolean): Promise\
-- enableNotification参数描述
+设定指定包的通知使能状态(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| enable | 只读 | boolean | 是 | 使能状态 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| enable | 是 | 否 | boolean | 是 | 使能状态。 |
-- 示例
+**示例:**
```js
var bundle = {
@@ -865,24 +802,22 @@ Notification.enableNotification(bundle, false).then(() => {
-## Notification.isNotificationEnabled(bundle: BundleOption, callback: AsyncCallback\)
+## Notification.isNotificationEnabled
-- 接口说明
+isNotificationEnabled(bundle: BundleOption, callback: AsyncCallback\): void
- 获取指定包的通知使能状态(Callback形式)
+获取指定包的通知使能状态(Callback形式)。
-- isNotificationEnabled参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | ------------------------ |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| callback | 只读 | AsyncCallback\ | 是 | 获取通知使能状态回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | ------------------------ |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 获取通知使能状态回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function isNotificationEnabledCallback(err, data) {
@@ -896,23 +831,27 @@ Notification.isNotificationEnabled(bundle, isNotificationEnabledCallback);
-## Notification.isNotificationEnabled(bundle: BundleOption)
+## Notification.isNotificationEnabled
+
+isNotificationEnabled(bundle: BundleOption): Promise\
-- 接口说明
+获取指定包的通知使能状态(Promise形式)。
- 获取指定包的通知使能状态(Promise形式)
+**系统能力**:SystemCapability.Notification.Notification
-- isNotificationEnabled参数描述
+**参数:**
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
-- 返回值
+**返回值:**
- Promise\
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取指定包的通知使能状态的结果。 |
-- 示例
+**示例:**
```js
var bundle = {
@@ -925,23 +864,21 @@ Notification.isNotificationEnabled(bundle).then((data) => {
-## Notification.isNotificationEnabled(callback: AsyncCallback\)
+## Notification.isNotificationEnabled
-- 接口说明
+isNotificationEnabled(callback: AsyncCallback\): void
- 获取通知使能状态(Callback形式)
+获取通知使能状态(Callback形式)。
-- isNotificationEnabled参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | ------------------------ |
-| callback | 只读 | AsyncCallback\ | 是 | 获取通知使能状态回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | ------------------------ |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 获取通知使能状态回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function isNotificationEnabledCallback(err, data) {
@@ -953,23 +890,27 @@ Notification.isNotificationEnabled(isNotificationEnabledCallback);
-## Notification.isNotificationEnabled()
+## Notification.isNotificationEnabled
+
+isNotificationEnabled(): Promise\
-- 接口说明
+获取通知使能状态(Promise形式)。
- 获取通知使能状态(Promise形式)
+**系统能力**:SystemCapability.Notification.Notification
-- isNotificationEnabled参数描述
+**参数:**
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
-- 返回值
+**返回值:**
- Promise\
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取通知使能状态的结果。 |
-- 示例
+**示例:**
```js
Notification.isNotificationEnabled().then((data) => {
@@ -979,25 +920,23 @@ Notification.isNotificationEnabled().then((data) => {
-## Notification.displayBadge(bundle: BundleOption, enable: boolean, callback: AsyncCallback\)
+## Notification.displayBadge
-- 接口说明
+displayBadge(bundle: BundleOption, enable: boolean, callback: AsyncCallback\): void
- 设定指定包的角标使能状态(Callback形式)
+设定指定包的角标使能状态(Callback形式)。
-- displayBadge参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| enable | 只读 | boolean | 是 | 使能状态 |
-| callback | 只读 | AsyncCallback\ | 是 | 设定角标使能回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| enable | 是 | 否 | boolean | 是 | 使能状态。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 设定角标使能回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function displayBadgeCallback(err) {
@@ -1011,24 +950,22 @@ Notification.displayBadge(bundle, false, displayBadgeCallback);
-## Notification.displayBadge(bundle: BundleOption, enable: boolean)
-
-- 接口说明
+## Notification.displayBadge
- 设定指定包的角标使能状态(Promise形式)
+displayBadge(bundle: BundleOption, enable: boolean): Promise\
-- displayBadge参数描述
+设定指定包的角标使能状态(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| enable | 只读 | boolean | 是 | 使能状态 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| enable | 是 | 否 | boolean | 是 | 使能状态。 |
-- 示例
+**示例:**
```js
var bundle = {
@@ -1041,24 +978,22 @@ Notification.displayBadge(bundle, false).then(() => {
-## Notification.isBadgeDisplayed(bundle: BundleOption, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.isBadgeDisplayed
- 获取指定包的角标使能状态(Callback形式)
+isBadgeDisplayed(bundle: BundleOption, callback: AsyncCallback\): void
-- isBadgeDisplayed参数描述
+获取指定包的角标使能状态(Callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | ------------------------ |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| callback | 只读 | AsyncCallback\ | 是 | 获取角标使能状态回调函数 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | ------------------------ |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 获取角标使能状态回调函数。 |
-- 示例
+**示例:**
```js
function isBadgeDisplayedCallback(err, data) {
@@ -1072,23 +1007,27 @@ Notification.isBadgeDisplayed(bundle, isBadgeDisplayedCallback);
-## Notification.isBadgeDisplayed(bundle: BundleOption)
+## Notification.isBadgeDisplayed
-- 接口说明
+isBadgeDisplayed(bundle: BundleOption): Promise\
- 获取指定包的角标使能状态(Promise形式)
+获取指定包的角标使能状态(Promise形式)。
-- isBadgeDisplayed参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
- Promise\
+**返回值:**
-- 示例
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取指定包的角标使能状态。 |
+
+**示例:**
```js
var bundle = {
@@ -1101,25 +1040,23 @@ Notification.isBadgeDisplayed(bundle).then((data) => {
-## Notification.setSlotByBundle(bundle: BundleOption, slot: NotificationSlot, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.setSlotByBundle
- 设定指定包的通知通道状态(Callback形式)
+setSlotByBundle(bundle: BundleOption, slot: NotificationSlot, callback: AsyncCallback\): void
-- setSlotByBundle参数描述
+设定指定包的通知通道状态(Callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| slot | 只读 | NotificationSlot | 是 | 通知通道 |
-| callback | 只读 | AsyncCallback\ | 是 | 设定通知通道回调函数 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| slot | 是 | 否 | NotificationSlot | 是 | 通知通道。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 设定通知通道回调函数。 |
-- 示例
+**示例:**
```js
function setSlotByBundleCallback(err) {
@@ -1136,24 +1073,22 @@ Notification.setSlotByBundle(bundle, notificationSlot, setSlotByBundleCallback);
-## Notification.setSlotByBundle(bundle: BundleOption, slot: NotificationSlot)
+## Notification.setSlotByBundle
-- 接口说明
+setSlotByBundle(bundle: BundleOption, slot: NotificationSlot): Promise\
- 设定指定包的角标使能状态(Promise形式)
+设定指定包的角标使能状态(Promise形式)。
-- setSlotByBundle参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| enable | 只读 | boolean | 是 | 使能状态 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| enable | 是 | 否 | boolean | 是 | 使能状态。 |
- Promise\
-
-- 示例
+**示例:**
```js
var bundle = {
@@ -1169,24 +1104,22 @@ Notification.displayBadge(bundle, notificationSlot).then(() => {
-## Notification.getSlotsByBundle(bundle: BundleOption, callback: AsyncCallback>)
-
-- 接口说明
+## Notification.getSlotsByBundle
- 获取指定包的通知通道(Callback形式)
+getSlotsByBundle(bundle: BundleOption, callback: AsyncCallback>): void
-- getSlotsByBundle参数描述
+获取指定包的通知通道(Callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ---------------------------------------- | ---- | -------------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| callback | 只读 | AsyncCallback> | 是 | 获取通知通道回调函数 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ---------------------------------------- | ---- | -------------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| callback | 是 | 否 | AsyncCallback> | 是 | 获取通知通道回调函数。 |
-- 示例
+**示例:**
```js
function getSlotsByBundleCallback(err, data) {
@@ -1200,23 +1133,27 @@ Notification.getSlotsByBundle(bundle, getSlotsByBundleCallback);
-## Notification.getSlotsByBundle(bundle: BundleOption)
+## Notification.getSlotsByBundle
-- 接口说明
+getSlotsByBundle(bundle: BundleOption): Promise>
- 获取指定包的通知通道(Promise形式)
+获取指定包的通知通道(Promise形式)。
-- getSlotsByBundle参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
- Promise>
+**返回值:**
-- 示例
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise> | 以Promise形式返回获取指定包的通知通道。 |
+
+**示例:**
```js
var bundle = {
@@ -1229,24 +1166,22 @@ Notification.getSlotsByBundle(bundle).then((data) => {
-## Notification.getSlotNumByBundle(bundle: BundleOption, callback: AsyncCallback\)
-
-- 接口说明
+## Notification.getSlotNumByBundle
- 获取指定包的通知通道数(Callback形式)
+getSlotNumByBundle(bundle: BundleOption, callback: AsyncCallback\): void
-- getSlotNumByBundle参数描述
+获取指定包的通知通道数(Callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ------------------------- | ---- | ---------------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| callback | 只读 | AsyncCallback\ | 是 | 获取通知通道数回调函数 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ------------------------- | ---- | ---------------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 获取通知通道数回调函数。 |
-- 示例
+**示例:**
```js
function getSlotNumByBundle(err, data) {
@@ -1260,23 +1195,27 @@ Notification.getSlotNumByBundle(bundle, getSlotNumByBundleCallback);
-## Notification.getSlotNumByBundle(bundle: BundleOption)
+## Notification.getSlotNumByBundle
+
+getSlotNumByBundle(bundle: BundleOption): Promise\
-- 接口说明
+获取指定包的通知通道数(Promise形式)。
- 获取指定包的通知通道数(Promise形式)
+**系统能力**:SystemCapability.Notification.Notification
-- getSlotNumByBundle参数描述
+**参数:**
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
-- 返回值
+**返回值:**
- Promise\
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取指定包的通知通道数。 |
-- 示例
+**示例:**
```js
var bundle = {
@@ -1289,25 +1228,23 @@ Notification.getSlotNumByBundle(bundle).then((data) => {
-## Notification.remove(bundle: BundleOption, notificationKey: NotificationKey, callback: AsyncCallback\)
+## Notification.remove
-- 接口说明
+remove(bundle: BundleOption, notificationKey: NotificationKey, callback: AsyncCallback\): void
- 删除指定通知(Callback形式)
+删除指定通知(Callback形式)。
-- remove参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------------- | -------- | ----------------------------------- | ---- | -------------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| notificationKey | 只读 | [NotificationKey](#notificationkey) | 是 | 通知键值 |
-| callback | 只读 | AsyncCallback\ | 是 | 删除指定通知回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------------- | ---- | --- | ----------------------------------- | ---- | -------------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| notificationKey | 是 | 否 | [NotificationKey](#notificationkey) | 是 | 通知键值。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 删除指定通知回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function removeCallback(err) {
@@ -1325,24 +1262,22 @@ Notification.remove(bundle, notificationKey, removeCallback);
-## Notification.remove(bundle: BundleOption, notificationKey: NotificationKey)
-
-- 接口说明
+## Notification.remove
- 删除指定通知(Promise形式)
+remove(bundle: BundleOption, notificationKey: NotificationKey): Promise\
-- remove参数描述
+删除指定通知(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------------- | -------- | --------------- | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| notificationKey | 只读 | [NotificationKey](#notificationkey) | 是 | 通知键值 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------------- | ---- | --- | --------------- | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| notificationKey | 是 | 否 | [NotificationKey](#notificationkey) | 是 | 通知键值。 |
-- 示例
+**示例:**
```js
var bundle = {
@@ -1359,24 +1294,22 @@ Notification.remove(bundle, notificationKey).then(() => {
-## Notification.remove(hashCode: string, callback: AsyncCallback\)
+## Notification.remove
-- 接口说明
+remove(hashCode: string, callback: AsyncCallback\): void
- 删除指定通知(Callback形式)
+删除指定通知(Callback形式)。
-- remove参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| hashCode | 只读 | string | 是 | 通知唯一ID |
-| callback | 只读 | AsyncCallback\ | 是 | 删除指定通知回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| hashCode | 是 | 否 | string | 是 | 通知唯一ID。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 删除指定通知回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function removeCallback(err) {
@@ -1388,23 +1321,21 @@ Notification.remove(hashCode, removeCallback);
-## Notification.remove(hashCode: string)
-
-- 接口说明
+## Notification.remove
- 删除指定通知(Promise形式)
+remove(hashCode: string): Promise\
-- remove参数描述
+删除指定通知(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ---------- | ---- | ---------- |
-| hashCode | 只读 | string | 是 | 通知唯一ID |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ---------- | ---- | ---------- |
+| hashCode | 是 | 否 | string | 是 | 通知唯一ID。 |
-- 示例
+**示例:**
```js
Notification.remove(hashCode).then(() => {
@@ -1414,24 +1345,22 @@ Notification.remove(hashCode).then(() => {
-## Notification.removeAll(bundle: BundleOption, callback: AsyncCallback\)
+## Notification.removeAll
-- 接口说明
+removeAll(bundle: BundleOption, callback: AsyncCallback\): void
- 删除指定包的所有通知(Callback形式)
+删除指定包的所有通知(Callback形式)。
-- removeAll参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | ---------------------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| callback | 只读 | AsyncCallback\ | 是 | 删除指定包的所有通知回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | ---------------------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 删除指定包的所有通知回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function removeAllCallback(err) {
@@ -1445,23 +1374,21 @@ Notification.removeAll(bundle, removeAllCallback);
-## Notification.removeAll(callback: AsyncCallback\)
-
-- 接口说明
+## Notification.removeAll
- 删除所有通知(Callback形式)
+removeAll(callback: AsyncCallback\): void
-- removeAll参数描述
+删除所有通知(Callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | -------------------- |
-| callback | 只读 | AsyncCallback\ | 是 | 删除所有通知回调函数 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | -------------------- |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 删除所有通知回调函数。 |
-- 示例
+**示例:**
```js
function removeAllCallback(err) {
@@ -1473,23 +1400,21 @@ Notification.removeAll(removeAllCallback);
-## Notification.removeAll(bundle?: BundleOption)
-
-- 接口说明
+## Notification.removeAll
- 删除所有通知(Promise形式)
+removeAll(bundle?: BundleOption): Promise\
-- removeAll参数描述
+删除所有通知(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------------ | ---- | ---------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 否 | 指定包信息 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------------ | ---- | ---------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 否 | 指定包信息。 |
-- 示例
+**示例:**
```js
Notification.removeAll().then(() => {
@@ -1499,23 +1424,21 @@ Notification.removeAll().then(() => {
-## Notification.getAllActiveNotifications(callback: AsyncCallback>)
+## Notification.getAllActiveNotifications
-- 接口说明
+getAllActiveNotifications(callback: AsyncCallback>): void
- 获取活动通知(Callback形式)
+获取活动通知(Callback形式)。
-- getAllActiveNotifications参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ------------------------------------------------------------ | ---- | -------------------- |
-| callback | 只读 | AsyncCallback> | 是 | 获取活动通知回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ------------------------------------------------------------ | ---- | -------------------- |
+| callback | 是 | 否 | AsyncCallback> | 是 | 获取活动通知回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function getAllActiveNotificationsCallback(err, data) {
@@ -1527,21 +1450,21 @@ Notification.getAllActiveNotifications(getAllActiveNotificationsCallback);
-## Notification.getAllActiveNotifications()
-
-- 接口说明
+## Notification.getAllActiveNotifications
- 获取活动通知(Promise形式)
+getAllActiveNotifications(): Promise\\>
-- getAllActiveNotifications参数描述
+获取活动通知(Promise形式)。
- 无
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**返回值:**
- Promise\\>
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\\> | 以Promise形式返回获取活动通知。 |
-- 示例
+**示例:**
```js
Notification.getAllActiveNotifications().then((data) => {
@@ -1551,23 +1474,21 @@ Notification.getAllActiveNotifications().then((data) => {
-## Notification.getActiveNotificationCount(callback: AsyncCallback\)
+## Notification.getActiveNotificationCount
-- 接口说明
+getActiveNotificationCount(callback: AsyncCallback\): void
- 获取当前应用的活动通知数(Callback形式)
+获取当前应用的活动通知数(Callback形式)。
-- getActiveNotificationCount参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ---------------------- | ---- | ---------------------- |
-| callback | 只读 | AsyncCallback\ | 是 | 获取活动通知数回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ---------------------- | ---- | ---------------------- |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 获取活动通知数回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function getActiveNotificationCountCallback(err, data) {
@@ -1579,21 +1500,21 @@ Notification.getActiveNotificationCount(getActiveNotificationCountCallback);
-## Notification.getActiveNotificationCount()
-
-- 接口说明
+## Notification.getActiveNotificationCount
- 获取当前应用的活动通知数(Promise形式)
+getActiveNotificationCount(): Promise\
-- getActiveNotificationCount参数描述
+获取当前应用的活动通知数(Promise形式)。
- 无
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**返回值:**
- 返回值为Promise\
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取当前应用的活动通知数。 |
-- 示例
+**示例:**
```js
Notification.getActiveNotificationCount().then((data) => {
@@ -1603,23 +1524,21 @@ Notification.getActiveNotificationCount().then((data) => {
-## Notification.getActiveNotifications(callback: AsyncCallback>)
+## Notification.getActiveNotifications
-- 接口说明
+getActiveNotifications(callback: AsyncCallback>): void
- 获取当前应用的活动通知(Callback形式)
+获取当前应用的活动通知(Callback形式)。
-- getActiveNotifications参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ------------------------------------------------------------ | ---- | ------------------------------ |
-| callback | 只读 | AsyncCallback> | 是 | 获取当前应用的活动通知回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ------------------------------------------------------------ | ---- | ------------------------------ |
+| callback | 是 | 否 | AsyncCallback> | 是 | 获取当前应用的活动通知回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function getActiveNotificationsCallback(err, data) {
@@ -1631,21 +1550,21 @@ Notification.getActiveNotifications(getActiveNotificationsCallback);
-## Notification.getActiveNotifications()
-
-- 接口说明
+## Notification.getActiveNotifications
- 获取当前应用的活动通知(Promise形式)
+getActiveNotifications(): Promise\\>
-- getActiveNotifications参数描述
+获取当前应用的活动通知(Promise形式)。
- 无
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**返回值:**
- Promise\\>
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\\> | 以Promise形式返回获取当前应用的活动通知。 |
-- 示例
+**示例:**
```js
Notification.getActiveNotifications().then((data) => {
@@ -1655,24 +1574,22 @@ Notification.getActiveNotifications().then((data) => {
-## Notification.cancelGroup(groupName: string, callback: AsyncCallback\)
+## Notification.cancelGroup
-- 接口说明
+cancelGroup(groupName: string, callback: AsyncCallback\): void
- 取消本应用指定组通知(Callback形式)
+取消本应用指定组通知(Callback形式)。
-- cancelGroup参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------- | -------- | --------------------- | ---- | ---------------------------- |
-| groupName | 只读 | string | 是 | 指定通知组名称 |
-| callback | 只读 | AsyncCallback\ | 是 | 取消本应用指定组通知回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------- | ---- | --- | --------------------- | ---- | ---------------------------- |
+| groupName | 是 | 否 | string | 是 | 指定通知组名称。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 取消本应用指定组通知回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function cancelGroupCallback(err) {
@@ -1686,23 +1603,21 @@ Notification.cancelGroup(groupName, cancelGroupCallback);
-## Notification.cancelGroup(groupName: string)
-
-- 接口说明
+## Notification.cancelGroup
- 取消本应用指定组通知(Promise形式)
+cancelGroup(groupName: string): Promise\
-- cancelGroup参数描述
+取消本应用指定组通知(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------- | -------- | ------ | ---- | -------------- |
-| groupName | 只读 | string | 是 | 指定通知组名称 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------- | ---- | --- | ------ | ---- | -------------- |
+| groupName | 是 | 否 | string | 是 | 指定通知组名称。 |
-- 示例
+**示例:**
```js
var groupName = "GroupName";
@@ -1713,25 +1628,23 @@ Notification.cancelGroup(groupName).then(() => {
-## Notification.removeGroupByBundle(bundle: BundleOption, groupName: string, callback: AsyncCallback\)
+## Notification.removeGroupByBundle
-- 接口说明
+removeGroupByBundle(bundle: BundleOption, groupName: string, callback: AsyncCallback\): void
- 删除指定应用指定组通知(Callback形式)
+删除指定应用指定组通知(Callback形式)。
-- removeGroupByBundle参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------- | -------- | --------------------- | ---- | ---------------------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| groupName | 只读 | string | 是 | 指定通知组名称 |
-| callback | 只读 | AsyncCallback\ | 是 | 删除本应用指定组通知回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------- | ---- | --- | --------------------- | ---- | ---------------------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| groupName | 是 | 否 | string | 是 | 指定通知组名称。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 删除本应用指定组通知回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function removeGroupByBundleCallback(err) {
@@ -1746,24 +1659,22 @@ Notification.removeGroupByBundle(bundleOption, groupName, removeGroupByBundleCal
-## Notification.removeGroupByBundle(bundle: BundleOption, groupName: string)
-
-- 接口说明
+## Notification.removeGroupByBundle
- 删除指定应用指定组通知(Promise形式)
+removeGroupByBundle(bundle: BundleOption, groupName: string): Promise\
-- removeGroupByBundle参数描述
+删除指定应用指定组通知(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------- | -------- | ------------ | ---- | -------------- |
-| bundle | 只读 | [BundleOption](#bundleoption) | 是 | 指定包信息 |
-| groupName | 只读 | string | 是 | 指定通知组名称 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------- | ---- | --- | ------------ | ---- | -------------- |
+| bundle | 是 | 否 | [BundleOption](#bundleoption) | 是 | 指定包信息。 |
+| groupName | 是 | 否 | string | 是 | 指定通知组名称。 |
-- 示例
+**示例:**
```js
var bundleOption = {bundle: "Bundle"};
@@ -1775,24 +1686,22 @@ Notification.removeGroupByBundle(bundleOption, groupName).then(() => {
-## Notification.setDoNotDisturbDate(date: DoNotDisturbDate, callback: AsyncCallback\)
+## Notification.setDoNotDisturbDate
-- 接口说明
+setDoNotDisturbDate(date: DoNotDisturbDate, callback: AsyncCallback\): void
- 设置免打扰时间(Callback形式)
+设置免打扰时间(Callback形式)。
-- setDoNotDisturbDate参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------- | ---- | ---------------------- |
-| date | 只读 | DoNotDisturbDate | 是 | 免打扰时间选项 |
-| callback | 只读 | AsyncCallback\ | 是 | 设置免打扰时间回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------- | ---- | ---------------------- |
+| date | 是 | 否 | DoNotDisturbDate | 是 | 免打扰时间选项。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 设置免打扰时间回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function setDoNotDisturbDateCallback(err) {
@@ -1810,23 +1719,21 @@ Notification.setDoNotDisturbDate(doNotDisturbDate, setDoNotDisturbDateCallback);
-## Notification.setDoNotDisturbDate(date: DoNotDisturbDate)
-
-- 接口说明
+## Notification.setDoNotDisturbDate
- 设置免打扰时间接口(Promise形式)
+setDoNotDisturbDate(date: DoNotDisturbDate): Promise\
-- setDoNotDisturbDate参数描述
+设置免打扰时间接口(Promise形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---- | -------- | ---------------- | ---- | -------------- |
-| date | 只读 | DoNotDisturbDate | 是 | 免打扰时间选项 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- Promise\
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---- | ---- | --- | ---------------- | ---- | -------------- |
+| date | 是 | 否 | DoNotDisturbDate | 是 | 免打扰时间选项。 |
-- 示例
+**示例:**
```js
var doNotDisturbDate = {
@@ -1841,23 +1748,21 @@ Notification.setDoNotDisturbDate(doNotDisturbDate).then(() => {
-## Notification.getDoNotDisturbDate(callback: AsyncCallback\)
+## Notification.getDoNotDisturbDate
-- 接口说明
+getDoNotDisturbDate(callback: AsyncCallback\): void
- 查询免打扰时间接口(Callback形式)
+查询免打扰时间接口(Callback形式)。
-- getDoNotDisturbDate参数描述
+**系统能力**:SystemCapability.Notification.Notification
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | --------------------------------- | ---- | ---------------------- |
-| callback | 只读 | AsyncCallback\ | 是 | 查询免打扰时间回调函数 |
+**参数:**
-- 返回值
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | --------------------------------- | ---- | ---------------------- |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 查询免打扰时间回调函数。 |
- void
-
-- 示例
+**示例:**
```js
function getDoNotDisturbDateCallback(err,data) {
@@ -1869,21 +1774,21 @@ Notification.getDoNotDisturbDate(getDoNotDisturbDateCallback);
-## Notification.getDoNotDisturbDate()
-
-- 接口说明
+## Notification.getDoNotDisturbDate
- 查询免打扰时间接口(Promise形式)
+getDoNotDisturbDate(): Promise\
-- getDoNotDisturbDate参数描述
+查询免打扰时间接口(Promise形式)。
- 无
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**返回值:**
- Promise\
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取查询免打扰时间接口。 |
-- 示例
+**示例:**
```js
Notification.getDoNotDisturbDate().then((data) => {
@@ -1893,23 +1798,21 @@ Notification.getDoNotDisturbDate().then((data) => {
-## Notification.supportDoNotDisturbMode(callback: AsyncCallback\)
-
-- 接口说明
+## Notification.supportDoNotDisturbMode
- 查询是否支持勿扰模式功能(Callback形式)
+supportDoNotDisturbMode(callback: AsyncCallback\): void
-- supportDoNotDisturbMode参数描述
+查询是否支持勿扰模式功能(Callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ------------------------ | ---- | -------------------------------- |
-| callback | 只读 | AsyncCallback\ | 是 | 查询是否支持勿扰模式功能回调函数 |
+**系统能力**:SystemCapability.Notification.Notification
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ------------------------ | ---- | -------------------------------- |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 查询是否支持勿扰模式功能回调函数。 |
-- 示例
+**示例:**
```js
function supportDoNotDisturbModeCallback(err,data) {
@@ -1921,21 +1824,21 @@ Notification.supportDoNotDisturbMode(supportDoNotDisturbModeCallback);
-## Notification.supportDoNotDisturbMode()
+## Notification.supportDoNotDisturbMode
-- 接口说明
+supportDoNotDisturbMode(): Promise\
- 查询是否支持勿扰模式功能(Promise形式)
+查询是否支持勿扰模式功能(Promise形式)。
-- supportDoNotDisturbMode参数描述
+**系统能力**:SystemCapability.Notification.Notification
- 无
+**返回值:**
-- 返回值
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取是否支持勿扰模式功能的结果。 |
- Promise\
-
-- 示例
+**示例:**
```js
Notification.supportDoNotDisturbMode().then((data) => {
@@ -1951,14 +1854,16 @@ isSupportTemplate(templateName: string, callback: AsyncCallback\): voi
查询模板是否存在。
-- 参数
+**系统能力**:SystemCapability.Notification.Notification
+
+**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------------------------ | ---- | -------------------------- |
-| templateName | string | 是 | 模板名称 |
-| callback | AsyncCallback\ | 是 | 查询模板是否存在的回调函数 |
+| templateName | string | 是 | 模板名称。 |
+| callback | AsyncCallback\ | 是 | 查询模板是否存在的回调函数。 |
-- 示例
+**示例:**
```javascript
var templateName = 'process';
@@ -1977,19 +1882,21 @@ isSupportTemplate(templateName: string): Promise\
查询模板是否存在。
-- 参数
+**系统能力**:SystemCapability.Notification.Notification
+
+**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------ | ---- | -------- |
-| templateName | string | 是 | 模板名称 |
+| templateName | string | 是 | 模板名称。 |
-- 返回值
+**返回值:**
| 类型 | 说明 |
| ------------------ | --------------- |
-| Promise\ | Promise方式返回 |
+| Promise\ | Promise方式返回模板是否存在的结果。 |
-- 示例
+**示例:**
```javascript
var templateName = 'process';
@@ -2007,13 +1914,15 @@ requestEnabledNotification(callback: AsyncCallback\): void
应用请求通知使能。
-- 参数
+**系统能力**:SystemCapability.Notification.Notification
+
+**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ---- | -------------------------- |
-| callback | AsyncCallback\ | 是 | 查询模板是否存在的回调函数 |
+| callback | AsyncCallback\ | 是 | 查询模板是否存在的回调函数。 |
-- 示例
+**示例:**
```javascript
function requestEnabledNotificationCallback(err) {
@@ -2035,13 +1944,15 @@ requestEnabledNotification(callback: AsyncCallback\): void
应用请求通知使能。
-- 返回值
+**系统能力**:SystemCapability.Notification.Notification
+
+**返回值:**
| 类型 | 说明 |
| ------------------ | --------------- |
-| Promise\ | Promise方式返回 |
+| Promise\ | Promise方式返回应用请求通知使能。 |
-- 示例
+**示例:**
```javascript
Notification.isNotificationEnabledSelf()
@@ -2054,18 +1965,49 @@ Notification.isNotificationEnabledSelf()
```
+## Notification.show
+
+show(options?: ShowNotificationOptions): void
+
+展示通知事件。
+
+**系统能力**:SystemCapability.Notification.Notification
+
+**参数:**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------- | ------------------------ | ---- | ---------------- |
+| options | ShowNotificationOptions | 否 | 需要展示通知的参数 |
+
+**示例:**
+
+```javascript
+var options = {
+ contentTitle: 'contentTitle',
+ contentText: 'contentText',
+ clickAction: {
+ bundleName: 'bundleName',
+ abilityName: 'abilityName',
+ uri: 'uri',
+ }
+};
+
+Notification.show(options);
+```
+
+
## NotificationSubscriber
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------------------------------------------------------------ | -------- | -------- | ---- | -------------------------- |
-| onConsume?:(data: [SubscribeCallbackData](#subscribecallbackdata)) | 读、写 | function | 否 | 接收通知回调函数 |
-| onCancel?:(data: [SubscribeCallbackData](#subscribecallbackdata)) | 读、写 | function | 否 | 删除通知回调函数 |
-| onUpdate?:(data: [NotificationSortingMap](#notificationsortingmap)) | 读、写 | function | 否 | 更新通知排序回调函数 |
-| onConnect?:() | 读、写 | function | 否 | 注册订阅回调函数 |
-| onDisconnect?:() | 读、写 | function | 否 | 取消订阅回调函数 |
-| onDestroy?:() | 读、写 | function | 否 | 服务失联回调函数 |
-| onDoNotDisturbDateChange?:(mode: Notification.[DoNotDisturbDate](#donotdisturbdate)) | 读、写 | function | 否 | 免打扰时间选项变更回调函数 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------------------------------------------------------------ | ---- | --- | -------- | ---- | -------------------------- |
+| onConsume?:(data: [SubscribeCallbackData](#subscribecallbackdata)) | 是 | 否 | function | 否 | 接收通知回调函数。
**系统能力**:SystemCapability.Notification.Notification |
+| onCancel?:(data: [SubscribeCallbackData](#subscribecallbackdata)) | 是 | 否 | function | 否 | 删除通知回调函数。
**系统能力**:SystemCapability.Notification.Notification |
+| onUpdate?:(data: [NotificationSortingMap](#notificationsortingmap)) | 是 | 否 | function | 否 | 更新通知排序回调函数。
**系统能力**:SystemCapability.Notification.Notification |
+| onConnect?:() | 是 | 否 | function | 否 | 注册订阅回调函数。
**系统能力**:SystemCapability.Notification.Notification |
+| onDisconnect?:() | 是 | 否 | function | 否 | 取消订阅回调函数。
**系统能力**:SystemCapability.Notification.Notification |
+| onDestroy?:() | 是 | 否 | function | 否 | 服务失联回调函数。
**系统能力**:SystemCapability.Notification.Notification |
+| onDoNotDisturbDateChange?:(mode: Notification.[DoNotDisturbDate](#donotdisturbdate)) | 是 | 否 | function | 否 | 免打扰时间选项变更回调函数。
**系统能力**:SystemCapability.Notification.Notification |
### onEnabledNotificationChanged
@@ -2073,13 +2015,15 @@ onEnabledNotificationChanged?:(callbackData: [EnabledNotificationCallbackData](#
监听应用通知使能变化。
-- 参数
+**系统能力**:SystemCapability.Notification.Notification
+
+**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | ------------------------ | ---- | -------------------------- |
-| callback | AsyncCallback\<[EnabledNotificationCallbackData](#enablednotificationcallbackdata)\> | 是 | 回调返回监听到的应用信息 |
+| callback | AsyncCallback\<[EnabledNotificationCallbackData](#enablednotificationcallbackdata)\> | 是 | 回调返回监听到的应用信息。 |
-- 示例
+**示例:**
```javascript
function subscribeCallback(err) {
@@ -2111,42 +2055,42 @@ Notification.subscribe(subscriber, subscribeCallback);
## SubscribeCallbackData
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------------- | -------- | ------------------------------------------------- | ---- | -------- |
-| request | 只读 | [NotificationRequest](#notificationrequest) | 是 | 通知内容 |
-| sortingMap | 只读 | [NotificationSortingMap](#notificationsortingmap) | 否 | 排序信息 |
-| reason | 只读 | number | 否 | 删除原因 |
-| sound | 只读 | string | 否 | 通知声音 |
-| vibrationValues | 只读 | Array\ | 否 | 通知震动 |
-
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------------- | ---- | --- | ------------------------------------------------- | ---- | -------- |
+| request | 是 | 否 | [NotificationRequest](#notificationrequest) | 是 | 通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| sortingMap | 是 | 否 | [NotificationSortingMap](#notificationsortingmap) | 否 | 排序信息。
**系统能力**:SystemCapability.Notification.Notification |
+| reason | 是 | 否 | number | 否 | 删除原因。
**系统能力**:SystemCapability.Notification.Notification |
+| sound | 是 | 否 | string | 否 | 通知声音。
**系统能力**:SystemCapability.Notification.Notification |
+| vibrationValues | 是 | 否 | Array\ | 否 | 通知震动。
**系统能力**:SystemCapability.Notification.Notification |
+。
**系统能力**:SystemCapability.Notification.Notification
## NotificationSortingMap
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------------- | -------- | ------------------------------------------------------------ | ---- | ---------------- |
-| sortings | 只读 | {[key: string]: [NotificationSorting](#notificationsorting)} | 是 | 通知排序信息数组 |
-| sortedHashCode | 只读 | Array\ | 是 | 通知唯一标识数组 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------------- | ---- | --- | ------------------------------------------------------------ | ---- | ---------------- |
+| sortings | 是 | 否 | {[key: string]: [NotificationSorting](#notificationsorting)} | 是 | 通知排序信息数组。
**系统能力**:SystemCapability.Notification.Notification |
+| sortedHashCode | 是 | 否 | Array\ | 是 | 通知唯一标识数组。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationSorting
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ------------------------------------- | ---- | ------------ |
-| slot | 只读 | [NotificationSlot](#notificationslot) | 是 | 通知通道内容 |
-| hashCode | 只读 | string | 是 | 通知唯一标识 |
-| ranking | 只读 | number | 是 | 通知排序序号 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | ---- | --- | ------------------------------------- | ---- | ------------ |
+| slot | 是 | 否 | [NotificationSlot](#notificationslot) | 是 | 通知通道内容。
**系统能力**:SystemCapability.Notification.Notification |
+| hashCode | 是 | 否 | string | 是 | 通知唯一标识。
**系统能力**:SystemCapability.Notification.Notification |
+| ranking | 是 | 否 | number | 是 | 通知排序序号。
**系统能力**:SystemCapability.Notification.Notification |
## DoNotDisturbDate
-| 名称 | 读写属性 | 类型 | 描述 |
-| ----- | -------- | ------------------------------------- | ------------------------ |
-| type | 读写 | [DoNotDisturbType](#donotdisturbtype) | 指定免打扰设置的时间类型 |
-| begin | 读写 | Date | 指定免打扰设置的起点时间 |
-| end | 读写 | Date | 指定免打扰设置的终点时间 |
+| 名称 | 可读 | 可写 | 类型 | 描述 |
+| ----- | ---- | --- | ------------------------------------- | ------------------------ |
+| type | 是 | 否 | [DoNotDisturbType](#donotdisturbtype) | 指定免打扰设置的时间类型。
**系统能力**:SystemCapability.Notification.Notification |
+| begin | 是 | 否 | Date | 指定免打扰设置的起点时间。
**系统能力**:SystemCapability.Notification.Notification |
+| end | 是 | 否 | Date | 指定免打扰设置的终点时间。
**系统能力**:SystemCapability.Notification.Notification |
@@ -2155,85 +2099,85 @@ Notification.subscribe(subscriber, subscribeCallback);
| 名称 | 值 | 说明 |
| ------------ | ---------------- | ---------------------------------------- |
-| TYPE_NONE | DoNotDisturbType | 非通知勿扰类型 |
-| TYPE_ONCE | DoNotDisturbType | 以设置时间段(只看小时和分钟)一次执行勿扰 |
-| TYPE_DAILY | DoNotDisturbType | 以设置时间段(只看小时和分钟)每天执行勿扰 |
-| TYPE_CLEARLY | DoNotDisturbType | 以设置时间段(明确年月日时分)执行勿扰 |
+| TYPE_NONE | DoNotDisturbType | 非通知勿扰类型。
**系统能力**:SystemCapability.Notification.Notification |
+| TYPE_ONCE | DoNotDisturbType | 以设置时间段(只看小时和分钟)一次执行勿扰。
**系统能力**:SystemCapability.Notification.Notification |
+| TYPE_DAILY | DoNotDisturbType | 以设置时间段(只看小时和分钟)每天执行勿扰。
**系统能力**:SystemCapability.Notification.Notification |
+| TYPE_CLEARLY | DoNotDisturbType | 以设置时间段(明确年月日时分)执行勿扰。
**系统能力**:SystemCapability.Notification.Notification |
## EnabledNotificationCallbackData
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------- | ---- | ---------------- |
-| bundle | 只读 | string | 否 | 应用的包名 |
-| uid | 只读 | number | 否 | 应用的uid |
-| enable | 只读 | boolean | 否 | 应用通知使能状态 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------- | ---- | ---------------- |
+| bundle | 是 | 否 | string | 否 | 应用的包名。
**系统能力**:SystemCapability.Notification.Notification |
+| uid | 是 | 否 | number | 否 | 应用的uid。
**系统能力**:SystemCapability.Notification.Notification |
+| enable | 是 | 否 | boolean | 否 | 应用通知使能状态。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationRequest
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------------------- | -------- | --------------------------------------------- | ---- | -------------------------- |
-| content | 读、写 | [NotificationContent](#notificationcontent) | 是 | 通知内容 |
-| id | 读、写 | number | 否 | 通知ID |
-| slotType | 读、写 | [SlotType](#slottype) | 否 | 通道类型 |
-| isOngoing | 读、写 | boolean | 否 | 是否进行时通知 |
-| isUnremovable | 读、写 | boolean | 否 | 是否可移除 |
-| deliveryTime | 读、写 | number | 否 | 通知发送时间 |
-| tapDismissed | 读、写 | boolean | 否 | 通知是否自动清除 |
-| autoDeletedTime | 读、写 | number | 否 | 自动清除的时间 |
-| wantAgent | 读、写 | WantAgent | 否 | 点击跳转的WantAgent |
-| extraInfo | 读、写 | {[key: string]: any} | 否 | 扩展参数 |
-| color | 读、写 | number | 否 | 通知背景颜色 |
-| colorEnabled | 读、写 | boolean | 否 | 通知背景颜色是否使能 |
-| isAlertOnce | 读、写 | boolean | 否 | 设置是否仅有一次此通知警报 |
-| isStopwatch | 读、写 | boolean | 否 | 是否显示已用时间 |
-| isCountDown | 读、写 | boolean | 否 | 是否显示倒计时时间 |
-| isFloatingIcon | 读、写 | boolean | 否 | 是否显示状态栏图标 |
-| label | 读、写 | string | 否 | 通知标签 |
-| badgeIconStyle | 读、写 | number | 否 | 通知角标类型 |
-| showDeliveryTime | 读、写 | boolean | 否 | 是否显示分发时间 |
-| actionButtons | 读、写 | Array\<[NotificationActionButton](#notificationactionbutton)\> | 否 | 通知按钮,最多两个按钮 |
-| smallIcon | 读、写 | PixelMap | 否 | 通知小图标 |
-| largeIcon | 读、写 | PixelMap | 否 | 通知大图标 |
-| creatorBundleName | 只读 | string | 否 | 创建通知的包名 |
-| creatorUid | 只读 | number | 否 | 创建通知的UID |
-| creatorPid | 只读 | number | 否 | 创建通知的PID |
-| hashCode | 只读 | string | 否 | 通知唯一标识 |
-| classification | 读、写 | string | 否 | 通知分类 |
-| groupName | 读、写 | string | 否 | 组通知名称 |
-| template8+ | 读、写 | [NotificationTemplate](#notificationtemplate) | 否 | 通知模板 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------------------- | ---- | --- | --------------------------------------------- | ---- | -------------------------- |
+| content | 是 | 是 | [NotificationContent](#notificationcontent) | 是 | 通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| id | 是 | 是 | number | 否 | 通知ID。
**系统能力**:SystemCapability.Notification.Notification |
+| slotType | 是 | 是 | [SlotType](#slottype) | 否 | 通道类型。
**系统能力**:SystemCapability.Notification.Notification |
+| isOngoing | 是 | 是 | boolean | 否 | 是否进行时通知。
**系统能力**:SystemCapability.Notification.Notification |
+| isUnremovable | 是 | 是 | boolean | 否 | 是否可移除。
**系统能力**:SystemCapability.Notification.Notification |
+| deliveryTime | 是 | 是 | number | 否 | 通知发送时间。
**系统能力**:SystemCapability.Notification.Notification |
+| tapDismissed | 是 | 是 | boolean | 否 | 通知是否自动清除。
**系统能力**:SystemCapability.Notification.Notification |
+| autoDeletedTime | 是 | 是 | number | 否 | 自动清除的时间。
**系统能力**:SystemCapability.Notification.Notification |
+| wantAgent | 是 | 是 | WantAgent | 否 | 点击跳转的WantAgent。
**系统能力**:SystemCapability.Notification.Notification |
+| extraInfo | 是 | 是 | {[key: string]: any} | 否 | 扩展参数。
**系统能力**:SystemCapability.Notification.Notification |
+| color | 是 | 是 | number | 否 | 通知背景颜色。
**系统能力**:SystemCapability.Notification.Notification |
+| colorEnabled | 是 | 是 | boolean | 否 | 通知背景颜色是否使能。
**系统能力**:SystemCapability.Notification.Notification |
+| isAlertOnce | 是 | 是 | boolean | 否 | 设置是否仅有一次此通知警报。
**系统能力**:SystemCapability.Notification.Notification |
+| isStopwatch | 是 | 是 | boolean | 否 | 是否显示已用时间。
**系统能力**:SystemCapability.Notification.Notification |
+| isCountDown | 是 | 是 | boolean | 否 | 是否显示倒计时时间。
**系统能力**:SystemCapability.Notification.Notification |
+| isFloatingIcon | 是 | 是 | boolean | 否 | 是否显示状态栏图标。
**系统能力**:SystemCapability.Notification.Notification |
+| label | 是 | 是 | string | 否 | 通知标签。
**系统能力**:SystemCapability.Notification.Notification |
+| badgeIconStyle | 是 | 是 | number | 否 | 通知角标类型。
**系统能力**:SystemCapability.Notification.Notification |
+| showDeliveryTime | 是 | 是 | boolean | 否 | 是否显示分发时间。
**系统能力**:SystemCapability.Notification.Notification |
+| actionButtons | 是 | 是 | Array\<[NotificationActionButton](#notificationactionbutton)\> | 否 | 通知按钮,最多两个按钮。
**系统能力**:SystemCapability.Notification.Notification |
+| smallIcon | 是 | 是 | PixelMap | 否 | 通知小图标。
**系统能力**:SystemCapability.Notification.Notification |
+| largeIcon | 是 | 是 | PixelMap | 否 | 通知大图标。
**系统能力**:SystemCapability.Notification.Notification |
+| creatorBundleName | 是 | 否 | string | 否 | 创建通知的包名。
**系统能力**:SystemCapability.Notification.Notification |
+| creatorUid | 是 | 否 | number | 否 | 创建通知的UID。
**系统能力**:SystemCapability.Notification.Notification |
+| creatorPid | 是 | 否 | number | 否 | 创建通知的PID。
**系统能力**:SystemCapability.Notification.Notification |
+| hashCode | 是 | 否 | string | 否 | 通知唯一标识。
**系统能力**:SystemCapability.Notification.Notification |
+| classification | 是 | 是 | string | 否 | 通知分类。
**系统能力**:SystemCapability.Notification.Notification |
+| groupName | 是 | 是 | string | 否 | 组通知名称。
**系统能力**:SystemCapability.Notification.Notification |
+| template8+ | 是 | 是 | [NotificationTemplate](#notificationtemplate) | 否 | 通知模板。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationSlot
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------------------- | -------- | --------------------- | ---- | ------------------------------------------ |
-| type | 读、写 | [SlotType](#slottype) | 是 | 通道类型 |
-| level | 读、写 | number | 否 | 通知级别,不设置则根据通知渠道类型有默认值 |
-| desc | 读、写 | string | 否 | 通知渠道描述信息 |
-| badgeFlag | 读、写 | boolean | 否 | 是否显示角标 |
-| bypassDnd | 读、写 | boolean | 否 | 置是否在系统中绕过免打扰模式 |
-| lockscreenVisibility | 读、写 | boolean | 否 | 在锁定屏幕上显示通知的模式 |
-| vibrationEnabled | 读、写 | boolean | 否 | 是否可振动 |
-| sound | 读、写 | string | 否 | 通知提示音 |
-| lightEnabled | 读、写 | boolean | 否 | 是否闪灯 |
-| lightColor | 读、写 | number | 否 | 通知灯颜色 |
-| vibrationValues | 读、写 | Array\ | 否 | 通知振动样式 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------------------- | ---- | --- | --------------------- | ---- | ------------------------------------------ |
+| type | 是 | 是 | [SlotType](#slottype) | 是 | 通道类型。
**系统能力**:SystemCapability.Notification.Notification |
+| level | 是 | 是 | number | 否 | 通知级别,不设置则根据通知渠道类型有默认值。
**系统能力**:SystemCapability.Notification.Notification |
+| desc | 是 | 是 | string | 否 | 通知渠道描述信息。
**系统能力**:SystemCapability.Notification.Notification |
+| badgeFlag | 是 | 是 | boolean | 否 | 是否显示角标。
**系统能力**:SystemCapability.Notification.Notification |
+| bypassDnd | 是 | 是 | boolean | 否 | 置是否在系统中绕过免打扰模式。
**系统能力**:SystemCapability.Notification.Notification |
+| lockscreenVisibility | 是 | 是 | boolean | 否 | 在锁定屏幕上显示通知的模式。
**系统能力**:SystemCapability.Notification.Notification |
+| vibrationEnabled | 是 | 是 | boolean | 否 | 是否可振动。
**系统能力**:SystemCapability.Notification.Notification |
+| sound | 是 | 是 | string | 否 | 通知提示音。
**系统能力**:SystemCapability.Notification.Notification |
+| lightEnabled | 是 | 是 | boolean | 否 | 是否闪灯。
**系统能力**:SystemCapability.Notification.Notification |
+| lightColor | 是 | 是 | number | 否 | 通知灯颜色。
**系统能力**:SystemCapability.Notification.Notification |
+| vibrationValues | 是 | 是 | Array\ | 否 | 通知振动样式。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationContent
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ----------- | -------- | ------------------------------------------------------------ | ---- | ------------------ |
-| contentType | 读、写 | [ContentType](#contenttype) | 是 | 通知内容类型 |
-| normal | 读、写 | [NotificationBasicContent](#notificationbasiccontent) | 否 | 基本类型通知内容 |
-| longText | 读、写 | [NotificationLongTextContent](#notificationlongtextcontent) | 否 | 长文本类型通知内容 |
-| multiLine | 读、写 | [NotificationMultiLineContent](#notificationmultilinecontent) | 否 | 多行类型通知内容 |
-| picture | 读、写 | [NotificationPictureContent](#notificationpicturecontent) | 否 | 图片类型通知内容 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ----------- | ---- | --- | ------------------------------------------------------------ | ---- | ------------------ |
+| contentType | 是 | 是 | [ContentType](#contenttype) | 是 | 通知内容类型。
**系统能力**:SystemCapability.Notification.Notification |
+| normal | 是 | 是 | [NotificationBasicContent](#notificationbasiccontent) | 否 | 基本类型通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| longText | 是 | 是 | [NotificationLongTextContent](#notificationlongtextcontent) | 否 | 长文本类型通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| multiLine | 是 | 是 | [NotificationMultiLineContent](#notificationmultilinecontent) | 否 | 多行类型通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| picture | 是 | 是 | [NotificationPictureContent](#notificationpicturecontent) | 否 | 图片类型通知内容。
**系统能力**:SystemCapability.Notification.Notification |
@@ -2241,78 +2185,78 @@ Notification.subscribe(subscriber, subscribeCallback);
| 名称 | 值 | 说明 |
| --------------------------------- | ----------- | ---------------- |
-| NOTIFICATION_CONTENT_BASIC_TEXT | ContentType | 普通类型通知 |
-| NOTIFICATION_CONTENT_LONG_TEXT | ContentType | 长文本类型通知 |
-| NOTIFICATION_CONTENT_PICTURE | ContentType | 图片类型通知 |
-| NOTIFICATION_CONTENT_CONVERSATION | ContentType | 社交类型通知 |
-| NOTIFICATION_CONTENT_MULTILINE | ContentType | 多行文本类型通知 |
+| NOTIFICATION_CONTENT_BASIC_TEXT | ContentType | 普通类型通知。
**系统能力**:SystemCapability.Notification.Notification |
+| NOTIFICATION_CONTENT_LONG_TEXT | ContentType | 长文本类型通知。
**系统能力**:SystemCapability.Notification.Notification |
+| NOTIFICATION_CONTENT_PICTURE | ContentType | 图片类型通知。
**系统能力**:SystemCapability.Notification.Notification |
+| NOTIFICATION_CONTENT_CONVERSATION | ContentType | 社交类型通知。
**系统能力**:SystemCapability.Notification.Notification |
+| NOTIFICATION_CONTENT_MULTILINE | ContentType | 多行文本类型通知。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationBasicContent
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------------- | -------- | ------ | ---- | -------------------------------- |
-| title | 读、写 | string | 是 | 通知标题 |
-| text | 读、写 | string | 是 | 通知内容 |
-| additionalText | 读、写 | string | 是 | 通知次要内容,是对通知内容的补充 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------------- | ---- |--- | ------ | ---- | -------------------------------- |
+| title | 是 | 是 | string | 是 | 通知标题。
**系统能力**:SystemCapability.Notification.Notification |
+| text | 是 | 是 | string | 是 | 通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| additionalText | 是 | 是 | string | 是 | 通知次要内容,是对通知内容的补充。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationLongTextContent
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------------- | -------- | ------ | ---- | -------------------------------- |
-| title | 读、写 | string | 是 | 通知标题 |
-| text | 读、写 | string | 是 | 通知内容 |
-| additionalText | 读、写 | string | 是 | 通知次要内容,是对通知内容的补充 |
-| longText | 读、写 | string | 是 | 通知的长文本 |
-| briefText | 读、写 | string | 是 | 通知概要内容,是对通知内容的总结 |
-| expandedTitle | 读、写 | string | 是 | 通知展开时的标题 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------------- | ---- | --- | ------ | ---- | -------------------------------- |
+| title | 是 | 是 | string | 是 | 通知标题。
**系统能力**:SystemCapability.Notification.Notification |
+| text | 是 | 是 | string | 是 | 通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| additionalText | 是 | 是 | string | 是 | 通知次要内容,是对通知内容的补充。
**系统能力**:SystemCapability.Notification.Notification |
+| longText | 是 | 是 | string | 是 | 通知的长文本。
**系统能力**:SystemCapability.Notification.Notification |
+| briefText | 是 | 是 | string | 是 | 通知概要内容,是对通知内容的总结。
**系统能力**:SystemCapability.Notification.Notification |
+| expandedTitle | 是 | 是 | string | 是 | 通知展开时的标题。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationMultiLineContent
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------------- | -------- | --------------- | ---- | -------------------------------- |
-| title | 读、写 | string | 是 | 通知标题 |
-| text | 读、写 | string | 是 | 通知内容 |
-| additionalText | 读、写 | string | 是 | 通知次要内容,是对通知内容的补充 |
-| briefText | 读、写 | string | 是 | 通知概要内容,是对通知内容的总结 |
-| longTitle | 读、写 | string | 是 | 通知展开时的标题 |
-| lines | 读、写 | Array\ | 是 | 通知的多行文本 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------------- | --- | --- | --------------- | ---- | -------------------------------- |
+| title | 是 | 是 | string | 是 | 通知标题。
**系统能力**:SystemCapability.Notification.Notification |
+| text | 是 | 是 | string | 是 | 通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| additionalText | 是 | 是 | string | 是 | 通知次要内容,是对通知内容的补充。
**系统能力**:SystemCapability.Notification.Notification |
+| briefText | 是 | 是 | string | 是 | 通知概要内容,是对通知内容的总结。
**系统能力**:SystemCapability.Notification.Notification |
+| longTitle | 是 | 是 | string | 是 | 通知展开时的标题。
**系统能力**:SystemCapability.Notification.Notification |
+| lines | 是 | 是 | Array\ | 是 | 通知的多行文本。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationPictureContent
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------------- | -------- | -------------- | ---- | -------------------------------- |
-| title | 读、写 | string | 是 | 通知标题 |
-| text | 读、写 | string | 是 | 通知内容 |
-| additionalText | 读、写 | string | 是 | 通知次要内容,是对通知内容的补充 |
-| briefText | 读、写 | string | 是 | 通知概要内容,是对通知内容的总结 |
-| expandedTitle | 读、写 | string | 是 | 通知展开时的标题 |
-| picture | 读、写 | image.PixelMap | 是 | 通知的图片内容 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------------- | ---- | --- | -------------- | ---- | -------------------------------- |
+| title | 是 | 是 | string | 是 | 通知标题。
**系统能力**:SystemCapability.Notification.Notification |
+| text | 是 | 是 | string | 是 | 通知内容。
**系统能力**:SystemCapability.Notification.Notification |
+| additionalText | 是 | 是 | string | 是 | 通知次要内容,是对通知内容的补充。
**系统能力**:SystemCapability.Notification.Notification |
+| briefText | 是 | 是 | string | 是 | 通知概要内容,是对通知内容的总结。
**系统能力**:SystemCapability.Notification.Notification |
+| expandedTitle | 是 | 是 | string | 是 | 通知展开时的标题。
**系统能力**:SystemCapability.Notification.Notification |
+| picture | 是 | 是 | image.PixelMap | 是 | 通知的图片内容。
**系统能力**:SystemCapability.Notification.Notification |
## BundleOption
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ------ | -------- | ------ | ---- | ------ |
-| bundle | 读/写 | string | 是 | 包名 |
-| uid | 读/写 | number | 否 | 用户id |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ------ | ---- | --- | ------ | ---- | ------ |
+| bundle | 是 | 是 | string | 是 | 包名。
**系统能力**:SystemCapability.Notification.Notification |
+| uid | 是 | 是 | number | 否 | 用户id。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationKey
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ----- | -------- | ------ | ---- | -------- |
-| id | 读、写 | number | 是 | 通知ID |
-| label | 读、写 | string | 否 | 通知标签 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ----- | ---- | --- | ------ | ---- | -------- |
+| id | 是 | 是 | number | 是 | 通知ID。
**系统能力**:SystemCapability.Notification.Notification |
+| label | 是 | 是 | string | 否 | 通知标签。
**系统能力**:SystemCapability.Notification.Notification |
@@ -2320,39 +2264,39 @@ Notification.subscribe(subscriber, subscribeCallback);
| 名称 | 值 | 说明 |
| -------------------- | -------- | -------- |
-| SOCIAL_COMMUNICATION | SlotType | 社交类型 |
-| SERVICE_INFORMATION | SlotType | 服务类型 |
-| CONTENT_INFORMATION | SlotType | 内容类型 |
-| OTHER_TYPES | SlotType | 其他类型 |
+| SOCIAL_COMMUNICATION | SlotType | 社交类型。
**系统能力**:SystemCapability.Notification.Notification |
+| SERVICE_INFORMATION | SlotType | 服务类型。
**系统能力**:SystemCapability.Notification.Notification |
+| CONTENT_INFORMATION | SlotType | 内容类型。
**系统能力**:SystemCapability.Notification.Notification |
+| OTHER_TYPES | SlotType | 其他类型。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationActionButton
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| --------- | -------- | ----------------------------------------------- | ---- | ------------------------- |
-| title | 读、写 | string | 是 | 按钮标题 |
-| wantAgent | 读、写 | WantAgent | 是 | 点击按钮时触发的WantAgent |
-| extras | 读、写 | Array\ | 否 | 按钮扩展信息 |
-| icon | 读、写 | image.PixelMap | 否 | 按钮图标 |
-| userInput | 读、写 | [NotificationUserInput](#notificationuserinput) | 否 | 用户输入对象实例 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| --------- | --- | ---- | ----------------------------------------------- | ---- | ------------------------- |
+| title | 是 | 是 | string | 是 | 按钮标题。
**系统能力**:SystemCapability.Notification.Notification |
+| wantAgent | 是 | 是 | WantAgent | 是 | 点击按钮时触发的WantAgent。
**系统能力**:SystemCapability.Notification.Notification |
+| extras | 是 | 是 | Array\ | 否 | 按钮扩展信息。
**系统能力**:SystemCapability.Notification.Notification |
+| icon | 是 | 是 | image.PixelMap | 否 | 按钮图标。
**系统能力**:SystemCapability.Notification.Notification |
+| userInput | 是 | 是 | [NotificationUserInput](#notificationuserinput) | 否 | 用户输入对象实例。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationUserInput
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ------ | ---- | ----------------------------- |
-| inputKey | 读、写 | string | 是 | 用户输入时用于标识此输入的key |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | --- | ---- | ------ | ---- | ----------------------------- |
+| inputKey | 是 | 是 | string | 是 | 用户输入时用于标识此输入的key。
**系统能力**:SystemCapability.Notification.Notification |
## NotificationSubscribeInfo
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ----------- | -------- | --------------- | ---- | ------------------------------- |
-| bundleNames | 读、写 | Array\ | 否 | 指定订阅哪些包名的APP发来的通知 |
-| userId | 读、写 | number | 否 | 指定订阅哪个用户下发来的通知 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ----------- | --- | ---- | --------------- | ---- | ------------------------------- |
+| bundleNames | 是 | 是 | Array\ | 否 | 指定订阅哪些包名的APP发来的通知。
**系统能力**:SystemCapability.Notification.Notification |
+| userId | 是 | 是 | number | 否 | 指定订阅哪个用户下发来的通知。
**系统能力**:SystemCapability.Notification.Notification |
@@ -2362,9 +2306,28 @@ Notification.subscribe(subscriber, subscribeCallback);
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| ---- | ---------------------- | ---- | ---- | -------- |
-| name | string | 是 | 是 | 模板名称 |
-| data | {[key:string]: Object} | 是 | 是 | 模板数据 |
+| name | string | 是 | 是 | 模板名称。
**系统能力**:SystemCapability.Notification.Notification |
+| data | {[key:string]: Object} | 是 | 是 | 模板数据。
**系统能力**:SystemCapability.Notification.Notification |
+
+
+## ActionResult
+
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
+| ------------ | ---------- | ---- | ---- | -------- |
+| bundleName | string | 是 | 是 | 点击通知后重定向应用的包名。
**系统能力**:SystemCapability.Notification.Notification |
+| abilityName | string | 是 | 是 | 点击通知后重定向应用的的Ability名称。
**系统能力**:SystemCapability.Notification.Notification |
+| uri | string | 是 | 是 | 要重定向到的页面的Uri。
**系统能力**:SystemCapability.Notification.Notification |
+
+
+
+## ShowNotificationOptions
+
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
+| ------------ | ---------- | ---- | ---- | -------- |
+| contentTitle | string | 是 | 是 | 通知的标题。
**系统能力**:SystemCapability.Notification.Notification |
+| contentText | string | 是 | 是 | 通知的内容。
**系统能力**:SystemCapability.Notification.Notification |
+| clickAction | ActionResult | 是 | 是 | 点击通知后触发的动作。
**系统能力**:SystemCapability.Notification.Notification |
@@ -2378,25 +2341,22 @@ import WantAgent from '@ohos.wantAgent';
-## WantAgent.getWantAgent(info: WantAgentInfo, callback: AsyncCallback\)
-
-- 接口说明
-
- 创建WantAgent(callback形式)
+## WantAgent.getWantAgent
-- getWantAgent参数描述
+getWantAgent(info: WantAgentInfo, callback: AsyncCallback\): void
+创建WantAgent(callback形式)。
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | -------------------------- | ---- | ----------------------- |
-| info | 只读 | WantAgentInfo | 是 | WantAgent信息 |
-| callback | 只读 | AsyncCallback\ | 是 | 创建WantAgent的回调方法 |
+**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
-- 返回值
+**参数:**
- void
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | --- | ---- | -------------------------- | ---- | ----------------------- |
+| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 创建WantAgent的回调方法。 |
-- 示例
+**示例:**
```js
import WantAgent from '@ohos.wantAgent';
@@ -2439,24 +2399,27 @@ WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
-## WantAgent.getWantAgent(info: WantAgentInfo): Promise\
+## WantAgent.getWantAgent
-- 接口说明
+getWantAgent(info: WantAgentInfo): Promise\
- 创建WantAgent(Promise形式)
+创建WantAgent(Promise形式)。
-- getWantAgent参数描述
+**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
+**参数:**
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| ---- | -------- | ------------- | ---- | ------------- |
-| info | 只读 | WantAgentInfo | 是 | WantAgent信息 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| ---- | --- | ---- | ------------- | ---- | ------------- |
+| info | 是 | 否 | WantAgentInfo | 是 | WantAgent信息。 |
-- 返回值
+**返回值:**
- Promise\
+| 类型 | 说明 |
+| ----------------------------------------------------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回WantAgent。 |
-- 示例
+**示例:**
```js
import WantAgent from '@ohos.wantAgent';
@@ -2497,25 +2460,22 @@ WantAgent.getWantAgent(wantAgentInfo).then((data) => {
-## WantAgent.getBundleName(agent: WantAgent, callback: AsyncCallback\)
+## WantAgent.getBundleName
-- 接口说明
+getBundleName(agent: WantAgent, callback: AsyncCallback\): void
- 获取WantAgent实例的包名(callback形式)
+获取WantAgent实例的包名(callback形式)。
-- getBundleName参数描述
+**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
+**参数:**
-| 名称 | 读写属性 | 类型 | 必填 | 描述 |
-| -------- | -------- | ----------------------- | ---- | --------------------------------- |
-| agent | 只读 | WantAgent | 是 | WantAgent对象 |
-| callback | 只读 | AsyncCallback\ | 是 | 获取WantAgent实例的包名的回调方法 |
+| 名称 | 可读 | 可写 | 类型 | 必填 | 描述 |
+| -------- | --- | ---- | ----------------------- | ---- | --------------------------------- |
+| agent | 是 | 否 | WantAgent | 是 | WantAgent对象。 |
+| callback | 是 | 否 | AsyncCallback\ | 是 | 获取WantAgent实例的包名的回调方法。 |
-- 返回值
-
- void
-
-- 示例
+**示例:**
```js
import WantAgent from '@ohos.wantAgent';
@@ -2572,24 +2532,27 @@ WantAgent.getBundleName(wantAgent, getBundleNameCallback)
-## WantAgent.getBundleName(agent: WantAgent): Promise\
+## WantAgent.getBundleName
-- 接口说明
+getBundleName(agent: WantAgent): Promise\