Mock GPS Simulator
启动
在仓库根目录运行:
npm run mock-gps-sim
启动后:
- 控制台页面:
http://127.0.0.1:17865/ - 小程序接收地址:
ws://127.0.0.1:17865/mock-gps - 资源代理:
http://127.0.0.1:17865/proxy?url=<remote-url>
当前能力
- 直接载入
game.json - 自动解析
map / mapmeta / course - 自动切换自定义瓦片
- 自动渲染 KML 控制点
- 一键跳到开始点 / 结束点 / 任意检查点
- 地图点击跳点
- 实时连续发送
mock_gps - 路径编辑
- 上传轨迹文件回放(GPX / KML / GeoJSON)
- 路径回放
- 速度、频率、精度调节
加载自己的地图
推荐方式:
- 启动模拟器后,打开
http://127.0.0.1:17865/ - 在“资源加载”里填自己的
game.json地址 - 点“载入配置”
模拟器会自动:
- 读取
map和mapmeta - 切换到你的瓦片底图
- 读取
course - 渲染开始点、检查点、结束点
如果你不想走整套配置,也可以:
- 直接填“瓦片模板”,例如
https://host/tiles/{z}/{x}/{y}.webp - 直接填
KML URL
路径回放也支持直接导入轨迹文件:
GPXKMLGeoJSON / JSON
说明:
- 配置和 KML 是通过本地代理拉取的,所以浏览器跨域问题会少很多
- 如果你的资源需要鉴权,第一版代理还没有加认证头透传
真机调试注意
如果小程序跑在手机上,不要用 127.0.0.1。
把小程序里的 mock bridge 地址改成你电脑在局域网里的 IP,例如:
ws://192.168.1.23:17865/mock-gps
同理,浏览器里的模拟器页面也建议用电脑局域网地址打开,例如:
http://192.168.1.23:17865/