電量信息
說明: 本模塊首批接口從API version 6開始支持。后續版本的新增接口,采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 :[
gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
導入模塊
import batteryInfo from '@ohos.batteryInfo';
屬性
描述電池信息。
系統能力 :SystemCapability.PowerManager.BatteryManager.Core
名稱 | 類型 | 可讀 | 可寫 | 描述 |
---|---|---|---|---|
batterySOC | number | 是 | 否 | 表示當前設備剩余電池電量百分比。 |
chargingStatus | [BatteryChargeState] | 是 | 否 | 表示當前設備電池的充電狀態。 |
healthStatus | [BatteryHealthState] | 是 | 否 | 表示當前設備電池的健康狀態。 |
pluggedType | [BatteryPluggedType] | 是 | 否 | 表示當前設備連接的充電器類型。 |
voltage | number | 是 | 否 | 表示當前設備電池的電壓,單位微伏。 |
technology | string | 是 | 否 | 表示當前設備電池的技術型號。 |
batteryTemperature | number | 是 | 否 | 表示當前設備電池的溫度,單位0.1攝氏度。 |
isBatteryPresent7+ | boolean | 是 | 否 | 表示當前設備是否支持電池或者電池是否在位。 |
batteryCapacityLevel9+ | [BatteryCapacityLevel] | 是 | 否 | 表示當前設備電池電量的等級。 |
estimatedRemainingChargeTime9+ | number | 是 | 否 | 表示當前設備充滿電的預估時間,單位毫秒。 |
totalEnergy9+ | number | 是 | 否 | 表示當前設備電池的總容量,單位毫安時。此接口為系統接口,三方應用不支持調用。 |
nowCurrent9+ | number | 是 | 否 | 表示當前設備電池的電流,單位毫安。此接口為系統接口,三方應用不支持調用。 |
remainingEnergy9+ | number | 是 | 否 | 表示當前設備電池的剩余容量,單位毫安時。此接口為系統接口,三方應用不支持調用。 |
- 示例:
import batteryInfo from '@ohos.batteryInfo'; var batterySoc = batteryInfo.batterySOC;
BatteryPluggedType
表示連接的充電器類型的枚舉。
系統能力 :SystemCapability.PowerManager.BatteryManager.Core
名稱 | 默認值 | 描述 |
---|---|---|
NONE | 0 | 表示連接充電器類型未知。 |
AC | 1 | 表示連接的充電器類型為交流充電器。 |
USB | 2 | 表示連接的充電器類型為USB。 |
WIRELESS | 3 | 表示連接的充電器類型為無線充電器。 |
BatteryChargeState
表示電池充電狀態的枚舉。
系統能力 :SystemCapability.PowerManager.BatteryManager.Core
名稱 | 默認值 | 描述 |
---|---|---|
NONE | 0 | 表示電池充電狀態未知。 |
ENABLE | 1 | 表示電池充電狀態為使能狀態。 |
DISABLE | 2 | 表示電池充電狀態為停止狀態。 |
FULL | 3 | 表示電池充電狀態為已充滿狀態。 |
BatteryHealthState
表示電池健康狀態的枚舉。
系統能力 :SystemCapability.PowerManager.BatteryManager.Core
名稱 | 默認值 | 描述 |
---|---|---|
UNKNOWN | 0 | 表示電池健康狀態未知。 |
GOOD | 1 | 表示電池健康狀態為正常。 |
OVERHEAT | 2 | 表示電池健康狀態為過熱。 |
OVERVOLTAGE | 3 | 表示電池健康狀態為過壓。 |
COLD | 4 | 表示電池健康狀態為低溫。 |
DEAD | 5 | 表示電池健康狀態為僵死狀態。 |
BatteryCapacityLevel9+
表示電池電量等級的枚舉。
系統能力 :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直接拿
系統能力 :SystemCapability.PowerManager.BatteryManager.Core
名稱 | 默認值 | 描述 |
---|---|---|
EXTRA_SOC | 0 | 表示剩余電池電量百分比的鍵代碼。 |
EXTRA_VOLTAGE | 1 | 表示當前設備電池電壓的鍵代碼。 |
EXTRA_TEMPERATURE | 2 | 表示當前設備電池溫度的鍵代碼。 |
EXTRA_HEALTH_STATE | 3 | 表示當前設備電池健康狀態的鍵代碼。 |
EXTRA_PLUGGED_TYPE | 4 | 表示當前設備連接的充電器類型的鍵代碼。 |
EXTRA_MAX_CURRENT | 5 | 表示當前設備電池最大電流的鍵代碼。 |
EXTRA_MAX_VOLTAGE | 6 | 表示當前設備電池最大電壓的鍵代碼。 |
EXTRA_CHARGE_STATE | 7 | 表示當前設備電池充電狀態的鍵代碼。 |
EXTRA_CHARGE_COUNTER | 8 | 表示當前設備電池充電次數的鍵代碼。 |
EXTRA_PRESENT | 9 | 表示當前設備是否支持電池或者電池是否在位的鍵代碼。 |
EXTRA_TECHNOLOGY | 10 | 表示當前設備電池技術型號的鍵代碼。 |
審核編輯 黃宇
-
鴻蒙
+關注
關注
57文章
2339瀏覽量
42812
發布評論請先 登錄
相關推薦
評論