更新记录

1.0.1（2025-07-18）

添加监听屏幕状态

1.0.0（2025-07-17）

代码首提

平台兼容性

uni-app(4.06)

uni-app x(4.06)

使用说明

引入插件后务必先打自定义基座后使用！！！

扫下面二维码下载 demo 查看效果

有关于该插件的疑问或者定制可以联系作者(备注来源)

插件采用动态注册广播接收器，而不是在 AndroidManifest.xml 中静态注册。这种方式更加灵活，可以控制接收器的生命周期。需要的时候开启，不需要的时候销毁！

微信号：z1003975792y

API 介绍

1、修改状态栏颜色 setStatusBarBackgroundColor

import { setStatusBarBackgroundColor } from '@/uni_modules/zy-bar'
// 参数必须是数字，由于vue的双向绑定会把绑定字段自动变为string，故需要Number()变更一下数据类型
setStatusBarBackgroundColor(255, 64, 158, 255)

2、显示/隐藏状态栏 setStatusBar

import { setStatusBar } from '@/uni_modules/zy-bar'
// 隐藏状态栏
setStatusBar(false)

3、监听屏幕状态 startOnScreen

import { startOnScreen } from '@/uni_modules/zy-bar'
startOnScreen({
    // 必填, 监听屏幕状态回调
    onScreenStateFun: (action) => {
        console.log(action) // SCREEN_ON 屏幕亮起、SCREEN_OFF 屏幕熄灭、USER_PRESENT 屏幕解锁
    },
    // 必填，监听开启监听的回调
    complete: (res) => {
        console.log(res) // {"code":200,"msg":"开启监听屏幕状态成功"} code 200是开启监听成功  500是失败
    },
    // 选填，通知title(默认值：屏幕状态监控)
    contentTitle: '测试title', // //对于Android 8及以上版本，如果你的应用处于后台，你需要将服务转变为前台服务来避免系统在一定时间后杀死服务。这需要通过创建一个持续在通知栏显示的通知来实现。
    // 选填，通知content(默认值：应用正在监控屏幕状态变化。这有助于提供定制的服务和改善用户体验。)
    contentText: '测试content',
})

4、关闭屏幕监听 stopOnScreen

import { stopOnScreen } from '@/uni_modules/zy-bar'
stopOnScreen((res) => {
    console.log(res) // {"code":200,"msg":"关闭成功"}  200 是关闭成功，500是关闭失败
})