BatteryState
public abstract class BatteryState
extends Object
| java.lang.Object | |
| ↳ | android.hardware.BatteryState |
The BatteryState class is a representation of a single battery on a device.
Summary
Constants | |
|---|---|
int | STATUS_CHARGING Battery is charging. |
int | STATUS_DISCHARGING Battery is discharging. |
int | STATUS_FULL Battery is full. |
int | STATUS_NOT_CHARGING Battery is connected to power but not charging. |
int | STATUS_UNKNOWN Battery status is unknown. |
Public constructors | |
|---|---|
BatteryState() | |
Public methods | |
|---|---|
abstract float | getCapacity() Get remaining battery capacity as float percentage [0.0f, 1.0f] of total capacity Returns NaN when battery capacity can't be read. |
abstract int | getStatus() Get the battery status. |
abstract boolean | isPresent() Check whether the hardware has a battery. |
Inherited methods | |
|---|---|
Constants
STATUS_CHARGING
public static final int STATUS_CHARGING
Battery is charging.
Constant Value: 2 (0x00000002)
STATUS_DISCHARGING
public static final int STATUS_DISCHARGING
Battery is discharging.
Constant Value: 3 (0x00000003)
STATUS_FULL
public static final int STATUS_FULL
Battery is full.
Constant Value: 5 (0x00000005)
STATUS_NOT_CHARGING
public static final int STATUS_NOT_CHARGING
Battery is connected to power but not charging.
Constant Value: 4 (0x00000004)
STATUS_UNKNOWN
public static final int STATUS_UNKNOWN
Battery status is unknown.
Constant Value: 1 (0x00000001)
Public constructors
BatteryState
public BatteryState ()
Public methods
getCapacity
public abstract float getCapacity ()
Get remaining battery capacity as float percentage [0.0f, 1.0f] of total capacity Returns NaN when battery capacity can't be read.
| Returns | |
|---|---|
float | the battery capacity. Value is between -1.0f and 1.0f inclusive |
getStatus
public abstract int getStatus ()
Get the battery status.
| Returns | |
|---|---|
int | the battery status. Value is STATUS_UNKNOWN, STATUS_CHARGING, STATUS_DISCHARGING, STATUS_NOT_CHARGING, or STATUS_FULL |
isPresent
public abstract boolean isPresent ()
Check whether the hardware has a battery.
| Returns | |
|---|---|
boolean | True if the hardware has a battery, else false. |