32 lines
1.1 KiB
Swift
32 lines
1.1 KiB
Swift
//
|
|
// Copyright 2025 Signal Messenger, LLC
|
|
// SPDX-License-Identifier: AGPL-3.0-only
|
|
//
|
|
|
|
import Foundation
|
|
|
|
@MainActor
|
|
public protocol DeviceBatteryLevelMonitor {
|
|
/// A value from 0 to 1
|
|
var batteryLevel: Float { get }
|
|
|
|
/// Notification fired on NotificationCenter.default when the battery level changes.
|
|
var notification: Notification.Name { get }
|
|
}
|
|
|
|
@MainActor
|
|
public protocol DeviceBatteryLevelManager {
|
|
|
|
/// Setting `UIDevice.isBatteryMonitoringEnabled` incurs a cost and Apple would like we
|
|
/// only do it as strictly needed. To manage this app wide, use a unique reason string. As long
|
|
/// as some monitor is active, battery monitoring will be enabled (thus allowing checking the
|
|
/// current battery level and getting battery level change notifications).
|
|
func beginMonitoring(reason: String) -> DeviceBatteryLevelMonitor
|
|
|
|
/// MUST call this before releasing the reference to the DeviceBatteryLevelMonitor from `beginMonitoring`.
|
|
func endMonitoring(_ monitor: DeviceBatteryLevelMonitor)
|
|
|
|
var isLowPowerModeEnabled: Bool { get }
|
|
var isLowPowerModeChangedNotification: Notification.Name { get }
|
|
}
|