# Mock GPS Simulator

## 启动

在仓库根目录运行：

```bash
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，例如：

```text
ws://192.168.1.23:17865/mock-gps
```

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

```text
http://192.168.1.23:17865/
```