qg.battery

基础信息说明

功能概述：提供设备电量信息的同步查询与异步获取，返回电量百分比与充电状态

项目	说明
版本要求	无
前提条件	设备支持系统电量查询能力
使用限制	无
相关教程	无

方法说明

方法名	签名	同步/异步	说明
getBatteryInfo	qg.getBatteryInfo(object): void	异步回调	获取设备电量信息，结果通过 success 回调返回
getBatteryInfoSync	qg.getBatteryInfoSync(): Object	同步	同步返回设备电量信息对象

参数说明

qg.getBatteryInfo(object)

属性名	类型	必填	说明
success	Function	否	成功回调，入参 { level: Number, isCharging: Boolean }
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

qg.getBatteryInfoSync()

返回值属性	类型	说明
level	Number	电量百分比（范围 0–1，以设备实现为准）
isCharging	Boolean	是否处于充电状态

返回值说明

getBatteryInfo：无直接返回，通过 success 回调返回 { level, isCharging }
getBatteryInfoSync：同步返回 { level, isCharging }；当系统不可用或无数据时可能返回空值

回调结果说明

回调成功
getBatteryInfo 回调参数

属性名	类型	说明
level	Number	电量百分比（范围 0–100%，以设备实现为准）
isCharging	Boolean	是否处于充电状态

示例代码

// 异步获取电量信息
qg.getBatteryInfo({
  success(res) {
    console.log('battery level:', res.level, 'isCharging:', res.isCharging)
  },
  fail(err) {
    console.log('getBatteryInfo fail', err)
  },
  complete() {
    console.log('getBatteryInfo complete')
  }
})

// 同步获取电量信息
const info = qg.getBatteryInfoSync()
if (info) {
  console.log('battery level:', info.level, 'isCharging:', info.isCharging)
} else {
  console.log('battery info unavailable')
}

注意事项

电量百分比范围与精度取决于设备实现，建议用于展示与简单逻辑判断。
某些设备或系统版本可能限制电量信息的访问，需确保具备相应权限。

上一篇:地理位置

下一篇:剪贴板

文档内容是否有帮助？

有帮助

无帮助