Power Subsystem Changelog

cl.powermgr.1 Error Information Return Method Change of APIs

The power module uses service logic return values to indicate error information, which does not comply with the API error code specifications of OpenHarmony. Therefore, modification is made in API version 9 and later.

• Power consumption statistics: @ohos.batteryStatistics
• Screen brightness: @ohos.brightness
• Power management: @ohos.power
• Runninglock management: @ohos.runningLock
• Thermal management: @ohos.thermal

Asynchronous API: An error message is returned via AsyncCallback or the error object of Promise.

Synchronous API: An error message is returned via an exception.

Change Impact

The application developed based on earlier versions needs to adapt the method for returning API error information. Otherwise, the original service logic will be affected.

Key API/Component Changes

Error code processing is added for the following APIs:

• getBatteryStats(callback: AsyncCallback<Array<BatteryStatsInfo>>): void
• getAppPowerValue(uid: number): number
• getAppPowerPercent(uid: number): number
• getHardwareUnitPowerValue(type: ConsumptionType): number
• getHardwareUnitPowerPercent(type: ConsumptionType): number
• setValue(value: number): void
• shutdown(reason: string): void;
• isActive(): boolean
• wakeup(detail: string): void
• suspend(): void
• getPowerMode(): DevicePowerMode
• setPowerMode(mode: DevicePowerMode, callback: AsyncCallback<void>): void
• setPowerMode(mode: DevicePowerMode): Promise<void>
• hold(timeout: number): void
• isHolding(): boolean
• unhold(): void
• isSupported(type: RunningLockType): boolean
• isSupported(type: RunningLockType): boolean
• create(name: string, type: RunningLockType, callback: AsyncCallback<RunningLock>): void
• create(name: string, type: RunningLockType): Promise<RunningLock>
• registerThermalLevelCallback(callback: Callback<ThermalLevel>): void
• unregisterThermalLevelCallback(callback?: Callback<void>): void
• getLevel(): ThermalLevel

Adaptation Guide

For details, see the API reference document of each API.

cl.powermgr.2 System API Change

Change Impact

The application developed based on earlier versions needs to adapt to new API names and the new method for returning API error information. Otherwise, the original service logic will be affected.

Key API/Component Changes

Adaptation Guide

For details, see @ohos.power.