1# Battery (V1_1)
2
3
4## 概述
5
6提供获取和订阅电池信息的接口。
7
8电池模块为电池服务提供的获取、订阅电池信息的接口。 服务获取此模块的对象或代理后，可以调用相关的接口获取电池信息、订阅电池信息的变化。
9
10**起始版本：** 3.2
11
12
13## 汇总
14
15
16### 文件
17
18| 名称 | 描述 |
19| -------- | -------- |
20| [IBatteryCallback.idl](_i_battery_callback_8idl_v11.md) | 提供电池信息的回调。 |
21| [IBatteryInterface.idl](_i_battery_interface_8idl_v11.md) | 提供用于获取和订阅电池信息的接口。 |
22| [Types.idl](battery_types_8idl_v11.md) | 电池信息相关数据类型。 |
23
24
25### 类
26
27| 名称 | 描述 |
28| -------- | -------- |
29| interface  [IBatteryCallback](interface_i_battery_callback_v11.md) | 表示电池信息的回调。 |
30| interface  [IBatteryInterface](interface_i_battery_interface_v11.md) | 获取、订阅电池信息的接口。 |
31| struct  [BatteryInfo](_battery_info_v11.md) | 电池相关信息。 |
32| struct  [ChargingLimit](_charging_limit_v11.md) | 定义电池充电电流或电压的限制。 |
33
34
35### 枚举
36
37| 名称 | 描述 |
38| -------- | -------- |
39| [BatteryHealthState](#batteryhealthstate) { BATTERY_HEALTH_UNKNOWN = 0, BATTERY_HEALTH_GOOD, BATTERY_HEALTH_OVERHEAT, BATTERY_HEALTH_OVERVOLTAGE,   BATTERY_HEALTH_COLD, BATTERY_HEALTH_DEAD, BATTERY_HEALTH_RESERVED } | 电池的健康状态。 |
40| [BatteryChargeState](#batterychargestate) { CHARGE_STATE_NONE = 0, CHARGE_STATE_ENABLE, CHARGE_STATE_DISABLE, CHARGE_STATE_FULL, CHARGE_STATE_RESERVED } | 电池的充电状态。 |
41| [BatteryPluggedType](#batterypluggedtype) { PLUGGED_TYPE_NONE = 0, PLUGGED_TYPE_AC, PLUGGED_TYPE_USB, PLUGGED_TYPE_WIRELESS,   PLUGGED_TYPE_BUTT } | 电池的充电设备类型。 |
42| [ChargingLimitType](#charginglimittype) { TYPE_CURRENT = 0 , TYPE_VOLTAGE } | 电池充电限制类型。 |
43
44
45## 枚举类型说明
46
47
48### BatteryChargeState
49
50```
51enum BatteryChargeState
52```
53
54**描述**
55
56电池的充电状态。
57
58**起始版本：** 3.1
59
60| 枚举值 | 描述 |
61| -------- | -------- |
62| CHARGE_STATE_NONE | 表示电池充电状态未知。 |
63| CHARGE_STATE_ENABLE | 表示电池充电状态为使能状态。 |
64| CHARGE_STATE_DISABLE | 表示电池充电状态为停止状态。 |
65| CHARGE_STATE_FULL | 表示电池充电状态为已充满状态。 |
66| CHARGE_STATE_RESERVED | 预留。 |
67
68
69### BatteryHealthState
70
71```
72enum BatteryHealthState
73```
74
75**描述**
76
77电池的健康状态。
78
79**起始版本：** 3.1
80
81| 枚举值 | 描述 |
82| -------- | -------- |
83| BATTERY_HEALTH_UNKNOWN | 表示电池健康状态未知。 |
84| BATTERY_HEALTH_GOOD | 表示电池健康状态为正常。 |
85| BATTERY_HEALTH_OVERHEAT | 表示电池健康状态为过热。 |
86| BATTERY_HEALTH_OVERVOLTAGE | 表示电池健康状态为过压。 |
87| BATTERY_HEALTH_COLD | 表示电池健康状态为低温。 |
88| BATTERY_HEALTH_DEAD | 表示电池健康状态为耗尽。 |
89| BATTERY_HEALTH_RESERVED | 预留。 |
90
91
92### BatteryPluggedType
93
94```
95enum BatteryPluggedType
96```
97
98**描述**
99
100电池的充电设备类型。
101
102**起始版本：** 3.2
103
104| 枚举值 | 描述 |
105| -------- | -------- |
106| PLUGGED_TYPE_NONE | 表示连接充电器类型未知。 |
107| PLUGGED_TYPE_AC | 表示连接的充电器类型为交流充电器。 |
108| PLUGGED_TYPE_USB | 表示连接的充电器类型为USB充电器。 |
109| PLUGGED_TYPE_WIRELESS | 表示连接的充电器类型为无线充电器。 |
110| PLUGGED_TYPE_BUTT | 预留。 |
111
112
113### ChargingLimitType
114
115```
116enum ChargingLimitType
117```
118
119**描述**
120
121电池充电限制类型。
122
123**起始版本：** 3.2
124
125| 枚举值 | 描述 |
126| -------- | -------- |
127| TYPE_CURRENT | 限制类型：充电电流 |
128| TYPE_VOLTAGE | 限制类型：充电电压 |
129