尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
HarmonyOS应用开发实战:猫猫大作战-animateTo 显式触发机制、与隐式 animation 的差异、AnimateParam 动画参数、
前言前面我们用.animation({ duration: 100 })第 16、33 篇做了猫咪下落的平滑过渡——那是隐式动画改position自动补间。但有种场景隐式动画做不了——点击按钮时显式触发一段动画得分加 10 时数字弹跳、合并时新猫放大出现、连击时火焰特效闪烁。这种「主动触发」要animateTo显式动画 API——在闭包里改 stateArkUI 自动补间。本篇以「猫猫大作战」得分弹跳、合并放大为预演场景把animateTo 显式触发机制、与隐式 animation 的差异、AnimateParam 动画参数、cancel 终止动画四大要点讲透。提示本系列不讲 ArkTS 基础语法与环境搭建假设你已跟完第 1–54 篇。本篇是阶段三第五篇。一、场景拆解得分弹跳与合并放大「猫猫大作战」得分更新第 31、33 篇this.score this.gameEngine.getScore(); // 改 StateHUD 刷新当前只是数字瞬间变——玩家想得分弹跳反馈数字放大 1.5 倍 → 0.9 倍 → 1 倍300ms 完成。合并新猫出现第 121、125 篇会专讲合并当前是直接渲染新猫——玩家想新猫放大出现从 0 倍缩放 → 1 倍200ms 完成。State.animation隐式动画只能补间「属性变化」做不了「点击时主动触发一段动」。要animateTo// 预演得分弹跳 State scoreScale: number 1; // 得分缩放 handleScoreChange() { animateTo({ duration: 300, curve: Curve.EaseOut }, () { this.scoreScale 1.5; // 放大 }); setTimeout(() { animateTo({ duration: 200, curve: Curve.EaseIn }, () { this.scoreScale 1; // 回 1 }); }, 300); } // HUD Text(this.score.toString()) .scale({ x: this.scoreScale, y: this.scoreScale }) // 读缩放核心问题animateTo怎么显式触发动画和隐式.animation有什么不同AnimateParam的duration/curve/iterations等参数怎么用多段动画放大→回 1怎么串联动画中途要终止怎么办二、animateTo 显式触发机制2.1 基本用法animateTo({ duration: 300, curve: Curve.EaseOut }, () { // 闭包内改 StateArkUI 自动补间到新值 this.scoreScale 1.5; });拆解片段含义animateTo(param, callback)显式动画 API{ duration: 300, curve: Curve.EaseOut }AnimateParam 动画参数() { this.scoreScale 1.5; }闭包内改 state 触发补间机制animateTo调时记录当前scoreScale的值如 1。执行闭包this.scoreScale 1.5改 state。ArkUI 检测到scoreScale变化用 300ms EaseOut 缓动从 1 补间到 1.5。依赖scoreScale的Text.scale平滑过渡。关键经验animateTo 是「显式触发补间」——在闭包里改 stateArkUI 用指定参数补间不调 animateTo 直接改 state 是瞬间变。2.2 与隐式 .animation 的差异// 隐式.animation 装饰改 state 自动补间 Text(this.score.toString()) .scale({ x: this.scoreScale, y: this.scoreScale }) .animation({ duration: 300, curve: Curve.EaseOut }) // ← 隐式 // 之后 this.scoreScale 1.5 自动补间 // 显式animateTo 包改 state主动触发 animateTo({ duration: 300, curve: Curve.EaseOut }, () { this.scoreScale 1.5; }); // 主动调才触发不调不改2.3 对比表维度隐式.animation显式animateTo触发改 state 自动补间主动调 animateTo参数固定在.animation({...})每次调可传不同参数多段动画❌ 难参数固定✅ 串联多次调终止❌ 难✅ cancel API适合「属性变化」补间「主动触发」特效关键经验「属性自然变化」用隐式 animation「主动触发特效」用显式 animateTo——猫咪下落用隐式position 自然变得分弹跳用显式点击主动触发。三、AnimateParam 动画参数3.1 完整参数interface AnimateParam { duration: number; // 动画时长毫秒 curve?: Curve | ICurve; // 缓动曲线 delay?: number; // 延迟开始毫秒 iterations?: number; // 重复次数-1 无限 playMode?: PlayMode; // 播放模式Normal/Reverse/Alternate 等 onFinish?: () void; // 完成回调 onClose?: () void; // 关闭回调 }3.2 duration 时长animateTo({ duration: 300 }, () { this.scoreScale 1.5; }); // 300ms 完成放大时长视觉适合100ms极短瞬微反馈300ms短顺按钮反馈本项目500ms中页面转场1000ms长慢强调动画3.3 curve 缓动曲线enum Curve { Linear, // 匀速 Ease, // 先慢后快再慢 EaseIn, // 先慢后快 EaseOut, // 先快后慢 EaseInOut, // 两端慢中间快 FastOut, // 快出 SlowOut, // 慢出 ExtremeEase, // 极端缓动 Sharp, // 锐利 Rhythm, // 节奏 Smooth, // 平滑 Deceleration, // 减速 // 等更多 }常用对照Curve效果适合Linear匀速机械移动EaseOut先快后慢放大出现本项目EaseIn先慢后快缩小消失EaseInOut两端慢中间快位置移动Spring弹性弹跳反馈关键经验放大用 EaseOut先快后慢有冲击感缩小用 EaseIn移动用 EaseInOut弹跳用 Spring。3.4 iterations 重复 playMode 模式// 重复 3 次 animateTo({ duration: 300, iterations: 3 }, () { this.flash !this.flash; }); // 无限重复 animateTo({ duration: 500, iterations: -1 }, () { this.flash !this.flash; }); // 正反交替闪烁 animateTo({ duration: 300, iterations: 5, playMode: PlayMode.Alternate }, () { this.flash !this.flash; });3.5 onFinish 完成回调animateTo({ duration: 300, curve: Curve.EaseOut, onFinish: () { console.info(放大完成开始缩小); animateTo({ duration: 200, curve: Curve.EaseIn }, () { this.scoreScale 1; }); } }, () { this.scoreScale 1.5; }); // 放大 300ms → onFinish → 缩小 200ms关键经验onFinish 串联多段动画——比 setTimeout 更准动画可能因性能提前/延后。四、多段动画串联4.1 得分弹跳放大 → 回 1State scoreScale: number 1; handleScoreChange() { // 第一段放大 animateTo({ duration: 300, curve: Curve.EaseOut, onFinish: () { // 第二段回 1 animateTo({ duration: 200, curve: Curve.EaseIn }, () { this.scoreScale 1; }); } }, () { this.scoreScale 1.5; }); } // HUD Text(this.score.toString()) .scale({ x: this.scoreScale, y: this.scoreScale }) // 读缩放流程得分变化触发handleScoreChange。第一段animateTo改scoreScale 1.5300ms EaseOut 放大。onFinish触发第二段animateTo改scoreScale 1200ms EaseIn 回 1。4.2 合并新猫放大出现State newCatScale: number 0; // 新猫缩放0 隐藏1 正常 handleMerge(newCat: Cat) { // 新猫从 0 放大到 1 animateTo({ duration: 200, curve: Curve.EaseOut }, () { this.newCatScale 1; }); } // 新猫渲染 ForEach(this.cats, (cat: Cat) { Column() { /* ... */ } .scale({ x: cat.id this.newCatId ? this.newCatScale : 1, y: cat.id this.newCatId ? this.newCatScale : 1 }) }, (cat: Cat) cat.id)4.3 三段动画预警 → 攻击 → 复位handleAttack() { // 第一段预警缩小蓄力 animateTo({ duration: 200, curve: Curve.EaseIn, onFinish: () { // 第二段攻击放大冲出 animateTo({ duration: 150, curve: Curve.EaseOut, onFinish: () { // 第三段复位 animateTo({ duration: 300, curve: Curve.EaseInOut }, () { this.scale 1; }); } }, () { this.scale 1.3; }); } }, () { this.scale 0.8; }); }关键经验多段动画用 onFinish 串联——每段完成后启动下一段时序精准。五、cancel 终止动画5.1 为什么要终止游戏结束时要立刻停所有动画——得分弹跳到一半要复位合并放大到一半要停。animateTo返回一个动画 id用cancelAnimation终止。5.2 用法private scoreAnimId: number -1; handleScoreChange() { this.scoreAnimId animateTo({ duration: 300, curve: Curve.EaseOut }, () { this.scoreScale 1.5; }); } // 终止动画 cancelAnimation(this.scoreAnimId); this.scoreScale 1; // 立即复位关键经验cancelAnimation 立即终止指定动画——传入 animateTo 返回的 idstate 立即停在当前值或手动复位。5.3 结束游戏时停所有动画endGame() { this.gameState GameState.GAME_OVER; // 停所有动画 if (this.scoreAnimId ! -1) { cancelAnimation(this.scoreAnimId); this.scoreAnimId -1; } if (this.mergeAnimId ! -1) { cancelAnimation(this.mergeAnimId); this.mergeAnimId -1; } // 复位 this.scoreScale 1; this.newCatScale 1; /* ... 其他结束逻辑 ... */ this.clearTimers(); }实战经验结束游戏要停所有动画 复位——不停动画会继续跑onFinish 还会触发改 state状态错乱。六、完整预演代码得分弹跳 合并放大// 预演Index 加 animateTo 显式动画 Entry Component struct Index { State gameState: GameState GameState.IDLE; State score: number 0; State cats: Cat[] []; State combo: ComboInfo { count: 0, multiplier: 1, lastMergeTime: 0 }; State nextCatLevel: CatLevel CatLevel.SMALL; State highScore: number 0; State gameTime: number 0; // animateTo 用动画 state State scoreScale: number 1; // 得分缩放 State newCatScale: number 1; // 新猫缩放 State newCatId: string ; // 新猫 id标记哪只是新合并的 State comboFlash: boolean false; // 连击闪烁 private gameEngine: GameEngine new GameEngine(); private gameLoopTimer: number -1; private spawnTimer: number -1; private timeTimer: number -1; private readonly cols: number[] [0, 1, 2, 3, 4]; // animateTo 用动画 idcancel 用 private scoreAnimId: number -1; private mergeAnimId: number -1; private comboAnimId: number -1; startGame() { this.clearTimers(); this.gameEngine.reset(); this.gameState GameState.PLAYING; this.score 0; this.cats []; this.gameTime 0; this.combo { count: 0, multiplier: 1, lastMergeTime: 0 }; this.nextCatLevel this.gameEngine.getNextCatLevel(); // 复位动画 state this.scoreScale 1; this.newCatScale 1; this.newCatId ; this.comboFlash false; this.gameLoopTimer setInterval(() { if (this.gameState ! GameState.PLAYING) return; const oldScore this.score; this.cats this.gameEngine.updateCats(); this.score this.gameEngine.getScore(); this.combo this.gameEngine.getCombo(); // 得分变化触发弹跳本篇重点 if (this.score ! oldScore) { this.handleScoreChange(); } // 连击 ≥ 3 触发闪烁 if (this.combo.count 3 !this.comboFlash) { this.handleComboFlash(); } if (this.gameEngine.isGameOver()) { this.endGame(); } }, 100); /* spawnTimer、timeTimer 等略 */ } // 得分弹跳本篇重点 handleScoreChange() { if (this.scoreAnimId ! -1) cancelAnimation(this.scoreAnimId); this.scoreAnimId animateTo({ duration: 300, curve: Curve.EaseOut, onFinish: () { this.scoreAnimId -1; animateTo({ duration: 200, curve: Curve.EaseIn }, () { this.scoreScale 1; }); } }, () { this.scoreScale 1.4; }); } // 连击闪烁 handleComboFlash() { this.comboFlash true; this.comboAnimId animateTo({ duration: 500, iterations: 3, playMode: PlayMode.Alternate, onFinish: () { this.comboFlash false; this.comboAnimId -1; } }, () { this.comboFlash !this.comboFlash; // 交替闪烁 }); } // 合并新猫放大出现 handleMerge(newCatId: string) { this.newCatId newCatId; this.newCatScale 0; this.mergeAnimId animateTo({ duration: 200, curve: Curve.EaseOut, onFinish: () { this.mergeAnimId -1; this.newCatId ; // 清标记 } }, () { this.newCatScale 1; }); } endGame() { this.gameState GameState.GAME_OVER; // 停所有动画本篇重点 if (this.scoreAnimId ! -1) { cancelAnimation(this.scoreAnimId); this.scoreAnimId -1; } if (this.mergeAnimId ! -1) { cancelAnimation(this.mergeAnimId); this.mergeAnimId -1; } if (this.comboAnimId ! -1) { cancelAnimation(this.comboAnimId); this.comboAnimId -1; } // 复位 this.scoreScale 1; this.newCatScale 1; this.comboFlash false; /* ... 其他结束逻辑 ... */ this.clearTimers(); } /* pauseGame / resumeGame / clearTimers / formatTime / aboutToDisappear 等略 */ Builder GameHUD() { Row() { Column() { Text(得分).fontSize(11).fontColor(#95A5A6) // 得分 Text读 scoreScale 缩放本篇重点 Text(this.score.toString()) .fontSize(22).fontWeight(FontWeight.Bold).fontColor(#2C3E50) .scale({ x: this.scoreScale, y: this.scoreScale }) // ← 读缩放 }.alignItems(HorizontalAlign.Start) Spacer() // 连击栏闪烁时变色 if (this.combo.count 1) { Row() { Text( x${this.combo.multiplier}) .fontSize(18).fontWeight(FontWeight.Bold) .fontColor(this.comboFlash ? #FF6B6B : #E74C3C) // ← 闪烁变色 } .padding({ left: 12, right: 12, top: 4, bottom: 4 }) .backgroundColor(this.comboFlash ? rgba(255, 107, 107, 0.3) : rgba(231, 76, 60, 0.1)) .borderRadius(16) .scale({ x: this.comboFlash ? 1.1 : 1, y: this.comboFlash ? 1.1 : 1 }) } Spacer() Column() { Text(时间).fontSize(11).fontColor(#95A5A6) Text(this.formatTime(this.gameTime)) .fontSize(18).fontWeight(FontWeight.Medium).fontColor(#2C3E50) }.alignItems(HorizontalAlign.End) } .width(100%).padding({ left: 20, right: 20, top: 12, bottom: 8 }) } Builder GameView() { Column() { this.GameHUD() Column() { Row() { /* 预告区 */ } Stack() { /* 棋盘背景 */ ForEach(this.cats, (cat: Cat) { Column() { /* ... emoji ... */ } .width(/* ... */).height(/* ... */) // 新合并的猫读 newCatScale 放大出现 .scale({ x: cat.id this.newCatId ? this.newCatScale : 1, y: cat.id this.newCatId ? this.newCatScale : 1 }) .position({ x: /* ... */, y: /* ... */ }) .animation({ duration: 100, curve: Curve.Linear }) // 隐式位置补间 }, (cat: Cat) cat.id) Row() { ForEach(this.cols, (col: number) { Column() .width(GameConfig.CELL_SIZE) .height(GameConfig.BOARD_HEIGHT * GameConfig.CELL_SIZE) .backgroundColor(rgba(0,0,0,0)) .onClick(() { this.handleColumnClick(col); }) }, (col: number) click_${col}) } } .width(GameConfig.BOARD_WIDTH * GameConfig.CELL_SIZE) .height(GameConfig.BOARD_HEIGHT * GameConfig.CELL_SIZE) .borderRadius(12).clip(true).backgroundColor(#D6EEF5) }.alignItems(HorizontalAlign.Center) Spacer() Row() { /* 底部控制栏 */ } .width(100%).padding({ left: 24, right: 24, bottom: 24, top: 12 }) } .width(100%).height(100%) .linearGradient({ direction: GradientDirection.Bottom, colors: [[#E8F4F8, 0.0], [#D6EEF5, 0.5], [#C9E8F2, 1.0]] }) .alignItems(HorizontalAlign.Center) } /* MainMenuView / PauseOverlay / GameOverOverlay / StatItem 等略 */ }七、踩坑提示7.1 animateTo 闭包不改 state// ❌ 错误闭包里没改 state无补间 animateTo({ duration: 300 }, () { console.info(没改 state); // 没动效 }); // ✅ 正确闭包内改 state animateTo({ duration: 300 }, () { this.scoreScale 1.5; // 改 state 触发补间 });7.2 用普通函数丢 this// ❌ 错误普通函数 this 不指向组件 animateTo({ duration: 300 }, function () { this.scoreScale 1.5; }); // ✅ 正确箭头函数保留 this第 38 篇讲过 animateTo({ duration: 300 }, () { this.scoreScale 1.5; });7.3 忘 cancel 导致动画继续跑// ❌ 错误结束游戏没 cancel动画 onFinish 还触发改 state endGame() { this.gameState GameState.GAME_OVER; // 忘了 cancelAnimation(this.scoreAnimId); // scoreScale 还在补间onFinish 还会触发 } // ✅ 正确结束 cancel 所有 复位 endGame() { if (this.scoreAnimId ! -1) { cancelAnimation(this.scoreAnimId); this.scoreAnimId -1; } this.scoreScale 1; /* ... */ }7.4 多段动画用 setTimeout 而非 onFinish// ⚠️ 可以但不准setTimeout 时序可能因性能漂移 animateTo({ duration: 300 }, () { this.scoreScale 1.5; }); setTimeout(() { animateTo({ duration: 200 }, () { this.scoreScale 1; }); }, 300); // setTimeout 300ms 不一定等于动画结束 // ✅ 推荐onFinish 精准 animateTo({ duration: 300, onFinish: () { animateTo({ duration: 200 }, () { this.scoreScale 1; }); } }, () { this.scoreScale 1.5; });7.5 忘复位 cancel 后的 state// ❌ 错误cancel 了但没复位state 停在中间值 cancelAnimation(this.scoreAnimId); // scoreScale 可能停在 1.3HUD 显示歪了 // ✅ 正确cancel 后手动复位 cancelAnimation(this.scoreAnimId); this.scoreScale 1; // 立即复位八、调试技巧console.info在 onFinish追动画完成时机验证串联。console.info在 animateTo 闭包后追 state 改的目标值。动画不触发排查检查闭包内是否改 state检查依赖 state 的属性是否绑定如 scale。动画结束后 state 错排查检查是否 cancel 了但忘复位检查 onFinish 是否在结束后误触发。九、性能与最佳实践「主动触发特效」用 animateTo「属性自然变化」用隐式 .animation——得分弹跳用显式猫下落用隐式。闭包内必改 state——不改无补间animateTo 是「补间到新值」。回调用箭头函数保留 this——普通函数 this 丢失第 38 篇。多段动画用 onFinish 串联——比 setTimeout 精准动画结束立即触发下段。结束 cancel 所有动画 复位——不停动画会继续跑onFinish 误触发。AnimateParam 选 curve——放大 EaseOut缩小 EaseIn移动 EaseInOut弹跳 Spring。iterations playMode 做闪烁——Alternate 交替闪烁-1 无限。十、阶段三进度51–55本篇是阶段三「交互与动画」第 5 篇篇主题核心要点51onTouch手势三阶段 Down/Move/Up52onHover悬停进入/离开53onKeyEvent键盘/遥控按键54bindContextMenu右键/长按上下文菜单55本篇animateTo显式动画触发多段串联cancel 终止接下来阶段三还会覆盖animation 属性动画隐式、Hero 共享元素、transition 转场、spring 物理、Hero Style Player 等。总结本篇我们从 animateTo 显式动画切入掌握了显式触发机制闭包改 state 补间、与隐式 .animation 的差异主动触发 vs 自动补间、AnimateParam 参数duration/curve/iterations/playMode/onFinish、cancel 终止 复位四大要点并给出了得分弹跳 合并放大 连击闪烁的完整代码。核心要点主动触发用 animateTo闭包箭头改 state多段用 onFinish 串联结束 cancel 所有 复位。下一篇我们将拆解 animation 属性动画——隐式补间机制。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源「猫猫大作战」项目源码本仓库entry/src/main/ets/pages/Index.etsArkUI animateTo 显式动画官方指南AnimateParam 动画参数官方文档Curve 缓动曲线官方文档HarmonyOS 动画性能最佳实践开源鸿蒙跨平台社区HarmonyOS 开发者官方文档首页系列索引本仓库articles/INDEX.md
RELATED

