@ohos.thermal (热管理)

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

说明：

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

导入模块

import thermal from '@ohos.thermal';

thermal.registerThermalLevelCallback9+

registerThermalLevelCallback(callback: Callback<ThermalLevel>): void

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

系统能力： SystemCapability.PowerManager.ThermalManager

参数：

参数名 类型 必填 说明
callback Callback<ThermalLevel> 是 回调函数，返回变化后的热档位。

错误码：

以下错误码的详细介绍请参见耗电统计错误码。

错误码ID 错误信息
4800101 If connecting to the service failed.

示例：

try {
    thermal.registerThermalLevelCallback(level => {
        console.info('thermal level is: ' + level);
    });
    console.info('register thermal level callback success.');
} catch(err) {
    console.error('register thermal level callback failed, err: ' + err);
}

thermal.unregisterThermalLevelCallback9+

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

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

系统能力： SystemCapability.PowerManager.ThermalManager

参数：

参数名 类型 必填 说明
callback Callback<void> 否 回调函数，无返回值。不填该参数则取消所有回调。

错误码：

以下错误码的详细介绍请参见热管理错误码。

错误码ID 错误信息
4800101 If connecting to the service failed.

示例：

try {
    thermal.unregisterThermalLevelCallback(() => {
        console.info('unsubscribe thermal level success.');
    });
    console.info('unregister thermal level callback success.');
} catch(err) {
    console.error('unregister thermal level callback failed, err: ' + err);
}

thermal.getLevel9+

getLevel(): ThermalLevel

获取当前热档位信息。

系统能力： SystemCapability.PowerManager.ThermalManager

返回值：

类型 说明
ThermalLevel 热档位信息。

错误码：

以下错误码的详细介绍请参见热管理错误码。

错误码ID 错误信息
4800101 If connecting to the service failed.

示例：

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

thermal.subscribeThermalLevel(deprecated)

subscribeThermalLevel(callback: AsyncCallback<ThermalLevel>): void

说明：
从API version 9开始不再维护，建议使用thermal.registerThermalLevelCallback替代。

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

系统能力： SystemCapability.PowerManager.ThermalManager

参数：

参数名 类型 必填 说明
callback AsyncCallback<ThermalLevel> 是 回调函数。AsyncCallback只返回一个参数，为热档位信息，此时可能会产生告警，可通过// @ts-ignore进行抑制。

示例：

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

thermal.unsubscribeThermalLevel(deprecated)

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

说明：
从API version 9开始不再维护，建议使用thermal.unregisterThermalLevelCallback替代。

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

系统能力： SystemCapability.PowerManager.ThermalManager

参数：

参数名 类型 必填 说明
callback AsyncCallback<void> 否 回调函数，无返回值。不填该参数则取消所有回调。

示例：

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

thermal.getThermalLevel(deprecated)

getThermalLevel(): ThermalLevel

说明：
从API version 9开始不再维护，建议使用thermal.getLevel替代。

获取当前热档位信息。

系统能力： SystemCapability.PowerManager.ThermalManager

返回值：

类型 说明
ThermalLevel 热档位信息。

示例：

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

ThermalLevel

热档位信息。

系统能力： SystemCapability.PowerManager.ThermalManager

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