系統電源管理

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

說明： 本模塊首批接口從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

參數：

參數名	類型	必填	說明
reason	string	是	關機原因。

示例：

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

power.rebootDevice

rebootDevice(reason: string): void

重啟設備。

需要權限： ohos.permission.REBOOT

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

參數：

參數名	類型	必填	說明
reason	string	是	重啟原因。

示例：

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

power.isScreenOn

isScreenOn(callback: AsyncCallback): void

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

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

參數：

參數名	類型	必填	說明
callback	AsyncCallback	是	指定的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

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

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

返回值：

類型	說明
Promise	Promise實例，用于異步獲取返回值，亮屏返回true，滅屏返回false。

示例：

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

參數：

參數名	類型	必填	說明
detail	string	是	喚醒原因。

示例：

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

參數：

參數名	類型	必填	說明
callback	AsyncCallback	是	指定的callback回調方法，用于獲取返回值。 callback返回值：[DevicePowerMode]。

示例：

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

返回值：

類型	說明
Promise	Promise實例，用于異步獲取返回值，[DevicePowerMode]。

示例：

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

參數：

參數名	類型	必填	說明
mode	[DevicePowerMode]	是	電源模式。
callback	AsyncCallback	是	指定的callback回調方法。

示例：

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

參數：

參數名	類型	必填	說明
mode	[DevicePowerMode]	是	電源模式。

返回值：

類型	說明
Promise	Promise實例。

示例：

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

搜狗高速瀏覽器截圖20240326151450.png

名稱`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`	默認值	描述
MODE_NORMAL	600	表示標準模式，默認值。
MODE_POWER_SAVE	601	表示省電模式。
MODE_PERFORMANCE	602	表示性能模式。
MODE_EXTREME_POWER_SAVE	603	表示超級省電模式。