public final class Anchor

An anchor describes a fixed location and orientation in the real world. To stay at a fixed location in physical space, the numerical description of this position may update as ARCore for XR updates its understanding of the physical world.

Summary

Nested types
public final class Anchor.State

The representation of the current state of an Anchor.

Public methods
static final @NonNull AnchorCreateResult
create(@NonNull Session session, @NonNull Pose pose)

Creates and attaches an Anchor at the given pose.
final void

Detaches this anchor.
boolean
equals(Object other)
static final @NonNull List<@NonNull UUID>

Retrieves all the UUID instances from Anchor objects that have been persisted by persist that are still present in the local storage.
final @NonNull StateFlow<@NonNull Anchor.State>

The current State of this anchor.
int
static final @NonNull AnchorCreateResult
load(@NonNull Session session, @NonNull UUID uuid)

Loads an Anchor from local storage, using the given uuid.
final @NonNull UUID

Stores this anchor in the application's local storage so that it can be shared across sessions.
static final void
unpersist(@NonNull Session session, @NonNull UUID uuid)

Deletes a persisted Anchor denoted by uuid from local storage.

Extension functions
final @NonNull ListenableFuture<@NonNull UUID>
GuavaAnchor.persistAsync(
    @NonNull Anchor receiver,
    @NonNull Session session
)

Stores this anchor in the application's local storage so that it can be shared across sessions.
final @NonNull Flowable<@NonNull Anchor.State>

The current State of this anchor.

Public methods

create

Added in 1.0.0-alpha05
public static final @NonNull AnchorCreateResult create(@NonNull Session session, @NonNull Pose pose)

Creates and attaches an Anchor at the given pose.

Parameters
@NonNull Session session

the Session that is used to create the anchor.
@NonNull Pose pose

the Pose that describes the location and orientation of the anchor.
Returns
@NonNull AnchorCreateResult

a subtype of AnchorCreateResult based on the result of the operation. If the operation is successful, the result will be of type AnchorCreateSuccess with the created Anchor as its property.

detach

Added in 1.0.0-alpha05
public final void detach()

Detaches this anchor. This anchor will no longer be updated or tracked.

equals

public boolean equals(Object other)

getPersistedAnchorUuids

Added in 1.0.0-alpha05
public static final @NonNull List<@NonNull UUID> getPersistedAnchorUuids(@NonNull Session session)

Retrieves all the UUID instances from Anchor objects that have been persisted by persist that are still present in the local storage.

Throws
kotlin.IllegalStateException

if Session.config is set to Config.AnchorPersistenceMode.DISABLED.

getState

Added in 1.0.0-alpha05
public final @NonNull StateFlow<@NonNull Anchor.State> getState()

The current State of this anchor.

hashCode

public int hashCode()

load

Added in 1.0.0-alpha05
public static final @NonNull AnchorCreateResult load(@NonNull Session session, @NonNull UUID uuid)

Loads an Anchor from local storage, using the given uuid. The anchor will attempt to be attached in the same physical location as the anchor that was previously persisted. The uuid should be the return value of a previous call to persist.

Throws
kotlin.IllegalStateException

if Session.config is set to Config.AnchorPersistenceMode.DISABLED.

persist

public final @NonNull UUID persist()

Stores this anchor in the application's local storage so that it can be shared across sessions.

Returns
@NonNull UUID

the UUID that uniquely identifies this anchor.
Throws
kotlin.IllegalStateException

if Session.config is set to Config.AnchorPersistenceMode.DISABLED, or if there was an unexpected error persisting the anchor (e.g. ran out of memory).

unpersist

Added in 1.0.0-alpha05
public static final void unpersist(@NonNull Session session, @NonNull UUID uuid)

Deletes a persisted Anchor denoted by uuid from local storage.

Throws
kotlin.IllegalStateException

if Session.config is set to Config.AnchorPersistenceMode.DISABLED or the provided uuid is invalid.

Extension functions

GuavaAnchor.persistAsync

public final @NonNull ListenableFuture<@NonNull UUID> GuavaAnchor.persistAsync(
    @NonNull Anchor receiver,
    @NonNull Session session
)

Stores this anchor in the application's local storage so that it can be shared across sessions.

Returns
@NonNull ListenableFuture<@NonNull UUID>

a ListenableFuture that returns a UUID that uniquely identifies this anchor.
Throws
kotlin.IllegalStateException

if Session.config is set to Config.AnchorPersistenceMode.DISABLED, or if there was an unexpected error persisting the anchor (e.g. ran out of memory).

RxJava3AnchorKt.getStateAsFlowable

public final @NonNull Flowable<@NonNull Anchor.State> RxJava3AnchorKt.getStateAsFlowable(@NonNull Anchor receiver)

The current State of this anchor.