这个项目能做什么

该库通过一个可调节的单一 API,为 Web 交互提供协调的触觉、听觉和视觉反馈。它支持通过 navigator.vibrate 实现 Android 振动,并通过输入开关技巧支持 iOS Taptic Engine。每个反馈通道(触感、声音和动作)都可以在运行时独立启用、禁用或调节。声音通过 Web Audio 合成,内置 20 种提示音或支持自定义样本包。动作反馈使用 emoji 粒子和弹性跳动效果,并遵循 prefers-reduced-motion 设置。其 API 模拟了 iOS UIFeedbackGenerator 的语义(如 selection、impact、notification 等),并允许自定义调节强度、音量、缩放和事件映射。该库旨在支持未来的原生后端替换(例如 Capacitor),具有框架无关性,支持 SSR 安全,并提供 TypeScript 类型且无运行时依赖。诊断功能可帮助调试平台特定问题,如缺失振动权限。它是增强 UI 反馈且无需直接依赖平台特定 API 的理想选择。