HarmonyOS 元服务冒险大转盘:随机抽取、同局去重与转盘动画的落地做法

举报
yd_297284506 发表于 2026/11/16 12:37:39 2026/11/16
【摘要】 今天在鸿蒙开发实践中心看了一个很有意思的元服务案例——“冒险大转盘”:朋友聚会时把手机放在桌子中间,选好玩法和挑战程度,转一转转盘,按命中结果完成任务,再交给下一位。它的界面并不复杂,真正的功夫在三件事上:随机要公平、状态要干净、结果要对得上指针。这篇文章就把这三件事的落地做法拆开讲清楚。 一、先把规则定死,再写代码转盘类应用最容易写散,根源是规则没先定死。这个案例的规则写得很明确:玩法分“...

今天在鸿蒙开发实践中心看了一个很有意思的元服务案例——“冒险大转盘”:朋友聚会时把手机放在桌子中间,选好玩法和挑战程度,转一转转盘,按命中结果完成任务,再交给下一位。它的界面并不复杂,真正的功夫在三件事上:随机要公平、状态要干净、结果要对得上指针。这篇文章就把这三件事的落地做法拆开讲清楚。

一、先把规则定死,再写代码

转盘类应用最容易写散,根源是规则没先定死。这个案例的规则写得很明确:

  • 玩法分“真心话 / 大冒险 / 混合局”三种,任务数量 2–20 个,挑战程度分轻松、适中、深入三档;
  • 内置任务 190 条,真心话与大冒险各 95 条,全部随工程打包;
  • 开局先筛选再随机:按玩法和程度筛出候选池,再从中抽出本局清单;
  • 自定义任务可以参与抽取,但最多占本局数量的一半,避免一局全是自家题目;
  • 目标 API 23,最低兼容 API 20,纯本地运行,不依赖服务器和账号。

规则先行还有一个好处:测试用例可以直接从规则导出,后面会讲到。

二、随机抽取:开局抽样与单次抽取是两回事

很多人把“随机”写成一处逻辑,这里要拆成两步:

第一步,开局抽样。 确认玩法、数量和程度后,从候选池里无重复地抽出 N 条,组成一张“本局清单”。确认之前不进转盘,不满意可以“重新生成”,确认后才开局。这一步决定了一局的全部内容,后面只做减法,不再加题。

第二步,单次抽取。 每次转动只从“尚未处理”的任务中选。关键顺序是:先决定抽中哪一条,再计算指针应该停在哪个角度,最后播动画。顺序反过来(先转再算结果)很容易出现指针与结果对不上的情况。

一个可直接参考的抽样示意(Fisher–Yates 洗牌后取前 N 条):

function sample<T>(pool: T[], count: number): T[] {
  const arr = [...pool];
  for (let i = arr.length - 1; i > 0; i--) {
    const j = Math.floor(Math.random() * (i + 1));
    [arr[i], arr[j]] = [arr[j], arr[i]];
  }
  return arr.slice(0, count);
}

另外两个细节不能省:旋转过程中禁止重复点击,避免一次转动触发两次抽取;结果卡片出现后才允许“交给下一位”,保证状态机一次只处在一个环节。

三、同局去重与状态流转:状态机比界面重要

本局的状态流转其实是一条很干净的状态机:

  1. 设置玩法、数量、程度 → 2. 查看并确认本局清单 → 3. 点击转盘抽取 → 4. 展示结果卡片 → 5. 交给下一位或结束本局。

每一步的状态变化都要落到数据上:

  • 抽中后,当前任务标记“完成”,对应扇区变灰,本局不会再抽到;
  • “交给下一位”后,剩余任务数量递减,指针与结果的对应关系保持一致;
  • 最后一项处理完,显示“完成本局”,而不是悄悄回到首页;
  • 重新开局可以遇到之前玩过的任务——因为完成状态只属于当前一局,不会污染下一局。

这条链路最容易出的 bug 是“结果与指针不一致”和“已处理任务被重复抽到”,定位时先看抽取与角度计算是否同一次决策,再看完成标记是否在结果展示前就已写入。

四、转盘动画:先快后慢,停稳再亮结果

视觉上,这个案例用 Canvas 做 2.5D 转盘,配合透视变换与属性动画:转动先快后慢,停稳后突出命中扇区,短暂停顿后,再以缩放、透明度或位移动画把结果卡片推到屏幕居中位置。动画分层值得借鉴:

  • 旋转动画只负责“停到正确角度”;
  • 命中反馈(扇区高亮)只在停稳后出现;
  • 结果卡片是独立的入场动画,与旋转解耦。

三层解耦后,改任意一层都不会牵动另外两层,排障时也很容易定位到某一层。

五、本地数据:保存、迁移与上限

这个元服务是纯本地应用:内置任务随工程打包,自定义任务与设置保存在本机,不自动云同步。数据侧有几条明确约定:

  • 自定义任务用 Preferences 做本地持久化,重启后仍在;
  • 自定义正文去首尾空白后必须非空,最多 30 个 Unicode 字符,空白与超长正文明确拒绝、不保存;
  • 任务可以在任务库里新增、编辑、启停、删除,停用的任务不参与抽取;
  • 迁移用 JSON 导出,或通过“分享我的任务”生成 TXT(正文仍是 JSON),新设备导入恢复;
  • 单份自定义文件最多导入 1000 条、大小不超过 1 MiB,导入时先统计再确认,只合并新任务,不覆盖已有内容。

这些约定的共同点是“先校验、再写入”,非法文件不写入,取消操作不破坏数据。

六、边界与安全:小游戏也要有边界感

  • 无服务器、无需游戏账号,不自动云同步;云端开发环境只是开发入口,不是应用后端;
  • 转盘不用于博彩或需审计的抽签场景;
  • 分享的接收应用由系统及接收方决定,对方实际取得文件才算传递成功;
  • 调试签名、私钥与口令保存在本机,不提交到公开仓库;分享日志和任务文件前检查敏感内容;
  • 用户自行添加的任务内容没有自动审核,参与者可以跳过不想做的任务。

七、一份可以直接照着核对的检查清单

按这个案例文档里的体验检查思路,我整理了一份清单,写完转盘类应用可以逐项核对:

  1. 调整玩法、数量和程度,清单符合条件,确认前不进转盘;
  2. 连续转动、交接并完成整局,指针与结果一致,扇区变灰,同局不重复;
  3. 任务库内容可浏览、搜索和筛选,内置任务不能编辑删除;
  4. 新增、编辑、启停、删除后重启,数据保留,停用项不被抽到;
  5. 保存空内容或超长正文时明确拒绝,不保存不合格项;
  6. 导出后重复导入,只合并新任务,非法文件不写入;
  7. 小窗口、较大字体与键盘弹出时,正文可读、结果居中、按钮可操作;
  8. 构建成功且 HAP 存在,安装、启动分别成功,不只检查旧文件。

小结

“冒险大转盘”这类元服务,界面只占工作量的一小部分,真正决定体验的是三条线:抽取规则(先筛选再抽样、单次只从未处理中选)、状态机(清单确认 → 转动 → 结果 → 交接 → 完成,状态落到数据上)、数据契约(本地持久化、校验后写入、合并只加新项)。把这三条线写清楚,再去做界面和动画,返工会少很多;反过来,先堆界面再补规则,几乎一定会在“指针与结果对不上”和“任务重复出现”上栽跟头。

如果你也在用 AI 辅助开发这类应用,建议按这个顺序对话:先让 AI 输出需求与技术文档,锁定规则与状态机,再分步骤实现并逐项核对完成标志;每步只改一处,改完先跑通再继续。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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