harmony 鸿蒙NotificationContent

2025-06-16
浏览 (5)

NotificationContent

描述通知类型。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

NotificationContent

通知内容。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
contentType^(deprecated)	notification.ContentType	否	是	通知内容类型。从API version 11开始不再维护，建议使用notificationContentType代替。
notificationContentType¹¹⁺	notificationManager.ContentType	否	是	通知内容类型。
normal	NotificationBasicContent	否	是	基本类型通知内容。
longText	NotificationLongTextContent	否	是	长文本类型通知内容。
multiLine	NotificationMultiLineContent	否	是	多行类型通知内容。
picture	NotificationPictureContent	否	是	图片类型通知内容。
systemLiveView¹¹⁺	NotificationSystemLiveViewContent	否	是	系统实况窗类型通知内容。不支持三方应用直接创建该类型通知，可以由系统代理创建系统实况窗类型通知后，三方应用发布同ID的通知来更新指定内容。

NotificationBasicContent

描述普通文本通知。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
title	string	否	否	通知标题（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
text	string	否	否	通知内容（不可为空字符串，大小不超过3072字节，超出部分会被截断）。
additionalText	string	否	是	通知附加内容，是对通知内容的补充（大小不超过3072字节，超出部分会被截断）。
lockscreenPicture¹²⁺	image.PixelMap	否	是	通知在锁屏界面显示的图片。当前仅支持实况窗类型通知。图标像素的总字节数不超过192KB（图标像素的总字节数通过getPixelBytesNumber获取），建议图标像素长宽为128*128。实际显示效果依赖于设备能力和通知中心UI样式。

NotificationLongTextContent

描述长文本通知。继承自NotificationBasicContent。

说明：

实际显示效果依赖于设备能力和通知中心UI样式。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
longText	string	否	否	通知的长文本（不可为空字符串，大小不超过3072字节，超出部分会被截断）。
briefText	string	否	否	通知概要内容，是对通知内容的总结（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
expandedTitle	string	否	否	通知展开时的标题（不可为空字符串，大小不超过1024字节，超出部分会被截断）。

NotificationMultiLineContent

描述多行文本通知。继承自NotificationBasicContent。

说明：

当该类型通知与其他通知形成组通知时，该通知显示默认与普通文本相同。展开组通知后，标题显示为展开时的标题longTitle，多行文本内容lines多行显示。
当该类型通知单独呈现时，该通知标题显示为展开时的标题longTitle，多行文本内容lines多行显示。

实际显示效果依赖于设备能力和通知中心UI样式。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
briefText	string	否	否	通知概要内容，是对通知内容的总结（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
longTitle	string	否	否	通知展开时的标题（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
lines	Array<string>	否	否	通知的多行文本（最多支持三行，每行大小不超过1024字节，超出部分会被截断）。

NotificationPictureContent

描述附有图片的通知。继承自NotificationBasicContent。

说明：

实际显示效果依赖于设备能力和通知中心UI样式。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
briefText	string	否	否	通知概要内容，是对通知内容的总结（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
expandedTitle	string	否	否	通知展开时的标题（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
picture	image.PixelMap	否	否	通知的图片内容(图像像素的总字节数不能超过2MB)。

NotificationSystemLiveViewContent

描述系统实况窗通知内容。不支持三方应用直接创建该类型通知，可以由系统代理创建系统实况窗类型通知后，三方应用发布同ID的通知来更新指定内容。继承自NotificationBasicContent。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
typeCode¹¹⁺	number	否	否	类型标识符，标记调用方业务类型。
capsule¹¹⁺	NotificationCapsule	否	是	实况通知的胶囊。
button¹¹⁺	NotificationButton	否	是	实况通知的按钮。
time¹¹⁺	NotificationTime	否	是	实况通知的时间。
progress¹¹⁺	NotificationProgress	否	是	实况内容的进度。

NotificationCapsule¹¹⁺

描述通知胶囊。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
title	string	否	是	胶囊标题。大小不超过200字节，超出部分会被截断。
icon	image.PixelMap	否	是	胶囊图片。
backgroundColor	string	否	是	背景颜色。

NotificationButton¹¹⁺

描述通知按钮。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
names	Array<string>	否	是	按钮名称（最多支持3个）。
icons	Array<image.PixelMap>	否	是	按钮图片（最多支持3个）。
iconsResource¹²⁺	Array<Resource>	否	是	按钮资源（最多支持3个）。

NotificationTime¹¹⁺

描述通知计时信息。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
initialTime	number	否	是	计时起始时间。单位：ms。
isCountDown	boolean	否	是	是否倒计时。默认为false。 - true：是。 - false：否。
isPaused	boolean	否	是	是否暂停。默认为false。 - true：是。 - false：否。
isInTitle	boolean	否	是	时间是否展示在title中。默认为false。 - true：是。 - false：否。

示例：

// 该通知从3秒开始倒计时，并且时间展示在title中。
time: {
    initialTime: 3000,
    isCountDown: true,
    isPaused: false,
    isInTitle: true,
}

NotificationProgress¹¹⁺

描述通知进度。

系统能力：SystemCapability.Notification.Notification

名称	类型	只读	可选	说明
maxValue	number	否	是	进度最大值。
currentValue	number	否	是	进度当前值。
isPercentage	boolean	否	是	是否按百分比展示。默认为false。 - true：是。 - false：否。