1. 开启 Web 服务
启用 Web 服务
2. 访问 Web 地图
接入第三方软件
如果你需要在 SimHub 仪表或 OBS 中显示地图，请查看 SimHub / OBS 加载地图教程。
当前电脑访问
- 1. 点击侧边栏的 Web 地图 按钮
- 2. 在模板列表中选择要使用的模板
- 3. 点击 打开模版 按钮
- 4. 软件会自动打开窗口显示 Web 地图
局域网电脑访问
局域网访问需要手动复制访问地址（需要提前开启局域网访问功能）
在移动设备上访问
移动端扫码获取访问地址（需要提前开启局域网访问功能）
- 1. 确保手机/平板与电脑在同一 Wi-Fi 网络
- 2. 使用手机/平板照相机功能扫码获取访问地址（如果手机照相机不支持扫码，请使用扫码功能 APP）
- 3. 点击扫码获取的地址，在浏览器中打开
- 4. 页面加载后即可看到实时地图
添加到主屏幕（PWA）
移动端浏览器支持将 Web 地图添加到桌面，实现类似原生应用的体验：
iOS（Safari）
- 1. 打开 Web 地图页面
- 2. 点击底部分享按钮
- 3. 选择 添加到主屏幕
- 4. 确认后，桌面会出现应用图标
Android（Chrome）
- 1. 打开 Web 地图页面
- 2. 点击右上角菜单
- 3. 选择 添加到主屏幕 或 安装应用
- 4. 确认后，桌面会出现应用图标
添加后，从桌面图标打开可以全屏显示，体验更佳。
PWA 限制
由于移动端浏览器权限限制，PWA 应用无法保持手机常亮。如需长时间使用，请在手机设置中调整屏幕自动锁定时间。
3. 实时数据推送
SSE 数据流
Web 端通过 SSE（Server-Sent Events） 接收实时数据，包括：
- 卡车实时位置和朝向
- 导航线路数据
- 遥测数据（速度、燃料、转速等）
- 游戏事件通知（碰撞、罚款等）
数据延迟
SSE 推送延迟极低，Web 端体验与桌面端基本一致：
- • 位置更新频率：约 10 次/秒
- • 遥测数据更新：实时同步
- • 事件通知：即时推送
注意事项
- • 可能存在某些手机操作系统对SSE的兼容性问题，导致数据延迟或卡顿
4. 地图模板
两套渲染引擎
软件提供两套 Web 地图模板，分别基于不同的渲染引擎：
| 模板 | 渲染引擎 | 地图类型 | 特点 |
|---|---|---|---|
| OL-Web地图 | OpenLayers | 光栅地图 | 传统 2D 视图，性能稳定 |
| ML-Web地图 | MapLibre GL | 光栅地图 / 矢量地图 | 支持 3D 视角、旋转、平滑缩放 |
注意事项
- • 每种渲染器只能打开对应的 Web 地图
- • 切换渲染器后，另一种渲染器 Web 地图会处于不可用状态
5. 自定义主题配色
主题预设
每套模板都内置多个主题预设，可一键切换：
默认主题
暗夜模式
高对比度
自定义
自定义配色
- 1. 进入软件侧边栏的 Web 地图 页面
- 2. 选择当前使用的模板并打开 模板设置
- 3. 可先选择主题预设，再按需另存为自定义主题，需要设定新的主题名称
- 4. 在自定义主题中逐项调整颜色（以实际软件提供的功能为准）：面板背景色、地图元素颜色、文字颜色
保存和应用
- 预设的主题不允许修改
- 自定义主题调整完成后点击 保存 按钮，会创建新的主题配置文件
- 所有配色在点击保存应用后会实时同步应用到 Web 地图界面
- 在任何设备上都能看到一致的个性化界面
- 保存的自定义主题可以在 设置 界面应用到软件地图中
提示
首次使用 Web 模板前，建议先进入地图页完成一次地图加载，这样模板页面可以读取当前游戏的语言与 POI 数据。
注意事项
- • 主题切换或自定义主题仅用于MapLibre渲染器的静态PMTiles模式，IPC实时模式暂未开放
6. 移动端优化
自适应布局
- • 响应式布局，自动适配不同屏幕尺寸
- • 触摸手势支持：双指缩放、拖动平移
- • 简化的控制面板，避免遮挡地图
- • 优化的字体大小，确保可读性
性能优化
- • 根据设备性能自动调整渲染质量
- • 移动网络下降低数据推送频率
- • 支持离线缓存，减少流量消耗