熱管理

2024-01-23 17:47 更新

該模塊提供熱管理相關(guān)的接口,包括熱檔位查詢及注冊(cè)回調(diào)等功能。

說明

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

導(dǎo)入模塊

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

thermal.registerThermalLevelCallback9+

registerThermalLevelCallback(callback: Callback<ThermalLevel>): void

訂閱熱檔位變化時(shí)的回調(diào)提醒。

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

參數(shù):

參數(shù)名

類型

必填

說明

callback

Callback<ThermalLevel>

回調(diào)函數(shù),返回變化后的熱檔位。

錯(cuò)誤碼:

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見耗電統(tǒng)計(jì)錯(cuò)誤碼。

錯(cuò)誤碼ID

錯(cuò)誤信息

4800101

連接服務(wù)失敗。

示例:

  1. try {
  2. thermal.registerThermalLevelCallback(level => {
  3. console.info('thermal level is: ' + level);
  4. });
  5. console.info('register thermal level callback success.');
  6. } catch(err) {
  7. console.error('register thermal level callback failed, err: ' + err);
  8. }

thermal.unregisterThermalLevelCallback9+

unregisterThermalLevelCallback(callback?: Callback<void>): void

取消訂閱熱檔位變化時(shí)的回調(diào)提醒。

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

參數(shù):

參數(shù)名

類型

必填

說明

callback

Callback<void>

回調(diào)函數(shù),無返回值。不填該參數(shù)則取消所有回調(diào)。

錯(cuò)誤碼:

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見熱管理錯(cuò)誤碼。

錯(cuò)誤碼ID

錯(cuò)誤信息

4800101

連接服務(wù)失敗。

示例:

  1. try {
  2. thermal.unregisterThermalLevelCallback(() => {
  3. console.info('unsubscribe thermal level success.');
  4. });
  5. console.info('unregister thermal level callback success.');
  6. } catch(err) {
  7. console.error('unregister thermal level callback failed, err: ' + err);
  8. }

thermal.getLevel9+

getLevel(): ThermalLevel

獲取當(dāng)前熱檔位信息。

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

返回值:

類型

說明

ThermalLevel

熱檔位信息。

錯(cuò)誤碼:

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見熱管理錯(cuò)誤碼。

錯(cuò)誤碼ID

錯(cuò)誤信息

4800101

連接服務(wù)失敗。

示例:

  1. try {
  2. var level = thermal.getLevel();
  3. console.info('thermal level is: ' + level);
  4. } catch(err) {
  5. console.error('get thermal level failed, err: ' + err);
  6. }

thermal.subscribeThermalLevel(deprecated)

subscribeThermalLevel(callback: AsyncCallback<ThermalLevel>): void

說明

從API version 9開始不再維護(hù),建議使用thermal.registerThermalLevelCallback替代。

訂閱熱檔位變化時(shí)的回調(diào)提醒。

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

參數(shù):

參數(shù)名

類型

必填

說明

callback

AsyncCallback<ThermalLevel>

回調(diào)函數(shù)。AsyncCallback只返回一個(gè)參數(shù)。

示例:

  1. thermal.subscribeThermalLevel((level) => {
  2. console.info('thermal level is: ' + level);
  3. });

thermal.unsubscribeThermalLevel(deprecated)

unsubscribeThermalLevel(callback?: AsyncCallback<void>): void

說明

從API version 9開始不再維護(hù),建議使用thermal.unregisterThermalLevelCallback替代。

取消訂閱熱檔位變化時(shí)的回調(diào)提醒。

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

參數(shù):

參數(shù)名

類型

必填

說明

callback

AsyncCallback<void>

回調(diào)函數(shù),無返回值。不填該參數(shù)則取消所有回調(diào)。

示例:

  1. thermal.unsubscribeThermalLevel(() => {
  2. console.info('unsubscribe thermal level success.');
  3. });

thermal.getThermalLevel(deprecated)

getThermalLevel(): ThermalLevel

說明

從API version 9開始不再維護(hù),建議使用thermal.getLevel替代。

獲取當(dāng)前熱檔位信息。

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

返回值:

類型

說明

ThermalLevel

熱檔位信息。

示例:

  1. var level = thermal.getThermalLevel();
  2. console.info('thermal level is: ' + level);

ThermalLevel

熱檔位信息。

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

名稱

說明

COOL

0

表明設(shè)備處于低溫的狀態(tài),業(yè)務(wù)執(zhí)行不受熱控的限制。

NORMAL

1

表明設(shè)備處于正常工作狀態(tài),但溫度不低,需要注意是否臨近發(fā)熱狀態(tài)

WARM

2

表明設(shè)備已經(jīng)進(jìn)入溫?zé)釥顟B(tài),部分無感知業(yè)務(wù)需要考慮停止或延遲執(zhí)行。

HOT

3

表明設(shè)備已經(jīng)明顯發(fā)熱,無感知業(yè)務(wù)應(yīng)全面停止,其他業(yè)務(wù)應(yīng)考慮降規(guī)格及負(fù)載。

OVERHEATED

4

表明設(shè)備已經(jīng)發(fā)熱嚴(yán)重,無感知業(yè)務(wù)應(yīng)全面停止,主要業(yè)務(wù)需降低規(guī)格及負(fù)載。

WARNING

5

表明設(shè)備已經(jīng)發(fā)熱嚴(yán)重并且即將進(jìn)入緊急狀態(tài),無感知業(yè)務(wù)應(yīng)全面停止,主要業(yè)務(wù)應(yīng)降低至最低規(guī)格。

EMERGENCY

6

表明設(shè)備已經(jīng)進(jìn)入緊急狀態(tài),所有業(yè)務(wù)應(yīng)當(dāng)全面停止工作,可保留部分緊急求助功能。

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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)