更新记录

1.0.0(2026-06-07) 下载此版本

初次提交


平台兼容性

uni-app(5.12)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - - - - - - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

uni-app x(5.12)

Chrome Safari Android iOS 鸿蒙 微信小程序
- -

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 小程序
  • 百度小程序
  • 支付宝小程序

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

let listenerId = 0

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

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

getBatteryInfo 参数

属性 类型 必填 说明
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

getBatteryInfo 成功回调

属性 类型 说明
level number 设备电量,范围 1 - 100
isCharging boolean 是否正在充电中

onBatteryInfoChange 返回值

返回值 类型 说明
listenerId number 大于 0 表示监听已注册成功,可用于精确解绑;返回 0 表示当前平台未启动监听

offBatteryInfoChange 说明

调用方式 说明
uni.offBatteryInfoChange(listenerId) 只移除对应监听器
uni.offBatteryInfoChange() 移除全部监听器

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。