系统电源管理
该模块主要提供重启、关机、查询屏幕状态等接口。
本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
power.isActive9+
isActive(): boolean
检测当前设备是否处于活动状态。
系统能力: SystemCapability.PowerManager.PowerManager.Core
错误码:
以下错误码的详细介绍请参见系统电源管理错误码。
错误码ID | 错误信息 |
---|---|
4900101 | 连接服务失败。 |
示例:
- try {
- var isActive = power.isActive();
- console.info('power is active: ' + isActive);
- } catch(err) {
- console.error('check active status failed, err: ' + err);
- }
power.getPowerMode9+
getPowerMode(): DevicePowerMode
获取当前设备的电源模式。
系统能力: SystemCapability.PowerManager.PowerManager.Core
返回值:
类型 | 说明 |
---|---|
电源模式。 |
错误码:
以下错误码的详细介绍请参见系统电源管理错误码。
错误码ID | 错误信息 |
---|---|
4900101 | 连接服务失败。 |
示例:
- try {
- var mode = power.getPowerMode();
- console.info('power mode: ' + mode);
- } catch(err) {
- console.error('get power mode failed, err: ' + err);
- }
power.rebootDevice(deprecated)
rebootDevice(reason: string): void
从API version 7开始支持,从API version 9开始不再维护,替代接口能力仅对系统应用开放。
重启设备。
需要权限: ohos.permission.REBOOT
系统能力: SystemCapability.PowerManager.PowerManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
reason | string | 是 | 重启原因。 |
示例:
- power.rebootDevice('reboot_test');
power.isScreenOn(deprecated)
isScreenOn(callback: AsyncCallback<boolean>): void
从API version 9开始不再维护,建议使用power.isActive替代。
检测当前设备的亮灭屏状态。使用callback异步回调。
系统能力: SystemCapability.PowerManager.PowerManager.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回调函数。当检测成功,err为undefined,data为获取到的亮灭屏状态,返回true表示亮屏,返回false表示灭屏;否则为错误对象。 |
示例:
- power.isScreenOn((err, data) => {
- if (typeof err === 'undefined') {
- console.info('screen on status is ' + data);
- } else {
- console.error('check screen status failed, err: ' + err);
- }
- })
power.isScreenOn(deprecated)
isScreenOn(): Promise<boolean>
从API version 9开始不再维护,建议使用power.isActive替代。
检测当前设备的亮灭屏状态。使用Promise异步回调。
系统能力: SystemCapability.PowerManager.PowerManager.Core
返回值:
类型 | 说明 |
---|---|
Promise<boolean> | Promise对象。返回true表示亮屏;返回false表示灭屏。 |
示例:
- power.isScreenOn()
- .then(data => {
- console.info('screen on status is ' + data);
- })
- .catch(err => {
- console.error('check screen status failed, err: ' + err);
- })
更多建议: