更新记录

1.0.0（2026-02-04）

基于UTS开发的Android通知栏消息监听插件，支持实时拦截并获取微信、QQ等第三方App的通知栏消息，包含包名、标题、正文及时间戳，支持权限自动检测与引导开启。

平台兼容性

uni-app(4.51)

uni-app x(4.51)

jwt-tzl 通知栏监听插件

简介

jwt-tzl 是一款基于 uniapp UTS 开发的 Android 通知栏消息监听插件。它可以实时拦截系统中各个 App（如微信、QQ 等）推送到通知栏的消息，并获取消息的包名、标题、内容及时间。

功能特性

• 实时监听：实时获取通知栏新增的消息。
• 权限管理：内置通知使用权检查及一键跳转系统设置页申请权限。
• 数据全面：提供发件 App 包名、通知标题、通知正文及时间戳。
• UTS 实现：高性能，无缝对接 uniapp 业务层。

平台支持

• Android 5.0 (API 21) 及以上系统。

快速上手

1. 引入插件

在需要监听通知的页面中引入相关 API：

import { checkPermission, requestPermission, setNotificationCallback } from '@/uni_modules/jwt-tzl';

2. 初始化监听

建议在 onLoad 或 onShow 生命周期中设置回调并检查权限：

export default {
    onLoad() {
        // 设置通知监听回调
        setNotificationCallback((data) => {
            console.log('监听到新通知:');
            console.log('应用包名:', data.packageName);
            console.log('通知标题:', data.title);
            console.log('通知内容:', data.text);
            console.log('通知时间:', new Date(data.when).toLocaleString());
        });
    },
    methods: {
        async startService() {
            // 检查权限
            const hasPermission = checkPermission();
            if (!hasPermission) {
                uni.showModal({
                    title: '权限申请',
                    content: '监听通知需要授予“通知使用权”，请在设置页中勾选本应用',
                    confirmText: '去设置',
                    success: (res) => {
                        if (res.confirm) {
                            requestPermission();
                        }
                    }
                });
            }
        }
    }
}

API 说明

setNotificationCallback(callback)

设置通知监听的回调函数。

• callback: (data: NotificationData) => void

• NotificationData 属性说明:	属性名	类型	说明
  packageName	string	发送通知的应用包名 (如: com.tencent.mm)
  title	string	通知标题
  text	string	通知正文内容
  when	number	通知产生的时间戳 (毫秒)

checkPermission()

检查当前应用是否已获得“通知使用权”。

• 返回值: boolean (true: 已获得, false: 未获得)

requestPermission()

跳转到 Android 系统设置中的“通知使用权”页面，引导用户手动开启权限。

注意事项

1. 必须手动开启权限：由于 Android 系统安全机制，通知监听权限必须由用户手动在系统设置中授予。
2. 自定义基座：使用 UTS 插件必须进行“自定义基座”打包后才能运行调试。
3. 白名单配置：在 manifest.json 中已自动配置了 BIND_NOTIFICATION_LISTENER_SERVICE 权限，请勿删除。
4. 后台运行：建议配合原生保活或开启应用自启动权限，以确保服务在后台稳定运行。