HarmonyOS ArkTS 实战:2048 小游戏的棋盘建模与手势交互
写在前面
最近在华为云鸿蒙开发实践中心读了一个很典型的端侧案例:用 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,调用方据此决定是否生成新方块,逻辑会清晰很多。
小结
这个案例最值得学的不是玩法,而是它把棋盘状态、合并规则、手势输入、本地存储四层拆得很干净。端侧小游戏看起来简单,真正决定代码质量的往往是这类状态边界的设计。
- 点赞
- 收藏
- 关注作者
评论(0)