mini-prog/tools/mock-gps-sim

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）
• 路径回放
• 速度、频率、精度调节

加载自己的地图

推荐方式：

1. 启动模拟器后，打开 http://127.0.0.1:17865/
2. 在“资源加载”里填自己的 game.json 地址
3. 点“载入配置”

模拟器会自动：

• 读取 map 和 mapmeta
• 切换到你的瓦片底图
• 读取 course
• 渲染开始点、检查点、结束点

如果你不想走整套配置，也可以：

• 直接填“瓦片模板”，例如 https://host/tiles/{z}/{x}/{y}.webp
• 直接填 KML URL

路径回放也支持直接导入轨迹文件：

• GPX
• KML
• GeoJSON / JSON

说明：

• 配置和 KML 是通过本地代理拉取的，所以浏览器跨域问题会少很多
• 如果你的资源需要鉴权，第一版代理还没有加认证头透传

真机调试注意

如果小程序跑在手机上，不要用 127.0.0.1。
把小程序里的 mock bridge 地址改成你电脑在局域网里的 IP，例如：

ws://192.168.1.23:17865/mock-gps

同理，浏览器里的模拟器页面也建议用电脑局域网地址打开，例如：

http://192.168.1.23:17865/