系统电源管理

说明： 从 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<boolean>): void

检测当前设备的亮灭屏状态。

• 参数：

  类型	类型	必填	说明
  callback	AsyncCallback<boolean>	是	指定的callback回调方法，用于获取返回值。 callback返回值：亮屏返回true，灭屏返回false。

• 示例：

  power.isScreenOn((error, screenOn) => {
      if (typeof error === "undefined") {
          console.info('screenOn status is ' + screenOn);
      } else {
          console.log('error: ' + error);
      }
  })

power.isScreenOn

isScreenOn(): Promise<boolean>

检测当前设备的亮灭屏状态。

• 返回值：

  类型	说明
  Promise<boolean>	Promise实例，用于异步获取返回值，亮屏返回true，灭屏返回false。

• 示例：

  power.isScreenOn()
  .then(screenOn => {
      console.info('screenOn status is ' + screenOn);
  })
  .catch(error => {
      console.log('error: ' + error);
  })