cmr-mini/doc/rendering/GPS点样式系统方案.md

GPS 点样式系统方案

目标

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

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

分层

1. 显示策略

• visible
• size
• colorPreset

2. 基础样式

第一阶段支持：

• dot
• beacon
• disc
• badge

默认：

• beacon

3. 朝向指示

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

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

4. 品牌化扩展

后续通过：

• logoUrl
• logoMode

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

第一阶段默认值

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

用户设置建议

系统设置先开放：

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

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

配置入口

建议统一放在：

"game": {
  "presentation": {
    "gpsMarker": {}
  }
}

长期演进

第二阶段

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

第三阶段

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

结论

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

第一阶段先把：

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

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