1# 电量信息 2 3>  **说明：** 4> 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 5 6该模块主要提供电池状态和充放电状态的查询接口。 7 8 9## 导入模块 10 11```js 12import batteryInfo from '@ohos.batteryInfo'; 13``` 14 15## 系统能力 16 17SystemCapability.PowerManager.BatteryManager.Core 18 19## 属性 20 21描述电池信息。 22 23| 名称 | 类型 | 可读 | 可写 | 描述 | 24| ----------------------------- | ---------------------------------------- | ---- | ---- | --------------------- | 25| batterySOC | number | 是 | 否 | 表示当前设备剩余电池电量百分比。 | 26| chargingStatus | [BatteryChargeState](#batterychargestate) | 是 | 否 | 表示当前设备电池的充电状态。 | 27| healthStatus | [BatteryHealthState](#batteryhealthstate) | 是 | 否 | 表示当前设备电池的健康状态。 | 28| pluggedType | [BatteryPluggedType](#batterypluggedtype) | 是 | 否 | 表示当前设备连接的充电器类型。 | 29| voltage | number | 是 | 否 | 表示当前设备电池的电压，单位微伏。 | 30| technology | string | 是 | 否 | 表示当前设备电池的技术型号。 | 31| batteryTemperature | number | 是 | 否 | 表示当前设备电池的温度，单位0.1摄氏度。 | 32| isBatteryPresent<sup>7+</sup> | boolean | 是 | 否 | 表示当前设备是否支持电池或者电池是否在位。 | 33 34- 示例： 35 ```js 36 import batteryInfo from '@ohos.batteryInfo'; 37 var batterySoc = batteryInfo.batterySOC; 38 ``` 39 40 41## BatteryPluggedType 42 43表示连接的充电器类型的枚举。 44 45 46| 名称 | 默认值 | 描述 | 47| -------- | ---- | ----------------- | 48| NONE | 0 | 表示连接充电器类型未知。 | 49| AC | 1 | 表示连接的充电器类型为交流充电器。 | 50| USB | 2 | 表示连接的充电器类型为USB。 | 51| WIRELESS | 3 | 表示连接的充电器类型为无线充电器。 | 52 53 54## BatteryChargeState 55 56表示电池充电状态的枚举。 57 58 59| 名称 | 默认值 | 描述 | 60| ------- | ---- | --------------- | 61| NONE | 0 | 表示电池充电状态未知。 | 62| ENABLE | 1 | 表示电池充电状态为使能状态。 | 63| DISABLE | 2 | 表示电池充电状态为停止状态。 | 64| FULL | 3 | 表示电池充电状态为已充满状态。 | 65 66 67## BatteryHealthState 68 69表示电池的健康状态的枚举。 70 71 72| 名称 | 默认值 | 描述 | 73| ----------- | ---- | -------------- | 74| UNKNOWN | 0 | 表示电池健康状态未知。 | 75| GOOD | 1 | 表示电池健康状态为正常。 | 76| OVERHEAT | 2 | 表示电池健康状态为过热。 | 77| OVERVOLTAGE | 3 | 表示电池健康状态为过压。 | 78| COLD | 4 | 表示电池健康状态为低温。 | 79| DEAD | 5 | 表示电池健康状态为僵死状态。 | 80
