电源子系统ChangeLog
cl.powermgr.1 API错误信息返回方式变更
下列API使用业务逻辑返回值表示错误信息，不符合OpenHarmony接口错误码规范。从API9进行变更。
- 耗电统计：@ohos.batteryStatistics
- 屏幕亮度：@ohos.brightness
- 系统电源管理：@ohos.power
- Runninglock锁：@ohos.runningLock
- 热管理：@ohos.thermal
异步接口：通过AsyncCallback或Promise的error对象返回错误信息。
同步接口：通过抛出异常的方式返回错误信息。
变更影响
基于此前版本开发的应用，需适配接口的错误信息返回方式，否则会影响原有业务逻辑。
关键的接口/组件变更
在以下接口增加错误码处理：
- 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
适配指导
请参考各接口的API参考。
cl.powermgr.2 系统接口变更
变更影响
基于此前版本开发的应用，需适配新接口名和错误信息返回方式，否则会影响原有业务逻辑。
关键的接口/组件变更
| 包名 | 旧接口 | 新接口 |
|---|---|---|
| @ohos.power | shutdownDevice(reason: string): void | shutdown(reason: string): void |
| @ohos.power | rebootDevice(reason: string): void | reboot(reason: string): void |
| @ohos.power | wakeupDevice(detail: string): void | wakeup(detail: string): void |
| @ohos.power | suspendDevice(): void | suspend(): void |
适配指导
请参考系统电源管理@ohos.power的API参考。