Criar âncoras com o ARCore para o Jetpack XR

Dispositivos XR relevantes

Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.

Saiba mais sobre tipos de dispositivos XR →

Saiba mais sobre tipos de dispositivos XR →

Uma âncora descreve um local e uma orientação fixos no mundo real. Anexar um objeto a uma âncora ajuda os objetos a aparecerem de forma realista no mundo real.

Acessar uma sessão

Crie âncoras usando um ARCore para Jetpack XR Session. Se você estiver aprimorando a interface espacial usando o Jetpack Compose para XR, acesse uma sessão do Jetpack Compose para XR. Se você estiver trabalhando com entidades espacializadas da biblioteca Jetpack SceneCore, acesse uma sessão do Jetpack XR Runtime.

Configurar a sessão

A criação e o carregamento de âncoras não exigem que a sessão seja configurada. No entanto, a persistência de âncoras não é ativada por padrão em sessões XR. Para persistir e carregar âncoras do armazenamento local, configure a sessão e defina o AnchorPersistenceMode.LOCAL modo:

val newConfig = session.config.copy(
    anchorPersistence = AnchorPersistenceMode.LOCAL,
)
when (val result = session.configure(newConfig)) {
    is SessionConfigureSuccess -> TODO(/* Success! */)
    else ->
        TODO(/* The session could not be configured. See SessionConfigureResult for possible causes. */)
}
Anchors.kt

Fixar conteúdo de âncora em um local fixo no espaço

Uma âncora é criada usando um Pose, que pode ser interpretada em relação a um Anchorable existente ou não. Um Anchorable é um Trackable que pode ter âncoras anexadas a ele.

Criar uma âncora em relação a um Anchorable

Quando uma âncora é criada em relação a um Anchorable, como um Plane, ela faz com que a âncora siga o Anchorable anexado quando ele se move pelo espaço.

when (val result = anchorable.createAnchor(pose)) {
    is AnchorCreateSuccess -> { /* anchor stored in `result.anchor`. */ }
    else -> { /* handle failure */ }
}
Anchors.kt

Criar uma âncora sem um Anchorable

Para criar uma âncora que não esteja anexada a um Anchorable:

when (val result = Anchor.create(session, pose)) {
    is AnchorCreateSuccess -> { /* anchor stored in `result.anchor`. */ }
    else -> { /* handle failure */ }
}
Anchors.kt

Anexar uma entidade a uma âncora

Para renderizar um modelo nesse local, crie um GltfModel e defina o pai dele como um AnchorEntity.

AnchorEntity.create(session, anchor).apply {
    parent = session.scene.activitySpace
    addChild(entity)
}
Anchors.kt

Entender o TrackingState

Cada Trackable tem um TrackingState que precisa ser verificado antes de ser usado. Um Trackable que tem um TrackableState de Tracking tem a Pose ativamente atualizada pelo sistema. Um Trackable que é Paused pode se tornar Tracking no futuro, enquanto um que é Stopped nunca se tornará Tracking.

Persistir uma âncora em todas as sessões

Uma âncora que não é persistida desaparece depois que uma sessão é destruída. Ao persistir uma âncora, seu app lembra a posição dela nos dados privados do app. Essa âncora pode ser recuperada em uma sessão subsequente e é ancorada no mesmo local do mundo.

Para persistir uma âncora, use Anchor.persist(), conforme mostrado aqui:

val uuid = anchor.persist()
AnchorPersistence.kt

Seu app pode recuperar a âncora usando o UUID em uma sessão futura:

when (val result = Anchor.load(session, uuid)) {
    is AnchorCreateSuccess -> {
        // Loading was successful. The anchor is stored in result.anchor.
    }
    else -> {
        // handle failure
    }
}
AnchorPersistence.kt

Quando você não precisar mais de uma âncora, chame unpersist(). Isso remove a âncora do armazenamento do app e torna o UUID fornecido irrecuperável para chamadas para Anchor.load().

Anchor.unpersist(session, uuid)
AnchorPersistence.kt

Seu app também pode solicitar uma lista de todas as âncoras persistidas que ainda estão presentes no armazenamento do app:

val uuids = Anchor.getPersistedAnchorUuids(session)
AnchorPersistence.kt