uni.getBatteryInfo(options)

获取电池电量信息

本 API 是 uni ext api，需下载插件：uni-getbatteryinfo

getBatteryInfo 兼容性

Web	微信小程序	Android	Android uni-app x UTS 插件	iOS	iOS uni-app x UTS 插件	HarmonyOS
4.0	4.35	3.9	3.9	4.11	4.11	x

参数

名称	类型	必填	默认值	兼容性	描述
options	GetBatteryInfoOptions	是	-	Web 微信小程序 Android iOS HarmonyOS - - - - x
名称 类型 必备 默认值 兼容性 描述 success (res: GetBatteryInfoSuccess) => void 否 - Web 微信小程序 Android iOS HarmonyOS - - - - x 接口调用成功的回调 fail (res: UniError) => void 否 - Web 微信小程序 Android iOS HarmonyOS - - - - x 接口调用失败的回调函数 complete (res: any) => void 否 - Web 微信小程序 Android iOS HarmonyOS - - - - x 接口调用结束的回调函数（调用成功、失败都会执行）

GetBatteryInfoSuccess 的属性值

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	Web 微信小程序 Android iOS HarmonyOS - - - - x
level	number	是	-	Web 微信小程序 Android iOS HarmonyOS - - - - x	设备电量，范围1 - 100
isCharging	boolean	是	-	Web 微信小程序 Android iOS HarmonyOS - - - - x	是否正在充电中

示例

hello uni-app x

扫码体验（手机浏览器跳转到App直达页）

扫码体验

Template

Script

<template>
  <view>
    <text>当前电量：{{level}}%</text>
    <text>是否充电中：{{isCharging}}</text>
  </view>
</template>

参见

• 相关 Bug
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.getBatteryInfoSync()

同步获取电池电量信息

本 API 是 uni ext api，需下载插件：uni-getbatteryinfo

getBatteryInfoSync 兼容性

Web	微信小程序	Android	Android uni-app x UTS 插件	iOS	iOS uni-app x UTS 插件	HarmonyOS
4.0	4.35	3.9	3.9	4.11	4.11	x

返回值

类型
GetBatteryInfoResult
名称 类型 必备 默认值 兼容性 描述 level number 是 - Web 微信小程序 Android iOS HarmonyOS - - - - x 设备电量，范围1 - 100 isCharging boolean 是 - Web 微信小程序 Android iOS HarmonyOS - - - - x 是否正在充电中

参见

• 相关 Bug
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

通用类型

GeneralCallbackResult

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	Web 微信小程序 Android iOS HarmonyOS - 4.41 - - -	错误信息