RUI Studio 帮助

触摸手势参数

参数设置 → 触摸手势。时间、距离速度、惯性与甩动滚屏。改完需重新导出并烧录。

入口:参数设置 → 触摸手势。同一页往下滚还有 惯性参数甩动跳页滚屏。效果演示读同一套数。

改完必须 重新导出代码并烧录,下位机才会用新值。

时间参数(ms)

界面名称默认作用
长按阈值300按住不动达到此时长,发一次长按
长按重复开始600开始连发(不会早于长按阈值)
长按重复周期100连发间隔;填 0 则不连发
双击最大间隔300两次单击间隔超过则不算双击

已经发过长按或连发时,抬手 不再 当普通单击,避免多走一步。

距离 / 速度阈值(px / px/s)

界面名称默认作用
允许抖动8 px小于此位移仍算按住,长按和点击还能成立
拖动阈值10 px超过则进入拖动(滑动条跟手)
双击最大距离12 px两点太远不算双击
甩动最小速度300 px/s抬手够快才算甩(甩动跳页 / 全页滚屏)

一般保持「允许抖动 ≤ 拖动阈值」。手指不稳就调大抖动;滑动条发钝就略减小拖动阈值。甩动切页不灵敏就减小甩动最小速度;容易误甩就调大。

惯性参数

甩动被识别后,手势引擎可以继续做减速滑行(惯性)。全页甩动滚屏 / 甩动跳转页面 走自己的滚屏动画,滚屏过程中会压住这条惯性,避免两套动画抢。

界面名称默认作用
惯性步进16 ms每隔多少毫秒推一帧惯性。建议 16~20
惯性停止速度50 px/s滑行速度低于该值就停
惯性衰减950每一帧速度乘以千分比。950 = 剩 95%

衰减越接近 1000,滑得越久;数字越小,停得越快。一般用默认即可。

甩动跳页滚屏

这两项管 甩动切页时画面怎么横着滚,和上面的惯性不是同一套。分页上还要选「滚动切屏」,并设好左/右目标页,见 触摸区分页

界面名称默认作用
水平滚动步进3 px每步平移多少像素。越大动画越快、越跳
滚屏步进延时1 ms每步之间停多久

粗略时长约为:屏宽 ÷ 步进 × 延时(毫秒)。动画太慢就加大步进或减小延时。

常见调法

现象可调
按住易抖、长按不稳增大允许抖动
想拖滑动条却总被当成点减小拖动阈值
双击太难 / 太容易调双击间隔和双击最大距离
连发太快 / 太慢调长按重复周期;首次出现调长按重复开始
甩动切页不灵 / 误甩减小 / 增大甩动最小速度
切页滚屏太慢或太快调水平滚动步进、滚屏步进延时
改了双击间隔下位机没变化须重新导出并烧录;主循环时间基要对(见软件帮助里的触摸说明)