在 HarmonyOS 应用开发中,我们经常需要向用户发送各种通知,例如短消息提醒、应用内公告、广告推送等等。HarmonyOS 提供了便捷的 NotificationManager
API 来实现这一功能。本教程将重点介绍如何使用 NotificationManager
发送多行文本类型的通知。
如何发送多行文本类型通知?
发送多行文本类型通知,需要使用 NotificationManager.publish()
方法,并在 notificationRequest
参数中设置 contentType
为 NotificationManager.ContentType.NOTIFICATION_CONTENT_MULTILINE
,以及配置 multiLine
对象来设置通知内容。
multiLine
对象包含以下属性:
title
:通知标题,简短概括通知内容。text
:通知内容,显示在标题下方。briefText
:通知摘要,当通知折叠时显示。longTitle
:长标题,当通知展开时显示。lines
:多行文本内容,以字符串数组的形式传入,每行文字单独显示。
示例代码
import { NotificationManager } from '@ohos.notification';
// 创建通知请求
let notificationRequest = {
id: 1,
content: {
contentType: NotificationManager.ContentType.NOTIFICATION_CONTENT_MULTILINE,
multiLine: {
title: '多行文本通知',
text: '这是一条多行文本通知的内容',
briefText: '多行文本通知摘要',
longTitle: '这是一个长标题,当通知展开时显示',
lines: ['第一行内容', '第二行内容', '第三行内容', '第四行内容'],
}
}
}
// 发布通知
NotificationManager.publish(notificationRequest, (err) => {
if (err) {
console.error(`[ANS] 发布通知失败,错误信息: ${err}`);
return;
}
console.info(`[ANS] 发布通知成功`);
});
总结
本教程介绍了如何使用 HarmonyOS NotificationManager
API 发送多行文本类型通知,并提供了详细的示例代码。你可以根据实际需求修改 multiLine
对象的属性值,自定义通知内容。