BatteryInfo

This property holds the number of batteries available, or -1 on error or the information is not available.

This property holds the type of the charger. Possible values are:

• BatteryInfo.UnknownCharger - The charger type is unknown, or no charger.
• BatteryInfo.WallCharger - Using wall (mains) charger.
• BatteryInfo.USBCharger - Using USB charger when the system cannot differentiate the current.
• BatteryInfo.VariableCurrentCharger - Using variable current charger such as bicycle or solar.

This property holds the energy unit used. Possible values are:

• BatteryInfo.UnitUnknown - Energy unit unknown.
• BatteryInfo.UnitmAh - Energy described in milliamp-hour (mAh)
• BatteryInfo.UnitmWh - Energy described in milliwatt-hour (mWh)

This property holds whether or not monitor the change of battery counts.

See also batteryCount.

This property holds whether or not monitor the change of battery's status.

See also onBatteryStatusChanged.

This property holds whether or not monitor the change of charger type.

See also chargerType.

This property holds whether or not monitor the change of charging state.

See also onChargingStateChanged.

This property holds whether or not monitor the flow of batteries.

See also onCurrentFlowChanged.

This property holds whether or not monitor the remaining capacity of batteries.

See also onRemainingCapacityChanged.

This property holds whether or not monitor the remaining charging time of batteries.

See also onRemainingChargingTimeChanged.

This property holds whether or not monitor the voltage of batteries.

See also onVoltageChanged.

This handler is called when status of battery has changed to status. Note that it won't be called unless monitorBatteryStatus is set true.

See also batteryStatus and monitorBatteryStatus.

This handler is called when charging state of battery has changed to state. Note that it won't be called unless monitorChargingState is set true.

See also chargingState and monitorChargingState.

This handler is called when current flow of battery has changed to flow. Note that it won't be called unless monitorCurrentFlow is set true.

See also currentFlow and monitorCurrentFlow.

This handler is called when remaining capacity of battery has changed to capacity. Note that it won't be called unless monitorRemainingCapacity is set true.

See also remainingCapacity and monitorRemainingCapacity.

This handler is called when remaining charging time of battery has changed to seconds. Note that it won't be called unless monitorRemainingChargingTime is set true.

See also remainingChargingTime and monitorRemainingChargingTime.

This handler is called when voltage of battery has changed to voltage. Note that it won't be called unless monitorVoltage is set true.

See also voltage and monitorVoltage.

Returns the status of the given battery. Possible values are:

• BatteryInfo.BatteryStatusUnknown - Battery level undetermined.
• BatteryInfo.BatteryEmpty - Battery is considered be empty and device needs to shut down.
• BatteryInfo.BatteryLow - Battery level is low and warnings need to be issued to the user.
• BatteryInfo.BatteryOk - Battery level is Ok. It is above "Low" but not "Full".
• BatteryInfo.BatteryFull - Battery is fully charged.

See also onBatteryStatusChanged.

Returns the charging state of the given battery. Possible values are:

• BatteryInfo.UnknownChargingState - The charging state is unknown or charging error occured.
• BatteryInfo.NotCharging - The battery is not charging, i.e. too low charger power.
• BatteryInfo.Charging - The battery is charging.
• BatteryInfo.Discharging - The battery is discharging.
• BatteryInfo.Full - The battery is fully charged.

See also onChargingStateChanged.

Returns the current flow of the battery.

See also onCurrentFlowChanged.

Returns the maximum capacity of the battery

Returns the remaining capacity of the battery.

See also onRemainingCapacityChanged.

Returns the remaining charging time of the battery.

See also onRemainingChargingTimeChanged.

Returns the voltage of the battery.

See also onVoltageChanged.