系統(tǒng)電源管理

2024-01-23 17:38 更新

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

說明

本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口,采用上角標單獨標記接口的起始版本。

導入模塊

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

power.isActive9+

isActive(): boolean

檢測當前設備是否處于活動狀態(tài)。

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

錯誤碼:

以下錯誤碼的詳細介紹請參見系統(tǒng)電源管理錯誤碼。

錯誤碼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

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

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

返回值:

類型

說明

DevicePowerMode

電源模式。

錯誤碼:

以下錯誤碼的詳細介紹請參見系統(tǒng)電源管理錯誤碼

錯誤碼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開始不再維護,替代接口能力僅對系統(tǒng)應用開放。

重啟設備。

需要權限: ohos.permission.REBOOT

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

參數(shù):

參數(shù)名

類型

必填

說明

reason

string

重啟原因。

示例:

  1. power.rebootDevice('reboot_test');

power.isScreenOn(deprecated)

isScreenOn(callback: AsyncCallback<boolean>): void

說明

從API version 9開始不再維護,建議使用power.isActive替代。

檢測當前設備的亮滅屏狀態(tài)。使用callback異步回調(diào)。

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

參數(shù):

參數(shù)名

類型

必填

說明

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。當檢測成功,err為undefined,data為獲取到的亮滅屏狀態(tài),返回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替代。

檢測當前設備的亮滅屏狀態(tài)。使用Promise異步回調(diào)。

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

表示電源模式的枚舉值。

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

名稱

說明

MODE_NORMAL

600

表示標準模式,默認值。

MODE_POWER_SAVE

601

表示省電模式。

MODE_PERFORMANCE

602

表示性能模式。

MODE_EXTREME_POWER_SAVE

603

表示超級省電模式。

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號