batteryManager

来自于:APICloud立即使用

getBatteryStatus getBatteryHealthInfo isBatteryPresent getBatteryLevel getBatteryScale getBatteryPluggedType getBatteryVoltage getBatteryTemperature getBatteryTechnology

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码供您参考。

概述

batteryManager 用于获取手机的电池信息,如电量,温度,电压等

  • 注意:以下方法中若返回 -1,均表示未知状态

getBatteryStatus

获取当前电池的充电状态

getBatteryStatus(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. status : 0 // 数字类型;充电状态
  3. }
  • status 取值范围:
    • 1 未知状态
    • 2 正在充电
    • 3 正在放电
    • 4 电池未充电
    • 5 电量充满

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.getBatteryStatus(function(ret){
  3. alert(JSON.stringify(ret.status));
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryHealthInfo

电池健康信息

getBatteryHealthInfo(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. health : 0 // 数字类型;电池状态
  3. }
  • health 取值范围:
    • 1 电池状态未知
    • 2 电池状态良好
    • 3 电池温度过高
    • 4 电池已损毁
    • 5 电池电压过高
    • 7 电池温度过低

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.getBatteryHealthInfo(function(ret){
  3. alert(ret);
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

isBatteryPresent

是否取出电池(注意:有些手机即使取出电池,只需要连接USB也可以工作,iOS 可以忽略该方法)

isBatteryPresent(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. isPresent : false // 布尔类型;是否取出电池
  3. }

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.isBatteryPresent(function(ret){
  3. alert(ret);
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryLevel

获取当前电池剩余电量

getBatteryLevel(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. level : 23.6 // 数字类型;剩余电量(百分比)
  3. }

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.getBatteryLevel(function(ret){
  3. alert(ret);
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryScale

获取当前电池剩余电量

getBatteryScale(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. scale : 100 // 数字类型;电池电量最大值
  3. }

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.getBatteryScale(function(ret){
  3. alert(ret);
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryPluggedType

获取当前电池的充电插线类型

getBatteryPluggedType(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. pluggedType : 0 // 数字类型;充电插线类型
  3. }
  • 取值范围:
    • 1 交流电插头
    • 2 USB插头充电
    • 4 无线充电

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.getBatteryPluggedType(function(ret){
  3. alert(ret);
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryVoltage

获取当前电池的电压

getBatteryVoltage(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. voltage : 3.5 // 数字类型;电压 单位:V(伏特)
  3. }

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.getBatteryVoltage(function(ret){
  3. alert(ret);
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryTemperature

获取当前电池的电压

getBatteryTemperature(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. temp : 19.8 // 数字类型;温度 单位:℃(摄氏度)
  3. }

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.getBatteryTemperature(function(ret){
  3. alert(ret);
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryTechnology

电池技术

getBatteryTechnology(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回值
  1. {
  2. tech : "li-xxx" // 数字类型;电池采用的技术
  3. }

示例代码

  1. var batteryManager = api.require('batteryManager');
  2. batteryManager.getBatteryTechnology(function(ret){
  3. alert(ret);
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本