Battery Info

To retrieve the battery information you must call the getBatteryInfo function. The battery information retrieval is an asynchronous process so you must listen for the BatteryEvent.BATTERY_INFO event to get the response.

Battery.service.addEventListener( BatteryEvent.BATTERY_INFO, battery_infoHandler );
Battery.service.getBatteryInfo();

Then when the battery information is available:

private function battery_infoHandler( event:BatteryEvent ):void
{
// event contains information about the battery
}

The BatteryEvent contains 2 pieces of information:

  • batteryState
  • batteryLevel

The batteryLevel represents the current charge level of the battery. It ranges from 1 (full) to 0 (empty).

The batteryState indicates the current state of the battery and will be one of the values defined in the BatteryState class, which includes states like: full, charging, not charging.

Example:

private function battery_infoHandler( event:BatteryEvent ):void
{
switch( int(event.batteryState) )
{
case BatteryState.CHARGING:
trace("Battery state: CHARGING");
break;
case BatteryState.FULL:
trace("Battery state: FULL");
break;
case BatteryState.NOT_CHARGING:
trace("Battery state: NOT CHARGING");
break;
case BatteryState.NOT_SUPPORTED:
trace("Battery state: NOT SUPPORTED");
break;
case BatteryState.UNKNOWN:
default:
trace("Battery state: UNKNOWN");
break;
}
trace("Battery level: " + event.batteryLevel );
}