更新记录

1.1.0（2026-06-14） 下载此版本

• 新增 iOS 原生应用内横幅通知，支持紧凑布局、毛玻璃视觉和手势交互
• 新增 Android 原生应用内横幅通知，支持紧凑胶囊样式与原生过渡动画
• 新增图片、标题、正文、时间、附带数据、自动关闭时长、提示音等通知参数
• 新增点击回调、消失回调、长按暂停、上滑关闭、自动消失、通知队列和覆盖切换能力
• 优化双端顶部安全区适配、横幅尺寸、图文排版和交互动效
• 优化 Android 提示音策略，优先使用系统通知音
• 完善插件文档、接口注释和插件市场发布信息

平台兼容性

uni-app(3.7.12)

uni-app x(3.7.12)

其他

kongbai-AppNotice

kongbai-AppNotice 是一个面向 uni-app x 的轻量原生应用内横幅通知 UTS API 插件。

它的目标不是系统通知栏，而是像 QQ / 微信那样，在应用前台顶部展示一条可交互、不中断当前页面操作的原生横幅通知。

插件特点

• 原生实现：Android / iOS 分别使用原生视图与动画实现
• 轻量 API：只暴露图片、标题、消息、时间、附带数据、时长、提示音等必要参数
• 不耦合业务：插件只负责展示、关闭、点击回传，不内置跳转逻辑
• 紧凑布局：当前版本为小巧胶囊式横幅，适合消息提醒场景
• 交互完整：支持点击、长按暂停自动消失、上滑关闭、队列管理、覆盖式切换
• 提示音支持：支持按参数控制是否播放系统提示音

适用场景

• 聊天消息前台提醒
• 页面内全局系统提示
• 轻量业务提醒条
• 不希望使用系统通知栏、又希望保留原生交互和动画的场景

平台兼容

安装方式

将插件放入项目的 uni_modules 目录后，按常规 uni_modules 方式使用即可。

import { showPluginInAppNotice, dismissPluginInAppNotice } from '@/uni_modules/kongbai-AppNotice'

快速开始

import { showPluginInAppNotice } from '@/uni_modules/kongbai-AppNotice'

showPluginInAppNotice({
  image: '/static/logo.png',
  title: '应用内通知演示',
  message: '这是一条纯原生 UTS 插件提供的通知消息',
  payload: JSON.stringify({ type: 'demo_notice' }),
  playSound: true
}, (payload: string) => {
  console.log('notice click payload:', payload)
}, () => {
  console.log('notice dismissed')
})

API 说明

showPluginInAppNotice(options, onClick, onDismiss)

显示一条应用内横幅通知。

参数

回调

dismissPluginInAppNotice()

主动关闭当前横幅通知，并清空等待中的通知队列。

交互说明

• 点击通知：触发 onClick
• 长按通知：暂停自动消失计时
• 松手恢复：恢复自动消失或继续处理队列
• 上滑关闭：直接移除当前通知
• 连续推送多条：新通知覆盖切换到展示位，旧通知平滑退场

设计说明

当前版本以“轻量、小巧、圆滑、灵动”为主要设计方向：

• iOS 使用原生毛玻璃与原生动画
• Android 使用紧凑胶囊布局、圆角卡片与原生过渡动画
• 双端都处理了顶部安全区

注意事项

• 本插件当前主打 uni-app x App 端，不建议直接用于 H5 / 小程序
• Android 端编译时可能出现 getUniActivity() 的废弃警告，目前不影响插件正常工作
• playSound: true 依赖系统音量、静音模式与音频路由，最终以真机表现为准
• 插件不负责业务跳转，如需点击后打开聊天页、详情页，请在 onClick 中自行处理
• payload 由业务层自行约定格式，插件不解析内容

目录结构

kongbai-AppNotice/
├─ package.json
├─ readme.md
├─ changelog.md
└─ utssdk/
   ├─ interface.uts
   ├─ app-android/
   │  ├─ config.json
   │  └─ index.uts
   ├─ app-ios/
   │  ├─ config.json
   │  └─ index.uts
   └─ app-harmony/
      ├─ config.json
      └─ index.uts

更新日志

详细更新内容见 changelog.md。

参考文档

• UTS 插件介绍
• uni_modules 规范
• UTS 语法