70 lines
3.7 KiB
Markdown
70 lines
3.7 KiB
Markdown
# 心率区间设置页面 — 原生落地图纸 implementation_plan
|
||
|
||
- **模块**:系统设置 — 心率区间设置 (`HeartRateZoneSettingsActivity`)
|
||
- **依据**:同目录 `baseline_ui.html` + `DESIGN_SPEC.md`
|
||
- **原始出厂截图**:`./Screenshot_20260817-135129.png`
|
||
- **执行角色**:`@coder` (Android 工程师)
|
||
|
||
---
|
||
|
||
## 1. CSS → Android Token 映射字典
|
||
|
||
### 1.1 颜色语义映射
|
||
|
||
| HTML CSS 变量 | 取值 | Android 语义 Token / 资源 ID | 状态 / 说明 |
|
||
| :--- | :--- | :--- | :--- |
|
||
| `--color-z5` | `#FF3B30` | `@color/hr_zone_5` (`#FF3B30`) | ✅ 心率区间 5 专属红色 |
|
||
| `--color-z4` | `#FF9500` | `@color/hr_zone_4` (`#FF9500`) | ✅ 心率区间 4 专属橙色 |
|
||
| `--color-z3` | `#34C759` | `@color/hr_zone_3` (`#34C759`) | ✅ 心率区间 3 专属绿色 |
|
||
| `--color-z2` | `#007AFF` | `@color/hr_zone_2` (`#007AFF`) | ✅ 心率区间 2 专属蓝色 |
|
||
| `--color-z1` | `#8E8E93` | `@color/hr_zone_1` (`#8E8E93`) | ✅ 心率区间 1 专属灰色 |
|
||
| `--color-primary` | `#3949AB` | `?attr/colorPrimary` | ✅ 已存在,年龄数值高亮 |
|
||
| `--color-surface` | `#FFFFFF` | `?attr/colorSurface` | ✅ 已存在,外层容器背景 |
|
||
| `--color-background` | `#F1F5F9` | `?attr/colorBackground` | ✅ 已存在,页面底色 |
|
||
| `--hud-bg` | `#0B0F19` | `@color/hud_monitor_bg` (`#0B0F19`) | ✅ 新建,右侧监控台底色 |
|
||
| `--hud-accent-cyan` | `#38BDF8` | `@color/hud_accent_cyan` (`#38BDF8`) | ✅ 新建,LED 最大心率读数 |
|
||
| `--hud-accent-green` | `#10B981` | `@color/hud_accent_green` (`#10B981`) | ✅ 新建,激光示波线颜色 |
|
||
|
||
---
|
||
|
||
## 2. Android 落地代码清单与改动指南
|
||
|
||
### 2.1 涉及文件
|
||
|
||
1. **布局文件 (Layout)**
|
||
- `app/src/main/res/layout/activity_heart_rate_zone_settings.xml`
|
||
2. **逻辑类 (Activity)**
|
||
- `app/src/main/java/com/umilab/eapmanage/team/settings/HeartRateZoneSettingsActivity.java`
|
||
3. **自定义 View / 动画 (Views & Animators)**
|
||
- `app/src/main/java/com/umilab/eapmanage/ui/view/EcgWaveformView.java` (激光心电动态示波 View)
|
||
- `app/src/main/res/anim/anim_heart_pulse.xml` (拟真双跳动态心跳动画)
|
||
- `app/src/main/res/drawable/bg_zone_card_gradient.xml` (5 个区间专属渐变 Drawable)
|
||
|
||
---
|
||
|
||
### 2.2 具体实施步骤
|
||
|
||
#### 步骤 1:重构 `activity_heart_rate_zone_settings.xml`
|
||
- 顶部保留 AppBar(`Toolbar`,60dp 高)。
|
||
- 顶部控制条:放置训练模式 `Spinner` 与年龄 `SeekBar`。
|
||
- 下方主体采用横向双栏:
|
||
- 左侧 `LinearLayout`(权重 1 或自适应):垂直排布 5 张 `MaterialCardView`(Z5 ~ Z1),每张卡片放置强度 Tag、主名称、副描述、动态心形 `ImageView`、心率范围与百分比说明。
|
||
- 右侧 `CardView`(固定 350dp,底色 `#0B0F19`):放置 `EcgWaveformView`、最大心率动态读数、及 5 阶流光能量进度条。
|
||
|
||
#### 步骤 2:心跳脉冲与 ECG 示波动效
|
||
- 为 5 张卡片中的 `iv_heart_icon` 绑定 `anim_heart_pulse.xml`,开启 `Animation.INFINITE`。
|
||
- `EcgWaveformView` 使用 `Path` + `ValueAnimator` 绘制绿色激光扫描心电波。
|
||
|
||
#### 步骤 3:`HeartRateZoneSettingsActivity.java` 年龄动态联动
|
||
- 监听 `sb_age.setOnSeekBarChangeListener`:
|
||
- 拖动时动态计算 $MaxHR = 220 - age$;
|
||
- 动态刷新 `tv_max_hr_hud` 与 5 个区间的 `tv_hr_range_z1 ~ z5` 文字。
|
||
|
||
---
|
||
|
||
## 3. 验收核验标准
|
||
- [ ] 平板横屏下展示为居中双栏架构,左侧 5 张渐变卡片 + 右侧黑曜石 HUD 监控台。
|
||
- [ ] 5 个心率区间专属色彩严格保持为红、橙、绿、蓝、灰,无任何色系偏差。
|
||
- [ ] 所有字段、文案、模式选项与百分比完全对应原图 `Screenshot_20260817-135129.png`。
|
||
- [ ] ❤️ 心形图标具备平滑拟真双跳心电脉冲,拖动年龄滑块实时联动全页数据。
|