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

The representation of the current state of an Anchor.

Public companion functions
AnchorCreateResult
create(session: Session, pose: Pose)

Creates and attaches an Anchor at the given pose.
List<UUID>

Retrieves all the UUID instances from Anchor objects that have been persisted by persist that are still present in the local storage.
AnchorCreateResult
load(session: Session, uuid: UUID)

Loads an Anchor from local storage, using the given uuid.
Unit
unpersist(session: Session, uuid: UUID)

Deletes a persisted Anchor denoted by uuid from local storage.

Public functions
Unit

Detaches this anchor.
open operator Boolean
equals(other: Any?)
open Int
suspend UUID

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

Public properties
StateFlow<Anchor.State>

The current State of this anchor.

Extension functions
ListenableFuture<UUID>

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

Extension properties
Flowable<Anchor.State>

The current State of this anchor.

Public companion functions

create

Added in 1.0.0-alpha05
fun create(session: Session, pose: Pose): AnchorCreateResult

Creates and attaches an Anchor at the given pose.

Parameters
session: Session

the Session that is used to create the anchor.
pose: Pose

the Pose that describes the location and orientation of the anchor.
Returns
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.

getPersistedAnchorUuids

Added in 1.0.0-alpha05
fun getPersistedAnchorUuids(session: Session): List<UUID>

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.

load

Added in 1.0.0-alpha05
fun load(session: Session, uuid: UUID): AnchorCreateResult

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.

unpersist

Added in 1.0.0-alpha05
fun unpersist(session: Session, uuid: UUID): Unit

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.

Public functions

detach

Added in 1.0.0-alpha05
fun detach(): Unit

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

equals

open operator fun equals(other: Any?): Boolean

hashCode

open fun hashCode(): Int

persist

suspend fun persist(): UUID

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

Returns
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).

Public properties

state

Added in 1.0.0-alpha05
val state: StateFlow<Anchor.State>

The current State of this anchor.

Extension functions

persistAsync

fun Anchor.persistAsync(session: Session): ListenableFuture<UUID>

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

Returns
ListenableFuture<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).

Extension properties

stateAsFlowable

val Anchor.stateAsFlowable: Flowable<Anchor.State>

The current State of this anchor.