openharmony 鸿蒙 js-apis-inner-notification-notificationContent

2025-06-16 浏览 (1)

NotificationContent

描述通知类型。

说明:

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

NotificationContent

通知内容。

系统能力:SystemCapability.Notification.Notification

名称类型只读可选说明
contentType(deprecated)notification.ContentType通知内容类型。
从API version 11开始不再维护,建议使用notificationContentType代替。
notificationContentType11+notificationManager.ContentType通知内容类型。
normalNotificationBasicContent基本类型通知内容。
longTextNotificationLongTextContent长文本类型通知内容。
multiLineNotificationMultiLineContent多行类型通知内容。
pictureNotificationPictureContent图片类型通知内容。
systemLiveView11+NotificationSystemLiveViewContent系统实况窗类型通知内容。不支持三方应用直接创建该类型通知,可以由系统代理创建系统实况窗类型通知后,三方应用发布同ID的通知来更新指定内容。

NotificationBasicContent

描述普通文本通知。

系统能力:SystemCapability.Notification.Notification

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

NotificationLongTextContent

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

说明:

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

系统能力:SystemCapability.Notification.Notification

名称类型只读可选说明
longTextstring通知的长文本(不可为空字符串,大小不超过3072字节,超出部分会被截断)。
briefTextstring通知概要内容,是对通知内容的总结(不可为空字符串,大小不超过1024字节,超出部分会被截断)。
expandedTitlestring通知展开时的标题(不可为空字符串,大小不超过1024字节,超出部分会被截断)。

NotificationMultiLineContent

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

说明:

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

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

系统能力:SystemCapability.Notification.Notification

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

NotificationPictureContent

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

说明:

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

系统能力:SystemCapability.Notification.Notification

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

NotificationSystemLiveViewContent

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

系统能力:SystemCapability.Notification.Notification

名称类型只读可选说明
typeCode11+number类型标识符,标记调用方业务类型。
capsule11+NotificationCapsule实况通知的胶囊。
button11+NotificationButton实况通知的按钮。
time11+NotificationTime实况通知的时间。
progress11+NotificationProgress实况内容的进度。

NotificationCapsule11+

描述通知胶囊。

系统能力:SystemCapability.Notification.Notification

名称类型只读可选说明
titlestring胶囊标题。大小不超过200字节,超出部分会被截断。
iconimage.PixelMap胶囊图片。
backgroundColorstring背景颜色。

NotificationButton11+

描述通知按钮。

系统能力:SystemCapability.Notification.Notification

名称类型只读可选说明
namesArray<string>按钮名称(最多支持3个)。
iconsArray<image.PixelMap>按钮图片(最多支持3个)。
iconsResource12+Array<Resource>按钮资源(最多支持3个)。

NotificationTime11+

描述通知计时信息。

系统能力:SystemCapability.Notification.Notification

名称类型只读可选说明
initialTimenumber计时起始时间。单位:ms。
isCountDownboolean是否倒计时。默认为false。
- true:是。
- false:否。
isPausedboolean是否暂停。默认为false。
- true:是。
- false:否。
isInTitleboolean时间是否展示在title中。默认为false。
- true:是。
- false:否。

示例:

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

NotificationProgress11+

描述通知进度。

系统能力:SystemCapability.Notification.Notification

名称类型只读可选说明
maxValuenumber进度最大值。
currentValuenumber进度当前值。
isPercentageboolean是否按百分比展示。默认为false。
- true:是。
- false:否。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Notification Kit(用户通知服务)

harmony 鸿蒙Notification

harmony 鸿蒙通知错误码

harmony 鸿蒙NotificationActionButton

harmony 鸿蒙NotificationCommonDef

harmony 鸿蒙NotificationContent(系统接口)

harmony 鸿蒙NotificationFlags(系统接口)

harmony 鸿蒙NotificationFlags

harmony 鸿蒙NotificationRequest(系统接口)

harmony 鸿蒙NotificationRequest

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/pr6Sj2