Files

70 lines
3.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 心率区间设置页面 — 原生落地图纸 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`。
- [ ] ❤️ 心形图标具备平滑拟真双跳心电脉冲,拖动年龄滑块实时联动全页数据。