Tempusxr English
Menu
  1. Documentation
  2. Fonctionnalités

Guide du suivi du monde

Le suivi du monde n'a besoin d'aucune image. Le téléphone trouve le sol ou une table, un anneau montre où ira le contenu, un toucher le place, et il reste là quand vous tournez autour. Les tailles sont en mètres : une boîte de 20 cm vaut 0.2.

Il tourne sur WebXR : il marche dans Chrome sur un téléphone Android avec ARCore. Safari sur iPhone n'a pas WebXR : l'iPhone demandera l'App Clip natif, plus tard. Ouvrez examples/world/ sur votre téléphone : son panneau dit ce que le téléphone sait faire.

Essayez : l'exemple A-Frame et l'exemple Three.js.

A-Frame

<script src="aframe.min.js"></script>
<script src="tempusxr-aframe.min.js"></script>
<script src="tempusxr-tracker-world.min.js"></script>

<a-scene tempusxr="tracker: world; anchors: spot">
  <a-entity tempusxr-anchor="index: 0">
    <a-box position="0 0.1 0" width="0.2" height="0.2" depth="0.2" color="#fecb02"></a-box>
  </a-entity>
  <a-entity tempusxr-reticle>
    <a-ring rotation="-90 0 0" radius-inner="0.06" radius-outer="0.075"></a-ring>
  </a-entity>
</a-scene>

Un bouton Lancer la réalité augmentée apparaît : WebXR ne peut démarrer que depuis un toucher. anchors: spot est placé par un toucher, anchors: spot:auto à la première surface trouvée. tempusxr-reticle est l'anneau.

Three.js

import { create } from '@tempusxr/sdk-three';
import { WebXRProvider } from '@tempusxr/sdk-core';
import '@tempusxr/sdk-tracker-world';

const container = document.getElementById('ar');
const ar = create({ container, camera: new WebXRProvider({ domOverlay: container }) });
const world = await ar.use('world', { anchors: [{ id: 'spot', placement: 'tap' }] });

ar.attach(world.anchors[0], box);   // la boîte apparaît quand l'ancre est placée
ar.attach(world.reticle, ring);     // l'anneau suit la surface devant la caméra
button.onclick = () => ar.start();  // depuis un toucher

Les boutons de l'overlay continuent de marcher en RA : le conteneur est le DOM overlay de la session RA.

Dans un fichier de scène

{ "tracker": { "kind": "world", "anchors": [{ "id": "spot", "placement": "tap" }] } }

Un nœud dit "anchor": "spot" comme pour une image. found part quand l'ancre est placée, lost quand le suivi est perdu : les comportements que vous connaissez marchent. loadScene dessine l'anneau et affiche une aide, et le Viewer ouvre une telle scène. Sur un téléphone sans RA, loadScene échoue avec le code unsupported et le Viewer dit d'ouvrir le lien sur un téléphone Android.

Les murs

Une ancre dit quelle surface elle veut : "surface": "floor" (par défaut), "wall" ou "any". L'anneau ne s'affiche que sur le bon type de surface. Sur un mur, le contenu fait face hors du mur et son haut reste en haut, comme un tableau accroché. Essayez un tableau sur le mur et un composant 3D sur le mur.

{ "tracker": { "kind": "world", "anchors": [{ "id": "wall", "placement": "tap", "surface": "wall" }] } }

Un mur peint sans texture ne donne presque rien à accrocher au téléphone, et Chrome sur Android peut ne signaler aucun plan vertical. Un mur est donc cherché dans cet ordre :

  1. Le test de collision, qui répond aussi avec des points caractéristiques.
  2. Les plans verticaux trouvés par le téléphone.
  3. Le capteur de profondeur, sur un téléphone qui en a un (depth-sensing). loadScene le demande quand une scène a un mur.
  4. Après environ 4 secondes sans mur, un repli : l'indication devient « Visez le mur et touchez pour placer ici », l'anneau flotte devant la caméra, et deux boutons le rapprochent ou l'éloignent. Un toucher y place le contenu, droit et face à vous. Le suivi du téléphone le garde en place, mais il n'est aussi précis que la distance choisie.

WorldTracker accepte wallFallback: false et depth: false pour couper les deux derniers, et expose surfaceSource ('hit-test', 'plane', 'depth', 'manual' ou 'none'), distance et setDistance(mètres) pour lire et déplacer l'anneau de repli. La console de test montre la source sur la ligne surface et le capteur sur la ligne depth.

Visionneuse de produit : visionneuse, points d'intérêt et boutons

Ajoutez un viewer au tracker et la personne voit d'abord le modèle dans une visionneuse 3D (tourner du doigt, zoomer à deux), avec un bouton Voir en RA. Un téléphone sans RA garde la visionneuse et affiche une courte note. Essayez.

{
  "tracker": { "kind": "world", "anchors": [{ "id": "spot" }], "viewer": { "background": "#e3e1e5" } },
  "assets": [{ "id": "bike", "type": "model", "src": "bike.glb", "compression": ["draco"] }],
  "nodes": [{
    "id": "bike-node", "asset": "bike", "anchor": "spot", "size": 1.7,
    "animation": { "clip": "Explosion View", "autoplay": false, "loop": false },
    "hotspots": [{ "id": "brake", "position": [-0.36, 0.41, 0.1], "title": "Frein à disque", "text": "200 mm" }]
  }],
  "controls": [{ "id": "explode", "type": "button", "label": "Éclater" }],
  "behaviors": [{ "on": "press", "control": "explode", "do": "toggle", "node": "bike-node" }]
}

Pendant que le téléphone cherche une surface

Un téléphone qui balaie le sol montre comment le bouger, jusqu'à ce qu'une surface soit trouvée. Puis une grille de points LED s'étend autour de l'anneau, jusqu'à ce que quelque chose soit placé. Donnez votre propre animation (un GIF ou un WebP animé) avec l'option scanHint de loadScene.

Limites