上一篇我已经把从安装到跑通完整过了一遍。默认模型能不能继续用？能。但如果你想切换成自己更熟悉的模型，或者接入第三方服务，该怎么配？这篇文章就专门讲这件事。的模型配置入口在哪里、怎么写、每个字段是什么意思、配完之后怎么验证有没有生效。下面是一个比较完整的配置示例。我这里保留了原有的官方模型，同时新增了一个自定义的1api提供方，用来接入模型。"glm-5": {"limit": {},},"1api

快递互动卡片用到了陀螺仪。小白如果只写页面代码，不配权限，很容易遇到“代码看起来没问题，但传感器就是没数据”的情况。这篇专门讲权限怎么配、配在哪里、为什么要这么配。快递卡片的陀螺仪权限不是可有可无。传感器类互动卡片，第一步就是把权限和使用场景配清楚。小白记住：先配权限，再写传感器动画。

上一篇讲了状态机，这一篇讲状态到底由谁来改。答案很明确：不要让普通卡片自己改最终状态。普通卡片只发动作，应用侧统一改状态，再刷新所有相关卡片。运动卡片的状态管理思路很适合其他业务复用。小白记住：卡片发动作，应用改状态，工具类批量刷新。

运动卡片有一个典型特点：状态会变。未开始、运动中、已完成，不同状态下 UI、按钮文案、点击动作都不一样。小白很容易写一堆 boolean，比如isStartedisFinishedisRunning。写到后面就乱了。项目里用枚举状态来做，这个思路更稳。表示当前状态。表示用户动作。状态和动作分开，这是关键。运动卡片这种场景，状态机比 boolean 可靠太多。记住一句话：状态描述现在是什么，动作描述

桌面上可能有多张音乐卡片，应用页面里也可能正在显示歌曲详情。当前项目用把这件事串起来。小白记住：最终状态放 RDB，桌面卡片靠FormUtils刷新，应用页面靠事件通知。

音乐切歌动画如果只是换一张图片，会很生硬。当前项目用 Canvas 把帧图和专辑封面合成到一起，效果会自然很多。这篇不讲高深图形学，只带小白看懂项目里 Canvas 的用法。Canvas 的好处是自由。切歌动画里，帧图、封面、旋转、裁剪都能自己控制。小白先记住三件事：清空画布、保存恢复状态、销毁时清理定时器。

音乐 LiveForm 不是固定播一段动画。用户点播放、上一首、下一首，看到的反馈应该不一样。当前项目就是根据来选择动画资源。这篇带小白把这段逻辑看懂。音乐 LiveForm 的动画选择，本质就是“动作驱动 UI”。决定动画类型，决定帧资源，决定当前显示哪一帧。

播放按钮只要知道“播放”就够了，但上一首、下一首不一样。切歌动画要知道用户点的是上一首还是下一首，还要知道切换前是哪首歌。这就是项目里保存和songId的原因。不是多余字段，它是普通卡片和 LiveForm 之间的“暗号”。做互动动画时，小白要记住：只传结果不够，有时候还要传触发过程。

音乐卡片的播放按钮看起来只是一个图标，但背后串了很多东西：普通卡片发动作、应用侧播放音乐、必要时展开 LiveForm、最后还要刷新桌面卡片状态。这篇就按项目代码，把播放按钮这条链路讲清楚。音乐播放按钮不是一个孤立按钮，它是“卡片 UI -> 应用业务 -> 卡片刷新 -> LiveForm 动画”的完整闭环。小白记住这句话：按钮只发意图，真正状态以应用侧刷新为准。

卡片只是桌面组件，真正的业务应该回到应用侧处理。当前项目把这件事统一交给。这篇就带你把这条链路看明白。：音乐播放、暂停、上一首、下一首。：新卡片主动请求当前数据。：运动卡片开始、结束、重置。把动作写成枚举的好处是：不容易写错字符串，也方便全项目搜索。的价值是“收口”。卡片越多，动作越多，如果没有统一入口，项目很快会乱。小白记住：卡片发动作，Handler 分发动作，业务服务处理动作。