未验证 提交 fac8dfd7 编写于 作者: O openharmony_ci 提交者: Gitee

!23618 文档纠正与补充

Merge pull request !23618 from XKK/month08151111
...@@ -10,45 +10,45 @@ ...@@ -10,45 +10,45 @@
**系统能力**:以下各项对应的系统能力均为SystemCapability.Notification.Notification **系统能力**:以下各项对应的系统能力均为SystemCapability.Notification.Notification
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| --------------------- | --------------------------------------------- | --- |-----------------------------------------------------------------------| |-------------------------------| --------------------------------------------- | --- |-----------------------------------------------------------------------|
| content | [NotificationContent](js-apis-inner-notification-notificationContent.md#notificationcontent) | 是 | 通知内容。 | | content | [NotificationContent](js-apis-inner-notification-notificationContent.md#notificationcontent) | 是 | 通知内容。 |
| id | number | 否 | 通知ID。 | | id | number | 否 | 通知ID。 |
| slotType | [SlotType](js-apis-notificationManager.md#slottype) | 否 | 通道类型。 | | slotType | [SlotType](js-apis-notificationManager.md#slottype) | 否 | 通道类型。 |
| isOngoing | boolean | 否 | 是否进行时通知。 | | isOngoing | boolean | 否 | 是否进行时通知。 |
| isUnremovable | boolean | 否 | 是否可移除(应用于长时间通知任务上,比如地图、音乐播放;点击通知下方删除按钮无法删除,左滑点击单个删除按钮可删除)。 | | isUnremovable | boolean | 否 | 是否可移除(应用于长时间通知任务上,比如地图、音乐播放;点击通知下方删除按钮无法删除,左滑点击单个删除按钮可删除)。 |
| deliveryTime | number | 否 | 通知发送时间。 | | deliveryTime | number | 否 | 通知发送时间。 |
| tapDismissed | boolean | 否 | 通知是否自动清除。 | | tapDismissed | boolean | 否 | 通知是否自动清除。 |
| autoDeletedTime | number | 否 | 自动清除的时间。 | | autoDeletedTime | number | 否 | 自动清除的时间。 |
| wantAgent | [WantAgent](js-apis-app-ability-wantAgent.md) | 否 | WantAgent封装了应用的行为意图,点击通知时触发该行为。 | | wantAgent | [WantAgent](js-apis-app-ability-wantAgent.md) | 否 | WantAgent封装了应用的行为意图,点击通知时触发该行为。 |
| extraInfo | {[key: string]: any} | 否 | 扩展参数。 | | extraInfo | {[key: string]: any} | 否 | 扩展参数。 |
| color | number | 否 | 通知背景颜色。预留能力,暂未支持。 | | color | number | 否 | 通知背景颜色。预留能力,暂未支持。 |
| colorEnabled | boolean | 否 | 通知背景颜色是否使能。预留能力,暂未支持。 | | colorEnabled | boolean | 否 | 通知背景颜色是否使能。预留能力,暂未支持。 |
| isAlertOnce | boolean | 否 | 设置是否仅有一次此通知提醒。 | | isAlertOnce | boolean | 否 | 设置是否仅有一次此通知提醒。 |
| isStopwatch | boolean | 否 | 是否显示已用时间。 | | isStopwatch | boolean | 否 | 是否显示已用时间。 |
| isCountDown | boolean | 否 | 是否显示倒计时时间。 | | isCountDown | boolean | 否 | 是否显示倒计时时间。 |
| isFloatingIcon | boolean | 否 | 是否显示状态栏图标。 | | isFloatingIcon | boolean | 否 | 是否显示状态栏图标。 |
| label | string | 否 | 通知标签。 | | label | string | 否 | 通知标签。 |
| badgeIconStyle | number | 否 | 通知角标类型。预留能力,暂未支持。 | | badgeIconStyle | number | 否 | 通知角标类型。预留能力,暂未支持。 |
| showDeliveryTime | boolean | 否 | 是否显示分发时间。 | | showDeliveryTime | boolean | 否 | 是否显示分发时间。 |
| actionButtons | Array\<[NotificationActionButton](js-apis-inner-notification-notificationActionButton.md)\> | 否 | 通知按钮,最多三个按钮。 | | actionButtons | Array\<[NotificationActionButton](js-apis-inner-notification-notificationActionButton.md)\> | 否 | 通知按钮,最多三个按钮。 |
| smallIcon | [image.PixelMap](js-apis-image.md#pixelmap7) | 否 | 通知小图标。可选字段,大小不超过30KB。 | | smallIcon | [image.PixelMap](js-apis-image.md#pixelmap7) | 否 | 通知小图标。可选字段,大小不超过30KB。 |
| largeIcon | [image.PixelMap](js-apis-image.md#pixelmap7) | 否 | 通知大图标。可选字段,大小不超过30KB。 | | largeIcon | [image.PixelMap](js-apis-image.md#pixelmap7) | 否 | 通知大图标。可选字段,大小不超过30KB。 |
| creatorBundleName | string | 否 | 创建通知的包名。 | | creatorBundleName | string | 否 | 创建通知的包名。 |
| creatorUid | number | 否 | 创建通知的UID。 | | creatorUid | number | 否 | 创建通知的UID。 |
| creatorPid | number | 否 | 创建通知的PID。 | | creatorPid | number | 否 | 创建通知的PID。 |
| creatorUserId<sup>8+<sup> | number | 否 | 创建通知的UserId。 | | creatorUserId<sup>8+<sup> | number | 否 | 创建通知的UserId。 |
| hashCode | string | 否 | 通知唯一标识。 | | hashCode | string | 否 | 通知唯一标识。 |
| classification | string | 否 | 通知分类。<br>**系统API**: 此接口为系统接口,三方应用不支持调用。 | | classification | string | 否 | 通知分类。<br>**系统API**: 此接口为系统接口,三方应用不支持调用。 |
| groupName<sup>8+<sup> | string | 否 | 组通知名称。 | | groupName<sup>8+<sup> | string | 否 | 组通知名称。 |
| template<sup>8+<sup> | [NotificationTemplate](./js-apis-inner-notification-notificationTemplate.md) | 否 | 通知模板。 | | template<sup>8+<sup> | [NotificationTemplate](./js-apis-inner-notification-notificationTemplate.md) | 否 | 通知模板。 |
| isRemoveAllowed<sup>10+<sup> | boolean | 否 | 通知是否能被移除(点击通知下方删除按钮无法删除,左滑不出现删除按钮)。<br>**系统API**: 此接口为系统接口,三方应用不支持调用。 | | isRemoveAllowed<sup>8+<sup> | boolean | 否 | 通知是否能被移除(点击通知下方删除按钮无法删除,左滑不出现删除按钮)。<br>**系统API**: 此接口为系统接口,三方应用不支持调用。 |
| source<sup>8+<sup> | number | 否 | 通知源。<br>**系统API**: 此接口为系统接口,三方应用不支持调用。 | | source<sup>8+<sup> | number | 否 | 通知源。<br>**系统API**: 此接口为系统接口,三方应用不支持调用。 |
| distributedOption<sup>8+<sup> | [DistributedOptions](#distributedoptions) | 否 | 分布式通知的选项。 | | distributedOption<sup>8+<sup> | [DistributedOptions](#distributedoptions) | 否 | 分布式通知的选项。 |
| deviceId<sup>8+<sup> | string | 否 | 通知源的deviceId。<br>**系统API**: 此接口为系统接口,三方应用不支持调用。 | | deviceId<sup>8+<sup> | string | 否 | 通知源的deviceId。<br>**系统API**: 此接口为系统接口,三方应用不支持调用。 |
| notificationFlags<sup>8+<sup> | [NotificationFlags](js-apis-inner-notification-notificationFlags.md#notificationflags) | 否 | 获取NotificationFlags。 | | notificationFlags<sup>8+<sup> | [NotificationFlags](js-apis-inner-notification-notificationFlags.md#notificationflags) | 否 | 获取NotificationFlags。 |
| removalWantAgent<sup>9+<sup> | [WantAgent](js-apis-app-ability-wantAgent.md) | 否 | 当移除通知时,通知将被重定向到的WantAgent实例。 | | removalWantAgent<sup>9+<sup> | [WantAgent](js-apis-app-ability-wantAgent.md) | 否 | 当移除通知时,通知将被重定向到的WantAgent实例。 |
| badgeNumber<sup>9+<sup> | number | 否 | 应用程序图标上显示的通知数。 | | badgeNumber<sup>9+<sup> | number | 否 | 应用程序图标上显示的通知数。 |
## DistributedOptions ## DistributedOptions
......
...@@ -12,8 +12,8 @@ ...@@ -12,8 +12,8 @@
**系统接口**: 以下为系统接口,三方应用不支持调用。 **系统接口**: 以下为系统接口,三方应用不支持调用。
| 名称 | 类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| -------------------- | --------------------- | --- | ------------------------------------------ | |---------| --------------------- | --- |------------------------|
| slot | [NotificationSlot](js-apis-inner-notification-notificationSlot.md) | 是 | 通道类型。 | | slot | [NotificationSlot](js-apis-inner-notification-notificationSlot.md) | 是 | 通道类型。 |
| level | number | 是 | 通知级别,不设置则根据通知渠道类型有默认值。 | | ranking | number | 是 | 通知级别,不设置则根据通知渠道类型有默认值。 |
| desc | string | 是 | 通知渠道描述信息。 | | hashCode | string | 是 | 通知唯一标识。 |
...@@ -2977,6 +2977,7 @@ notificationManager.setDistributedEnable(enable).then(() => { ...@@ -2977,6 +2977,7 @@ notificationManager.setDistributedEnable(enable).then(() => {
}); });
``` ```
## notificationManager.requestEnableNotification<sup>10+<sup>
## notificationManager.isDistributedEnabled ## notificationManager.isDistributedEnabled
......
...@@ -443,9 +443,9 @@ notificationSubscribe.remove(hashCode, reason).then(() => { ...@@ -443,9 +443,9 @@ notificationSubscribe.remove(hashCode, reason).then(() => {
console.info("remove success"); console.info("remove success");
}); });
``` ```
## NotificationSubscribe.remove ## NotificationSubscribe.remove<sup>10+<sup>
remove(hashCodes: Array\<string\>, reason: RemoveReason, callback: AsyncCallback\<void\>): void remove(hashCodes: Array\<String\>, reason: RemoveReason, callback: AsyncCallback\<void\>): void
批量删除指定通知(Callback形式)。 批量删除指定通知(Callback形式)。
...@@ -459,7 +459,7 @@ remove(hashCodes: Array\<string\>, reason: RemoveReason, callback: AsyncCallback ...@@ -459,7 +459,7 @@ remove(hashCodes: Array\<string\>, reason: RemoveReason, callback: AsyncCallback
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
|-----------|-------------------------------| ---- |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |-----------|-------------------------------| ---- |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| hashCodes | Array\<string\> | 是 | 通知唯一ID数组集合。可以通过[onConsume](js-apis-inner-notification-notificationSubscriber.md#onConsume)回调的入参[SubscribeCallbackData](js-apis-notification.md#subscribecallbackdata)获取其内部[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)对象中的hashCode。 | | hashCodes | Array\<String\> | 是 | 通知唯一ID数组集合。可以通过[onConsume](js-apis-inner-notification-notificationSubscriber.md#onConsume)回调的入参[SubscribeCallbackData](js-apis-notification.md#subscribecallbackdata)获取其内部[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)对象中的hashCode。 |
| reason | [RemoveReason](#removereason) | 是 | 通知删除原因。 | | reason | [RemoveReason](#removereason) | 是 | 通知删除原因。 |
| callback | AsyncCallback\<void\> | 是 | 删除指定通知回调函数。 | | callback | AsyncCallback\<void\> | 是 | 删除指定通知回调函数。 |
...@@ -489,9 +489,9 @@ let reason = notificationSubscribe.RemoveReason.CANCEL_REASON_REMOVE; ...@@ -489,9 +489,9 @@ let reason = notificationSubscribe.RemoveReason.CANCEL_REASON_REMOVE;
notificationSubscribe.remove(hashCodes, reason, removeCallback); notificationSubscribe.remove(hashCodes, reason, removeCallback);
``` ```
## NotificationSubscribe.remove ## NotificationSubscribe.remove<sup>10+<sup>
remove(hashCodes: Array\<string\>, reason: RemoveReason): Promise\<void\> remove(hashCodes: Array\<String\>, reason: RemoveReason): Promise\<void\>
批量删除指定通知(Promise形式)。 批量删除指定通知(Promise形式)。
...@@ -505,7 +505,7 @@ remove(hashCodes: Array\<string\>, reason: RemoveReason): Promise\<void\> ...@@ -505,7 +505,7 @@ remove(hashCodes: Array\<string\>, reason: RemoveReason): Promise\<void\>
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
|-----------|-------------------------------| ---- |-------------| |-----------|-------------------------------| ---- |-------------|
| hashCodes | Array\<string\> | 是 | 通知唯一ID数组集合。 | | hashCodes | Array\<String\> | 是 | 通知唯一ID数组集合。 |
| reason | [RemoveReason](#removereason) | 是 | 通知删除原因。 | | reason | [RemoveReason](#removereason) | 是 | 通知删除原因。 |
**错误码:** **错误码:**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册