电量信息
该模块主要提供电池状态和充放电状态的查询接口。
说明： 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
导入模块
import batteryInfo from '@ohos.batteryInfo';
属性
描述电池信息。
系统能力：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 | 是 | 否 | 表示当前设备电池的剩余容量，单位毫安时。此接口为系统接口，三方应用不支持调用。 |
-
示例：
import batteryInfo from '@ohos.batteryInfo'; var batterySoc = batteryInfo.batterySOC;
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_NONE | 0 | 表示电池电量等级未知。 |
| LEVEL_FULL | 1 | 表示电池电量等级为满电量。 |
| LEVEL_HIGH | 2 | 表示电池电量等级为高电量。 |
| LEVEL_NORMAL | 3 | 表示电池电量等级为正常电量。 |
| LEVEL_LOW | 4 | 表示电池电量等级为低电量。 |
| LEVEL_CRITICAL | 5 | 表示电池电量等级为极低电量。 |
CommonEventBatteryChangedCode9+
表示COMMON_EVENT_BATTERY_CHANGED通用事件的键代码。
系统能力：SystemCapability.PowerManager.BatteryManager.Core
| 名称 | 默认值 | 描述 |
|---|---|---|
| EXTRA_SOC | 0 | 表示剩余电池电量百分比的键代码。 |
| EXTRA_VOLTAGE | 1 | 表示当前设备电池电压的键代码。 |
| EXTRA_TEMPERATURE | 2 | 表示当前设备电池温度的键代码。 |
| EXTRA_HEALTH_STATE | 3 | 表示当前设备电池健康状态的键代码。 |
| EXTRA_PLUGGED_TYPE | 4 | 表示当前设备连接的充电器类型的键代码。 |
| EXTRA_MAX_CURRENT | 5 | 表示当前设备电池最大电流的键代码。 |
| EXTRA_MAX_VOLTAGE | 6 | 表示当前设备电池最大电压的键代码。 |
| EXTRA_CHARGE_STATE | 7 | 表示当前设备电池充电状态的键代码。 |
| EXTRA_CHARGE_COUNTER | 8 | 表示当前设备电池充电次数的键代码。 |
| EXTRA_PRESENT | 9 | 表示当前设备是否支持电池或者电池是否在位的键代码。 |
| EXTRA_TECHNOLOGY | 10 | 表示当前设备电池技术型号的键代码。 |
