及时做APP开发实战(九)-系统级震动反馈实现

及时做APP开发实战(九)-系统级震动反馈实现本文将详细介绍如何在HarmonyOS NEXT中实现番茄钟的系统级震动反馈提升用户体验。一、需求背景1.1 功能需求番茄钟应用需要在关键时刻提供震动反馈提醒用户状态变化┌─────────────────────────────────────┐ │ 震动反馈场景 │ ├─────────────────────────────────────┤ │ 番茄钟完成 → 长震动 模式震动 │ │ 休息开始 → 短震动提示 │ │ 休息结束 → 双击震动提醒 │ └─────────────────────────────────────┘1.2 技术选型HarmonyOS提供ohos.vibrator模块实现震动功能接口说明startVibration触发震动stopVibration停止震动VibratorStopMode停止模式枚举二、权限配置2.1 添加震动权限在module.json5中添加权限声明{ module: { requestPermissions: [ { name: ohos.permission.VIBRATE, reason: $string:vibrate_reason, usedScene: { abilities: [EntryAbility], when: inuse } } ] } }2.2 添加权限说明在string.json中添加权限说明{string:[{name:vibrate_reason,value:用于番茄钟计时结束时提供震动反馈提醒}]}三、FeedbackUtil工具类实现3.1 类结构设计┌─────────────────────────────────────┐ │ FeedbackUtil │ ├─────────────────────────────────────┤ │ - instance: FeedbackUtil │ ├─────────────────────────────────────┤ │ getInstance(): FeedbackUtil │ │ vibrate(duration): void │ │ vibratePattern(pattern): void │ │ stopVibrate(): void │ │ pomodoroComplete(): void │ │ breakStart(): void │ │ breakEnd(): void │ └─────────────────────────────────────┘3.2 完整实现代码importvibratorfromohos.vibrator;import{BusinessError}fromohos.base;exportclassFeedbackUtil{privatestaticinstance:FeedbackUtil|nullnull;// 私有构造函数privateconstructor(){}// 获取单例publicstaticgetInstance():FeedbackUtil{if(!FeedbackUtil.instance){FeedbackUtil.instancenewFeedbackUtil();}returnFeedbackUtil.instance;}/** * 触发震动反馈 * param duration 震动持续时间毫秒默认200ms */publicvibrate(duration:number200):void{try{vibrator.startVibration({type:time,duration:duration},{id:0,usage:alarm},(error:BusinessError){if(error){console.error([FeedbackUtil] 震动失败:${error.message});}else{console.info([FeedbackUtil] 震动反馈成功);}});}catch(err){conste:BusinessErrorerrasBusinessError;console.error([FeedbackUtil] 震动异常:${e.message});}}/** * 触发模式震动 * param pattern 震动模式 [静止, 震动, 静止, 震动, ...] */publicvibratePattern(pattern:number[]):void{try{vibrator.startVibration({type:preset,effectId:haptic.clock.timer,count:1},{id:0,usage:alarm},(error:BusinessError){if(error){console.error([FeedbackUtil] 模式震动失败:${error.message});}});}catch(err){conste:BusinessErrorerrasBusinessError;console.error([FeedbackUtil] 模式震动异常:${e.message});}}/** * 停止震动 */publicstopVibrate():void{try{vibrator.stopVibration(vibrator.VibratorStopMode.VIBRATOR_STOP_MODE_TIME,(error:BusinessError){if(error){console.error([FeedbackUtil] 停止震动失败:${error.message});}});}catch(err){conste:BusinessErrorerrasBusinessError;console.error([FeedbackUtil] 停止震动异常:${e.message});}}/** * 番茄钟完成反馈 * 长震动 特效震动 */publicpomodoroComplete():void{this.vibrate(500);setTimeout((){this.vibratePattern([100,100,100,100]);},600);}/** * 休息开始反馈 */publicbreakStart():void{this.vibrate(150);}/** * 休息结束反馈 */publicbreakEnd():void{this.vibrate(100);setTimeout((){this.vibrate(100);},200);}}四、业务场景集成4.1 在PomodoroPage中使用import{FeedbackUtil}from../utils/FeedbackUtil;EntryComponentstruct PomodoroPage{// 工具类实例privatefeedbackUtil:FeedbackUtilFeedbackUtil.getInstance();// 计时完成asynconTimerComplete(){this.stopTimer();this.isRunningfalse;if(this.isBreak){// 休息结束this.isBreakfalse;this.timeLeftthis.customDuration*60;this.feedbackUtil.breakEnd();// 双击震动}else{// 番茄钟完成this.pomodoroCount;// ... 保存记录逻辑this.feedbackUtil.pomodoroComplete();// 长震动模式震动// 进入休息this.timeLeftConstants.SHORT_BREAK_DURATION*60;this.isBreaktrue;this.feedbackUtil.breakStart();// 短震动}}}4.2 震动时机说明【图1震动反馈时机】┌─────────────────────────────────────┐ │ 番茄钟生命周期 │ ├─────────────────────────────────────┤ │ [开始专注] │ │ ↓ │ │ [专注中...] │ │ ↓ │ │ [专注完成] → pomodoroComplete() │ │ ↓ (500ms 模式震动) │ │ [进入休息] → breakStart() │ │ ↓ (150ms震动) │ │ [休息中...] │ │ ↓ │ │ [休息结束] → breakEnd() │ │ (双击震动) │ └─────────────────────────────────────┘五、API详解5.1 startVibration参数vibrator.startVibration(effect:VibrateEffect,// 震动效果attribute:VibrateAttribute,// 震动属性callback:AsyncCallbackvoid// 回调)VibrateEffect类型类型说明示例time时长震动{ type: time, duration: 200 }preset预设效果{ type: preset, effectId: haptic.clock.timer }file文件震动{ type: file, hapticScene: xxx }VibrateAttribute属性{id:0,// 震动马达IDusage:alarm// 使用场景alarm/notification/communication等}5.2 stopVibration参数vibrator.stopVibration(stopMode:VibratorStopMode,// 停止模式callback:AsyncCallbackvoid)VibratorStopMode枚举模式说明VIBRATOR_STOP_MODE_TIME停止时长震动VIBRATOR_STOP_MODE_PRESET停止预设震动VIBRATOR_STOP_MODE_FILE停止文件震动六、最佳实践6.1 单例模式// ✅ 推荐使用单例避免重复创建privatefeedbackUtil:FeedbackUtilFeedbackUtil.getInstance();// ❌ 不推荐每次都创建新实例letfeedbackUtilnewFeedbackUtil();// 构造函数私有无法直接创建6.2 异常处理// ✅ 推荐捕获所有可能的异常try{vibrator.startVibration(effect,attribute,callback);}catch(err){conste:BusinessErrorerrasBusinessError;console.error(震动异常:${e.message});}// ❌ 不推荐不处理异常vibrator.startVibration(effect,attribute,callback);6.3 权限检查// 在使用前检查权限importabilityAccessCtrlfromohos.abilityAccessCtrl;asynccheckVibratePermission():Promiseboolean{constatManagerabilityAccessCtrl.createAtManager();constgrantStatusawaitatManager.verifyAccessToken(this.context.applicationInfo.accessTokenId,ohos.permission.VIBRATE);returngrantStatusabilityAccessCtrl.GrantStatus.PERMISSION_GRANTED;}七、效果测试7.1 测试环境说明⚠️重要提示模拟器不支持震动功能需要在真机上测试震动效果。【图2测试环境对比】环境震动支持测试建议模拟器❌ 不支持用于UI和逻辑测试真机✅ 支持用于震动效果测试7.2 测试场景【图3震动效果时序图】时间轴番茄钟完成 → 休息开始 → 休息结束 │ ├─ [0ms] 触发 pomodoroComplete() │ └─ 500ms长震动 ▓▓▓▓▓ │ ├─ [600ms] 触发模式震动 │ └─ haptic.clock.timer 特效 │ ├─ [800ms] 触发 breakStart() │ └─ 150ms短震动 ▓▓ │ └─ [休息结束] 触发 breakEnd() └─ 双击震动 ▓ ▓ (100ms × 2)7.3 真机测试步骤连接真机用USB连接手机到DevEco Studio运行应用点击运行按钮选择真机设备测试震动启动番茄钟等待倒计时结束可设置短时间测试手机会震动反馈7.4 用户体验优化┌─────────────────────────────────────┐ │ 震动强度建议 │ ├─────────────────────────────────────┤ │ 重要提醒完成→ 强震动 │ │ 状态切换休息→ 中等震动 │ │ 轻量提示 → 轻震动 │ └─────────────────────────────────────┘7.5 效果截图【图4番茄钟完成界面】倒计时结束显示完成状态【图5进入休息界面】自动切换到休息模式八、总结本文实现了番茄钟的系统级震动反馈功能权限配置在module.json5中声明VIBRATE权限工具类封装FeedbackUtil单例类统一管理震动逻辑场景集成在关键时刻调用对应的震动方法异常处理捕获所有可能的错误保证稳定性震动反馈是提升用户体验的重要手段合理使用可以让应用更加人性化。