• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 电源子系统ChangeLog
2
3## cl.powermgr.1 API错误信息返回方式变更
4
5下列API使用业务逻辑返回值表示错误信息，不符合OpenHarmony接口错误码规范。从API9进行变更。
6
7- 耗电统计：[@ohos.batteryStatistics](../../../application-dev/reference/apis/js-apis-batteryStatistics.md)
8 - 屏幕亮度：[@ohos.brightness](../../../application-dev/reference/apis/js-apis-brightness.md)
9 - 系统电源管理：[@ohos.power](../../../application-dev/reference/apis/js-apis-power.md)
10 - Runninglock锁：[@ohos.runningLock](../../../application-dev/reference/apis/js-apis-runninglock.md)
11 - 热管理：[@ohos.thermal](../../../application-dev/reference/apis/js-apis-thermal.md)
12
13异步接口：通过AsyncCallback或Promise的error对象返回错误信息。
14
15同步接口：通过抛出异常的方式返回错误信息。
16
17#### 变更影响
18
19基于此前版本开发的应用，需适配接口的错误信息返回方式，否则会影响原有业务逻辑。
20
21#### 关键的接口/组件变更
22
23在以下接口增加错误码处理：
24  - getBatteryStats(callback: AsyncCallback<Array&lt;BatteryStatsInfo&gt;>): void
25  - getAppPowerValue(uid: number): number
26  - getAppPowerPercent(uid: number): number
27  - getHardwareUnitPowerValue(type: ConsumptionType): number
28  - getHardwareUnitPowerPercent(type: ConsumptionType): number
29  - setValue(value: number): void
30  - shutdown(reason: string): void;
31  - isActive(): boolean
32  - wakeup(detail: string): void
33  - suspend(): void
34  - getPowerMode(): DevicePowerMode
35  - setPowerMode(mode: DevicePowerMode, callback: AsyncCallback&lt;void&gt;): void
36  - setPowerMode(mode: DevicePowerMode): Promise&lt;void&gt;
37  - hold(timeout: number): void
38  - isHolding(): boolean
39  - unhold(): void
40  - isSupported(type: RunningLockType): boolean
41  - isSupported(type: RunningLockType): boolean
42  - create(name: string, type: RunningLockType, callback: AsyncCallback&lt;RunningLock&gt;): void
43  - create(name: string, type: RunningLockType): Promise&lt;RunningLock&gt;
44  - registerThermalLevelCallback(callback: Callback&lt;ThermalLevel&gt;): void
45  - unregisterThermalLevelCallback(callback?: Callback&lt;void&gt;): void
46  - getLevel(): ThermalLevel
47
48#### 适配指导
49
50请参考各接口的API参考。
51## cl.powermgr.2 系统接口变更
52
53#### 变更影响
54
55基于此前版本开发的应用，需适配新接口名和错误信息返回方式，否则会影响原有业务逻辑。
56
57#### 关键的接口/组件变更
58
59| 包名        | 旧接口                               | 新接口                         |
60| ----------- | ------------------------------------ | ------------------------------ |
61| @ohos.power | shutdownDevice(reason: string): void | shutdown(reason: string): void |
62| @ohos.power | rebootDevice(reason: string): void   | reboot(reason: string): void   |
63| @ohos.power | wakeupDevice(detail: string): void   | wakeup(detail: string): void   |
64| @ohos.power | suspendDevice(): void                | suspend(): void                |
65
66#### 适配指导
67
68请参考系统电源管理[@ohos.power](../../../application-dev/reference/apis/js-apis-power.md)的API参考。
69