電量信息
該模塊主要提供電池狀態(tài)和充放電狀態(tài)的查詢接口。
說明: 本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口,采用上角標單獨標記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(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 | 是 | 否 | 表示當前設(shè)備剩余電池電量百分比。 |
chargingStatus | [BatteryChargeState] | 是 | 否 | 表示當前設(shè)備電池的充電狀態(tài)。 |
healthStatus | [BatteryHealthState] | 是 | 否 | 表示當前設(shè)備電池的健康狀態(tài)。 |
pluggedType | [BatteryPluggedType] | 是 | 否 | 表示當前設(shè)備連接的充電器類型。 |
voltage | number | 是 | 否 | 表示當前設(shè)備電池的電壓,單位微伏。 |
technology | string | 是 | 否 | 表示當前設(shè)備電池的技術(shù)型號。 |
batteryTemperature | number | 是 | 否 | 表示當前設(shè)備電池的溫度,單位0.1攝氏度。 |
isBatteryPresent7+ | boolean | 是 | 否 | 表示當前設(shè)備是否支持電池或者電池是否在位。 |
batteryCapacityLevel9+ | [BatteryCapacityLevel] | 是 | 否 | 表示當前設(shè)備電池電量的等級。 |
estimatedRemainingChargeTime9+ | number | 是 | 否 | 表示當前設(shè)備充滿電的預(yù)估時間,單位毫秒。 |
totalEnergy9+ | number | 是 | 否 | 表示當前設(shè)備電池的總?cè)萘浚瑔挝缓涟矔r。此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。 |
nowCurrent9+ | number | 是 | 否 | 表示當前設(shè)備電池的電流,單位毫安。此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。 |
remainingEnergy9+ | number | 是 | 否 | 表示當前設(shè)備電池的剩余容量,單位毫安時。此接口為系統(tǒng)接口,三方應(yī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直接拿
系統(tǒng)能力 :SystemCapability.PowerManager.BatteryManager.Core
名稱 | 默認值 | 描述 |
---|---|---|
EXTRA_SOC | 0 | 表示剩余電池電量百分比的鍵代碼。 |
EXTRA_VOLTAGE | 1 | 表示當前設(shè)備電池電壓的鍵代碼。 |
EXTRA_TEMPERATURE | 2 | 表示當前設(shè)備電池溫度的鍵代碼。 |
EXTRA_HEALTH_STATE | 3 | 表示當前設(shè)備電池健康狀態(tài)的鍵代碼。 |
EXTRA_PLUGGED_TYPE | 4 | 表示當前設(shè)備連接的充電器類型的鍵代碼。 |
EXTRA_MAX_CURRENT | 5 | 表示當前設(shè)備電池最大電流的鍵代碼。 |
EXTRA_MAX_VOLTAGE | 6 | 表示當前設(shè)備電池最大電壓的鍵代碼。 |
EXTRA_CHARGE_STATE | 7 | 表示當前設(shè)備電池充電狀態(tài)的鍵代碼。 |
EXTRA_CHARGE_COUNTER | 8 | 表示當前設(shè)備電池充電次數(shù)的鍵代碼。 |
EXTRA_PRESENT | 9 | 表示當前設(shè)備是否支持電池或者電池是否在位的鍵代碼。 |
EXTRA_TECHNOLOGY | 10 | 表示當前設(shè)備電池技術(shù)型號的鍵代碼。 |
審核編輯 黃宇
-
鴻蒙
+關(guān)注
關(guān)注
57文章
2383瀏覽量
42945
發(fā)布評論請先 登錄
相關(guān)推薦
評論