更新记录

1.0.0（2026-08-04）

• 首次发布插件
• 提供 Android App 端电量百分比获取能力
• 提供 Android App 端充电状态获取能力
• 补充基础使用说明和上架文档
• 修正插件平台声明，仅保留当前真实支持的平台

平台兼容性

uni-app(3.7.11)

UTS 电池状态

jun-battery-status 是一个用于 uni-app 的 UTS API 插件，提供获取设备当前电量和充电状态的能力。

当前发布版本面向 Android App 平台，适合以下场景：

• 电池状态展示
• 系统信息面板
• 设备检测工具
• 低电量提醒业务

平台支持

安装方式

将插件导入项目后，直接从插件根目录引入即可。

import { getBatteryStatus } from '@/uni_modules/jun-battery-status'

API

getBatteryStatus()

同步获取当前设备电池状态。

const result = getBatteryStatus()

返回数据结构：

{
  level: 86,
  isCharging: true
}

字段说明：

• level: 当前电量百分比，范围 0-100
• isCharging: 当前是否处于充电状态

使用示例

<template>
  <view>
    <button @click="readBattery">获取电量</button>
    <text>电量：{{ battery.level }}%</text>
    <text>状态：{{ battery.isCharging ? '充电中' : '未充电' }}</text>
  </view>
</template>

<script>
import { getBatteryStatus } from '@/uni_modules/jun-battery-status'

export default {
  data() {
    return {
      battery: {
        level: 0,
        isCharging: false
      }
    }
  },
  methods: {
    readBattery() {
      this.battery = getBatteryStatus()
    }
  }
}
</script>

实现说明

• Android 端通过系统电池广播 ACTION_BATTERY_CHANGED 获取状态
• 插件不依赖三方 SDK
• 插件不采集用户数据
• 插件不需要额外敏感权限

注意事项

• 当前版本实际上架能力仅包含 App Android
• 如果你计划发布 iOS 支持，请先补齐 utssdk/app-ios 的真实实现后再更新平台声明
• 如需做实时展示，建议在业务层自行定时调用 getBatteryStatus() 进行刷新

更新记录

详见 changelog.md