電量信息

該模塊主要提供電池狀態(tài)和充放電狀態(tài)的查詢接口。

說明： 本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導入模塊

import batteryInfo from '@ohos.batteryInfo';

屬性

描述電池信息。

系統(tǒng)能力 ：SystemCapability.PowerManager.BatteryManager.Core

名稱	類型	可讀	可寫	描述
batterySOC	number	是	否	表示當前設備剩余電池電量百分比。
chargingStatus	[BatteryChargeState]	是	否	表示當前設備電池的充電狀態(tài)。
healthStatus	[BatteryHealthState]	是	否	表示當前設備電池的健康狀態(tài)。
pluggedType	[BatteryPluggedType]	是	否	表示當前設備連接的充電器類型。
voltage	number	是	否	表示當前設備電池的電壓，單位微伏。
technology	string	是	否	表示當前設備電池的技術型號。
batteryTemperature	number	是	否	表示當前設備電池的溫度，單位0.1攝氏度。
isBatteryPresent7+	boolean	是	否	表示當前設備是否支持電池或者電池是否在位。
batteryCapacityLevel9+	[BatteryCapacityLevel]	是	否	表示當前設備電池電量的等級。
estimatedRemainingChargeTime9+	number	是	否	表示當前設備充滿電的預估時間，單位毫秒。
totalEnergy9+	number	是	否	表示當前設備電池的總容量，單位毫安時。此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
nowCurrent9+	number	是	否	表示當前設備電池的電流，單位毫安。此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
remainingEnergy9+	number	是	否	表示當前設備電池的剩余容量，單位毫安時。此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

示例：

import batteryInfo from '@ohos.batteryInfo';
var batterySoc = batteryInfo.batterySOC;

BatteryPluggedType

表示連接的充電器類型的枚舉。

系統(tǒng)能力 ：SystemCapability.PowerManager.BatteryManager.Core

名稱	默認值	描述
NONE	0	表示連接充電器類型未知。
AC	1	表示連接的充電器類型為交流充電器。
USB	2	表示連接的充電器類型為USB。
WIRELESS	3	表示連接的充電器類型為無線充電器。

BatteryChargeState

表示電池充電狀態(tài)的枚舉。

系統(tǒng)能力 ：SystemCapability.PowerManager.BatteryManager.Core

名稱	默認值	描述
NONE	0	表示電池充電狀態(tài)未知。
ENABLE	1	表示電池充電狀態(tài)為使能狀態(tài)。
DISABLE	2	表示電池充電狀態(tài)為停止狀態(tài)。
FULL	3	表示電池充電狀態(tài)為已充滿狀態(tài)。

BatteryHealthState

表示電池健康狀態(tài)的枚舉。

系統(tǒng)能力 ：SystemCapability.PowerManager.BatteryManager.Core

名稱	默認值	描述
UNKNOWN	0	表示電池健康狀態(tài)未知。
GOOD	1	表示電池健康狀態(tài)為正常。
OVERHEAT	2	表示電池健康狀態(tài)為過熱。
OVERVOLTAGE	3	表示電池健康狀態(tài)為過壓。
COLD	4	表示電池健康狀態(tài)為低溫。
DEAD	5	表示電池健康狀態(tài)為僵死狀態(tài)。

BatteryCapacityLevel9+

表示電池電量等級的枚舉。

系統(tǒng)能力 ：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通用事件的鍵代碼。
HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿

搜狗高速瀏覽器截圖20240326151344.png

系統(tǒng)能力 ：SystemCapability.PowerManager.BatteryManager.Core

名稱	默認值	描述
EXTRA_SOC	0	表示剩余電池電量百分比的鍵代碼。
EXTRA_VOLTAGE	1	表示當前設備電池電壓的鍵代碼。
EXTRA_TEMPERATURE	2	表示當前設備電池溫度的鍵代碼。
EXTRA_HEALTH_STATE	3	表示當前設備電池健康狀態(tài)的鍵代碼。
EXTRA_PLUGGED_TYPE	4	表示當前設備連接的充電器類型的鍵代碼。
EXTRA_MAX_CURRENT	5	表示當前設備電池最大電流的鍵代碼。
EXTRA_MAX_VOLTAGE	6	表示當前設備電池最大電壓的鍵代碼。
EXTRA_CHARGE_STATE	7	表示當前設備電池充電狀態(tài)的鍵代碼。
EXTRA_CHARGE_COUNTER	8	表示當前設備電池充電次數(shù)的鍵代碼。
EXTRA_PRESENT	9	表示當前設備是否支持電池或者電池是否在位的鍵代碼。
EXTRA_TECHNOLOGY	10	表示當前設備電池技術型號的鍵代碼。