系统电源管理

About 1 min

系统电源管理

icon-note.gif 说明: 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import power from '@ohos.power';
1

权限

关机权限: 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')
    
    1
    2

power.rebootDevice

rebootDevice(reason: string): void

重启设备。

  • 参数:

    参数名 类型 必填 说明
    reason string 重启原因。
  • 示例:

    power.rebootDevice("reboot_test");
    console.info('power_reboot_device_test success')
    
    1
    2

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);
        }
    })
    
    1
    2
    3
    4
    5
    6
    7

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);
    })
    
    1
    2
    3
    4
    5
    6
    7