P0-3 H5 兼容性与断网降级实测
2026-11-16。对应
调研缺口清单.md第 7 步。 目标:把「H5 载体到底会不会在手机上坏掉」从猜测变成可复跑的数字,并给出免 ICP 备案的前提(C1)的技术证据。 结论先行:15 个视口全通过、断网可启动可推进、存档不丢;但有 5 项模拟器测不了,必须真机。
〇、判定
| 项 | 判定 | 证据强度 |
|---|---|---|
| 多机型布局(竖屏 13 个视口) | ✅ 通过 | 几何 + 命中测试,可复跑 |
| 横屏 | ✅ 已按设计阻截(不重排) | 实测横屏正文区只剩 79px / 2 行 |
| 文字被浮层遮挡 | ✅ 未出现 | elementFromPoint 网格命中,可见比 1.00 |
| 断网启动(C1 核心玩法离线可完成) | ✅ 成立 | 严格模式 transferSize=0,见第四节 |
| 刷新 / 切后台丢档 | ✅ 不丢 | idx 0→1→1,bootSource=restore |
| 真机 Safari / TapTap 容器 WebView | ⬜ 未验证 | 模拟器替代不了,见第九节 6 条 |
一句话:技术形态没有问题,风险已经从「会不会坏」收窄成「在别人家的 WebView 里会不会不一样」。
一、为什么不是「真机」
本机没有可用的 iOS / Android 测试机,也没有 TapTap 客户端容器。因此用无头 Chrome + CDP
Emulation.setDeviceMetricsOverride 模拟视口与 DPR,跑一份真实可交互的页面(不是静态稿),
把能自动化的部分钉死。
这套方法能证明什么
- 几何布局:在给定 CSS 尺寸下,正文区能吃下几行、选项能不能放完、有没有横向溢出
- 遮挡:浮层与正文/按钮是否存在像素级重叠(用命中测试,不看
z-index猜) - 热区尺寸、字号、对比度、200% 字体缩放
- Service Worker 离线启动、localStorage 存档恢复、后台冻结后回前台
这套方法不能证明什么
- iOS Safari 地址栏收放时
100vh的真实行为(WebKit 特有,且与是否滚动绑定) env(safe-area-inset-*)的真实取值(模拟器里恒为 0px)- 字体度量差异导致的中文换行差异(iOS 用 PingFang,行高与断行点未必一致)
- TapTap 小游戏容器内 WebView 的内核版本与嵌套滚动行为
- 惯性滚动、长按选中、双指缩放等触摸手感
- 低端机的渲染性能(首屏耗时、长列表掉帧)
所以下文所有「✅」都只对最后一列负责:布局与离线逻辑成立,不等于「兼容性通过」。真正的验收仍然是第九节那张表。
二、测试台(可复跑)
h5-rig/
├── index.html # 三段式:HUD / 正文滚动区 / 选项区 + 固定广告底栏 + 横屏遮罩
├── style.css # 含 100vh→100dvh 兜底、安全区 padding、48px 热区
├── app.js # 最小闭环:事件→选择→推进;每次选择静默落盘;注册 SW
├── sw.js # 离线壳,预缓存 5 个文件
├── selftest.js # 页内自检器:12 项判定,全部基于几何与命中测试(竖屏执行 11 项)
├── h5_probe.mjs # CDP 驱动:15 机型 × 自检 + 阴性对照 + 断网 + 存档 + 切后台
└── out/ # compat.json + 17 张截图(15 机型 + 阴性对照 + 断网态)+ contact-sheet.png
复跑:
cd h5-rig && (python3 -m http.server 4399 --bind 127.0.0.1 &) ; sleep 1
node h5_probe.mjs http://127.0.0.1:4399/ ./out
pkill -f "http.server 4399"
服务必须与探针写在同一条命令里(跨命令起的后台进程会被回收,Chrome 会截到 refused to connect 错误页)。
三、设备矩阵结果
| 机型 | CSS 尺寸 | DPR | 正文区容量 | 长文滚动 | 正文可见比 | 对比度 | 选项热区 | 判定 |
|---|---|---|---|---|---|---|---|---|
| 320-se1 | 320×568 | 2 | 10 行 | 0.5 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 320-se1-stress | 320×568 | 2 | 10 行 | 1.4 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 280-fold-closed | 280×653 | 2.625 | 13 行 | 0.5 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 280-fold-closed-stress | 280×653 | 2.625 | 12 行 | 1.3 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 360-redmi9a | 360×640 | 2 | 12 行 | 0.3 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 360-android-mid | 360×800 | 3 | 18 行 | 0.2 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 375-iphone8 | 375×667 | 2 | 13 行 | 0.3 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 375-13mini | 375×812 | 3 | 18 行 | 0.2 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 390-iphone14 | 390×844 | 3 | 20 行 | 0.2 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 393-15pro | 393×852 | 3 | 20 行 | 0.2 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 412-android-big | 412×915 | 2.625 | 22 行 | 0.2 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 430-15promax | 430×932 | 3 | 23 行 | 0.2 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| 744-ipadmini | 744×1133 | 2 | 30 行 | 0.1 屏 | 1.00 | 15.55:1 | 48px | ✅ |
| landscape-844x390 | 844×390 | 3 | — | — | — | — | — | 横屏阻截生效 |
| landscape-800x360 | 800×360 | 3 | — | — | — | — | — | 横屏阻截生效 |
六联对比图:
h5-rig/out/contact-sheet.png(280 外屏 / 320 常规 / 320 长文 / 390 主流 / 横屏阻截 / 阴反对照)
三行读法:
- 小屏不是瓶颈,横屏才是。 320 宽仍有 10 行容量(约 180 字),而横屏 800×360 只剩 79px = 2 行—— HUD 41px + 三个选项 168px + 广告底栏 56px 把 360 的高度吃光了。这不是「再挤一挤」能解决的,见第七节。
- 237 字的长事件在 320 宽要滚 1.4 屏。 滚动本身正常,但截图里正文被裁在「怀里那半块干粮硬得」这样 半句中间,页面上没有任何「还有下文」的提示 —— 这正是竞品评论「下面文字全挡住了」的一种真实形态。
- 三个无争议项:热区恒 48px、正文对比度 15.55:1(远超 AA 4.5)、系统 200% 字体缩放下横向溢出 0px。