麻将游戏的性能问题很容易被低估:一局里可能有几十到上百张牌,每张牌都有牌体、牌面、阴影、层级、选中状态和动画。如果全部运行时动态组合,手机上很快会出现掉帧或发热。

Sumi Mahjong 的资产流程采用两阶段:开发阶段用代码实时绘制牌体并叠加透明牌面,方便调试;视觉确认后,把完整牌面烘焙成 PNG,运行时直接使用静态资源。

这篇日志讲的不是美术,而是产品落地里的性能工程:什么时候用代码生成,什么时候转成资产,什么时候让机器校验替代人眼感觉。

开发细节补充:这篇记录放在 Sumi Mahjong 禅艺麻将 的产品日记里,不是为了把一个功能包装成故事,而是把“10 · 性能优化:从实时绘制到 PNG 烘焙”放回真实项目推进中看。它要同时回答三件事:用户为什么需要这个点,开发时哪些边界必须先定住,以及这个选择会怎样影响上架、推广和后续课程复盘。平台口径是 iPhone / iOS / 游戏,当前公开状态是 App Store / 无广告 / 无追踪,所以文案不能脱离真实发布进度。

对应的 docs 线索主要来自 ZenMahjong 产品策略、玩法算法与判定、牌面资产和动效记录、完成审计与本地化上架文档。公开页面不会照搬内部工作记录,而是把可公开、可学习、不会泄露私密路径和账号信息的事实整理出来。ZenMahjong docs 覆盖开发哲学、痛点功能清单、命名品牌、UI 结构、主题美术、定价 IAP 和本地化上架。 开发计划记录了玩法算法、两折线判定、周 1 开发日志、动效粒子、开源布局参考、随机布局策略和牌面生成流程。 完成审计把玩法、隐私、无广告、StoreKit、素材和上架说明合在一起,让游戏不是只停留在可玩 Demo。 公开文章要说明为什么小游戏也需要不做清单:无广告、无账号、无体力、无排行榜,都是架构和商业化选择。

从产品功能看,Sumi Mahjong 禅艺麻将 关联的能力包括:144 张手调水墨麻将牌、经典两折线连接规则、撤销、提示、洗牌、无广告 SDK、无账号、无第三方追踪。写这类日记时,不能只说“做了什么”,还要说明为什么先做这些、为什么暂时不做另一些。比如一个按钮、一个导入流程、一个本地模型开关或一段截图文案,放在代码里只是小改动,放在产品里却会影响用户理解、审核员复现和后续推广素材。

从工程推进看,这篇日记对应的检查点是:轻量游戏的上架、IAP 和隐私边界;产品页如何表达安静体验。真实开发最容易失真的是中间过程,因为最后页面看起来只有一个结果,但实际会经历方案取舍、权限确认、素材准备、测试设备、审核备注和发布节奏。把这些过程写下来,后面做同类产品时才不会重新踩同一个坑。

从隐私和合规看,当前约束是:正常游玩不需要网络;付费解锁通过 Apple StoreKit 完成。这类信息必须前置到开发日记里,因为独立产品的可信度不是靠口号建立的,而是靠数据在哪里处理、用户能不能退出、功能是否离线可用、商店页怎么承诺、隐私政策是否与实现一致这些小事实积累出来的。

从课程和复用看,这篇内容可以沉淀到 iOS 小游戏、StoreKit 2、无广告产品、多语言上架。它的价值不只是给访问者看一个产品,而是展示一个独立开发者怎样把想法转成可验证的产品:先收窄场景,再选技术路径,再做体验最小闭环,最后把审核、推广、运营数据和失败教训都纳入下一次迭代。

轻量游戏也可以成为完整产品案例:规则、手感、美术、IAP、审核和推广都能拆开复用。 这也是为什么每篇产品日记都要写到足够长:不是为了凑字数,而是为了把“证据、决策、实现、边界、复盘”都放在同一页,让读者看到一个判断是怎样被逐步验证出来的。最难的是让麻将消除既安静又耐玩,同时避免广告化和过度游戏化破坏产品气质。

所以这篇日记的结论不是“功能已经写完”,而是把一个阶段的判断公开化:哪些证据足够支撑继续推进,哪些资料还需要回到源码、商店材料、公开文案或运营观察里补齐。这样的记录会比单纯的发布公告更慢,但也更真实,能让产品页、发布记录和课程内容保持同一条事实线。

验收时我会把它拆成四个层次:第一层是用户路径能不能走通,第二层是异常状态有没有被诚实处理,第三层是页面上的按钮、状态、截图和文案是否对应真实发布渠道,第四层是公开证据能否支撑这个判断。只要其中一层对不上,产品看起来再完整,也不能算真正进入下一个阶段。

交接时也要保留边界:源码、构建、测试、商店元数据、公开文案、平台反馈和运营观察分别保存原始资料。产品日记只把这些事实翻译成读者能理解的过程,不替任何私有记录保存原始材料。

把这些内容公开出来,还有一个很现实的原因:AI 教程如果只展示成功结果,很容易让人误以为产品是一次生成出来的。真实情况恰好相反,真正可学习的是一次次收窄、验证、失败、补证据和重新提交。日记越具体,后续读者越能看到判断的脉络,而不是只看到一个漂亮的截图。

先用代码快跑,再用资产稳定

开发早期用代码绘制牌体很有价值,因为可以快速调整边框、阴影、比例、圆角和牌面位置。但这不代表最终上线也必须实时绘制每个细节。

一旦视觉方向稳定,就应该把牌体和牌面烘焙成完整 PNG。这样运行时只需要绘制图片,减少布局和组合成本,也更容易保证不同设备上的一致性。

AI 美术输出不能直接信任

AI 生成的图集经常会出现尺寸不准、格子偏移、元素数量错误、符号太细、万字不可读等问题。看起来风格对了,不代表能进入游戏。

因此需要语义骨架、裁切预览、数量检查、透明背景、边距校验和游戏内 sample 预览。美术资产也要有测试,而不是只靠审美判断。

主题不是滤镜,是语义系统

筒、条、万、字牌、花季牌各自有不同语义。主题可以把筒换成莲花或星核,把条换成飘带或光束,但数量和相对位置必须稳定。

尤其是万字牌,它是整套牌的麻将识别锚点。完全改成抽象图标会让玩家失去识别感,所以更适合保留汉字结构,只调整笔触、材质和装饰。

性能优化也是课程资产

这个案例能讲清楚一个很常见的独立开发取舍:不要一开始就把流程做重,但也不要把原型期方案直接当最终方案上线。

先用快速方案验证玩法和视觉,再用脚本、校验和烘焙把资产稳定下来。这个流程以后做 App Store 截图、图标生成、主题包、课程素材都能复用。