| java.lang.Object | |
| ↳ | android.os.BatteryManager |
The BatteryManager class contains strings and constants used for values
in the ACTION_BATTERY_CHANGED Intent, and
provides a method for querying battery and charging properties.
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| String | ACTION_CHARGING | Sent when the device's battery has started charging (or has reached full charge and the device is on power). | |||||||||
| String | ACTION_DISCHARGING | Sent when the device's battery may be discharging, so apps should avoid doing extraneous work that would cause it to discharge faster. | |||||||||
| int | BATTERY_HEALTH_COLD | ||||||||||
| int | BATTERY_HEALTH_DEAD | ||||||||||
| int | BATTERY_HEALTH_GOOD | ||||||||||
| int | BATTERY_HEALTH_OVERHEAT | ||||||||||
| int | BATTERY_HEALTH_OVER_VOLTAGE | ||||||||||
| int | BATTERY_HEALTH_UNKNOWN | ||||||||||
| int | BATTERY_HEALTH_UNSPECIFIED_FAILURE | ||||||||||
| int | BATTERY_PLUGGED_AC | Power source is an AC charger. | |||||||||
| int | BATTERY_PLUGGED_USB | Power source is a USB port. | |||||||||
| int | BATTERY_PLUGGED_WIRELESS | Power source is wireless. | |||||||||
| int | BATTERY_PROPERTY_CAPACITY | Remaining battery capacity as an integer percentage of total capacity (with no fractional part). | |||||||||
| int | BATTERY_PROPERTY_CHARGE_COUNTER | Battery capacity in microampere-hours, as an integer. | |||||||||
| int | BATTERY_PROPERTY_CURRENT_AVERAGE | Average battery current in microamperes, as an integer. | |||||||||
| int | BATTERY_PROPERTY_CURRENT_NOW | Instantaneous battery current in microamperes, as an integer. | |||||||||
| int | BATTERY_PROPERTY_ENERGY_COUNTER | Battery remaining energy in nanowatt-hours, as a long integer. | |||||||||
| int | BATTERY_STATUS_CHARGING | ||||||||||
| int | BATTERY_STATUS_DISCHARGING | ||||||||||
| int | BATTERY_STATUS_FULL | ||||||||||
| int | BATTERY_STATUS_NOT_CHARGING | ||||||||||
| int | BATTERY_STATUS_UNKNOWN | ||||||||||
| String | EXTRA_HEALTH |
Extra for ACTION_BATTERY_CHANGED:
integer containing the current health constant.
|
|||||||||
| String | EXTRA_ICON_SMALL |
Extra for ACTION_BATTERY_CHANGED:
integer containing the resource ID of a small status bar icon
indicating the current battery state.
|
|||||||||
| String | EXTRA_LEVEL |
Extra for ACTION_BATTERY_CHANGED:
integer field containing the current battery level, from 0 to
EXTRA_SCALE.
|
|||||||||
| String | EXTRA_PLUGGED |
Extra for ACTION_BATTERY_CHANGED:
integer indicating whether the device is plugged in to a power
source; 0 means it is on battery, other constants are different
types of power sources.
|
|||||||||
| String | EXTRA_PRESENT |
Extra for ACTION_BATTERY_CHANGED:
boolean indicating whether a battery is present.
|
|||||||||
| String | EXTRA_SCALE |
Extra for ACTION_BATTERY_CHANGED:
integer containing the maximum battery level.
|
|||||||||
| String | EXTRA_STATUS |
Extra for ACTION_BATTERY_CHANGED:
integer containing the current status constant.
|
|||||||||
| String | EXTRA_TECHNOLOGY |
Extra for ACTION_BATTERY_CHANGED:
String describing the technology of the current battery.
|
|||||||||
| String | EXTRA_TEMPERATURE |
Extra for ACTION_BATTERY_CHANGED:
integer containing the current battery temperature.
|
|||||||||
| String | EXTRA_VOLTAGE |
Extra for ACTION_BATTERY_CHANGED:
integer containing the current battery voltage level.
|
|||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Return the value of a battery property of integer type.
| |||||||||||
Return the value of a battery property of long type If the
platform does not provide the property queried, this value will
be Long.MIN_VALUE.
| |||||||||||
Return true if the battery is currently considered to be charging.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Sent when the device's battery has started charging (or has reached full charge
and the device is on power). This is a good time to do work that you would like to
avoid doing while on battery (that is to avoid draining the user's battery due to
things they don't care enough about).
This is paired with ACTION_DISCHARGING. The current state can always
be retrieved with isCharging().
Sent when the device's battery may be discharging, so apps should avoid doing
extraneous work that would cause it to discharge faster.
This is paired with ACTION_CHARGING. The current state can always
be retrieved with isCharging().
Power source is an AC charger.
Power source is a USB port.
Power source is wireless.
Remaining battery capacity as an integer percentage of total capacity (with no fractional part).
Battery capacity in microampere-hours, as an integer.
Average battery current in microamperes, as an integer. Positive values indicate net current entering the battery from a charge source, negative values indicate net current discharging from the battery. The time period over which the average is computed may depend on the fuel gauge hardware and its configuration.
Instantaneous battery current in microamperes, as an integer. Positive values indicate net current entering the battery from a charge source, negative values indicate net current discharging from the battery.
Battery remaining energy in nanowatt-hours, as a long integer.
Extra for ACTION_BATTERY_CHANGED:
integer containing the current health constant.
Extra for ACTION_BATTERY_CHANGED:
integer containing the resource ID of a small status bar icon
indicating the current battery state.
Extra for ACTION_BATTERY_CHANGED:
integer field containing the current battery level, from 0 to
EXTRA_SCALE.
Extra for ACTION_BATTERY_CHANGED:
integer indicating whether the device is plugged in to a power
source; 0 means it is on battery, other constants are different
types of power sources.
Extra for ACTION_BATTERY_CHANGED:
boolean indicating whether a battery is present.
Extra for ACTION_BATTERY_CHANGED:
integer containing the maximum battery level.
Extra for ACTION_BATTERY_CHANGED:
integer containing the current status constant.
Extra for ACTION_BATTERY_CHANGED:
String describing the technology of the current battery.
Extra for ACTION_BATTERY_CHANGED:
integer containing the current battery temperature.
Extra for ACTION_BATTERY_CHANGED:
integer containing the current battery voltage level.
Return the value of a battery property of integer type. If the platform does not provide the property queried, this value will be Integer.MIN_VALUE.
| id | identifier of the requested property |
|---|
Return the value of a battery property of long type If the platform does not provide the property queried, this value will be Long.MIN_VALUE.
| id | identifier of the requested property |
|---|
Return true if the battery is currently considered to be charging. This means that
the device is plugged in and is supplying sufficient power that the battery level is
going up (or the battery is fully charged). Changes in this state are matched by
broadcasts of ACTION_CHARGING and ACTION_DISCHARGING.
Developers