相关推荐

HarmonyOS应用开发实战:猫猫大作战-gameState 跨层共享给嵌套子组件为锚点,把 @Provide 声明与 @Consume 取用、跨层

HarmonyOS应用开发实战:猫猫大作战-gameState 跨层共享给嵌套子组件为锚点,把 @Provide 声明与 @Consume 取用、跨层

前言 前面我们用 Prop/Link/Event 处理父子组件数据流——但都是父子相邻两层。如果数据要从祖父传到曾孙,用 Prop 要逐层透传:祖父传父、父传子、子传孙、孙传曾孙——每层都写一遍 Prop 声明和传值,称为「prop drilling」,代码…

📅 2026/9/15 1:25:33
前端工程师收藏必看:大模型时代如何转型AI Agent工程师,抢占下一个风口?

前端工程师收藏必看:大模型时代如何转型AI Agent工程师,抢占下一个风口?

随着大模型技术的成熟,前端开发岗位面临缩减与裁员。本文分析了前端工程师转型AI Agent开发的必要性、可行性及完整路径,对比了技术栈,分析了核心优势,并构建了知识图谱,为焦虑中的前端开发者提供清晰的转型“逃生”与…

📅 2026/9/15 1:26:09
Modbus协议从入门到落地:RTU/TCP双模式原生C#实现,工业数据采集全流程详解

