fix(ui): Overlay 画布指针命中未消费排序脏标记,帧间修改 sortOrder 后存在过期窗口

Abierto
#3,124 0 comentarios 0 reacciones 1 asignado Ver en GitHub

Los mantenedores suelen responder en 1 día

@cptbtptpbcptdtptp ya está trabajando en esto.

Desde el 28/9/2026.

Evaluación

Este issue todavía no se ha evaluado.

Descripción

问题

UIPointerEventEmitter.processRaycast() 的 Overlay 分支(packages/ui/src/input/UIPointerEventEmitter.ts)直接反向遍历 ComponentsManager._overlayCanvases,未先消费 _overlayCanvasesSortingDirty。

当前 sortOverlayUICanvases() 仅在 Engine._render()(packages/core/src/Engine.ts:614)内被调用,而 Engine.update() 中 _firePointerScript()(Engine.ts:363)先于 render 执行。因此指针命中使用的是上一次渲染时的画布顺序:帧间修改 sortOrder 后,下一次 pointer event 在本帧 render 之前处理时,会按旧顺序命中。

触发场景(规范使用方式内即可触发)

  1. 同帧多指:PointerManager._firePointerScript() 按指针循环处理。指 A 的 onPointerDown 回调修改某画布 sortOrder 后,指 B 的 processRaycast 在同一帧 render 之前执行,读到的是旧顺序;
  2. 首帧:raycast 早于第一次 render,addUICanvas 置位的 dirty 尚未被消费,命中按插入序而非 sortOrder。

窗口是瞬态的(下一次 render 后自愈),但多点触控场景真实可达。

建议方案

在 processRaycast() 读取 _overlayCanvases 前调用既有的 sortOverlayUICanvases():

       const componentsManager = scene._componentsManager;
       let canvasElements = componentsManager._overlayCanvases as DisorderedArray<UICanvas>;
+      // Consume pending overlay sorting before hit-testing (no-op when clean).
+      componentsManager.sortOverlayUICanvases();
       // Convert screen coordinates to overlay coordinates.
  • 脏标记为假时该调用是 no-op,无每帧开销;
  • 保持 ComponentsManager 作为排序 / dirty / _canvasIndex 的唯一 owner,不在 emitter 复制 comparator 或新增镜像状态;
  • 与非 Overlay 路径对齐:#3111 之后该路径已在 emitter 内按实时 sortOrder 排序,目前仅 Overlay 路径仍读上次 render 的缓存序。

测试建议

两块重叠的 ScreenSpaceOverlay 画布(sortOrder 分别为 1 和 2),完成一次排序后,将较低者的 sortOrder 改为 3,不经过 render 直接触发指针处理,断言命中目标为原较低画布(修复前会命中旧顶层)。

来源

PR #3115 review 中提出的 P1。该 PR 的拼写修复(_overlayCanvasesSortingFlag → _overlayCanvasesSortingDirty)已随 #3105 合入,但本问题未随之解决;#3111 修复的是非 Overlay 路径的命中顺序,不覆盖 Overlay。

Lenguaje dominante
TypeScript
Estrellas
5.9k
Forks
413
Merge medio
16 h 17 min
PR fusionados (30 d)
41

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de galacean/engine

Todos los issues de galacean/engine

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.