batteryManager

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

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18