Skip to Content
Platform.Ontology

Thermal state and headroom

Reports how hot the device is: 4 coarse levels on iOS, 7 levels plus a forecast on Android.

Gets silentlyDevice detailsPowerAndroid and iPhoneWhile you use it

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

AndroidiPhone
StatusSupportedSupported
First versionAndroid 10 (API 29)iOS 11.0
Permission or entitlementNot listednone
Protection levelnonenone
How access is grantednonenone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedNot listed
Store policyNone listedNone listed
APIPowerManager.getCurrentThermalStatus() (API 29), getThermalHeadroom(seconds) (API 30), addThermalStatusListener4 levels: nominal, fair, serious, critical
NotesStatus: NONE, LIGHT, MODERATE, SEVERE, CRITICAL, EMERGENCY, SHUTDOWN (7 levels); headroom is a 0.0 to 1.0 float forecast, 1.0 meaning throttlingNone

Data you get

What comes back: Thermal status
Shape: enum
How often: On change

FieldTypeUnitRangePrecision
android_statusenumNoneNONE to SHUTDOWN7 levels
android_headroomfloatfraction0.0 to 1.0 (NaN if unsupported)forecast up to 60 s ahead
ios_thermal_stateenumNonenominal to critical4 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

TypeExampleApps
gamesA racing game quietly cuts shadows and resolution when your phone reports heat, so frame rate holds.None named
ar-vrAn AR app drops tracking quality when your phone is hot after a long session.None named
videoA camera or video call app lowers resolution if the phone is overheating.None named
fitnessA workout app that uses camera and GPS warns you the phone is too hot in the sun.None named
automotiveA car mirror app on a hot dashboard reduces map detail to stay cool.None named
liveA 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

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits1Rough 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

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.

On this page