harmony 鸿蒙Power Subsystem Changelog

2023-06-24
浏览 (387)

Power Subsystem Changelog

cl.powermgr.1 CommonEventBatteryChangedCode API Change

Changed the CommonEventBatteryChangedCode enum class in @ohos.batteryInfo as follows:

Changed the class name to CommonEventBatteryChangedKey.
Deleted EXTRA_MAX_CURRENT, EXTRA_MAX_VOLTAGE, and EXTRA_CHARGE_COUNTER.
Changed the enum value type from numeric to string.

Change Impact

The JS API needs to be adapted for applications developed based on earlier versions. Otherwise, relevant functions will be affected.

Key API/Component Changes

Before change:

Name	Value	Description
EXTRA_SOC	0	Remaining battery level in percentage.
EXTRA_VOLTAGE	1	Battery voltage of the device.
EXTRA_TEMPERATURE	2	Battery temperature of the device.
EXTRA_HEALTH_STATE	3	Battery health status of the device.
EXTRA_PLUGGED_TYPE	4	Type of the charger connected to the device.
EXTRA_MAX_CURRENT	5	Maximum battery current of the device.
EXTRA_MAX_VOLTAGE	6	Maximum battery voltage of the device.
EXTRA_CHARGE_STATE	7	Battery charging status of the device.
EXTRA_CHARGE_COUNTER	8	Number of battery charging times of the device.
EXTRA_PRESENT	9	Whether the battery is supported by the device or installed.
EXTRA_TECHNOLOGY	10	Battery technology of the device.
EXTRA_CAPACITY_LEVEL	11	Battery level of the device.

After change:

Name	Value	Description
EXTRA_SOC	“soc”	Remaining battery level in percentage.
EXTRA_CHARGE_STATE	“chargeState”	Battery charging status of the device.
EXTRA_HEALTH_STATE	“healthState”	Battery health status of the device.
EXTRA_PLUGGED_TYPE	“pluggedType”	Type of the charger connected to the device.
EXTRA_VOLTAGE	“voltage”	Battery voltage of the device.
EXTRA_TECHNOLOGY	“technology”	Battery technology of the device.
EXTRA_TEMPERATURE	“temperature”	Battery temperature of the device.
EXTRA_PRESENT	“present”	Whether the battery is supported by the device or installed.
EXTRA_CAPACITY_LEVEL	“capacityLevel”	Battery level of the device.

Adaptation Guide

For details, see the API reference of the @ohos.batteryInfo API.

cl.powermgr.2 estimatedRemainingChargeTime API Change

Changed the estimatedRemainingChargeTime API in @ohos.batteryInfo to a system API.

Change Impact

The JS API needs to be adapted for applications developed based on earlier versions. Otherwise, relevant functions will be affected.

Adaptation Guide

For details, see the API reference of the @ohos.batteryInfo API.

cl.powermgr.3 System Common Event Behavior Change

The following common events are provided in the battery information through @ohos.commonEventManager (common event module):

COMMON_EVENT_BATTERY_LOW: common event for low battery level. It includes the remaining battery in percentage.
COMMON_EVENT_BATTERY_OKAY: common event for normal battery level. It includes the remaining battery in percentage.
COMMON_EVENT_POWER_CONNECTED: common event for connection to an external power supply. It includes the type of the power supply to which the device is connected.
COMMON_EVENT_POWER_DISCONNECTED: common event for disconnection from an external power supply. It includes the type of the power supply from which the device is disconnected.
COMMON_EVENT_CHARGING: common event for starting of battery charging. It includes the battery charging status.
COMMON_EVENT_DISCHARGING: common event for ending of battery charging. It includes the battery charging status.

Changed the method of obtaining data from common events from CommonEventData.data to CommonEventData.code.

Change Impact

The application developed based on earlier versions needs to adapt the method for obtaining common events in the battery information. Otherwise, the original service logic will be affected.