@ohos.batteryInfo (电量信息)


@ohos.batteryInfo (电量信息)

该模块主要提供电池状态和充放电状态的查询接口。

说明:

本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import batteryInfo from '@ohos.batteryInfo';
1

属性

描述电池信息。

系统能力:SystemCapability.PowerManager.BatteryManager.Core

名称 类型 可读 可写 说明
batterySOC number 表示当前设备剩余电池电量百分比。
chargingStatus BatteryChargeState 表示当前设备电池的充电状态。
healthStatus BatteryHealthState 表示当前设备电池的健康状态。
pluggedType BatteryPluggedType 表示当前设备连接的充电器类型。
voltage number 表示当前设备电池的电压,单位微伏。
technology string 表示当前设备电池的技术型号。
batteryTemperature number 表示当前设备电池的温度,单位0.1摄氏度。
isBatteryPresent7+ boolean 表示当前设备是否支持电池或者电池是否在位。
batteryCapacityLevel9+ BatteryCapacityLevel 表示当前设备电池电量的等级。
estimatedRemainingChargeTime9+ number 表示当前设备充满电的预估时间,单位毫秒。此接口为系统接口。
totalEnergy9+ number 表示当前设备电池的总容量,单位毫安时。此接口为系统接口。
nowCurrent9+ number 表示当前设备电池的电流,单位毫安。此接口为系统接口。
remainingEnergy9+ number 表示当前设备电池的剩余容量,单位毫安时。此接口为系统接口。

BatteryPluggedType

表示连接的充电器类型的枚举。

系统能力:SystemCapability.PowerManager.BatteryManager.Core

名称 说明
NONE 0 表示连接充电器类型未知。
AC 1 表示连接的充电器类型为交流充电器。
USB 2 表示连接的充电器类型为USB。
WIRELESS 3 表示连接的充电器类型为无线充电器。

BatteryChargeState

表示电池充电状态的枚举。

系统能力:SystemCapability.PowerManager.BatteryManager.Core

名称 说明
NONE 0 表示电池充电状态未知。
ENABLE 1 表示电池充电状态为使能状态。
DISABLE 2 表示电池充电状态为停止状态。
FULL 3 表示电池充电状态为已充满状态。

BatteryHealthState

表示电池健康状态的枚举。

系统能力:SystemCapability.PowerManager.BatteryManager.Core

名称 说明
UNKNOWN 0 表示电池健康状态未知。
GOOD 1 表示电池健康状态为正常。
OVERHEAT 2 表示电池健康状态为过热。
OVERVOLTAGE 3 表示电池健康状态为过压。
COLD 4 表示电池健康状态为低温。
DEAD 5 表示电池健康状态为僵死状态。

BatteryCapacityLevel9+

表示电池电量等级的枚举。

系统能力:SystemCapability.PowerManager.BatteryManager.Core

名称 说明
LEVEL_FULL 1 表示电池电量等级为满电量。
LEVEL_HIGH 2 表示电池电量等级为高电量。
LEVEL_NORMAL 3 表示电池电量等级为正常电量。
LEVEL_LOW 4 表示电池电量等级为低电量。
LEVEL_WARNING 5 表示电池电量等级为告警电量。
LEVEL_CRITICAL 6 表示电池电量等级为极低电量。
LEVEL_SHUTDOWN 7 表示电池电量等级为关机电量。

CommonEventBatteryChangedKey9+

表示COMMON_EVENT_BATTERY_CHANGED通用事件附加信息的查询键。

系统能力:SystemCapability.PowerManager.BatteryManager.Core

名称 说明
EXTRA_SOC "soc" 表示剩余电池电量百分比的查询键。
EXTRA_CHARGE_STATE "chargeState" 表示当前设备电池充电状态的查询键。
EXTRA_HEALTH_STATE "healthState" 表示当前设备电池健康状态的查询键。
EXTRA_PLUGGED_TYPE "pluggedType" 表示当前设备连接的充电器类型的查询键。
EXTRA_VOLTAGE "voltage" 表示当前设备电池电压的查询键。
EXTRA_TECHNOLOGY "technology" 表示当前设备电池技术型号的查询键。
EXTRA_TEMPERATURE "temperature" 表示当前设备电池温度的查询键。
EXTRA_PRESENT "present" 表示当前设备是否支持电池或者电池是否在位的查询键。
EXTRA_CAPACITY_LEVEL "capacityLevel" 表示当前设备电池电量等级的查询键。