Criar âncoras com o ARCore para o Jetpack XR

Dispositivos XR aplicáveis

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

Saiba mais sobre os tipos de dispositivos XR →

Saiba mais sobre os tipos de dispositivos XR →

Uma âncora descreve um local e uma orientação fixos no mundo real. Anexar um objeto a uma âncora ajuda a fazer com que os objetos pareçam colocados de forma realista no mundo real.

Acessar uma sessão

Crie âncoras usando um Session do ARCore para Jetpack XR. Se você estiver melhorando 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

Não é necessário configurar a sessão para criar e carregar âncoras. No entanto, a persistência de âncoras não está ativada por padrão em sessões de XR. Para manter e carregar âncoras do armazenamento local, configure a sessão e defina o modo AnchorPersistenceMode.LOCAL:

val newConfig = session.config.copy(
    anchorPersistence = Config.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

Ancorar conteúdo em um local fixo no espaço

Uma âncora é criada usando um Pose, que pode ser interpretado em relação a um Trackable existente ou não.

Criar uma âncora relativa a um Trackable

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

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

Criar uma âncora sem um rastreável

Para criar uma âncora que não está anexada a um Trackable:

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 parent como um AnchorEntity.

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

Entender TrackingState

Cada Trackable tem um TrackingState que precisa ser verificado antes do uso. Um Trackable com um TrackableState de Tracking tem o Pose atualizado ativamente pelo sistema. Um Trackable Paused pode se tornar Tracking no futuro, enquanto um Stopped nunca vai se tornar Tracking.

Manter uma âncora em todas as sessões

Uma âncora não persistente desaparece depois que uma sessão é destruída. Ao persistir uma âncora, o 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 manter 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 especificado irrecuperável para chamadas a 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