Friend Maker的2个时序参数：inputDelay和buttonPressDuration该如何设置？

• 桌面应用
• 智能硬件
• 固件
• 图像处理

Friend Maker 是一个面向 Nintendo Switch《朋友收集：梦想生活》（Tomodachi Life）的自动绘制工作台，负责把图片转换成像素脚本，再通过 ESP32 模拟 Switch 手柄完成自动绘制。其中inputDelay和buttonPressDuration两个时序参数，直接决定了绘制是稳定还是快速，是新手最容易调错的地方。本文给出完整的 Friend Maker 时序参数设置指南：从推荐默认值45 / 65起步，按现象逐步微调，最后用调试测速闭环验证。

先搞懂：两个参数分别管什么

Friend Maker 生成的脚本里，第一行命令就是CFG INPUT <按键保持> <稳定等待> <Home等待>（例如CFG INPUT 65 45 1800），ESP32 固件会据此控制每个动作之间的节奏。这两个参数可以粗暴地理解为两个旋钮：

• inputDelay（界面叫“稳定等待”）= 稳定性旋钮：决定每次按键、移动之后留多少缓冲时间。拐弯歪、越跑越偏、连续动作吃不稳，都是它的事。
• buttonPressDuration（界面叫“按键保持”）= 力度旋钮：决定按键按住多久。A键漏按、落笔漏点、少画一个点，才是它的事。

两者都作用于 16~100ms 之间（步进 1ms），默认值为inputDelay 45ms / buttonPressDuration 65ms，定义见 apps/desktop/src/protocol/timing.ts 与 apps/desktop/src/config/defaultProfile.ts。

一键起步：使用推荐默认值 45 / 65

第一次使用不要自己猜数值，直接按推荐默认值跑，这是官方文档给出的起步口径（见 docs/user-trial-guide.md 第 6 节“调试测速”）：

💡 这两个值会同时用于手柄测试、调试测速和正式绘制，在“调试测速”页调好后无需再改其他地方。页面还提供了一键“恢复推荐默认值 45 / 65”按钮，调乱了随时可以回退，界面实现见 apps/desktop/src/web/static/index.html。

优先调 inputDelay：遇到这 3 种情况先动它

Friend Maker 官方的排查原则很明确：先调inputDelay，只有方向稳定后，再碰buttonPressDuration。

看到以下任意一种情况，请把“稳定等待”加 1~3ms 再测：

1. 拐弯会歪、越跑越偏（漂移累计）
2. 连续动作吃不稳
3. 长流程里越来越容易错位

反过来，如果已经很稳只是嫌慢，就每次只减1~2ms，先减“稳定等待”，每改一次都重新复测，别一次减太多（详见 docs/troubleshooting.md 第 6 节）。

再微调 buttonPressDuration：只处理漏点问题

当方向移动已经稳了，但出现A键偶尔没画出来、落笔少点、漏步时，才需要把“按键保持”加 1~3ms，然后用单点测试和短测验证。

注意别调过头：buttonPressDuration超过常用区间（>75ms）后绘制会变慢，还可能出现过冲；小于等于 45ms 时则容易漏点。页面会实时给你标注当前档位（偏轻 / 常用区间 / 偏稳），逻辑见 apps/desktop/src/web/static/app.js。

调试测速页的 3 步验证流程

参数调完不等于调对，Friend Maker 内置了“调试测速”页做闭环验证，推荐流程是先稳，再快，最后复现：

1. 先试 1 格移动和 A 键单点：如果 1 格都不稳，先别跑长测，把参数调慢一点；
2. 先跑“快速检查”：确认短流程稳定后再继续；
3. 最后跑以中心为基准的 6 行 x 240 点阵：专门看长直线末段和换行处是否开始错位——“长测后才开始漂”的情况只有它能暴露出来。

补充两个容易忽略的环境因素：开发板明显发热时先降温再测；附近活跃蓝牙设备很多时先减少干扰再继续调时序。

参数设置速查清单

• 🎯 起步：inputDelay 45 / buttonPressDuration 65，先跑快速检查
• 🔄 拐弯歪、漂移：inputDelay+1~3ms
• 🕳️ A 漏按、漏点：buttonPressDuration+1~3ms
• ⚡ 想更快：每次只减 1~2ms，先减inputDelay，每改一次都复测
• 📏 取值范围：两个参数都在 16~100ms，界面会自动钳制到合法区间

更多背景资料可参考：

• 快速上手与 timing 章节：docs/user-trial-guide.md
• 错位/漂移故障排查：docs/troubleshooting.md
• 开发手册中对两个旋钮的定位：docs/development-manual.md
• 内置 profile 示例（含inputDelay、buttonPressDuration字段）：profiles/switch-mono-256.json

• 桌面应用
• 智能硬件
• 固件
• 图像处理