batteryManager

来自于:APICloud立即使用

概述

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

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

getBatteryStatus

获取当前电池的充电状态

getBatteryStatus(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryHealthInfo

电池健康信息

getBatteryHealthInfo(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

isBatteryPresent

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

isBatteryPresent(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryLevel

获取当前电池剩余电量

getBatteryLevel(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryScale

获取当前电池剩余电量

getBatteryScale(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryPluggedType

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

getBatteryPluggedType(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryVoltage

获取当前电池的电压

getBatteryVoltage(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryTemperature

获取当前电池的电压

getBatteryTemperature(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getBatteryTechnology

电池技术

getBatteryTechnology(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本