fix(ui): Overlay 画布指针命中未消费排序脏标记,帧间修改 sortOrder 后存在过期窗口
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 之前处理时,会按旧顺序命中。
触发场景(规范使用方式内即可触发)
- 同帧多指:
PointerManager._firePointerScript()按指针循环处理。指 A 的onPointerDown回调修改某画布sortOrder后,指 B 的processRaycast在同一帧 render 之前执行,读到的是旧顺序; - 首帧: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
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de galacean/engine
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 64/100
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
Los mantenedores suelen responder en 1 día
-
Dificultad 4/5 3-5 días Aptitud para principiantes 52/100
Los mantenedores suelen responder en 1 día
-
RFC: Adopt Unity-style Collider components and hierarchical Rigidbody ownershipPosiblemente ocupada Un pull request vinculado a esta issue está abierto o ya se fusionó. Abierto
Dificultad 5/5 Más de una semana Aptitud para principiantes 20/100
Los mantenedores suelen responder en 1 día
-
SkinnedMeshRenderer should derive default rootBone-space localBounds from mesh and skinPosiblemente ocupada Un pull request vinculado a esta issue está abierto o ya se fusionó. Abiertoenhancement
Dificultad 4/5 3-5 días Aptitud para principiantes 42/100
Los mantenedores suelen responder en 1 día
Todos los issues de galacean/engine
Issues similares
-
bug impact:low Team: SecuritySolution Team:Defend Workflows v9.6.0
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
elastic/kibana#306401 · 3 comentarios ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
agentes-chat/agentes-chat#927 ·
Los mantenedores suelen responder en 1 día
-
[Bug]: Webapp workspace fails to render in Safari — "Can't find variable: requestIdleCallback"Abiertocomp/desktop P2 type/bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
NousResearch/hermes-agent#157702 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
Los mantenedores suelen responder en 1 día
-
e2e-failure ready-to-code
Dificultad 1/5 Menos de una hora Aptitud para principiantes 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · 1 comentario ·
Los mantenedores suelen responder en 1 día