更新记录

0.0.2（2025-11-07）

优化文档

0.0.1（2025-11-07）

首次发布

平台兼容性

uni-app(4.81)

Vue2	Vue3	Vue2插件版本	Chrome	Safari	app-vue	app-nvue	Android	iOS	鸿蒙	鸿蒙插件版本
×	√	0.0.1	×	×	×	×	×	×	10	0.0.1

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	快应用-华为	快应用-联盟
×	×	×	×	×	×	×	×	×	×	×

uni-app x(4.81)

Chrome	Safari	Android	iOS	鸿蒙	鸿蒙插件版本	微信小程序
×	×	×	×	10	0.0.1	×

zai-hm-notice 纯血鸿蒙通知栏

一个基于UTS实现的插件，仅使用于纯血鸿蒙的本地通知栏操作插件。兼容uniapp/uniappX

安装方法

在uni-app插件市场中搜索并导入zai-hm-notice
导入后在页面引入相关方法
需要自定义基座才能使用
试用符合需求后才购买，插件无法退款

代码演示

// #ifdef APP-HARMONY
import { pushNotice } from '@/uni_modules/zai-hm-notice'
// #endif

const onClick = () => {
    // #ifdef APP-HARMONY
    const data = await pushNotice({
        id: 1,
        type: 'NOTIFICATION_CONTENT_BASIC_TEXT',
        title: '这是标题',
        text: '这是通知内容，不可为空字符串，大小不超过3072字节，超出部分会被截断',
        additionalText: '通知附加内容，是对通知内容的补充',
        onClick: (res) => {
            console.log('🎯 通知被点击了！收到事件回调', res)
        }
    })
    console.log('发送通知消息结果：', data)
    // #endif
}

API文档

getNoticeAuth()

检测是否授权了通知权限

传参：-
返回：Promise<number>

返回的code码说明

code码	说明
200	已获得授权
300	未获得授权
其它码	鸿蒙文档地址

requestNoticeAuth()

拉起通知弹窗，向用户请求通知授权。

传参：-
返回：Promise<number>

返回的code码说明

code码	说明
200	已获得授权
其它码	鸿蒙文档地址

openNoticeAuth()

拉起通知管理半模态弹窗，向用户再次申请通知授权。

传参：-
返回：Promise<number>

返回的code码说明

code码	说明
200	已获得授权
其它码	鸿蒙文档地址

addNoticeSlot(type)

创建指定类型的通知渠道

传参：type
返回：Promise<number>

type传参说明，仅支持以下参数

参数	说明
UNKNOWN_TYPE	未知类型
SOCIAL_COMMUNICATION	社交通信
SERVICE_INFORMATION	服务提醒
CONTENT_INFORMATION	内容资讯
CUSTOMER_SERVICE	客服消息
OTHER_TYPES	其他

返回的code码说明

code码	说明
200	成功
其它码	鸿蒙文档地址

getNoticeSlot(type)

查询指定类型的通知渠道

传参：type
返回：Promise

type传参说明，仅支持以下参数

参数	说明
UNKNOWN_TYPE	未知类型
SOCIAL_COMMUNICATION	社交通信
SERVICE_INFORMATION	服务提醒
CONTENT_INFORMATION	内容资讯
CUSTOMER_SERVICE	客服消息
OTHER_TYPES	其他

返回对象说明

参数	说明
code	200 / 300，200为成功，300为失败
err	code为300时返回，返回的内容参考鸿蒙文档
data	code为200时返回，返回的内容参考鸿蒙文档

delNoticeSlot(type)

删除指定类型的通知渠道

传参：type
返回：Promise<number>

type传参说明，仅支持以下参数

参数	说明
UNKNOWN_TYPE	未知类型
SOCIAL_COMMUNICATION	社交通信
SERVICE_INFORMATION	服务提醒
CONTENT_INFORMATION	内容资讯
CUSTOMER_SERVICE	客服消息
OTHER_TYPES	其他

返回的code码说明

code码	说明
200	成功
其它码	鸿蒙文档地址

pushNotice(parameters)

传参：parameters

发布文本类型通知

参数	类型	说明
id	number	通知ID，默认为0。当相同通知ID存在时，将更新该通知的内容。
type	string	通知内容类型, 见下文
title	string	通知标题（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
text	string	通知内容（不可为空字符串，大小不超过3072字节，超出部分会被截断）。
additionalText	string	通知附加内容，是对通知内容的补充（大小不超过3072字节，超出部分会被截断）。
briefText	string	通知概要内容，是对通知内容的总结（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
longTitle	string	通知展开时的标题（不可为空字符串，大小不超过1024字节，超出部分会被截断）。
lines	`Array<string>`	通知的多行文本（最多支持三行，每行大小不超过1024字节，超出部分会被截断）。
extraInfo	`{[key: string]: any}`	扩展参数。为应用提供定制服务。
slotType	string	通知渠道类型，默认为OTHER_TYPES。参考渠道类型
isAlertOnce	boolean	发布或更新该通知时，是否只进行一次通知提醒，默认为false。
badgeNumber	number	应用程序图标上显示的通知数，该数量累计展示。当badgeNumber取值小于或等于0时，将忽略本次角标设定。
updateOnly	boolean	是否仅更新通知，默认值为false。
onClick	Function	通知被点击的事件回调

type类型如下

参数	说明
NOTIFICATION_CONTENT_BASIC_TEXT	普通文本类型通知
NOTIFICATION_CONTENT_MULTILINE	多行文本类型通知

type 为 NOTIFICATION_CONTENT_BASIC_TEXT 时，以下参数不可用

briefText 、 longTitle 、 lines

type 为 NOTIFICATION_CONTENT_MULTILINE 时，以下参数不可用

additionalText

isAlertOnce 说明

发布或更新该通知时，是否只进行一次通知提醒，默认为false。

true：仅首次发布通知时进行提醒，后续更新该通知时，提醒方式变更为LEVEL_MIN。

false：每次均按照配置的通知提醒方式进行提醒。

badgeNumber 说明

应用程序图标上显示的通知数，该数量累计展示。

当badgeNumber取值小于或等于0时，将忽略本次角标设定。

当角标累加设定个数取值大于99时，通知角标将显示99+。

例如，应用发布3条通知，badgeNumber依次设置为2、0、3，应用将依次展示为2、2、5。

updateOnly 说明

是否仅更新通知，默认值为false。

true：若相同ID通知存在，则更新通知；若相同ID通知不存在，则更新失败，不创建新的通知。

false：若相同ID通知存在，则更新通知；若相同ID通知不存在，则创建通知。

返回：Promise<number>

code码	说明
200	成功
其它码	鸿蒙文档地址

cancelNotice(id)

取消指定通知消息

传参：id<number>
返回：Promise<number>

id传参说明

参数	说明
id	通知id

返回的code码说明

code码	说明
200	成功
其它码	鸿蒙文档地址

cancelAllNotice()

取消所有通知消息

传参：-
返回：Promise<number>

返回的code码说明

code码	说明
200	成功
其它码	鸿蒙文档地址

常见问题

本插件仅限纯血鸿蒙使用，引入和使用，需要做好条件编译，以免其它平台出现问题
所有的api都是 Promise 返回
onClick 会返回你提供的参数内容