diff --git a/docs/acceptance/b210-android-call-visual-rework.md b/docs/acceptance/b210-android-call-visual-rework.md new file mode 100644 index 0000000..0d0d209 --- /dev/null +++ b/docs/acceptance/b210-android-call-visual-rework.md @@ -0,0 +1,97 @@ +# B-210 Android 通话视觉打回返工 + +分支:`agent/agent/ede0aecc`(基于 B-204 `agent/agent/3a58b06e` HEAD `714794f`) +施工依据:B-91 视觉规范 v2;打回结论 B-209;姓名字号裁定 18px,32px 仅计时器。 +本卡只做打回返工、构建验证和返工证据,不部署、不发布、不换标。 + +**结论:9 项阻塞 + 建议项已按规范收口;Android debug/release 真实构建通过。缺有效账号和 ARM64 真机,来电/通话页实机渲染、听筒/扬声器、静音、后台/锁屏、铃声震动继续标为未测。** + +## 打回项对照 + +| # | 打回项 | 修改位置 | 结果 | +|---|---|---|---| +| 1 | 计时器 32px 纯白 tabular figures | `AppFont.callTimer`、`Styles.ts_callTimer`、`controls.dart` 通话中状态字 | 已改 | +| 2 | 通话页底 `#1D2129`,不复用 maskBg | `AppColors.callBg`、`Styles.c_callBg`、`call_state.dart` | 已改 | +| 3 | 呼出中仅居中 64 红色取消 | `controls.dart` `_buttonArea`、`LiveButton.cancel` | 已改 | +| 4 | 通话中 48 次按钮 + 居中红色挂断;Token 圆底线性图标 | `live_button.dart`、`controls.dart` | 已改,不再用位图 PNG | +| 5 | 姓名 → 状态 → 96 头像圆角 0.18 | `controls.dart` `_infoColumn` | 姓名 18px,头像 96×0.18 | +| 6 | 结束/失败展示 1.5s 后退出,失败 toast | `call_state.dart` `beginEnding`、`Styles.callEndHold` | 已结束 / 网络异常,通话中断 / 对方已拒绝 | +| 7 | 未接 60s +「未接通话」系统消息;清掉 30s 双来源 | `AppDuration.callInviteTimeout` → `LiveKitCallConfig` / `Styles` / `CallSessionGuard` / 信令 timeout | 超时插入 `CallState.timeout`,文案 `未接通话` | +| 8 | 进出 250ms 自下而上 ease-out,状态不可被重复回调破坏 | `call_page_host.dart`、`live_client.dart` close 防重入、`beginEnding` `_ending/_closed` | 已改 | +| 9 | 来电每 1s 震动,拒绝/接听/退出/销毁停止 | `live_controller.dart` `_startIncomingVibrate` / `_stopSound` | 已改;真机未测 | +| 10 | 状态字 14px 白 60%;文案;静音/免提;最小化点击区 48 | `ts_callStatus`、zh_CN 文案、`LiveButton.mute/handsFree`、最小化 `IconButton` 48 | 已改 | + +## 提交主题(可逐项 `git revert`) + +从新到旧回退:先本验收记录,再视觉返工。 + +| 主题 | SHA | 文件 | +|---|---|---| +| 本验收记录 | 本文件当次提交 | `docs/acceptance/b210-android-call-visual-rework.md` | +| 视觉打回返工 | `9bde926` | Token、文案、超时单一来源、通话页布局/按钮/结束态/动效/震动、测试 | + +回退示例(新到旧): + +``` +git revert <本验收提交> +git revert 9bde926 +``` + +## 环境 + +- Flutter 3.24.5 / Dart 3.5.4(`C:\flutter324`) +- Temurin JDK 17.0.20+8 +- Android SDK:既有 B-95 工具链(compileSdk 34) +- `org.gradle.jvmargs=-Xmx4096M` + +## 检查与构建 + +### 定点测试 + +``` +cd mobile-next +flutter test test/company/rtc_token_mapper_test.dart test/company/call_session_guard_test.dart test/company/call_visual_rework_test.dart +``` + +16 项通过:换票映射、占线/去重/超时/销毁、60s 单一来源、callBg≠maskBg、32px tabular figures、14px/18px、250ms/1.5s/48·64·96 尺寸。 + +定点 `flutter analyze` 修改文件:**0 error**。存量 info/warning 未作为本卡阻塞。 + +### Android(真实构建) + +| 构建 | 结果 | 大小 | SHA256 | 产物 | +|---|---|---|---|---| +| debug | 成功 | 109,424,273 B | `415478F0908BB44449C7DA944F07C5214989888C77B7E13295E4D71082197308` | `mobile-next/build/app/outputs/flutter-apk/app-debug.apk` | +| release | 成功 | 53,289,471 B | `7D81C54D2A03920E0989DDCFD5E29C3433DEB4FDB15266DE2913864D6C4FFD1C` | `mobile-next/build/app/outputs/flutter-apk/app-release.apk` | + +构建期告警同 B-204:Flutter Gradle apply-script 弃用;部分依赖 Kotlin metadata 1.8.0 vs 工程预期 1.6.0。均属上游,debug/release 均通过。APK 内嵌时间戳,哈希不可位级复现。 + +## 越界比对 + +相对 `714794f`(本卡开工 HEAD):仅 `mobile-next/` 与本验收文档。 + +相对 `e26abad`:`mobile/`、`account-service/`、`config/`、`scripts/` **零改动**。本卡工作区 diff 不含 `pc-client/`。 + +`FeatureFlags.livekitCall` 门控保持:配置不足时入口隐藏。 + +## 已测 / 未测 + +已测(替身或构建): + +- Token 映射:callBg `#1D2129`、计时器 32px tabular figures、状态字 14px 白 60%、姓名 18px +- 未接超时 60s 单一来源(配置 / Styles / Guard) +- 占线、重复信令、超时取消、销毁释放计时器 +- Android debug/release 可构建 + +未测(缺外部条件,禁止写成通过): + +- 无有效工号+密码,未登录 +- Android ARM64 真机:呼入呼出、听筒/扬声器、静音、后台/锁屏、铃声与每秒震动 +- 结束/失败 1.5s 退场与 250ms 滑入滑出的真机观感 +- 「未接通话」系统消息在会话里的真机展示 + +## 风险与回退 + +- 真机铃声/震动依赖设备振动器与勿扰模式,静态审查不能代替点验 +- 结束态 1.5s 内重复回调被 `_ending` 吞掉,属有意防护 +- 回退:先 `git revert` 本验收提交,再 `git revert` 视觉返工提交