swan.getBatteryInfoSync

基础库 3.30.2 开始支持,低版本需做兼容处理。

解释: 获取当前设备电量同步接口,ios系统不可用。

方法参数

返回值说明

参数名类型说明
levelstring设备电量, 范围为1-100
isChargingboolean设备是否正在充电

示例

在开发者工具中预览效果

扫码体验

swan.getBatteryInfoSync - 图1" class="demo-qrcode-image" /> 请使用百度APP扫码

图片示例

swan.getBatteryInfoSync - 图2

swan.getBatteryInfoSync - 图3

swan.getBatteryInfoSync - 图4

代码示例

  • 在 js 文件中
  1. let res = swan.getBatteryInfoSync();
  2. // 基础库 3.140.1 之前,无法判断接口是否调用失败
  3. // 基础库 3.140.1 及以后,通过 instanceof 来判断接口是否调用失败
  4. if (!(res instanceof Error)) {
  5. console.log('当前设备电量值:', res.level);
  6. console.log('当前设备是否正在充电:', res.isCharging);
  7. }
  8. else {
  9. console.log('getBatteryInfoSync fail', res.errMsg || res.message);
  10. }

Bug & Tip

  • iOS 不可用时,返回值 level 为100, isCharging 为true。
  • 基础库 3.140.1 之前,无法判断接口是否调用失败。
  • 基础库 3.140.1 及以后,接口调用失败时会返回一个标准的Error对象,可通过instanceof来判断接口是否调用失败。