specs-world-query

Create a HitTestSession via WorldQueryModule.createHitTestSessionWithOptions, call start(), then invoke hitTest with ray start and end points. Use the result's position and normal to set the target object's world transform.

Enable Experimental APIs in project settings, set options.classification = true on HitTestSessionOptions, and check result.classification for SurfaceClassification.Ground in the hit test callback.

hitTest returns null when the ray falls outside the camera field of view, since the depth map only covers visible areas. It also returns nothing if session.start() was never called after creating the session.

WorldQueryModule provides fast lightweight surface placement at roughly 5Hz updates. Use DeviceTracking.hitTestWorldMesh for precise mesh raycasting, Physics.Probe.raycast for physics-based queries, or DepthTexture.sampleDepthAtPoint for raw depth at a UV point.

No. The depth computation updates at approximately 5Hz, making it suitable only for static or slow-moving surfaces like floors, walls, and tables, not for fast-moving objects.