Thermal state and headroom
Reports how hot the device is: 4 coarse levels on iOS, 7 levels plus a forecast on Android.
In one line
Can tell how hot your phone is, in 4 levels on iPhone and 7 on Android
Reports how hot the device is: 4 coarse levels on iOS, 7 levels plus a forecast on Android.
Shows the phone is throttled or in a hot place (car, sun, charging while gaming). Weak context signal; more useful to games that scale quality.
What it can and can't do
What the user does: Nothing. The app checks while it is running, mostly games and video
It can
- See iPhone heat as nominal, fair, serious or critical
- See Android heat in 7 levels, from none to shutdown
- Get a forecast on Android 11 and newer, as a number from 0.0 to 1.0
- Slow down graphics or work when the phone is hot
It cannot
- See an exact temperature in degrees on iPhone
- Cool the phone down
- See heat forecasts on Android 10 and older
How it differs between platforms: Android gives 7 levels plus a forecast. iPhone gives 4 coarse levels only.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Supported | Supported |
| First version | Android 10 (API 29) | iOS 11.0 |
| Permission or entitlement | Not listed | none |
| Protection level | none | none |
| How access is granted | none | none |
| What the user sees | Not listed | Not listed |
| How long it lasts | Not listed | Not listed |
| How to take it back | Not listed | Not listed |
| Store policy | None listed | None listed |
| API | PowerManager.getCurrentThermalStatus() (API 29), getThermalHeadroom(seconds) (API 30), addThermalStatusListener | 4 levels: nominal, fair, serious, critical |
| Notes | Status: NONE, LIGHT, MODERATE, SEVERE, CRITICAL, EMERGENCY, SHUTDOWN (7 levels); headroom is a 0.0 to 1.0 float forecast, 1.0 meaning throttling | None |
Data you get
What comes back: Thermal status
Shape: enum
How often: On change
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
android_status | enum | None | NONE to SHUTDOWN | 7 levels |
android_headroom | float | fraction | 0.0 to 1.0 (NaN if unsupported) | forecast up to 60 s ahead |
ios_thermal_state | enum | None | nominal to critical | 4 levels |
Technical limits
- No temperature in degrees on iOS
- Headroom rate-limited: call at most about once per second
The story
What it is
An app can tell if your phone is getting too hot.
For you
If your phone gets hot in a car or in the sun, a game may lower its graphics so it cools down. You see a smoother, cooler experience, though sometimes with fewer effects.
For makers
Games and video apps use it to scale quality before the phone throttles and stutters. Android offers seven levels and a forecast, iOS four coarse levels.
Where you see it
| Type | Example | Apps |
|---|---|---|
| games | A racing game quietly cuts shadows and resolution when your phone reports heat, so frame rate holds. | None named |
| ar-vr | An AR app drops tracking quality when your phone is hot after a long session. | None named |
| video | A camera or video call app lowers resolution if the phone is overheating. | None named |
| fitness | A workout app that uses camera and GPS warns you the phone is too hot in the sun. | None named |
| automotive | A car mirror app on a hot dashboard reduces map detail to stay cool. | None named |
| live | A streaming app lowers bitrate when the phone is hot during a long live stream. | None named |
Risks
- Hints where you are
- Minor privacy impact
Android and iPhone in short
- Android: Reports seven levels plus a forecast of future headroom.
- iPhone: Reports four coarse levels to apps.
What the platform says
- Google: Thermal API and ADPF. Developer pitch: sense heat headroom so games and apps can adjust before the phone slows down.
- Apple: Thermal state. Developer guide: apps can respond to the device's thermal state to keep it cool and responsive.
Good uses and abuse
Legitimate uses
- Lower frame rate or resolution
- Pause heavy uploads
Known abuse
- Little
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 1 | Rough identifying entropy, when known |
History
- 2017-09, iPhone iOS 11: ProcessInfo.thermalState added
- 2019-09, Android 10 (API 29): Thermal status API added
- 2020-09, Android 11 (API 30): getThermalHeadroom forecast added
Related capabilities
Related
- Battery health, temperature and cycle count. Can see battery health and charge cycles on Android 14 and newer, but not on iPhone
Same idea on the web
- Compute Pressure. Can tell roughly how busy your device is, only while the page is in view
Sources
How well checked: Based on official documentation.