1# 系统电源管理<a name="ZH-CN_TOPIC_0000001164130786"></a> 2 3> **说明：** 4>从 API Version 7 开始支持。 5 6## 支持设备<a name="zh-cn_topic_0000001209567627_section8858145319412"></a> 7 8<a name="zh-cn_topic_0000001209567627_table785845317416"></a> 9<table><thead align="left"><tr id="zh-cn_topic_0000001209567627_row188588531947"><th class="cellrowborder" valign="top" width="25%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001209567627_p168595537417"><a name="zh-cn_topic_0000001209567627_p168595537417"></a><a name="zh-cn_topic_0000001209567627_p168595537417"></a>手机</p> 10</th> 11<th class="cellrowborder" valign="top" width="25%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001209567627_p158593531343"><a name="zh-cn_topic_0000001209567627_p158593531343"></a><a name="zh-cn_topic_0000001209567627_p158593531343"></a>平板</p> 12</th> 13<th class="cellrowborder" valign="top" width="25%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001209567627_p1885917531416"><a name="zh-cn_topic_0000001209567627_p1885917531416"></a><a name="zh-cn_topic_0000001209567627_p1885917531416"></a>智慧屏</p> 14</th> 15<th class="cellrowborder" valign="top" width="25%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001209567627_p185910531748"><a name="zh-cn_topic_0000001209567627_p185910531748"></a><a name="zh-cn_topic_0000001209567627_p185910531748"></a>智能穿戴</p> 16</th> 17</tr> 18</thead> 19<tbody><tr id="zh-cn_topic_0000001209567627_row18594532419"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209567627_p17859185312414"><a name="zh-cn_topic_0000001209567627_p17859185312414"></a><a name="zh-cn_topic_0000001209567627_p17859185312414"></a>支持</p> 20</td> 21<td class="cellrowborder" valign="top" width="25%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209567627_p2085920531148"><a name="zh-cn_topic_0000001209567627_p2085920531148"></a><a name="zh-cn_topic_0000001209567627_p2085920531148"></a>支持</p> 22</td> 23<td class="cellrowborder" valign="top" width="25%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209567627_p68595531247"><a name="zh-cn_topic_0000001209567627_p68595531247"></a><a name="zh-cn_topic_0000001209567627_p68595531247"></a>不支持</p> 24</td> 25<td class="cellrowborder" valign="top" width="25%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209567627_p1785935316416"><a name="zh-cn_topic_0000001209567627_p1785935316416"></a><a name="zh-cn_topic_0000001209567627_p1785935316416"></a>支持</p> 26</td> 27</tr> 28</tbody> 29</table> 30 31## 导入模块<a name="zh-cn_topic_0000001209567627_s56d19203690d4782bfc74069abb6bd71"></a> 32 33``` 34import power from '@ohos.power'; 35``` 36 37## 权限<a name="zh-cn_topic_0000001209567627_section11257113618419"></a> 38 39关机权限： ohos.permission.SHUTDOWN 40 41重启权限： ohos.permission.REBOOT 42 43重启并进入recovery模式的权限：ohos.permission.REBOOT\_RECOVERY 44 45## power.shutdownDevice<a name="zh-cn_topic_0000001209567627_section192192415554"></a> 46 47shutdownDevice\(reason: string\): void 48 49系统关机。 50 51- 参数： 52 53 <a name="zh-cn_topic_0000001209567627_table69661135912"></a> 54 <table><thead align="left"><tr id="zh-cn_topic_0000001209567627_row149668318915"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001209567627_p7966738914"><a name="zh-cn_topic_0000001209567627_p7966738914"></a><a name="zh-cn_topic_0000001209567627_p7966738914"></a>参数名</p> 55 </th> 56 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001209567627_p296713699"><a name="zh-cn_topic_0000001209567627_p296713699"></a><a name="zh-cn_topic_0000001209567627_p296713699"></a>类型</p> 57 </th> 58 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001209567627_p196718315911"><a name="zh-cn_topic_0000001209567627_p196718315911"></a><a name="zh-cn_topic_0000001209567627_p196718315911"></a>必填</p> 59 </th> 60 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001209567627_p9967231197"><a name="zh-cn_topic_0000001209567627_p9967231197"></a><a name="zh-cn_topic_0000001209567627_p9967231197"></a>说明</p> 61 </th> 62 </tr> 63 </thead> 64 <tbody><tr id="zh-cn_topic_0000001209567627_row99671533914"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209567627_p5518501625"><a name="zh-cn_topic_0000001209567627_p5518501625"></a><a name="zh-cn_topic_0000001209567627_p5518501625"></a>reason</p> 65 </td> 66 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209567627_p11967433914"><a name="zh-cn_topic_0000001209567627_p11967433914"></a><a name="zh-cn_topic_0000001209567627_p11967433914"></a>string</p> 67 </td> 68 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209567627_p19671336916"><a name="zh-cn_topic_0000001209567627_p19671336916"></a><a name="zh-cn_topic_0000001209567627_p19671336916"></a>是</p> 69 </td> 70 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209567627_p69671631796"><a name="zh-cn_topic_0000001209567627_p69671631796"></a><a name="zh-cn_topic_0000001209567627_p69671631796"></a>关机原因。</p> 71 </td> 72 </tr> 73 </tbody> 74 </table> 75 76- 示例： 77 78 ``` 79 power.shutdownDevice("shutdown_test"); 80 console.info('power_shutdown_device_test success') 81 ``` 82 83 84## power.rebootDevice<a name="zh-cn_topic_0000001209567627_section1773218207620"></a> 85 86rebootDevice\(reason: string\): void 87 88重启设备。 89 90- 参数： 91 92 <a name="zh-cn_topic_0000001209567627_table8732192015611"></a> 93 <table><thead align="left"><tr id="zh-cn_topic_0000001209567627_row1173216204612"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001209567627_p973222015615"><a name="zh-cn_topic_0000001209567627_p973222015615"></a><a name="zh-cn_topic_0000001209567627_p973222015615"></a>参数名</p> 94 </th> 95 <th class="cellrowborder" valign="top" width="16.830000000000002%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001209567627_p273232015612"><a name="zh-cn_topic_0000001209567627_p273232015612"></a><a name="zh-cn_topic_0000001209567627_p273232015612"></a>类型</p> 96 </th> 97 <th class="cellrowborder" valign="top" width="11.88%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001209567627_p9732202013618"><a name="zh-cn_topic_0000001209567627_p9732202013618"></a><a name="zh-cn_topic_0000001209567627_p9732202013618"></a>必填</p> 98 </th> 99 <th class="cellrowborder" valign="top" width="56.47%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001209567627_p167326201566"><a name="zh-cn_topic_0000001209567627_p167326201566"></a><a name="zh-cn_topic_0000001209567627_p167326201566"></a>说明</p> 100 </th> 101 </tr> 102 </thead> 103 <tbody><tr id="zh-cn_topic_0000001209567627_row773292016614"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209567627_p57320201162"><a name="zh-cn_topic_0000001209567627_p57320201162"></a><a name="zh-cn_topic_0000001209567627_p57320201162"></a>reason</p> 104 </td> 105 <td class="cellrowborder" valign="top" width="16.830000000000002%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209567627_p973216201164"><a name="zh-cn_topic_0000001209567627_p973216201164"></a><a name="zh-cn_topic_0000001209567627_p973216201164"></a>string</p> 106 </td> 107 <td class="cellrowborder" valign="top" width="11.88%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209567627_p5732132020612"><a name="zh-cn_topic_0000001209567627_p5732132020612"></a><a name="zh-cn_topic_0000001209567627_p5732132020612"></a>是</p> 108 </td> 109 <td class="cellrowborder" valign="top" width="56.47%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209567627_p4733720662"><a name="zh-cn_topic_0000001209567627_p4733720662"></a><a name="zh-cn_topic_0000001209567627_p4733720662"></a>重启原因。</p> 110 </td> 111 </tr> 112 </tbody> 113 </table> 114 115- 示例： 116 117 ``` 118 power.rebootDevice("reboot_test"); 119 console.info('power_reboot_device_test success') 120 ``` 121 122 123## power.isScreenOn<a name="zh-cn_topic_0000001209567627_section69511458115312"></a> 124 125isScreenOn\(callback: AsyncCallback<boolean\>\): void 126 127检测当前设备的亮灭屏状态。 128 129- 参数： 130 131 <a name="zh-cn_topic_0000001209567627_table183681450191519"></a> 132 <table><thead align="left"><tr id="zh-cn_topic_0000001209567627_row20368050151519"><th class="cellrowborder" valign="top" width="15.989999999999998%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001209567627_p13681150121519"><a name="zh-cn_topic_0000001209567627_p13681150121519"></a><a name="zh-cn_topic_0000001209567627_p13681150121519"></a>类型</p> 133 </th> 134 <th class="cellrowborder" valign="top" width="28.27%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001209567627_p1636895015154"><a name="zh-cn_topic_0000001209567627_p1636895015154"></a><a name="zh-cn_topic_0000001209567627_p1636895015154"></a>类型</p> 135 </th> 136 <th class="cellrowborder" valign="top" width="9.64%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001209567627_p7565410191617"><a name="zh-cn_topic_0000001209567627_p7565410191617"></a><a name="zh-cn_topic_0000001209567627_p7565410191617"></a>必填</p> 137 </th> 138 <th class="cellrowborder" valign="top" width="46.1%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001209567627_p43681350181515"><a name="zh-cn_topic_0000001209567627_p43681350181515"></a><a name="zh-cn_topic_0000001209567627_p43681350181515"></a>说明</p> 139 </th> 140 </tr> 141 </thead> 142 <tbody><tr id="zh-cn_topic_0000001209567627_row636865081513"><td class="cellrowborder" valign="top" width="15.989999999999998%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209567627_p4368165091513"><a name="zh-cn_topic_0000001209567627_p4368165091513"></a><a name="zh-cn_topic_0000001209567627_p4368165091513"></a>callback</p> 143 </td> 144 <td class="cellrowborder" valign="top" width="28.27%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209567627_p83691450151519"><a name="zh-cn_topic_0000001209567627_p83691450151519"></a><a name="zh-cn_topic_0000001209567627_p83691450151519"></a>AsyncCallback<boolean></p> 145 </td> 146 <td class="cellrowborder" valign="top" width="9.64%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209567627_p17565310191610"><a name="zh-cn_topic_0000001209567627_p17565310191610"></a><a name="zh-cn_topic_0000001209567627_p17565310191610"></a>是</p> 147 </td> 148 <td class="cellrowborder" valign="top" width="46.1%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209567627_p163691850191515"><a name="zh-cn_topic_0000001209567627_p163691850191515"></a><a name="zh-cn_topic_0000001209567627_p163691850191515"></a>指定的callback回调方法，用于获取返回值。</p> 149 <p id="zh-cn_topic_0000001209567627_p3566124615812"><a name="zh-cn_topic_0000001209567627_p3566124615812"></a><a name="zh-cn_topic_0000001209567627_p3566124615812"></a>callback返回值：亮屏返回true，灭屏返回false。</p> 150 </td> 151 </tr> 152 </tbody> 153 </table> 154 155 156- 示例： 157 158 ``` 159 power.isScreenOn((error, screenOn) => { 160 if (typeof error === "undefined") { 161 console.info('screenOn status is ' + screenOn); 162 done(); 163 } else { 164 console.log('error: ' + error); 165 done(); 166 } 167 }) 168 ``` 169 170 171## power.isScreenOn<a name="zh-cn_topic_0000001209567627_section143367619119"></a> 172 173isScreenOn\(\): Promise<boolean\> 174 175检测当前设备的亮灭屏状态。 176 177- 返回值： 178 179 <a name="zh-cn_topic_0000001209567627_table1730417311314"></a> 180 <table><thead align="left"><tr id="zh-cn_topic_0000001209567627_row1930412311018"><th class="cellrowborder" valign="top" width="23.87%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001209567627_p15304113117114"><a name="zh-cn_topic_0000001209567627_p15304113117114"></a><a name="zh-cn_topic_0000001209567627_p15304113117114"></a>类型</p> 181 </th> 182 <th class="cellrowborder" valign="top" width="76.13%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001209567627_p830411311017"><a name="zh-cn_topic_0000001209567627_p830411311017"></a><a name="zh-cn_topic_0000001209567627_p830411311017"></a>说明</p> 183 </th> 184 </tr> 185 </thead> 186 <tbody><tr id="zh-cn_topic_0000001209567627_row173045311711"><td class="cellrowborder" valign="top" width="23.87%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001209567627_p686517815914"><a name="zh-cn_topic_0000001209567627_p686517815914"></a><a name="zh-cn_topic_0000001209567627_p686517815914"></a>Promise<boolean></p> 187 </td> 188 <td class="cellrowborder" valign="top" width="76.13%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001209567627_p163041531916"><a name="zh-cn_topic_0000001209567627_p163041531916"></a><a name="zh-cn_topic_0000001209567627_p163041531916"></a>Promise实例，用于异步获取返回值，亮屏返回true，灭屏返回false。</p> 189 </td> 190 </tr> 191 </tbody> 192 </table> 193 194- 示例： 195 196 ``` 197 power.isScreenOn() 198 .then(screenOn => { 199 console.info('screenOn status is ' + screenOn); 200 done(); 201 }) 202 .catch(error => { 203 console.log('error: ' + error); 204 done(); 205 }) 206 ``` 207 208 209
