電量信息

2024-01-23 17:32 更新

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

說明

本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口,采用上角標單獨標記接口的起始版本。

導入模塊

  1. 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è)備電池電量的等級。

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_FULL

1

表示電池電量等級為滿電量。

LEVEL_HIGH

2

表示電池電量等級為高電量。

LEVEL_NORMAL

3

表示電池電量等級為正常電量。

LEVEL_LOW

4

表示電池電量等級為低電量。

LEVEL_WARNING

5

表示電池電量等級為告警電量。

LEVEL_CRITICAL

6

表示電池電量等級為極低電量。

LEVEL_SHUTDOWN

7

表示電池電量等級為關(guān)機電量。

CommonEventBatteryChangedKey9+

表示COMMON_EVENT_BATTERY_CHANGED通用事件附加信息的查詢鍵。

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

名稱

說明

EXTRA_SOC

"soc"

表示剩余電池電量百分比的查詢鍵。

EXTRA_CHARGE_STATE

"chargeState"

表示當前設(shè)備電池充電狀態(tài)的查詢鍵。

EXTRA_HEALTH_STATE

"healthState"

表示當前設(shè)備電池健康狀態(tài)的查詢鍵。

EXTRA_PLUGGED_TYPE

"pluggedType"

表示當前設(shè)備連接的充電器類型的查詢鍵。

EXTRA_VOLTAGE

"voltage"

表示當前設(shè)備電池電壓的查詢鍵。

EXTRA_TECHNOLOGY

"technology"

表示當前設(shè)備電池技術(shù)型號的查詢鍵。

EXTRA_TEMPERATURE

"temperature"

表示當前設(shè)備電池溫度的查詢鍵。

EXTRA_PRESENT

"present"

表示當前設(shè)備是否支持電池或者電池是否在位的查詢鍵。

EXTRA_CAPACITY_LEVEL

"capacityLevel"

表示當前設(shè)備電池電量等級的查詢鍵。

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號