# 系统电源管理
- [支持设备](#zh-cn_topic_0000001209567627_section8858145319412)
- [导入模块](#zh-cn_topic_0000001209567627_s56d19203690d4782bfc74069abb6bd71)
- [权限](#zh-cn_topic_0000001209567627_section11257113618419)
- [power.shutdownDevice](#zh-cn_topic_0000001209567627_section192192415554)
- [power.rebootDevice](#zh-cn_topic_0000001209567627_section1773218207620)
- [power.isScreenOn](#zh-cn_topic_0000001209567627_section69511458115312)
- [power.isScreenOn](#zh-cn_topic_0000001209567627_section143367619119)
> **说明:**
>从 API Version 7 开始支持。
## 支持设备
手机
|
平板
|
智慧屏
|
智能穿戴
|
支持
|
支持
|
不支持
|
支持
|
## 导入模块
```
import power from '@ohos.power';
```
## 权限
关机权限: ohos.permission.SHUTDOWN
重启权限: ohos.permission.REBOOT
重启并进入recovery模式的权限:ohos.permission.REBOOT\_RECOVERY
## power.shutdownDevice
shutdownDevice\(reason: string\): void
系统关机。
- 参数:
参数名
|
类型
|
必填
|
说明
|
reason
|
string
|
是
|
关机原因。
|
- 示例:
```
power.shutdownDevice("shutdown_test");
console.info('power_shutdown_device_test success')
```
## power.rebootDevice
rebootDevice\(reason: string\): void
重启设备。
- 参数:
参数名
|
类型
|
必填
|
说明
|
reason
|
string
|
是
|
重启原因。
|
- 示例:
```
power.rebootDevice("reboot_test");
console.info('power_reboot_device_test success')
```
## power.isScreenOn
isScreenOn\(callback: AsyncCallback\): void
检测当前设备的亮灭屏状态。
- 参数:
类型
|
类型
|
必填
|
说明
|
callback
|
AsyncCallback<boolean>
|
是
|
指定的callback回调方法,用于获取返回值。
callback返回值:亮屏返回true,灭屏返回false。
|
- 示例:
```
power.isScreenOn((error, screenOn) => {
if (typeof error === "undefined") {
console.info('screenOn status is ' + screenOn);
done();
} else {
console.log('error: ' + error);
done();
}
})
```
## power.isScreenOn
isScreenOn\(\): Promise
检测当前设备的亮灭屏状态。
- 返回值:
类型
|
说明
|
Promise<boolean>
|
Promise实例,用于异步获取返回值,亮屏返回true,灭屏返回false。
|
- 示例:
```
power.isScreenOn()
.then(screenOn => {
console.info('screenOn status is ' + screenOn);
done();
})
.catch(error => {
console.log('error: ' + error);
done();
})
```