Trackable

public interface Trackable

Known Indirect Subclasses AugmentedFace, AugmentedImage, DepthPoint, Earth, InstantPlacementPoint, Plane, Point, StreetscapeGeometry AugmentedFace Describes a face detected by ARCore and provides methods to access additional center and face region poses as well as face mesh related data.  AugmentedImage Describes the current best knowledge of a real-world augmented image.  DepthPoint On supported devices, represents a depth image based HitResult returned by Frame.hitTest(float, float).  Earth A Trackable implementation representing the Earth.  InstantPlacementPoint Trackable Instant Placement point returned by Frame.hitTestInstantPlacement(float, float, float).  Plane Describes the current best knowledge of a real-world planar surface.  Point Represents a point in space that ARCore is tracking.  StreetscapeGeometry Defines geometry such as terrain, buildings, or other structures obtained from the Streetscape Geometry API.

A Trackable is something that ARCore can track and that Anchors can be attached to.

Public Methods

abstract Anchor	createAnchor(Pose pose) Creates an anchor that is attached to this trackable, using the given initial pose in the world coordinate space.
abstract Collection<Anchor>	getAnchors() Gets the Anchors attached to this trackable.
abstract TrackingState	getTrackingState() Gets the TrackingState of this Trackable.

Public Methods

public abstract Anchor createAnchor (Pose pose)

createAnchor

public abstract Anchor createAnchor(
  Pose pose
)

Creates an anchor that is attached to this trackable, using the given initial pose in the world coordinate space. The type of trackable will determine the semantics of attachment and how the anchor's pose will be updated to maintain this relationship. Note that the relative offset between the pose of multiple anchors attached to a trackable may adjust slightly over time as ARCore updates its model of the world.

Details
Parameters	pose
Throws	NotTrackingException if the trackable's tracking state was not TrackingState.TRACKING SessionPausedException if the session had been paused. ResourceExhaustedException if too many anchors exist. IllegalStateException if this trackable doesn't support anchors.

public abstract Collection<Anchor> getAnchors ()

getAnchors

public abstract Collection<Anchor> getAnchors()

Gets the Anchors attached to this trackable.

public abstract TrackingState getTrackingState ()

getTrackingState

public abstract TrackingState getTrackingState()

Gets the TrackingState of this Trackable.

Note: Starting in ARCore 1.12, changing the active camera config using Session.setCameraConfig(CameraConfig) may cause the tracking state on certain devices to become permanently PAUSED. For consistent behavior across all supported devices, release any previously created trackables when setting a new camera config.