Added in API level 24

Summary: Constants | Methods | Inherited Methods

HardwarePropertiesManager

Kotlin |Java

public class HardwarePropertiesManager
extends Object

java.lang.Object
↳	android.os.HardwarePropertiesManager

The HardwarePropertiesManager class provides a mechanism of accessing hardware state of a device: CPU, GPU and battery temperatures, CPU usage per core, fan speed, etc.

Summary

Constants
`int`	`DEVICE_TEMPERATURE_BATTERY` Temperature of battery in Celsius.
`int`	`DEVICE_TEMPERATURE_CPU` Temperature of CPUs in Celsius.
`int`	`DEVICE_TEMPERATURE_GPU` Temperature of GPUs in Celsius.
`int`	`DEVICE_TEMPERATURE_SKIN` Temperature of device skin in Celsius.
`int`	`TEMPERATURE_CURRENT` Get current temperature.
`int`	`TEMPERATURE_SHUTDOWN` Get shutdown temperature threshold.
`int`	`TEMPERATURE_THROTTLING` Get throttling temperature threshold.
`int`	`TEMPERATURE_THROTTLING_BELOW_VR_MIN` Get throttling temperature threshold above which minimum clockrates for VR mode will not be met.
`float`	`UNDEFINED_TEMPERATURE` Undefined temperature constant.

Public methods
`CpuUsageInfo[]`	`getCpuUsages()` Return an array of CPU usage info for each core.
`float[]`	`getDeviceTemperatures(int type, int source)` Return an array of device temperatures in Celsius.
`float[]`	`getFanSpeeds()` Return an array of fan speeds in RPM.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

DEVICE_TEMPERATURE_BATTERY

Added in API level 24

public static final int DEVICE_TEMPERATURE_BATTERY

Temperature of battery in Celsius.

Constant Value: 2 (0x00000002)

DEVICE_TEMPERATURE_CPU

Added in API level 24

public static final int DEVICE_TEMPERATURE_CPU

Temperature of CPUs in Celsius.

Constant Value: 0 (0x00000000)

DEVICE_TEMPERATURE_GPU

Added in API level 24

public static final int DEVICE_TEMPERATURE_GPU

Temperature of GPUs in Celsius.

Constant Value: 1 (0x00000001)

DEVICE_TEMPERATURE_SKIN

Added in API level 24

public static final int DEVICE_TEMPERATURE_SKIN

Temperature of device skin in Celsius.

Constant Value: 3 (0x00000003)

TEMPERATURE_CURRENT

Added in API level 24

public static final int TEMPERATURE_CURRENT

Get current temperature.

Constant Value: 0 (0x00000000)

TEMPERATURE_SHUTDOWN

Added in API level 24

public static final int TEMPERATURE_SHUTDOWN

Get shutdown temperature threshold.

Constant Value: 2 (0x00000002)

TEMPERATURE_THROTTLING

Added in API level 24

public static final int TEMPERATURE_THROTTLING

Get throttling temperature threshold.

Constant Value: 1 (0x00000001)

TEMPERATURE_THROTTLING_BELOW_VR_MIN

Added in API level 24

public static final int TEMPERATURE_THROTTLING_BELOW_VR_MIN

Get throttling temperature threshold above which minimum clockrates for VR mode will not be met.

Constant Value: 3 (0x00000003)

UNDEFINED_TEMPERATURE

Added in API level 24

public static final float UNDEFINED_TEMPERATURE

Undefined temperature constant.

Constant Value: -3.4028235E38

Public methods

getCpuUsages

Added in API level 24

public CpuUsageInfo[] getCpuUsages ()

Return an array of CPU usage info for each core.

Returns
`CpuUsageInfo[]`	an array of `CpuUsageInfo` for each core. Return `null` for each unplugged core. Empty if CPU usage is not supported on this system.

Throws
`SecurityException`	if something other than the device owner or the current VR service tries to retrieve information provided by this service.

getDeviceTemperatures

Added in API level 24

public float[] getDeviceTemperatures (int type, 
                int source)

Return an array of device temperatures in Celsius.

Parameters
`type`	`int`: type of requested device temperature, one of `DEVICE_TEMPERATURE_CPU`, `DEVICE_TEMPERATURE_GPU`, `DEVICE_TEMPERATURE_BATTERY` or `DEVICE_TEMPERATURE_SKIN`. Value is `DEVICE_TEMPERATURE_CPU`, `DEVICE_TEMPERATURE_GPU`, `DEVICE_TEMPERATURE_BATTERY`, or `DEVICE_TEMPERATURE_SKIN`
`source`	`int`: source of requested device temperature, one of `TEMPERATURE_CURRENT`, `TEMPERATURE_THROTTLING`, `TEMPERATURE_THROTTLING_BELOW_VR_MIN` or `TEMPERATURE_SHUTDOWN`. Value is `TEMPERATURE_CURRENT`, `TEMPERATURE_THROTTLING`, `TEMPERATURE_SHUTDOWN`, or `TEMPERATURE_THROTTLING_BELOW_VR_MIN`

Returns
`float[]`	an array of requested float device temperatures. Temperature equals to `UNDEFINED_TEMPERATURE` if undefined. Empty if platform doesn't provide the queried temperature. This value cannot be `null`.

Throws
`SecurityException`	if something other than the device owner or the current VR service tries to retrieve information provided by this service.

getFanSpeeds

Added in API level 24

public float[] getFanSpeeds ()

Return an array of fan speeds in RPM.

Returns
`float[]`	an array of float fan speeds in RPM. Empty if there are no fans or fan speed is not supported on this system. This value cannot be `null`.

Throws
`SecurityException`	if something other than the device owner or the current VR service tries to retrieve information provided by this service.