Instance Method


Searches for real-world objects or AR anchors in the captured camera image corresponding to a point in the SceneKit view.


func hitTest(_ point: CGPoint, types: ARHitTestResult.ResultType) -> [ARHitTestResult]



A point in the 2D coordinate system of the view.


The types of hit-test result to search for.

Return Value

A list of results, sorted from nearest to farthest (in distance from the camera).


Hit testing searches for real-world objects or surfaces detected through the AR session's processing of the camera image. A 2D point in the view's coordinate system can refer to any point along a 3D line that starts at the device camera and extends in a direction determined by the device orientation and camera projection. This method searches along that line, returning all objects that intersect it in order of distance from the camera.

The behavior of a hit test depends on which types you specify and the order you specify them in. For details, see ARHitTestResult and the various ARHitTestResult.ResultType options.

See Also

Finding Real-World Surfaces

func raycastQuery(from: CGPoint, allowing: ARRaycastQuery.Target, alignment: ARRaycastQuery.TargetAlignment) -> ARRaycastQuery?

Creates a raycast query that originates from a point on the view, aligned with the center of the camera's field of view.