1# @ohos.batteryInfo (电量信息) 2 3该模块主要提供电池状态和充放电状态的查询接口。 4 5> **说明：** 6> 7> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9 10## 导入模块 11 12```js 13import batteryInfo from '@ohos.batteryInfo'; 14``` 15 16## 属性 17 18描述电池信息。 19 20**系统能力**：SystemCapability.PowerManager.BatteryManager.Core 21 22| 名称 | 类型 | 可读 | 可写 | 说明 | 23| --------------- | ------------------- | ---- | ---- | ---------------------| 24| batterySOC | number | 是 | 否 | 表示当前设备剩余电池电量百分比。 | 25| chargingStatus | [BatteryChargeState](#batterychargestate) | 是 | 否 | 表示当前设备电池的充电状态。 | 26| healthStatus | [BatteryHealthState](#batteryhealthstate) | 是 | 否 | 表示当前设备电池的健康状态。 | 27| pluggedType | [BatteryPluggedType](#batterypluggedtype) | 是 | 否 | 表示当前设备连接的充电器类型。 | 28| voltage | number | 是 | 否 | 表示当前设备电池的电压，单位微伏。 | 29| technology | string | 是 | 否 | 表示当前设备电池的技术型号。 | 30| batteryTemperature | number | 是 | 否 | 表示当前设备电池的温度，单位0.1摄氏度。 | 31| isBatteryPresent<sup>7+</sup> | boolean | 是 | 否 | 表示当前设备是否支持电池或者电池是否在位。 | 32| batteryCapacityLevel<sup>9+</sup> | [BatteryCapacityLevel](#batterycapacitylevel9) | 是 | 否 | 表示当前设备电池电量的等级。 | 33| estimatedRemainingChargeTime<sup>9+</sup> | number | 是 | 否 | 表示当前设备充满电的预估时间，单位毫秒。此接口为系统接口。 | 34| totalEnergy<sup>9+</sup> | number | 是 | 否 | 表示当前设备电池的总容量，单位毫安时。此接口为系统接口。 | 35| nowCurrent<sup>9+</sup> | number | 是 | 否 | 表示当前设备电池的电流，单位毫安。此接口为系统接口。 | 36| remainingEnergy<sup>9+</sup> | number | 是 | 否 | 表示当前设备电池的剩余容量，单位毫安时。此接口为系统接口。 | 37 38## BatteryPluggedType 39 40表示连接的充电器类型的枚举。 41 42**系统能力**：SystemCapability.PowerManager.BatteryManager.Core 43 44| 名称 | 值 | 说明 | 45| -------- | ---- | ----------------- | 46| NONE | 0 | 表示连接充电器类型未知。 | 47| AC | 1 | 表示连接的充电器类型为交流充电器。 | 48| USB | 2 | 表示连接的充电器类型为USB。 | 49| WIRELESS | 3 | 表示连接的充电器类型为无线充电器。 | 50 51## BatteryChargeState 52 53表示电池充电状态的枚举。 54 55**系统能力**：SystemCapability.PowerManager.BatteryManager.Core 56 57| 名称 | 值 | 说明 | 58| ------- | ---- | --------------- | 59| NONE | 0 | 表示电池充电状态未知。 | 60| ENABLE | 1 | 表示电池充电状态为使能状态。 | 61| DISABLE | 2 | 表示电池充电状态为停止状态。 | 62| FULL | 3 | 表示电池充电状态为已充满状态。 | 63 64## BatteryHealthState 65 66表示电池健康状态的枚举。 67 68**系统能力**：SystemCapability.PowerManager.BatteryManager.Core 69 70| 名称 | 值 | 说明 | 71| ----------- | ---- | -------------- | 72| UNKNOWN | 0 | 表示电池健康状态未知。 | 73| GOOD | 1 | 表示电池健康状态为正常。 | 74| OVERHEAT | 2 | 表示电池健康状态为过热。 | 75| OVERVOLTAGE | 3 | 表示电池健康状态为过压。 | 76| COLD | 4 | 表示电池健康状态为低温。 | 77| DEAD | 5 | 表示电池健康状态为僵死状态。 | 78 79## BatteryCapacityLevel<sup>9+</sup> 80 81表示电池电量等级的枚举。 82 83**系统能力**：SystemCapability.PowerManager.BatteryManager.Core 84 85| 名称 | 值 | 说明 | 86| -------------- | ------ | ---------------------------- | 87| LEVEL_FULL | 1 | 表示电池电量等级为满电量。 | 88| LEVEL_HIGH | 2 | 表示电池电量等级为高电量。 | 89| LEVEL_NORMAL | 3 | 表示电池电量等级为正常电量。 | 90| LEVEL_LOW | 4 | 表示电池电量等级为低电量。 | 91| LEVEL_WARNING | 5 | 表示电池电量等级为告警电量。 | 92| LEVEL_CRITICAL | 6 | 表示电池电量等级为极低电量。 | 93| LEVEL_SHUTDOWN | 7 | 表示电池电量等级为关机电量。 | 94 95## CommonEventBatteryChangedKey<sup>9+</sup> 96 97表示COMMON_EVENT_BATTERY_CHANGED通用事件附加信息的查询键。 98 99**系统能力**：SystemCapability.PowerManager.BatteryManager.Core 100 101| 名称 | 值 | 说明 | 102| -------------------- | ------ | -------------------------------------------------- | 103| EXTRA_SOC | "soc" | 表示剩余电池电量百分比的查询键。 | 104| EXTRA_CHARGE_STATE | "chargeState" | 表示当前设备电池充电状态的查询键。 | 105| EXTRA_HEALTH_STATE | "healthState" | 表示当前设备电池健康状态的查询键。 | 106| EXTRA_PLUGGED_TYPE | "pluggedType" | 表示当前设备连接的充电器类型的查询键。 | 107| EXTRA_VOLTAGE | "voltage" | 表示当前设备电池电压的查询键。 | 108| EXTRA_TECHNOLOGY | "technology" | 表示当前设备电池技术型号的查询键。 | 109| EXTRA_TEMPERATURE | "temperature" | 表示当前设备电池温度的查询键。 | 110| EXTRA_PRESENT | "present" | 表示当前设备是否支持电池或者电池是否在位的查询键。 | 111| EXTRA_CAPACITY_LEVEL | "capacityLevel" | 表示当前设备电池电量等级的查询键。 | 112