Plane tracking

ARKit doesn't support plane subsumption (that is, one plane can't be included in another plane); there is no merge event. If two planes are determined to be separate parts of the same surface, one plane might be removed while the other expands to the explored surface.

ARKit provides boundary points for all its planes on iOS 11.3 and later.

The ARKit plane subsystem requires additional CPU resources and can be energy-intensive. Enabling both horizontal and vertical plane detection (available in iOS 11.3+) requires additional resources. Consider disabling plane detection when your app doesn't need it to save energy.

Setting the plane detection mode to PlaneDetectionMode.None is equivalent to calling Stop() on the subsystem.

For more information, refer to Plane detection.

Plane classifications

This package maps ARKit's ARPlaneAnchor.Classification to AR Foundation's PlaneClassifications.

Note

While AR Foundation allows XR providers to assign multiple classifications per plane, ARKit only assigns a single classification to any given plane.

Refer to the table below to understand the mapping between AR Foundation's classifications and ARKit's classifications:

AR Foundation label	ARKit label
Table	table
Couch
Seat	seat
Floor	floor
Ceiling	ceiling
WallFace	wall
WallArt
DoorFrame	door
WindowFrame	window
InvisibleWallFace
Other