Détecter des plans à l'aide d'ARCore pour Jetpack XR

ARCore pour Jetpack XR peut détecter les surfaces planes dans l'environnement de l'utilisateur et fournir des informations à leur sujet, comme leur position, leur taille et leur orientation. Cela peut aider votre application à trouver des surfaces comme des tables sur lesquelles placer des objets.

Créer une session ARCore pour Jetpack XR

Accédez aux informations sur les plans via une session ARCore pour Jetpack XR. Consultez Comprendre le cycle de vie d'une session pour obtenir un Session.

Configurer la session

La détection de plans n'est pas activée par défaut dans les sessions XR. Pour activer le suivi des plans, configurez la session et définissez le mode PlaneTrackingMode.HORIZONTAL_AND_VERTICAL :

val newConfig = session.config.copy(
    planeTracking = Config.PlaneTrackingMode.HORIZONTAL_AND_VERTICAL,
)
when (val result = session.configure(newConfig)) {
    is SessionConfigureConfigurationNotSupported ->
        TODO(/* Some combinations of configurations are not valid. Handle this failure case. */)
    is SessionConfigureSuccess -> TODO(/* Success! */)
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}
Planes.kt

Récupérer l'état des plans perçus

ARCore pour Jetpack XR fournit l'état des plans via un StateFlow qui émet l'état des plans. L'abonnement aux plans d'une session permet à votre application d'être avertie lorsque des plans sont ajoutés, mis à jour ou supprimés.

Plane.subscribe(session).collect { planes ->
    // Planes have changed; update plane rendering
}
Planes.kt

Un plan possède les propriétés suivantes :

• label : description sémantique d'un Plane donné. Il peut s'agir de WALL, FLOOR, CEILING ou TABLE.
• centerPose : pose du centre du plan détecté.
• extents : dimensions du plan détecté, en mètres.
• vertices : liste des sommets d'un polygone convexe qui approxime le plan.

Effectuer un test de positionnement sur des plans

Un test de positionnement est une méthode permettant de calculer l'intersection d'un rayon avec des objets suivis par la session. Une application courante d'un test de positionnement consiste à pointer sur une table et à placer un objet à cet emplacement. L'exécution d'un test de positionnement génère une liste d'objets touchés. En d'autres termes, un test de sélection ne s'arrête pas au premier objet touché. Toutefois, vous ne serez peut-être intéressé que par le premier objet touché d'un type donné.

Pour effectuer un test de positionnement, utilisez Interaction.hitTest() avec un Ray :

val results = androidx.xr.arcore.hitTest(session, ray)
// When interested in the first Table hit:
val tableHit = results.firstOrNull {
    val trackable = it.trackable
    trackable is Plane && trackable.state.value.label == Plane.Label.TABLE
}
Planes.kt