SuperAPI AI 工具集

test-with-simulator

测试与质量

查看项目

更新于 10-15 21:39

技能介绍

用途:在桌面模拟器中测试与调试 Even Hub G2 应用,覆盖启动、配置、调试、截图,并帮助理解模拟器与真机的差异。模拟器是硬件测试的补充,不能替代真机测试。

安装:npm install -g @evenrealities/evenhub-simulator,版本 v0.7.1,跨平台支持 macOS、Linux、Windows。

基本用法:evenhub-simulator http://localhost:5173;加 -g 启用发光效果,-b spring 使用弹簧回弹,-c ./my-config.toml 指定自定义配置。

主要能力:CLI 支持 -c/--config、-g/--glow、--no-glow、-b/--bounce、--list-audio-input-devices、--aid、--no-aid、--print-config-path、--automation-port、--completions、-V/--version、-h/--help。配置文件路径可用 --print-config-path 查看。键盘鼠标映射为眼镜手势:上/下对应滑动,单击对应轻点,双击对应双击。音频采样率 16000 Hz,16 位小端 PCM,每事件 100ms(3200 字节/1600 采样),数据经 event.audioEvent.audioPcm 传入。点击模拟器显示区可导出 RGBA PNG 截图到当前目录,文件名基于时间戳。

调试:RUST_LOG=debug evenhub-simulator <url> 可记录原始负载解析错误;模拟器托管 WebView,可用浏览器开发者工具检查控制台、网络与 DOM。

限制与差异:onDeviceStatusChanged 不触发(配置硬编码);eventSource 固定为 1;imuData 始终为 null;字体渲染为近似;列表滚动可能与硬件不同;图像内存无限制;错误处理边缘情况可能不同。因此布局与逻辑可依赖模拟器迭代,列表滚动、图像内存限制、设备状态流程、IMU 功能和多输入源需在真机验证。

典型流程:npm run dev 启动开发服务器,evenhub-simulator -g http://localhost:5173 启动模拟器,交互并截图,代码自动重载,部署前在真机验证。Shell 补全可用 --completions 生成。