1# Battery (V2_0)
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_v20.md) | 提供电池信息的回调。 | 
21| [IBatteryInterface.idl](_i_battery_interface_8idl_v20.md) | Provides 获取、订阅电池信息的接口。 | 
22| [Types.idl](battery_types_8idl_v20.md) | 电池信息相关数据类型。 | 
23
24
25### 类
26
27| 名称 | 描述 | 
28| -------- | -------- |
29| interface  [IBatteryCallback](interface_i_battery_callback_v20.md) | 表示电池信息的回调。 | 
30| interface  [IBatteryInterface](interface_i_battery_interface_v20.md) | 获取、订阅电池信息的接口。 | 
31| struct  [BatteryInfo](_battery_info_v20.md) | 电池相关信息。 | 
32| struct  [ChargingLimit](_charging_limit_v20.md) | 定义电池充电电流或电压的限制。 | 
33
34
35### 枚举
36
37| 名称 | 描述 | 
38| -------- | -------- |
39| [BatteryHealthState](#batteryhealthstate) {<br/>BATTERY_HEALTH_UNKNOWN = 0, BATTERY_HEALTH_GOOD, BATTERY_HEALTH_OVERHEAT, BATTERY_HEALTH_OVERVOLTAGE,&nbsp;&nbsp;&nbsp;BATTERY_HEALTH_COLD, BATTERY_HEALTH_DEAD, BATTERY_HEALTH_RESERVED<br/>} | 电池的健康状态。 | 
40| [BatteryChargeState](#batterychargestate) {<br/>CHARGE_STATE_NONE = 0, CHARGE_STATE_ENABLE, CHARGE_STATE_DISABLE, CHARGE_STATE_FULL, CHARGE_STATE_RESERVED<br/>} | 电池的充电状态。 | 
41| [BatteryPluggedType](#batterypluggedtype) {<br/>PLUGGED_TYPE_NONE = 0, PLUGGED_TYPE_AC, PLUGGED_TYPE_USB, PLUGGED_TYPE_WIRELESS,&nbsp;&nbsp;&nbsp;PLUGGED_TYPE_BUTT<br/>} | 电池的充电设备类型。 | 
42| [ChargingLimitType](#charginglimittype) { TYPE_CURRENT = 0 , TYPE_VOLTAGE } | 定义电池充电限制类型。 | 
43| [ChargeType](#chargetype) {<br/>CHARGE_TYPE_NONE = 0 , CHARGE_TYPE_WIRED_NORMAL , CHARGE_TYPE_WIRED_QUICK , CHARGE_TYPE_WIRED_SUPER_QUICK ,<br/>CHARGE_TYPE_WIRELESS_NORMAL , CHARGE_TYPE_WIRELESS_QUICK , CHARGE_TYPE_WIRELESS_SUPER_QUICK<br/>} | 表示插入的充电器类型。 | 
44
45
46## 枚举类型说明
47
48
49### BatteryChargeState
50
51```
52enum BatteryChargeState
53```
54
55**描述**
56
57电池的充电状态。
58
59**起始版本：** 3.1
60
61| 枚举值 | 描述 | 
62| -------- | -------- |
63| CHARGE_STATE_NONE | 表示电池充电状态未知。 | 
64| CHARGE_STATE_ENABLE | 表示电池充电状态为使能状态。 | 
65| CHARGE_STATE_DISABLE | 表示电池充电状态为停止状态。 | 
66| CHARGE_STATE_FULL | 表示电池充电状态为已充满状态。 | 
67| CHARGE_STATE_RESERVED | 预留。 | 
68
69
70### BatteryHealthState
71
72```
73enum BatteryHealthState
74```
75
76**描述**
77
78电池的健康状态。
79
80**起始版本：** 3.1
81
82| 枚举值 | 描述 | 
83| -------- | -------- |
84| BATTERY_HEALTH_UNKNOWN | 表示电池健康状态未知。 | 
85| BATTERY_HEALTH_GOOD | 表示电池健康状态为正常。 | 
86| BATTERY_HEALTH_OVERHEAT | 表示电池健康状态为过热。 | 
87| BATTERY_HEALTH_OVERVOLTAGE | 表示电池健康状态为过压。 | 
88| BATTERY_HEALTH_COLD | 表示电池健康状态为低温。 | 
89| BATTERY_HEALTH_DEAD | 表示电池健康状态为耗尽。 | 
90| BATTERY_HEALTH_RESERVED | 预留。 | 
91
92
93### BatteryPluggedType
94
95```
96enum BatteryPluggedType
97```
98
99**描述**
100
101电池的充电设备类型。
102
103**起始版本：** 3.2
104
105| 枚举值 | 描述 | 
106| -------- | -------- |
107| PLUGGED_TYPE_NONE | 表示连接充电器类型未知。 | 
108| PLUGGED_TYPE_AC | 表示连接的充电器类型为交流充电器。 | 
109| PLUGGED_TYPE_USB | 表示连接的充电器类型为USB充电器。 | 
110| PLUGGED_TYPE_WIRELESS | 表示连接的充电器类型为无线充电器。 | 
111| PLUGGED_TYPE_BUTT | 预留。 | 
112
113
114### ChargeType
115
116```
117enum ChargeType
118```
119
120**描述**
121
122表示插入的充电器类型。
123
124**起始版本：** 4.0
125
126| 枚举值 | 描述 | 
127| -------- | -------- |
128| CHARGE_TYPE_NONE | 未知类型 | 
129| CHARGE_TYPE_WIRED_NORMAL | 有线普通型 | 
130| CHARGE_TYPE_WIRED_QUICK | 有线快速型 | 
131| CHARGE_TYPE_WIRED_SUPER_QUICK | 有线超快速型 | 
132| CHARGE_TYPE_WIRELESS_NORMAL | 无线普通型 | 
133| CHARGE_TYPE_WIRELESS_QUICK | 无线快速型 | 
134| CHARGE_TYPE_WIRELESS_SUPER_QUICK | 无线超快速型 | 
135
136
137### ChargingLimitType
138
139```
140enum ChargingLimitType
141```
142
143**描述**
144
145定义电池充电限制类型。
146
147**起始版本：** 3.2
148
149| 枚举值 | 描述 | 
150| -------- | -------- |
151| TYPE_CURRENT | 限制类型：充电电流 | 
152| TYPE_VOLTAGE | 限制类型：充电电压 | 
153