# GPS 点样式系统方案
> 文档版本：v1.0
> 最后更新：2026-04-02 08:28:05


## 目标

把当前“粗糙蓝点”升级成正式的 GPS 点样式系统，满足：

- 默认样式更精致
- 显示/隐藏可控
- 大小可调
- 颜色可调
- 带跟随朝向旋转的小三角
- 后续可承接品牌 logo 定制

## 分层

### 1. 显示策略

- `visible`
- `size`
- `colorPreset`

### 2. 基础样式

第一阶段支持：

- `dot`
- `beacon`
- `disc`
- `badge`

默认：

- `beacon`

### 3. 朝向指示

GPS 点上方增加一个小三角：

- 跟随朝向旋转
- 朝向可信度高时更明显
- 朝向可信度低时自动降低透明度

### 4. 品牌化扩展

后续通过：

- `logoUrl`
- `logoMode`

把商家 logo 作为中心贴片嵌入 GPS 点，不直接替代定位点本体。

## 第一阶段默认值

```json
{
  "visible": true,
  "style": "beacon",
  "size": "medium",
  "colorPreset": "cyan",
  "showHeadingIndicator": true,
  "logoUrl": "",
  "logoMode": "center-badge"
}
```

## 用户设置建议

系统设置先开放：

- GPS 点显示：`显示 / 隐藏`
- GPS 点大小：`小 / 中 / 大`
- GPS 点颜色：8 种亮色

品牌 logo 先不进用户设置，只保留给活动配置。

## 配置入口

建议统一放在：

```json
"game": {
  "presentation": {
    "gpsMarker": {}
  }
}
```

## 长期演进

### 第二阶段

- logo 中心贴片
- 不同玩法默认 GPS 点 profile
- 更强的脉冲/光晕动画

### 第三阶段

- GPS 点与心率/危险状态联动
- 客户品牌化主题包
- 特殊活动皮肤

## 结论

GPS 点应被视为独立样式系统，而不是固定蓝点。

第一阶段先把：

- 显示
- 大小
- 颜色
- 朝向三角

做稳定，再逐步承接商业品牌化定制。