Modbus协议从入门到落地:RTU/TCP双模式原生C#实现,工业数据采集全流程详解

在工业通信领域,Modbus是当之无愧的“通用语言”。从PLC、变频器、仪表到传感器,几乎所有工业设备都原生支持Modbus协议。但很多开发者习惯直接用NModbus、EasyModbus这类第三方库,只知调用方法不知底层原理,一到现场遇到通讯超时…

📅 2026/9/15 1:32:22
MORE NEWS

更多资讯

📰

电工证考证课程千万别踩坑,证书过期了不知道怎么复审延期怎么处理

电工证考证课程千万别踩坑,证书过期了不知道怎么复审延期怎么处理 证书过期了不知道怎么复审延期?千万别踩坑,这是很多电工从业者的真实写照。特别是像安阳公路工程这类需要频繁接触电力设备、线路的岗位,没有有效的电工证,不仅影响工作进度,还可能面临…

📰

低压电工作业证归哪管 郑州报考避坑指南

低压电工作业证归哪管 郑州报考避坑指南 你缺的是特种作业证,而不是工作机会。现在不少工地、工厂、企业都明确规定,没有低压电工作业证,连门都进不去。尤其是郑州这种就业竞争激烈的城市, 低压电工作业证归哪管…

📰

弱电工程师工作业绩阐述怎么写官方回应来了

