及时做APP开发实战(七)-专注时长实时累加实现

📅 2026/7/17 21:01:55
及时做APP开发实战(七)-专注时长实时累加实现
及时做APP开发实战(七)-专注时长实时累加实现本文将详细介绍番茄钟专注时长的实时累加实现让用户能够实时看到专注成果的积累。一、问题背景1.1 问题现象在番茄钟应用中用户希望实时看到专注时长的累加而不是等到番茄钟完成才更新。原实现存在以下问题┌─────────────────────────────────────┐ │ 问题现象示意 │ ├─────────────────────────────────────┤ │ 专注10分钟 → 显示0分钟未完成 │ │ 提前结束 → 专注时长丢失 │ │ 用户无法实时看到专注成果 │ └─────────────────────────────────────┘1.2 问题分析原代码只在番茄钟完成时一次性累加// 问题代码只在完成时累加timerIdsetInterval((){if(this.timeLeft0){this.timeLeft--;// 只减少剩余时间}else{this.onTimerComplete();}},1000);// 完成时一次性累加onTimerComplete(){this.totalFocusMinutesthis.customDuration;}问题根源专注时长totalFocusMinutes只在完成时更新无法实时反映用户的专注进度提前结束时专注时长丢失二、解决方案2.1 核心思路┌─────────────────────────────────────┐ │ 解决思路 │ ├─────────────────────────────────────┤ │ 1. 新增变量记录当前番茄钟秒数进度 │ │ 2. 每秒累加满60秒更新一次专注时长 │ │ 3. 完成时处理不足60秒的部分 │ │ 4. 区分专注时间和休息时间 │ └─────────────────────────────────────┘2.2 变量设计┌─────────────────────────────────────┐ │ 双变量设计 │ ├─────────────────────────────────────┤ │ totalFocusMinutes 总专注时长 │ │ State用于UI显示 │ │ │ │ currentFocusSeconds 当前秒数进度 │ │ private用于累加计算 │ └─────────────────────────────────────┘2.3 代码实现EntryComponentstruct PomodoroTimer{StatetotalFocusMinutes:number0;// 总专注时长分钟privatecurrentFocusSeconds:number0;// 当前番茄钟已专注秒数StateisBreak:booleanfalse;// 是否休息时间StatetimeLeft:number25*60;StateisRunning:booleanfalse;privatetimerId:number-1;// 开始计时startTimer(){if(this.isRunning)return;this.isRunningtrue;this.timerIdsetInterval((){if(this.timeLeft0){this.timeLeft--;// 实时累加专注时长仅在专注时间非休息时间if(!this.isBreak){this.currentFocusSeconds;// 每满60秒增加1分钟专注时长if(this.currentFocusSeconds60){this.totalFocusMinutes;this.currentFocusSeconds0;}}}else{this.onTimerComplete();}},1000);}// 计时完成onTimerComplete(){clearInterval(this.timerId);this.isRunningfalse;// 处理最后不足60秒的专注时间if(this.currentFocusSeconds0){// 四舍五入超过30秒算1分钟if(this.currentFocusSeconds30){this.totalFocusMinutes;}this.currentFocusSeconds0;}}// 重置计时器resetTimer(){clearInterval(this.timerId);this.isRunningfalse;this.currentFocusSeconds0;// 重置专注秒数this.timeLeft25*60;}}更改后结果图倒计时减少一分钟专注计时增加一分钟三、关键设计点3.1 休息时间判断if(!this.isBreak){// 仅在专注时间累加休息时间不累加this.currentFocusSeconds;}这样可以确保专注时间累加专注时长休息时间不累加专注时长3.2 不足1分钟的处理采用四舍五入策略┌─────────────────────────────────────┐ │ 四舍五入策略 │ ├─────────────────────────────────────┤ │ 专注45秒 → 超过30秒 → 算作1分钟 │ │ 专注20秒 → 不足30秒 → 忽略 │ └─────────────────────────────────────┘if(this.currentFocusSeconds30){this.totalFocusMinutes;}3.3 完整UI示例EntryComponentstruct FocusTimerPage{StatetimeLeft:number25*60;StatetotalFocusMinutes:number0;StateisRunning:booleanfalse;StateisBreak:booleanfalse;privatecurrentFocusSeconds:number0;privatetimerId:number-1;build(){Column(){// 显示总专注时长Row(){Text(今日专注).fontSize(14).fontColor(#666666)Text(${this.totalFocusMinutes}分钟).fontSize(24).fontWeight(FontWeight.Bold).fontColor(#FF6B6B)}.margin({bottom:20})// 进度条Progress({value:this.getProgress(),total:100,type:ProgressType.Ring}).width(200).height(200).color(this.isBreak?#4CAF50:#FF6B6B)// 时间显示Text(this.formatTime(this.timeLeft)).fontSize(48).fontWeight(FontWeight.Bold).margin({top:20})// 当前进度调试用Text(当前进度${this.currentFocusSeconds}秒).fontSize(14).fontColor(#999999).margin({top:10})// 控制按钮Row(){Button(this.isRunning?暂停:开始).backgroundColor(#FF6B6B).fontColor(Color.White).onClick(()this.toggleTimer())Button(重置).backgroundColor(#E0E0E0).fontColor(#333333).onClick(()this.resetTimer()).margin({left:20})}.margin({top:30})}.width(100%).height(100%).justifyContent(FlexAlign.Center)}getProgress():number{consttotalTime25*60;return((totalTime-this.timeLeft)/totalTime)*100;}formatTime(seconds:number):string{constminsMath.floor(seconds/60);constsecsseconds%60;return${mins.toString().padStart(2,0)}:${secs.toString().padStart(2,0)};}toggleTimer(){if(this.isRunning){clearInterval(this.timerId);this.isRunningfalse;}else{this.startTimer();}}startTimer(){this.isRunningtrue;this.timerIdsetInterval((){if(this.timeLeft0){this.timeLeft--;if(!this.isBreak){this.currentFocusSeconds;if(this.currentFocusSeconds60){this.totalFocusMinutes;this.currentFocusSeconds0;}}}else{this.complete();}},1000);}complete(){clearInterval(this.timerId);this.isRunningfalse;if(this.currentFocusSeconds30){this.totalFocusMinutes;}this.currentFocusSeconds0;}resetTimer(){clearInterval(this.timerId);this.isRunningfalse;this.currentFocusSeconds0;this.timeLeft25*60;}}四、效果对比4.1 功能验证场景修改前修改后专注10分钟显示0分钟显示10分钟 ✅专注25分钟完成显示25分钟显示25分钟 ✅提前结束显示0分钟显示实际时长 ✅休息时间也会累加不累加 ✅4.2 数据流示意┌─────────────────────────────────────┐ │ 实时累加流程 │ ├─────────────────────────────────────┤ │ 每秒触发 → currentFocusSeconds │ │ ↓ │ │ 满60秒? → totalFocusMinutes │ │ → currentFocusSeconds 0 │ │ ↓ │ │ 完成/重置 → 处理剩余秒数 │ └─────────────────────────────────────┘五、最佳实践5.1 变量设计原则// ✅ 正确分离显示变量和计算变量StatetotalFocusMinutes:number0;// 显示用privatecurrentFocusSeconds:number0;// 计算用// ❌ 错误只用一个变量无法精确控制StatefocusSeconds:number0;5.2 边界条件处理// ✅ 正确处理不足单位时间的情况if(this.currentFocusSeconds30){this.totalFocusMinutes;}// ❌ 错误忽略剩余时间// 直接清零丢失最后几十秒的专注成果5.3 状态区分// ✅ 正确区分专注和休息if(!this.isBreak){this.currentFocusSeconds;}// ❌ 错误不区分状态this.currentFocusSeconds;// 休息时间也会累加六、总结本文实现了专注时长的实时累加功能核心是采用双变量设计totalFocusMinutes用于UI显示的总时长currentFocusSeconds用于累加计算的秒数进度同时需要注意处理边界条件不足1分钟的部分和区分不同状态专注/休息这样才能为用户提供准确的实时反馈。