- Documentation
- 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 :
- Le test de collision, qui répond aussi avec des points caractéristiques.
- Les plans verticaux trouvés par le téléphone.
- Le capteur de profondeur, sur un téléphone qui en a un (
depth-sensing).loadScenele demande quand une scène a un mur. - 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" }]
}
sizeest le plus grand côté d'un modèle en mètres : il arrive en taille réelle quelles que soient les unités du fichier.- Les points d'intérêt sont des points numérotés avec un titre et un texte libre. Un toucher ouvre l'étiquette, un toucher ailleurs la ferme, et un point de l'autre côté du modèle se cache. La position est dans l'espace du nœud, en mètres quand
sizeest donné. Ils restent à leur point : ils ne suivent pas une pièce qui bouge dans une animation. - Les boutons (
controls) sont posés au-dessus de la caméra. Un comportementpresss'exécute quand on en appuie un, ettogglejoue une animation en avant, puis en arrière à l'appui suivant : le bouton Éclater. - Les modèles à géométrie Draco disent
"compression": ["draco"], et la page donnedecoders.dracoPath. - Les points d'intérêt marchent aussi sur une image : essayez avec
poster.png.
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
- iPhone : en test, avec Variant Launch. Safari n'a pas WebXR : une page du monde sur iPhone charge le script du lanceur, qui l'ouvre dans un App Clip avec ARKit derrière les mêmes appels WebXR. Seules les pages de suivi du monde le font (
examples/launch-ar.js) ; le suivi d'images reste dans Safari. Le lanceur annonce les tests de collision, les ancres et la superposition DOM, mais pas la détection de plans ni de profondeur : un mur repose sur le repli au toucher, et les photos et vidéos n'y ont pas l'image de la caméra. - Photo et vidéo : en RA, le navigateur dessine lui-même l'image de la caméra et la page ne peut pas la lire. Quand le téléphone accorde l'accès caméra de WebXR (Chrome sur Android le demande une fois), les photos et vidéos contiennent l'image de la caméra et le 3D ensemble, lue à 1280 pixels au plus. Si le téléphone refuse, elles contiennent le contenu 3D seul (une photo transparente). La lecture coûte de la vitesse : vérifiez la fluidité sur votre téléphone.
- Toucher sur le contenu (le comportement
tap) : disponible en RA une fois tout placé. Avant, le toucher place l'ancre. Les points d'intérêt et les boutons ne la placent jamais. - Tests : les tests du navigateur utilisent un téléphone RA émulé (IWER), le test sur un vrai téléphone est le vôtre.