91 lines
1.4 KiB
Markdown
91 lines
1.4 KiB
Markdown
# 轨迹可视化方案
|
||
> 文档版本：v1.0
|
||
> 最后更新：2026-04-02
|
||
|
||
|
||
本文档定义用户轨迹的显示模式、默认策略与配置结构。
|
||
|
||
目标：
|
||
|
||
- 支持 `none / full / tail` 三种轨迹模式
|
||
- `tail` 模式有更强的实时感和游戏感
|
||
- 兼顾低端机性能
|
||
|
||
## 模式定义
|
||
|
||
### `none`
|
||
|
||
- 不显示轨迹
|
||
- 只显示当前 GPS 点
|
||
|
||
### `full`
|
||
|
||
- 显示从开始到当前的完整轨迹
|
||
|
||
### `tail`
|
||
|
||
- 只显示最近一小段拖尾轨迹
|
||
- 头部更亮、更粗
|
||
- 尾部逐步变淡、变细
|
||
- 用户停止移动后，轨迹会逐步缩短到消失
|
||
|
||
## 推荐默认值
|
||
|
||
### 顺序赛
|
||
|
||
- `mode = full`
|
||
- `style = classic`
|
||
|
||
### 积分赛
|
||
|
||
- `mode = tail`
|
||
- `style = neon`
|
||
|
||
## 推荐配置
|
||
|
||
```json
|
||
"game": {
|
||
"presentation": {
|
||
"track": {
|
||
"mode": "tail",
|
||
"style": "neon",
|
||
"tailMeters": 60,
|
||
"tailMaxSeconds": 30,
|
||
"fadeOutWhenStill": true,
|
||
"stillSpeedKmh": 0.6,
|
||
"fadeOutDurationMs": 3000,
|
||
"colorHex": "#176d5d",
|
||
"headColorHex": "#54f3d8",
|
||
"widthPx": 5,
|
||
"headWidthPx": 10,
|
||
"glowStrength": 0.42
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 当前实现约定
|
||
|
||
当前第一版实现支持：
|
||
|
||
- `mode`
|
||
- `style`
|
||
- `tailMeters`
|
||
- `tailMaxSeconds`
|
||
- `fadeOutWhenStill`
|
||
- `stillSpeedKmh`
|
||
- `fadeOutDurationMs`
|
||
- `colorHex`
|
||
- `headColorHex`
|
||
- `widthPx`
|
||
- `headWidthPx`
|
||
- `glowStrength`
|
||
|
||
## 后续扩展
|
||
|
||
- 轨迹颜色按心率区间变化
|
||
- 轨迹颜色按速度变化
|
||
- `standard / lite` 下自动降级 glow
|
||
|
||
|