電量信息

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

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

導(dǎo)入模塊

import batteryInfo from '@ohos.batteryInfo';

屬性

描述電池信息。

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

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

示例：

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

BatteryPluggedType

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

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

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

BatteryChargeState

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

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

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

BatteryHealthState

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

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

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

BatteryCapacityLevel9+

表示電池電量等級(jí)的枚舉。

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

名稱	默認(rèn)值	描述
LEVEL_NONE	0	表示電池電量等級(jí)未知。
LEVEL_FULL	1	表示電池電量等級(jí)為滿電量。
LEVEL_HIGH	2	表示電池電量等級(jí)為高電量。
LEVEL_NORMAL	3	表示電池電量等級(jí)為正常電量。
LEVEL_LOW	4	表示電池電量等級(jí)為低電量。
LEVEL_CRITICAL	5	表示電池電量等級(jí)為極低電量。

CommonEventBatteryChangedCode9+

表示COMMON_EVENT_BATTERY_CHANGED通用事件的鍵代碼。
HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿

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

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

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

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