系统电源管理

2024-01-23 17:38 更新

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

说明

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

导入模块

  1. import power from '@ohos.power';

power.isActive9+

isActive(): boolean

检测当前设备是否处于活动状态。

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

错误码:

以下错误码的详细介绍请参见系统电源管理错误码

错误码ID

错误信息

4900101

连接服务失败。

示例:

  1. try {
  2. var isActive = power.isActive();
  3. console.info('power is active: ' + isActive);
  4. } catch(err) {
  5. console.error('check active status failed, err: ' + err);
  6. }

power.getPowerMode9+

getPowerMode(): DevicePowerMode

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

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

返回值:

类型

说明

DevicePowerMode

电源模式。

错误码:

以下错误码的详细介绍请参见系统电源管理错误码

错误码ID

错误信息

4900101

连接服务失败。

示例:

  1. try {
  2. var mode = power.getPowerMode();
  3. console.info('power mode: ' + mode);
  4. } catch(err) {
  5. console.error('get power mode failed, err: ' + err);
  6. }

power.rebootDevice(deprecated)

rebootDevice(reason: string): void

说明

从API version 7开始支持,从API version 9开始不再维护,替代接口能力仅对系统应用开放。

重启设备。

需要权限: ohos.permission.REBOOT

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

参数:

参数名

类型

必填

说明

reason

string

重启原因。

示例:

  1. power.rebootDevice('reboot_test');

power.isScreenOn(deprecated)

isScreenOn(callback: AsyncCallback<boolean>): void

说明

从API version 9开始不再维护,建议使用power.isActive替代。

检测当前设备的亮灭屏状态。使用callback异步回调。

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

参数:

参数名

类型

必填

说明

callback

AsyncCallback<boolean>

回调函数。当检测成功,err为undefined,data为获取到的亮灭屏状态,返回true表示亮屏,返回false表示灭屏;否则为错误对象。

示例:

  1. power.isScreenOn((err, data) => {
  2. if (typeof err === 'undefined') {
  3. console.info('screen on status is ' + data);
  4. } else {
  5. console.error('check screen status failed, err: ' + err);
  6. }
  7. })

power.isScreenOn(deprecated)

isScreenOn(): Promise<boolean>

说明

从API version 9开始不再维护,建议使用power.isActive替代。

检测当前设备的亮灭屏状态。使用Promise异步回调。

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

返回值:

类型

说明

Promise<boolean>

Promise对象。返回true表示亮屏;返回false表示灭屏。

示例:

  1. power.isScreenOn()
  2. .then(data => {
  3. console.info('screen on status is ' + data);
  4. })
  5. .catch(err => {
  6. console.error('check screen status failed, err: ' + err);
  7. })

DevicePowerMode9+

表示电源模式的枚举值。

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

名称

说明

MODE_NORMAL

600

表示标准模式,默认值。

MODE_POWER_SAVE

601

表示省电模式。

MODE_PERFORMANCE

602

表示性能模式。

MODE_EXTREME_POWER_SAVE

603

表示超级省电模式。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号