电量监控方案设计

电量监控方案设计

本文档结合 CCElectrictyMonitor 和 CCElectricitySampleManager 两个模块的代码,介绍 iOS 应用中电量监控的整体方案、工作流程及统计功能,并附带流程图以便理解。


1. 模块概述

1.1 CCElectrictyMonitor (电量监控器)

  • 职责:实时监听设备电量变化,提供代理和闭包两种回调方式,支持 OC 调用。

  • 功能:

    • 开启电池监控(UIDevice.current.isBatteryMonitoringEnabled = true)
    • 定时器定时读取当前电量(默认10秒间隔)
    • 通过代理或 block 回调通知电量变化
    • 支持设置最小电量阈值(可扩展)

1.2 CCElectricitySampleManager (电量采样管理器)

  • 职责:根据不同运行场景(前台、后台)周期性采集电量数据,统计累计时间,保存采样数据到文件。

  • 功能:

    • 支持前台和后台两种场景采样,移除待机场景
    • 配置不同场景采样时间间隔(前台30分钟,后台10分钟)
    • 统计每个采样周期内电量变化百分比
    • 累计统计各场景总时间
    • 支持数据持久化存储与加载(JSON格式)
    • 支持导出采样数据文件路径供外部分析

2. 设计方案说明

  • 实时电量监听 :CCElectrictyMonitor 通过定时器定时读取系统电量,通知外部关注者。适合做即时电量变化响应。
  • 场景周期采样 :CCElectricitySampleManager 根据 APP 当前运行场景,周期性采样电量,统计累计耗时和电量变化。适合做长期电量消耗分析。
  • 数据持久化:采样数据保存到本地 JSON 文件,支持断点续采和后续上传分析。
  • 接口设计:均支持 Objective-C 访问,方便混合项目集成。

3. 工作流程


4. 关键代码说明

4.1 电量实时监听(CCElectrictyMonitor)

  • 使用 UIDevice.current.batteryLevel 获取当前电量百分比(0~1)
  • 通过 Timer.scheduledTimer 每10秒触发一次电量读取
  • 电量变化通过代理或闭包传递给调用者
  • 支持设置最小电量阈值 minBatteryLevel
swift 复制代码
@MainActor private func startTimerIfNeeded() {
    guard timer == nil else { return }
    timer = Timer.scheduledTimer(withTimeInterval: 10.0, repeats: true) { [weak self] _ in
        Task { @MainActor in
            self?.observeElectricityChanged()
        }
    }
    observeElectricityChanged()
}

4.2 电量采样管理(CCElectricitySampleManager)

  • 根据场景配置采样间隔,前台30分钟,后台10分钟
  • 采样时记录电量百分比变化
  • 累计每个场景的总时间
  • 采样数据缓存,定期写入本地 JSON 文件
  • 支持导出采样数据文件路径
less 复制代码
@MainActor @objc public func addSample(scene: EnergySamplingScene,
                             batteryLevel: Float,
                             currentMA: Float,
                             controllerName: String) {
    
    let now = Date().timeIntervalSince1970
    guard shouldSample(scene: scene, now: now) else { return }
    
    let startTime = lastSampleTimes[scene] ?? now
    let startBattery = lastBatteryLevels[scene] ?? batteryLevel
    
    let duration = now - startTime
    totalDuration[scene, default: 0] += duration
    
    let sample = EnergySample(
        scene: scene,
        startTimestamp: startTime,
        endTimestamp: now,
        batteryLevelStart: startBattery,
        batteryLevelEnd: batteryLevel,
        deviceModel: UIDevice.current.modelName,
        controllerName: lastControllerNames[scene] ?? controllerName
    )
    
    samplesCache.append(sample)
    
    lastSampleTimes[scene] = now
    lastBatteryLevels[scene] = batteryLevel
    lastControllerNames[scene] = controllerName
    
    if now - lastSaveTime > saveInterval {
        saveToFile()
        lastSaveTime = now
    }
}

5. 使用示例

php 复制代码
// 监听实时电量变化
CCElectrictyMonitor.shared.addElectricityLevelListener { level in
    print("当前电量:(level)%")
}
​
// 在合适时机调用采样(例如根据场景切换)
CCElectricitySampleManager.shared.addSample(scene: .foreground,
                                            batteryLevel: UIDevice.current.batteryLevel,
                                            currentMA: 0.0,
                                            controllerName: "HomeViewController")
​
// 查询累计时间
let fgDuration = CCElectricitySampleManager.shared.totalDuration(for: .foreground)
print("前台累计时间:(fgDuration)秒")

6. 总结

本方案结合实时电量监听与周期采样统计两部分:

  • 实时监听确保能够快速响应电量变化事件
  • 周期采样统计支持长期耗电分析,区分前后台场景
  • 数据持久化方便后续数据上传和分析
  • 设计兼顾 Swift 与 Objective-C 混合项目的调用需求

通过该方案,可以科学监控和分析 APP 的电量消耗表现,辅助优化节能策略。

相关推荐
JMchen1231 小时前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c
Flynt13 小时前
Java4Shell 实测:EPYC 一跑就中招,关掉 Base64 硬件加速,1KB 解码慢 14 倍
java·安全·性能优化
利威尔xu16 小时前
PostgreSQL 索引失效 4 类:函数运算让查询全表扫描拖垮性能
开发语言·数据库·postgresql·性能优化·索引优化
爱写Bug的浮游2 天前
C++移动构造真的比拷贝快吗
c++·性能优化
Flynn Liang2 天前
Java 虚拟线程别乱用:I/O 密集型服务的线程模型与并发度计算
java·spring boot·性能优化·高并发·线程池·虚拟线程
Flynn Liang2 天前
I/O 密集型高并发实战:Java 服务 10 维优化,从线程打满到 10 万 QPS
java·spring boot·性能优化·高并发·系统设计·虚拟线程·io密集型
隔窗听雨眠3 天前
Spring Boot启动提速的机制剖析与调优路径
性能优化·springboot·后端开发
码间留白3 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
Flynt3 天前
掘金热文说 Spring Boot 4.1 默认开虚拟线程,我实测后发现了更狠的坑
java·spring boot·性能优化
JMchen1233 天前
【Android 性能优化实战 60 讲】10 Jetpack App Startup 内核魔改:手写异步懒加载启动框架,根治串行初始化耗时
android·性能优化·源码分析·启动优化·kotlin协程·app startup