Files
MapLibreParticleLab/docs/60_测试/STEP-055_Android真实WeatherV2风场综合可视化_人工验收指令_v7.md
OpenAI Codex f8e715d080
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled
fix: keep particle density stable across zoom
2026-09-05 12:23:15 +08:00

2.0 KiB
Raw Permalink Blame History

STEP-055 Android 真实 WeatherV2 风场综合可视化人工验收指令 v7

环境:Windows 11;设备 192.168.1.146。Android 构建、安装与设备操作由用户手工执行;Codex 未执行这些步骤。

cd platform\android
$env:RENDERER='opengl'; $env:BUILDTYPE='Debug'; make apackage --console=plain
adb -s 192.168.1.146 install -r <APK路径>
adb -s 192.168.1.146 logcat -c
adb -s 192.168.1.146 logcat | Select-String 'Particle(Density|Motion|Lifecycle|Trail|Timeline|GPU|StateTarget)'
  1. REAL WEATHER 自动 fit(z≈2–3):粒子持续可见、运动且自然分布;不得回到固定 world-length 粗短棍,也不应呈规则均匀点阵。
  2. z≈5:停止相机操作至少 150ms。确认 ParticleTrail: event=CAMERA_STABLE_RESUME 后出现一条 ParticleDensity mode=VIEWPORT_RESPAWN cameraStable=true margin=0.15;粒子密度应比 v8 明显改善。
  3. z≈8–9:不提高 particleCount 仍有足够可见粒子;不得有整批 reseed、大面积闪烁或高频越界 respawn。ParticleDensity 的 respawnBounds 必须位于 fieldBounds 内。
  4. 连续 pinch zoom/pan/rotate:交互期间 State 继续,ParticleTrail 只一次 CAMERA_INVALIDATE,不反复重建 texture;稳定后 resume 并启用 viewport respawn。不得出现 SIMULATION_RESET、Field resubmit 或 PARTICLE_COUNT_CHANGE。
  5. Timeline Pause:forecast cursor/mix 冻结,但 Particle simulation 和 wall-time lifecycle 继续;生命周期仍为 12 real seconds、hash jitter 9–15 seconds。
  6. TIME → PLAY 至 T3:继续确认 OLD_T1 → NEW_T0 reuse、only NEW_T1 upload、simulationRebuild=false、trailCleared=false。正常 forecast boundary 不得因 density 逻辑清 Trail。

若 ParticleDensity 显示 FIELD_FALLBACK,保留完整日志和相机状态;这是空/无效/过小交集的 fail-safe,不得通过提高 particleCount 或改回固定 streak 绕过。

所有 ADB 命令必须显式使用 adb -s 192.168.1.146 ...。