SuperAPI AI 工具集

motion-and-haptics

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:为 Flutter 应用定义“感官层”交互反馈规范,规定哪些时刻存在、各自承诺什么、触觉如何映射与触发,以及动画不可用时如何降级。它不负责动效令牌(由 design-system-structure 负责)、画布机制(custom-canvas-and-gestures)或消息表面选择(ui-states-and-feedback)。

主要能力与规则:每个提交型交互须在同一帧被确认,按下即显示按压态;动效只装饰状态,禁用动画后终态必须一致、正确且可达;每个时刻需声明触发条件、变化内容、时长角色与曲线、触觉槽位、减弱动效回退;触觉用 HapticTheme 扩展把事件映射到至多一个 HapticFeedback 动词(selection ≤ selectionClick,commit ≤ lightImpact/mediumImpact,rejection ≤ lightImpact,success ≤ mediumImpact,heavyImpact 仅用于真正里程碑),null 槽位表示有意静默;每个已提交事件在提交帧只触发一次触觉,禁止在动画回调、onEnd 或合并手势的逐项循环中触发;heavyImpact 不得用于错误;所有触觉(含庆祝)由单一应用内开关集中控制;动画须可中断,点击立即解析到终态;庆祝有元素数量与时间预算,从动作点发出、只播一次、不循环;重复或环境动画须声明停止条件(路由非当前、应用后台、减弱动效);反馈跨通道冗余,状态变化不得仅靠动效传达;声音为第三通道,须短、尊重静音、集中开关;过渡遵循阅读方向,方向中立的内容表面不镜像。

使用方式:实现前先写下时刻声明表(Moment/Trigger/What changes/Duration role/Haptic/Reduced-motion fallback),实现无法填满某列即表示该时刻未设计完成。触觉事件映射放在主题中,调用点只命名事件而非强度,并通过一个集中 gate 检查开关。

限制:时长是角色而非具体数值,数值令牌归 design-system-structure;方向几何归 i18n-rtl-l10n;颜色单独传达归 accessibility-as-code。资料未提供具体安装命令、收费或平台支持信息。