系统电源管理
该模块主要提供重启、关机、查询屏幕状态等接口。
本模块首批接口从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);
- })