HarmonyOS ArkTS 实战:2048 小游戏的棋盘建模与手势交互

举报
yd_272402707 发表于 2026/11/12 00:26:37 2026/11/12
【摘要】 从鸿蒙开发实践中心的 2048 案例出发,记录 ArkTS 端侧小游戏的棋盘建模、四方向合并算法收敛、PanGesture 方向判定与去抖、ForEach key 选择、preferences 持久化与纯函数化测试等六个实践要点。

写在前面

最近在华为云鸿蒙开发实践中心读了一个很典型的端侧案例:用 ArkTS 写一个 2048 滑块合并小游戏。案例体量不大,但把「状态建模 + 手势识别 + 本地持久化」这条端侧开发主线串得很完整。这篇笔记记录我读下来最有价值的几个设计点,以及自己动手复刻时容易踩的坑。

一、棋盘用什么数据结构

4×4 的棋盘最直观的表示是二维数组:

type Board = number[][];

也可以内部用一维数组加行宽换算,读写更省一点。但 2048 的核心操作是「按行滑动」,二维数组配合行列转置更直观,调试打印也更好读。建议内部用二维数组,对外暴露纯函数接口,渲染层再拍平成列表。

二、四方向合并:把问题收敛成一个方向

2048 看似有四个方向,其实只要实现「向左滑动」,其余三个方向都能通过翻转或转置复用。第一步去掉这一行里的 0,得到非零序列;第二步从左到右扫描,相邻且相等就合并,合并后跳过一格;第三步末尾补 0,把长度补回 4;最后按方向做逆变换写回棋盘。

第二步的「合并后跳过一格」是重点,它保证一次滑动中同一个新方块不会被连续吞并两次。例如 [2,2,4,0] 向左滑必须得到 [4,4,0,0],而不是 [8,0,0,0]。

还要处理「无效移动」:滑动前后棋盘完全一致时,不应该生成新方块,也不应该记分,否则玩家会看到凭空多出来的块。

三、手势识别:方向判定与去抖

用 PanGesture 做输入很顺手,但有几个细节。一是用位移主轴判断方向,比较 abs(dx) 与 abs(dy),不要用起始角度;二是设一个最小位移阈值,例如 30 到 80 像素,避免轻触被误判;三是一次手势结束只触发一次移动,手势过程中的过渡事件要忽略。

不做去抖时,快速滑动经常会在一次操作里连续移动两次,体验会明显变差。

四、渲染与动画

用 ForEach 渲染方块时,key 必须用方块自身的唯一 id,而不是数组下标。2048 移动后位置会整体变化,用下标做 key 会导致节点复用错位,出现「数字闪一下再跳走」的现象。

动画用 animateTo 包裹状态更新即可,位移与数值变化的时长可以略有差异,视觉上会更自然。

五、持久化:断线也能接着玩

端侧游戏很适合用 @ohos.data.preferences 保存状态:棋盘、当前分数、历史最高分三份数据就够了。写入建议做防抖,例如移动结束 300 毫秒后再落盘,避免每步都触发一次 IO。

另一个容易忽略的点是读档校验:读取存档时要检查棋盘结构与长度,防止旧版本数据把游戏直接卡死。

六、可测试性

把 move(board, direction) 写成纯函数,不依赖 UI 与全局状态,单测就很好写。边界用例至少覆盖满盘、全部相同、只剩一个空格、滑动后无变化。函数在无变化时返回 null,调用方据此决定是否生成新方块,逻辑会清晰很多。

小结

这个案例最值得学的不是玩法,而是它把棋盘状态、合并规则、手势输入、本地存储四层拆得很干净。端侧小游戏看起来简单,真正决定代码质量的往往是这类状态边界的设计。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。