系统电源管理

说明: 从 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);
            done();
        } else {
            console.log('error: ' + error);
            done();
        }
    })
    

power.isScreenOn

isScreenOn(): Promise<boolean>

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

  • 返回值:

    类型

    说明

    Promise<boolean>

    Promise实例,用于异步获取返回值,亮屏返回true,灭屏返回false。

  • 示例:

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