更新记录

1.0.0（2026-06-07） 下载此版本

初次提交

平台兼容性

uni-app(5.12)

uni-app x(5.12)

laoqianjunzi-battery

插件简介

laoqianjunzi-battery 是一个基于 uni-getbatteryinfo 二次开发的电池信息插件，用于在 App、Web 和部分小程序平台获取设备电量及充电状态。

本插件可以理解为基于官方插件能力扩展的增强版，在保留基础电池信息获取能力的同时，补充了更多平台适配与电量变化监听能力，适合需要更完整电池状态能力的项目使用。

官方插件地址：https://ext.dcloud.net.cn/plugin?name=uni-getbatteryinfo

使用文档

获取当前电量快照

uni.getBatteryInfo({
    success(res) {
        console.log(res)
        uni.showToast({
            title: '当前电量：' + res.level + '%',
            icon: 'none'
        })
    }
})

监听电量与充电状态变化

当前版本支持以下真实事件监听：

• Android：基于系统电池广播
• iOS：基于 UIDevice 电池状态通知
• HarmonyOS：基于 COMMON_EVENT_BATTERY_CHANGED
• Web：基于 navigator.getBattery() 返回的 BatteryManager 事件，需浏览器自身支持

以下平台暂不支持真实事件监听，uni.onBatteryInfoChange 会返回 0：

• 微信小程序
• QQ 小程序
• 百度小程序
• 支付宝小程序

注册监听后会立即回调一次当前状态，后续只有在 level 或 isCharging 发生变化时才会继续回调。

let listenerId = 0

listenerId = uni.onBatteryInfoChange((res) => {
    console.log('battery change', res.level, res.isCharging)
})

if (listenerId > 0) {
    uni.offBatteryInfoChange(listenerId)
}

getBatteryInfo 参数

getBatteryInfo 成功回调

onBatteryInfoChange 返回值

offBatteryInfoChange 说明