fluttercommunity / fluttercommunity/plus_plugins

[Request]: Support tracking all battery aspects

Open
#3,448 6 comments 69 reactions 0 assignees View on GitHub
enhancement triage
Dominant language
Dart
Stars
1.9k
Forks
1.3k
PR merge metrics
No merged PRs in 30d

Description

### Plugin

battery_plus

### Use case

At the moment, there is no option to track changes in battery level or any other aspect. However, for many apps, it would be quite reasonable to react to such changes, by displaying a snackbar message or sending analytics data.

iOS provides support for this functionality:
[Documentation for level notification](https://developer.apple.com/documentation/uikit/uidevice/batteryleveldidchangenotification?language=objc)
[Documentation for power save mode notification](https://developer.apple.com/documentation/foundation/nsprocessinfopowerstatedidchangenotification)

```swift
Publishers.Merge3(
NotificationCenter.default.publisher(for: UIDevice.batteryLevelDidChangeNotification),
NotificationCenter.default.publisher(for: UIDevice.batteryStateDidChangeNotification),
NotificationCenter.default.publisher(for: NSNotification.Name.NSProcessInfoPowerStateDidChange)
)
.sink { _ in self.onBatteryInfoChanged() }
```

Android also supports monitoring battery level changes:
[Documentation](https://developer.android.com/training/monitoring-device-state/battery-monitoring)
[Power save mode changed notification](https://developer.android.com/reference/android/os/PowerManager#ACTION_POWER_SAVE_MODE_CHANGED)

```kotlin
applicationContext?.registerReceiver(
this,
IntentFilter().apply {
addAction(Intent.ACTION_BATTERY_CHANGED)
addAction(Intent.ACTION_BATTERY_LOW)
addAction(PowerManager.ACTION_POWER_SAVE_MODE_CHANGED)
}
)
```

I’m not entirely sure about other platforms, but I would expect similar functionality to be available.

### Proposal

```dart
class BatteryInfo {
final double level;
final bool isLow;
final bool isInBatterySaveMode;
final BatteryState state;
}

battery.onBatteryInfoChanged.listen((BatteryInfo info) {
// Do something with new info
});
```

I actually already have an implementation for iOS and Android and would be happy to contribute if this proposal is considered useful.

@mhadaily cc

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.