系统电源管理

该模块主要提供重启、关机、查询屏幕状态等接口。

说明： 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import power from '@ohos.power';

power.shutdownDevice

shutdownDevice(reason: string): void

系统关机。

此接口为系统接口，三方应用不支持调用。

需要权限： ohos.permission.REBOOT

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

示例：

power.shutdownDevice("shutdown_test");
console.info('power_shutdown_device_test success')

power.rebootDevice

rebootDevice(reason: string): void

重启设备。

需要权限： ohos.permission.REBOOT

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

示例：

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

power.isScreenOn

isScreenOn(callback: AsyncCallback<boolean>): void

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

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

示例：

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

power.isScreenOn

isScreenOn(): Promise<boolean>

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

系统能力： SystemCapability.PowerManager.PowerManager.Core

返回值：

示例：

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

power.wakeupDevice⁹⁺

wakeupDevice(detail: string): void

唤醒设备。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

示例：

power.wakeupDevice("application");
console.info('power_wakeup_device_test success')

power.suspendDevice⁹⁺

suspendDevice(): void

休眠设备。

此接口为系统接口，三方应用不支持调用。

系统能力： SystemCapability.PowerManager.PowerManager.Core

示例：

power.suspendDevice();
console.info('power_suspend_device_test success')

power.getPowerMode⁹⁺

getPowerMode(callback: AsyncCallback<DevicePowerMode>): void

获取当前设备的电源模式。

需要权限： ohos.permission.POWER_OPTIMIZATION

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

示例：

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

power.getPowerMode⁹⁺

getPowerMode(): Promise<DevicePowerMode>

获取当前设备的电源模式。

需要权限： ohos.permission.POWER_OPTIMIZATION

系统能力： SystemCapability.PowerManager.PowerManager.Core

返回值：

示例：

power.getPowerMode()
.then(mode => {
    console.info('power mode is ' + mode);
})
.catch(error => {
    console.log('error: ' + error);
})

power.setPowerMode⁹⁺

setPowerMode(mode: DevicePowerMode, callback: AsyncCallback<void>): void

设置当前设备的电源模式。

此接口为系统接口，三方应用不支持调用。

需要权限： ohos.permission.POWER_OPTIMIZATION

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

示例：

power.setPowerMode(power.DevicePowerMode.MODE_PERFORMANCE, error => {
    if (typeof error === "undefined") {
        console.info('set power mode to MODE_PERFORMANCE');
    } else {
        console.log('error: ' + error);
    }
})

power.setPowerMode⁹⁺

setPowerMode(mode: DevicePowerMode): Promise<void>

设置当前设备的电源模式。

此接口为系统接口，三方应用不支持调用。

需要权限： ohos.permission.POWER_OPTIMIZATION

系统能力： SystemCapability.PowerManager.PowerManager.Core

参数：

返回值：

示例：

power.setPowerMode(power.DevicePowerMode.MODE_PERFORMANCE)
.then(() => {
    console.info('set power mode to MODE_PERFORMANCE');
})
.catch(error => {
    console.log('error: ' + error);
})

DevicePowerMode⁹⁺

表示电源模式的枚举值。

系统能力： SystemCapability.PowerManager.PowerManager.Core