热管理

icon-note.gif 说明: 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

该模块提供热管理相关的接口,包括热档位查询及注册回调等功能。

导入模块

import thermal from '@ohos.thermal';

ThermalLevel

热档位信息。

系统能力: 以下各项对应的系统能力均为SystemCapability.PowerManager.ThermalManager

名称 默认值 描述
COOL 0 表明设备处于低温的状态,业务执行不受热控的限制。
NORMAL 1 表明设备处于正常工作状态,但温度不低,需要注意是否临近发热状态
WARM 2 表明设备已经进入温热状态,部分无感知业务需要考虑停止或延迟执行。
HOT 3 表明设备已经明显发热,无感知业务应全面停止,其他业务应考虑降规格及负载。
OVERHEATED 4 表明设备已经发热严重,无感知业务应全面停止,主要业务需降低规格及负载。
WARNING 5 表明设备已经发热严重并且即将进入紧急状态,无感知业务应全面停止,主要业务应降低至最低规格。
EMERGENCY 6 表明设备已经进入紧急状态,所有业务应当全面停止工作,可保留部分紧急求助功能。

thermal.subscribeThermalLevel

subscribeThermalLevel(callback: AsyncCallback<ThermalLevel>): void

订阅热档位变化时的回调提醒。

系统能力: SystemCapability.PowerManager.ThermalManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<ThermalLevel> 指定的callback回调方法,用于获取返回值。
callback返回值:热档位信息。

示例:

var lev = 0;
thermal.subscribeThermalLevel((lev) => {
    console.info("Thermal level is: " + lev);
})

thermal.unsubscribeThermalLevel

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

取消订阅热档位变化时的回调提醒。

系统能力: SystemCapability.PowerManager.ThermalManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 可选 指定的callback回调方法,无返回值。

示例:

thermal.unsubscribeThermalLevel(() => {
    console.info("Unsubscribe completed.");
});

thermal.getThermalLevel

getThermalLevel(): ThermalLevel

获取当前热档位信息。

系统能力: SystemCapability.PowerManager.ThermalManager

返回值:

类型 说明
ThermalLevel 热档位信息。

示例:

var lev = thermal.getThermalLevel();
console.info("Thermal level is: " + lev);