系統電源管理

該模塊主要提供重啟、關機、查詢屏幕狀態等接口。

說明： 本模塊首批接口從API version 7開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導入模塊

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): 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

檢測當前設備的亮滅屏狀態。

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

返回值：

示例：

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

power.wakeupDevice9+

wakeupDevice(detail: string): void

喚醒設備。

此接口為系統接口，三方應用不支持調用。

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

參數：

示例：

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

power.suspendDevice9+

suspendDevice(): void

休眠設備。

此接口為系統接口，三方應用不支持調用。

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

示例：

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

power.getPowerMode9+

getPowerMode(callback: AsyncCallback): 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.getPowerMode9+

getPowerMode(): Promise

獲取當前設備的電源模式。

需要權限： 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.setPowerMode9+

setPowerMode(mode: DevicePowerMode, callback: AsyncCallback): 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.setPowerMode9+

setPowerMode(mode: DevicePowerMode): Promise

設置當前設備的電源模式。

此接口為系統接口，三方應用不支持調用。

需要權限： 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);
})

DevicePowerMode9+

表示電源模式的枚舉值。

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

審核編輯 黃宇