76 lines
1.7 KiB
Markdown
76 lines
1.7 KiB
Markdown
# 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/
|
||
```
|