弱电工程师工作业绩阐述怎么写官方回应来了 之前考的证在外省能不能转过来?这个问题困扰了太多特种作业人员,尤其是像弱电工程师这类跨地区流动频繁的岗位。官方回应来了,根据 郑州市应急管理局…

📰

常熟哪里报考电工证,学历不高怕报不上名?全国通用证书值得考吗

常熟哪里报考电工证,学历不高怕报不上名?全国通用证书值得考吗 你是不是也担心学历不高,考个电工证连报名资格都没?别急,今天咱就聊聊【常熟哪里报考电工证】这个事,告诉你为啥 全国通用 的电工证,现在考还来得及,甚至越早考越吃香。…

📰

苏州培训电工证多少钱?急需上岗的你必须知道的细节

苏州培训电工证多少钱?急需上岗的你必须知道的细节 你是不是正在为找不到工作发愁?是不是听说很多企业都要求必须持有特种作业操作证才能上岗?那你知道【苏州培训电工证】多少钱?到底怎么考?今天就给你讲明白,别再踩坑了。 电工证是就业的“敲门砖”…

📰

电工证办理是不是骗子?上岗必备的电工证到底值不值?

电工证办理是不是骗子?上岗必备的电工证到底值不值? 你是不是也遇到过这种情况,网上搜“电工证办理”,弹出来的全是“代办、包过、最快3天拿证”,但你又怕是骗子?尤其是你这种刚毕业的应届生,想进工地、进厂子、进电力公司,都得有 上岗必备…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