1# NotificationRequest(系统接口) 2 3描述通知的请求。 4 5> **说明：** 6> 7> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 9> 当前界面仅包含本模块的系统接口，其他公开接口参见[NotificationRequest](./js-apis-inner-notification-notificationRequest.md)。 10 11## NotificationRequest 12 13**系统能力**：SystemCapability.Notification.Notification 14 15| 名称 | 类型 | 只读 | 可选 | 说明 | 16|-------------------------------| -------------------------------------------------------- | ----- | --- |-----------------------------------------------------------------------| 17| overlayIcon<sup>11+</sup> | [image.PixelMap](../apis-image-kit/js-apis-image.md#pixelmap7) | 否 | 是 | 通知重叠图标。可选字段，图像像素的总字节数不超过100KB。<br>**系统接口**：此接口为系统接口。 | 18| classification | string | 否 | 是 | 通知分类。<br>**系统接口**：此接口为系统接口。预留能力，暂未支持。 | 19| isRemoveAllowed<sup>8+</sup> | boolean | 否 | 是 | 通知是否能被移除（点击通知下方删除按钮无法删除，左滑不出现删除按钮）。默认为false。<br> - true：是。<br> - false：否。<br>**系统接口**：此接口为系统接口。<br>**需要权限**：ohos.permission.SET_UNREMOVABLE_NOTIFICATION | 20| source<sup>8+</sup> | number | 是 | 是 | 通知源。<br>**系统接口**：此接口为系统接口。预留能力，暂未支持。 | 21| deviceId<sup>8+</sup> | string | 是 | 是 | 通知源的deviceId。<br>**系统接口**：此接口为系统接口。预留能力，暂未支持。 | 22| representativeBundle<sup>12+</sup> | [BundleOption](js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 否 | 是 | 被代理的包信息。<br>**系统接口**：此接口为系统接口。 | 23| notificationControlFlags<sup>12+</sup> | number | 否 | 是 | 通知提醒方式管控。<br>可以通过此接口减少当前通知的提醒方式。与[NotificationControlFlagStatus](js-apis-notificationManager-sys.md#notificationcontrolflagstatus12)的枚举进行按位或运算得到该参数。<br>**系统接口**：此接口为系统接口。 | 24| unifiedGroupInfo<sup>12+</sup> | [UnifiedGroupInfo](#unifiedgroupinfo12) | 否 | 是 |消息智能聚合信息字段。 <br>**系统接口**：此接口为系统接口。| 25| creatorInstanceKey<sup>(deprecated)</sup> | number | 是 | 是 | 创建者实例键值。 <br>**系统接口**：此接口为系统接口。| 26| agentBundle<sup>12+</sup> | [BundleOption](js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 是 | 创建通知的代理包信息。 <br>**系统接口**：此接口为系统接口。| 27| appInstanceKey<sup>15+</sup> | string | 是 | 是 | 应用实例键值。 <br>**系统接口**：此接口为系统接口。| 28| notDistributed<sup>16+</sup> | boolean | 否 | 是 | 通知是否不进行全场景跨设备协同显示，默认为false。<br/>**说明**:<br/>该字段与forceDistributed字段互斥，当两者同时配置时，仅notDistributed字段生效。<br/>- 设置为true时：通知仅在本设备上显示。<br/>- 设置为false时：通知将在所有协同设备上显示。<br>**系统接口**: 此接口为系统接口。 | 29| forceDistributed<sup>16+</sup> | boolean | 否 | 是 | 通知是否强制进行全场景跨设备协同显示，默认为false。<br/>**说明**:<br/>仅当应用在跨设备协同管控名单中且未配置notDistributed字段时，该字段才会生效。通过读取notification_config.json文件（文件配置路径见：[notification_config_parse.h](https://gitee.com/openharmony/notification_distributed_notification_service/blob/master/services/ans/include/notification_config_parse.h) 中的NOTIFICAITON_CONFIG_FILE属性）中的collaborationFilter字段，查看是否包含应用的UID或包名。如果包含，说明是在应用跨设备协同管控名单中。<br>- 设置为true时：通知将在所有协同设备上显示。<br/>- 设置为false时：通知将按照协同管控名单显示。<br>**系统接口**: 此接口为系统接口。 | 30 31## DistributedOptions<sup>8+</sup> 32 33描述分布式选项。 34 35**系统能力**：SystemCapability.Notification.Notification 36 37| 名称 | 类型 | 必填 | 说明 | 38| ---------------------- | -------------- | ---- | ---------------------------------- | 39| remindType | number | 否 | 通知的提醒方式。<br>**系统接口**：此接口为系统接口。 | 40 41 42## NotificationFilter<sup>11+</sup> 43 44描述查询普通实况窗时的筛选条件。 45 46**系统能力**：SystemCapability.Notification.Notification 47 48**系统接口**：此接口为系统接口。 49 50| 名称 | 类型 | 必填 | 说明 | 51| ----------------| ------------------------------------- | ---- | ---------------------------------- | 52| bundle | [BundleOption](js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 实况通知的包信息。| 53| notificationKey | [NotificationKey](js-apis-notificationSubscribe-sys.md#notificationkey) | 是 | 通知信息，包含通知ID和通知标签。 | 54| extraInfoKeys | Array\<string> | 否 | 筛选附加信息的键值列表。不填表示查询所有的附加信息。| 55 56 57## NotificationCheckRequest<sup>11+</sup> 58 59描述通知的鉴权信息。 60 61**系统能力**：SystemCapability.Notification.Notification 62 63**系统接口**：此接口为系统接口。 64 65| 名称 | 类型 | 必填 | 说明 | 66| --------------| --------------------------------------------------------- | ---- | ----------------- | 67| contentType | [ContentType](js-apis-notificationManager.md#contenttype) | 是 | 通知类型。 | 68| slotType | [SlotType](js-apis-notificationManager.md#slottype) | 是 | 渠道类型。 | 69| extraInfoKeys | Array\<string> | 是 | 实况通知的附加信息。| 70 71## UnifiedGroupInfo<sup>12+</sup> 72 73描述通知智能聚合信息字段。 74 75**系统能力**：SystemCapability.Notification.Notification 76 77**系统接口**：此接口为系统接口。 78 79| 名称 | 类型 | 必填 | 说明 | 80| ---------------------- | -------------- | ---- | ---------------------------------- | 81| key | string | 否 | 聚合组ID。 | 82| title | string | 否 | 聚合组标题。 | 83| content | string | 否 | 聚合组摘要正文。 | 84| sceneName | string | 否 | 聚合场景名称。 | 85| extraInfo | {[key: string]: any} | 否 | 其他聚合信息。 | 86