diff --git a/en/application-dev/reference/apis/js-apis-thermal.md b/en/application-dev/reference/apis/js-apis-thermal.md index 9c534aae3b5dee1be7890153cd9eba768d770a64..5d6648171ee97febc156025f1501c8500a0cb011 100644 --- a/en/application-dev/reference/apis/js-apis-thermal.md +++ b/en/application-dev/reference/apis/js-apis-thermal.md @@ -1,8 +1,10 @@ -# Thermal Management +# Thermal Manager > ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE** > The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version. +The Thermal Manager module provides APIs for listening to the device thermal status. + ## Modules to Import @@ -15,15 +17,15 @@ import thermal from '@ohos.thermal'; Represents the thermal level. -| Name| Default Value| Description| -| -------- | -------- | -------- | -| COOL | 0 | The device is cool, and services are not restricted.| -| NORMAL | 1 | The device is operational but is not cool. You need to pay attention to its heating.| -| WARM | 2 | The device is warm. You need to stop or delay some imperceptible services.| -| HOT | 3 | The device is heating up. You need to stop all imperceptible services and downgrade or reduce the load of other services.| -| OVERHEATED | 4 | The device is overheated. You need to stop all imperceptible services and downgrade or reduce the load of major services.| -| WARNING | 5 | The device is overheated and is about to enter the emergency state. You need to stop all imperceptible services and downgrade major services to the maximum extent.| -| EMERGENCY | 6 | The device has entered the emergency state. You need to stop all services except those for the emergency help purposes.| +| Name | Default Value | Description | +| ---------- | ---- | ---------------------------------------- | +| COOL | 0 | The device is cool, and services are not restricted.
**System capability:** SystemCapability.PowerManager.ThermalManager| +| NORMAL | 1 | The device is operational but is not cool. You need to pay attention to its heating.
**System capability:** SystemCapability.PowerManager.ThermalManager| +| WARM | 2 | The device is warm. You need to stop or delay some imperceptible services.
**System capability:** SystemCapability.PowerManager.ThermalManager| +| HOT | 3 | The device is heating up. You need to stop all imperceptible services and downgrade or reduce the load of other services.
**System capability:** SystemCapability.PowerManager.ThermalManager| +| OVERHEATED | 4 | The device is overheated. You need to stop all imperceptible services and downgrade or reduce the load of major services.
**System capability:** SystemCapability.PowerManager.ThermalManager| +| WARNING | 5 | The device is overheated and is about to enter the emergency state. You need to stop all imperceptible services and downgrade major services to the maximum extent.
**System capability:** SystemCapability.PowerManager.ThermalManager| +| EMERGENCY | 6 | The device has entered the emergency state. You need to stop all services except those for the emergency help purposes.
**System capability:** SystemCapability.PowerManager.ThermalManager| ## thermal.subscribeThermalLevel @@ -32,19 +34,18 @@ subscribeThermalLevel(callback: AsyncCallback<ThermalLevel>): void Subscribes to thermal level changes. -**System Capabilities** - -SystemCapability.PowerManager.ThermalManager +**System capability:** SystemCapability.PowerManager.ThermalManager **Parameters** -| Name| Type| Mandatory| Description| -| -------- | -------- | -------- | -------- | -| callback | AsyncCallback<ThermalLevel> | Yes| Callback used to obtain the return value.
Return value: thermal level| +| Name | Type | Mandatory | Description | +| -------- | --------------------------------- | ---- | ---------------------------------------- | +| callback | AsyncCallback<ThermalLevel> | Yes | Callback used to obtain the return value.
Return value: thermal level| **Example** ``` +var lev = 0; thermal.subscribeThermalLevel((lev) => { console.info("Thermal level is: " + lev); }) @@ -52,19 +53,17 @@ thermal.subscribeThermalLevel((lev) => { ## thermal.unsubscribeThermalLevel -unsubscribeThermalLevel(callback?: AsyncCallback): void +unsubscribeThermalLevel(callback?: AsyncCallback\): void Unsubscribes from thermal level changes. -**System Capabilities** - -SystemCapability.PowerManager.ThermalManager +**System capability:** SystemCapability.PowerManager.ThermalManager **Parameters** -| Name| Type| Mandatory| Description| -| -------- | -------- | -------- | -------- | -| callback | AsyncCallback<void> | No| Callback without a return value.| +| Name | Type | Mandatory | Description | +| -------- | ------------------------- | ---- | --------------------- | +| callback | AsyncCallback<void> | No | Callback without a return value.| **Example** @@ -80,14 +79,12 @@ getThermalLevel(): ThermalLevel Obtains the current thermal level. -**System Capabilities** - -SystemCapability.PowerManager.ThermalManager +**System capability:** SystemCapability.PowerManager.ThermalManager -**Return value** +**Return value**: -| Type| Description| -| -------- | -------- | +| Type | Description | +| ------------ | ------ | | ThermalLevel | Thermal level obtained.| **Example**