batteryManager

来自于：APICloud立即使用

• Method

getBatteryStatus getBatteryHealthInfo isBatteryPresent getBatteryLevel getBatteryScale getBatteryPluggedType getBatteryVoltage getBatteryTemperature getBatteryTechnology

论坛示例

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

概述

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及更高版本