Files
MapLibreParticleLab/docs/60_测试/STEP-055_Android真实WeatherV2风场综合可视化_人工验收指令_v2.md
OpenAI Codex 6c7886b0c3
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled
fix: tune real weather particle rendering
2026-09-05 08:34:36 +08:00

3.3 KiB
Raw Permalink Blame History

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

状态:等待用户手工 Android 验收。Codex 不执行本文件中的 Gradle、APK、ADB 或设备操作。

Windows 11 构建、安装与日志

在 Windows 11 项目目录执行:

./gradlew :MapLibreAndroidTestApp:assembleOpenGLDebug --console=plain
adb -s 192.168.1.146 install -r <APK_PATH>
adb -s 192.168.1.146 logcat -c
adb -s 192.168.1.146 logcat | findstr /I "REAL_WEATHER GSI ParticleTuning ParticleMotion ParticleTimeline WINDOW_BOUNDARY FIELD_REUSE FIELD_UPLOAD DUPLICATE INVALID simulationRebuild trailCleared"

入口与默认画面

  1. 进入 Particle Core Layer Validation。
  2. 底栏应为 TIME | VIS | COUNT | MAP | REAL WEATHER | MORE;MORE 中不应再有 REAL WEATHER。
  3. 点击 REAL WEATHER。确认 GSI 日本及周边地图、半透明 WeatherColorLayer 和细密粒子共同出现,且日志有 REAL_WEATHER_COMPOSITE_READY ... basemap=GSI。
  4. HUD 应持续显示:P 2048 · W 0.75 · L 0.0040 · O 0.75 · T 0.55 · F 0.88。粒子应明显持续运动,而不是粗大橙色块状轨迹。

GSI tile 若网络不可用,记录 BASEMAP/GSI 错误即可;WeatherColorLayer、粒子、Timeline 不得因此黑屏或 crash。

调参、RESET 与暂停

再次点击已激活的 REAL WEATHER,确认仅打开/关闭 PARTICLE TUNING,不出现 STYLE_LOAD reason=REAL_WEATHER、不重新加载 Dataset 或提交 Host fields。使用各 -/+ 项分别改变 P/W/L/O/T/F:HUD 必须立刻显示实际生效值,且菜单关闭后仍显示。

  • P 可在 256、512、1024、2048、4096、8192、16384 间调整;允许只见 particle State/draw resources 重建。
  • W/L/O/T/F 调整不得产生 STYLE_LOAD、Field upload、Timeline reset、Runtime Window reset 或 Weather dataset reload。
  • RESET DEFAULT 后 HUD 恢复 P=2048、W=0.75、L=0.0040、O=0.75、T=0.55、F=0.88。
  • 不点 PLAY 或在 TIME → PAUSE 后,Timeline cursor/MIX 可冻结,但粒子仍应在当前固定风场运动。

Timeline、边界与地图交互

  1. TIME → PLAY / RESTART,确认 READY、PLAY、自动 MIX 和 T0→T3。
  2. 观察至少两次 production→production boundary:T0/T1→T1/T2→T2/T3。每次应有 FIELD_REUSE from=OLD_T1、只上传 NEW_T1、simulationRebuild=false、trailCleared=false。
  3. 检查每约 1 秒的 ParticleMotion:sampleU/sampleV 非零时,有 dt、visualSpeedScale=6000 和非零 estimatedStateDeltaWorld;此日志为 CPU 估算,不做持续 GPU readback。
  4. Pan、Zoom、Rotate,并进行 Activity Rotation:GSI、色场和粒子保持地理对齐;旋转后应自动恢复,无需点击按钮。

负向与保护检查

  • MORE → HOST DUPLICATE:当前 Host window 返回 NOOP,fieldUploadCount/simulationResetCount 无增量。
  • MORE → HOST INVALID:Adapter reject,保持最后有效 Field,Renderer/色场连续,无黑屏、无 crash。
  • 本次没有 Weather Service、HTTP、React Native 或 Jest;真实 WeatherV2 仍来自 Android asset。

保存日志中的 GSI、ParticleTuning、ParticleMotion、Timeline/Boundary、Duplicate/Invalid 片段及任何视觉问题。MIX 文字可能滞后、WAITING/INVALID 视觉不够明显仍是 NON-BLOCKING observability,应以 Core 日志判断。