1# 系统电源管理 2 3>  **说明：** 4> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 5 6该模块主要提供重启、关机、查询屏幕状态等接口。 7 8 9## 导入模块 10 11```js 12import power from '@ohos.power'; 13``` 14 15## 系统能力 16 17SystemCapability.PowerManager.PowerManager.Core 18 19 20## power.shutdownDevice 21 22shutdownDevice(reason: string): void 23 24系统关机。 25 26此接口为系统接口，三方应用不支持调用。 27 28**需要权限：** ohos.permission.REBOOT 29 30**参数：** 31 32| 参数名 | 类型 | 必填 | 说明 | 33| ------ | ------ | ---- | ----- | 34| reason | string | 是 | 关机原因。 | 35 36**示例：** 37 38```js 39power.shutdownDevice("shutdown_test"); 40console.info('power_shutdown_device_test success') 41``` 42 43 44## power.rebootDevice 45 46rebootDevice(reason: string): void 47 48重启设备。 49 50**需要权限：** ohos.permission.REBOOT（重启权限）、ohos.permission.REBOOT_RECOVERY（重启并进入recovery或者updater模式的权限） 51 52**参数：** 53 54| 参数名 | 类型 | 必填 | 说明 | 55| ------ | ------ | ---- | ----- | 56| reason | string | 是 | 重启原因。 | 57 58**示例：** 59 60```js 61power.rebootDevice("reboot_test"); 62console.info('power_reboot_device_test success') 63``` 64 65 66## power.isScreenOn 67 68isScreenOn(callback: AsyncCallback<boolean>): void 69 70检测当前设备的亮灭屏状态。 71 72**参数：** 73 74| 参数名 | 类型 | 必填 | 说明 | 75| -------- | ---------------------------- | ---- | ---------------------------------------- | 76| callback | AsyncCallback<boolean> | 是 | 指定的callback回调方法，用于获取返回值。<br/>callback返回值：亮屏返回true，灭屏返回false。 | 77 78**示例：** 79 80```js 81power.isScreenOn((error, screenOn) => { 82 if (typeof error === "undefined") { 83 console.info('screenOn status is ' + screenOn); 84 } else { 85 console.log('error: ' + error); 86 } 87}) 88``` 89 90 91## power.isScreenOn 92 93isScreenOn(): Promise<boolean> 94 95检测当前设备的亮灭屏状态。 96 97**返回值：** 98| 类型 | 说明 | 99| ---------------------- | --------------------------------------- | 100| Promise<boolean> | Promise实例，用于异步获取返回值，亮屏返回true，灭屏返回false。 | 101 102**示例：** 103 104```js 105power.isScreenOn() 106.then(screenOn => { 107 console.info('screenOn status is ' + screenOn); 108}) 109.catch(error => { 110 console.log('error: ' + error); 111}) 112``` 113
