系統(tǒng)電源管理

該模塊主要提供重啟、關(guān)機(jī)、查詢屏幕狀態(tài)等接口。

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

導(dǎo)入模塊

import power from '@ohos.power';

power.shutdownDevice

shutdownDevice(reason: string): void

系統(tǒng)關(guān)機(jī)。

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

需要權(quán)限： ohos.permission.REBOOT

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

示例：

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

power.rebootDevice

rebootDevice(reason: string): void

重啟設(shè)備。

需要權(quán)限： ohos.permission.REBOOT

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

示例：

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

power.isScreenOn

isScreenOn(callback: AsyncCallback): void

檢測當(dāng)前設(shè)備的亮滅屏狀態(tài)。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

示例：

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

power.isScreenOn

isScreenOn(): Promise

檢測當(dāng)前設(shè)備的亮滅屏狀態(tài)。

系統(tǒng)能力： 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

喚醒設(shè)備。

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

示例：

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

power.suspendDevice9+

suspendDevice(): void

休眠設(shè)備。

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

示例：

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

power.getPowerMode9+

getPowerMode(callback: AsyncCallback): void

獲取當(dāng)前設(shè)備的電源模式。

需要權(quán)限： ohos.permission.POWER_OPTIMIZATION

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

示例：

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

power.getPowerMode9+

getPowerMode(): Promise

獲取當(dāng)前設(shè)備的電源模式。

需要權(quán)限： ohos.permission.POWER_OPTIMIZATION

系統(tǒng)能力： 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

設(shè)置當(dāng)前設(shè)備的電源模式。

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

需要權(quán)限： ohos.permission.POWER_OPTIMIZATION

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

示例：

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

設(shè)置當(dāng)前設(shè)備的電源模式。

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

需要權(quán)限： ohos.permission.POWER_OPTIMIZATION

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

參數(shù)：

返回值：

示例：

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

DevicePowerMode9+

表示電源模式的枚舉值。

系統(tǒng)能力： SystemCapability.PowerManager.PowerManager.Core

審核編輯 黃宇