Changements du SDK, des exemples et de la documentation, du plus récent au plus ancien.
SDKFormat de scène
Portails
Un portail est une porte qui montre un autre monde : une photo 360 ou une pièce en 3D. Posé au sol avec le suivi du monde, on peut le traverser, et le monde remplit l'écran jusqu'à ce qu'on ressorte. Dans un poster, c'est une fenêtre dans laquelle on regarde. Un fichier de scène le dit avec un nouvel asset portal (et "projection": "equirect" sur une image), et les comportements enter et exit disent quand on passe. Le format de scène reste v1 : les anciennes scènes se chargent comme avant. Cela marche dans A-Frame, Three.js et le Viewer, sans tampon stencil. Deux nouvelles expériences dans la bibliothèque : une porte sur le sol et une fenêtre dans un poster, avec un ciel CC0 de Poly Haven. Testé dans un navigateur et un téléphone RA émulé ; pas encore testé sur un vrai téléphone. Une nouvelle page : Guide du portail.
Docs
La documentation commence par l'installation
Le guide est réécrit pour un développeur qui n'a jamais vu le dépôt. Il commence par l'installation du SDK (trois balises script ou npm), une première expérience en cinq minutes avec une image d'exemple hébergée sur ce site, et un premier fichier de scène. Une nouvelle page : La console de test. Les parties du guide pour les personnes qui travaillent sur le SDK (comment il est construit, les commandes, les règles) passent dans une nouvelle section Contribuer, avec une page sur la publication du SDK. La page d'accueil montre d'abord les lignes d'installation.
SDKRelease
Bêta publique : npm et trois fichiers
Le SDK est prêt à devenir public, sans clé. Une page HTML simple demande trois fichiers : A-Frame (ou Three.js), Tempusxr et un traqueur (tempusxr-image, tempusxr-world). Ils sont servis depuis /v1/ avec un CORS ouvert, et depuis un dossier versionné qui ne change jamais. Les mêmes paquets sont prêts pour npm (@tempusxr/sdk-three, sdk-aframe, sdk-tracker-image et les autres), minifiés, avec leurs types et un fichier de licence. Le code est gratuit et n'est pas open source. Une nouvelle page, Installer le SDK, montre les trois voies.
SDKDocs
Chaque expérience de trois façons
Un fichier de scène tourne maintenant dans une page A-Frame avec tempusxr-scene="src: scene.json", à côté de loadScene pour Three.js. Chaque expérience de la bibliothèque en fichier de scène a une page A-Frame et une page Three.js, et la capture photo et vidéo marche sur les deux. Les expériences à qui il manquait une façon sont complétées : pages Three.js pour l'affiche avec vidéo, la carte de visite et le cadre de tableau ; pages A-Frame pour l'arbre dans un cadre et le plan vers la pièce ; fichiers de scène pour l'affiche avec vidéo, la carte de visite, et les exemples minimal, basique, plusieurs cibles et plusieurs pistes. Le cadre de tableau, l'arbre, le plan vers la pièce et les leçons sur les événements, l'interaction et l'interface perso restent en code seulement : ils construisent leurs formes en code, ce qu'un fichier de scène ne sait pas dire. Testé dans un navigateur ; pas encore testé sur téléphone.
SDK
Suivi du monde sur iPhone, en test
Safari sur iPhone n'a pas WebXR. Une page de suivi du monde ouverte sur un iPhone charge maintenant le script de Variant Launch, qui l'ouvre dans un App Clip. Le script n'est chargé que là : ni sur Android, ni sur ordinateur, ni pour le suivi d'images. Il reste à essayer sur un vrai iPhone : le lanceur annonce les tests de collision, les ancres et la superposition DOM, mais pas la détection de plans, la profondeur ni l'accès à la caméra.
SDK
Quitter la RA n'est pas une erreur
Revenir en arrière (le geste retour du système) pendant une expérience du monde affichait « Un problème est survenu (Camera ended) ». La fin de la session RA est maintenant comprise comme un départ : la session s'arrête, un écran dit « RA terminée », et Réessayer la relance. La session a un nouvel événement ended pour cela.
SDK
Boutons virtuels : moins de faux appuis
Testés sur téléphone, les boutons s'appuyaient tout seuls juste après la détection du poster, et une main au-dessus des deux zones pressait les deux. Une zone apprend maintenant l'impression pendant ses 0,7 premières secondes stables, ignore les lectures quand le poster bouge vite, et ne presse qu'une zone du poster à la fois (la plus couverte). Une zone compte comme couverte quand environ la moitié est cachée : le bout d'un doigt sur une partie suffit.
SDKDocs
Murs sans texture et console de test plus claire
Un mur que le téléphone ne voit pas a maintenant des replis. Le capteur de profondeur est utilisé sur un téléphone qui en a un. Après environ 4 secondes sans mur, 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. La console de test montre d'où vient la surface, et ses boutons Copy, Clear et Close sont en bas de l'écran. L'entrée de menu Technologies devient Fonctionnalités.
SDKRelease
Boutons virtuels
Des zones imprimées sur un poster qui réagissent à un doigt, comme les boutons virtuels de Vuforia. Une cible liste des buttons (un rectangle en fractions de l'image), et un comportement cover se déclenche quand un doigt en couvre un. Nouvelles actions forward et reverse : une animation jusqu'à sa fin ou en arrière. La bibliothèque d'expériences en a un premier : un vélo sur un poster avec des boutons imprimés Éclater et Normal, à côté du bouton 3D Éclater. Le bouton Test montre la lecture en direct de chaque zone.
SDKDocs
Mode test
Un bouton Test, activé par Test mode sur l'écran de départ (ou ?test dans l'adresse), ouvre une console sur l'expérience, en RA aussi. Elle montre ce que fait le SDK (fonctions WebXR accordées, nombre de résultats du test de surface et de plans, ce que la capture photo et vidéo lit de la caméra et de la couche 3D) avec les erreurs de la page, et Copy envoie tout dans le presse-papiers. Pensé pour tester sur téléphone, où il n'y a pas de console de développement.
DocsExemples
Le code de chaque expérience
Chaque carte de la bibliothèque d'expériences a maintenant une page Voir le code : le code de l'expérience séparé en fichiers comme vous les garderiez, HTML, CSS et JavaScript, avec un onglet par stack (A-Frame, Three.js) et un bouton Copier. Une expérience de scène montre d'abord son fichier de scène. Les pages en ligne gardent les trois dans un seul fichier : copier chaque partie dans son fichier donne la même page.
SDKRelease
Visionneuse de produit, points d'intérêt, murs et guidage du scan
L'expérience d'un produit qu'on tourne, qu'on éclate et qu'on pose dans sa pièce, et les étapes suivantes du suivi du monde.
Visionneuse de produit : une scène du monde avec un viewer s'ouvre dans une visionneuse 3D (tourner, zoomer), avec des points d'intérêt numérotés, un bouton Éclater et Voir en RA. Un téléphone sans RA garde la visionneuse.
Format de scène :viewer, size d'un nœud (mètres) et hotspots, controls (boutons), le déclencheur press et l'action toggle. Tout est optionnel, le format reste en v1. Les modèles à géométrie Draco se chargent.
Murs : une ancre dit surface: "wall" : l'anneau ne s'affiche que sur les murs, et le contenu fait face hors du mur, haut en haut.
Guidage du scan : une animation de téléphone qui balaie tant qu'aucune surface n'est trouvée, puis des points LED autour de l'anneau. Donnez votre animation avec scanHint.
Touchers en RA : points d'intérêt, boutons et comportements tap marchent en RA une fois tout placé, et ne déplacent jamais le contenu.
Expériences : la visionneuse de produit, des points d'intérêt à texte libre, des points d'intérêt sur une image, un tableau sur le mur et un composant 3D sur le mur, dans la bibliothèque d'expériences.
La bibliothèque d'expériences, les pages de technologies et un nouveau menu
Toutes les expériences au même endroit, et un menu qui suit ce que Tempusxr sait faire.
Bibliothèque d'expériences : une grille de cartes avec une image générée, un niveau (Basique, Moyen, Avancé), les fonctionnalités et un bouton par stack. Filtrez par stack (A-Frame, Three.js, fichier de scène), technologie, fonctionnalité et niveau. Les filtres sont dans l'adresse : une vue filtrée se partage.
Technologies : une page pour le suivi d'images et une pour le suivi du monde, avec leurs variantes en sections. Visage, main et corps ont déjà leur page et disent qu'ils sont prévus. Cylindre et marqueur rejoindront le suivi d'images.
Nouveau menu : Pour commencer, Construire avec le SDK, Technologies, Bibliothèque d'expériences, Outils, À propos de Tempusxr. Nouvelles pages : quels téléphones fonctionnent, ce qu'est Tempusxr, licences et mentions. Les anciennes adresses n'ont pas changé.
Un seul registre :examples/library.json alimente tout, et un test échoue quand un exemple en est absent.
L'image de la caméra dans les photos et vidéos prises en RA
Avec l'accès caméra de WebXR, une photo ou une vidéo prise en suivi du monde contient maintenant l'image réelle de la caméra sous le contenu 3D, comme pour le suivi d'images. L'image est lue à 1280 pixels au plus, seulement pendant la capture. Si le téléphone refuse l'accès caméra, le fichier contient le 3D seul, comme avant. Pas encore testé sur un vrai téléphone : vérifiez la fluidité pendant l'enregistrement. Lisez le suivi du monde.
SDKRelease
Suivi du monde (WebXR), sans image
Du contenu posé au sol ou sur une table, en taille réelle, depuis Chrome sur un téléphone Android avec ARCore.
SDK :WebXRProvider (la session RA, la pose de la caméra, le DOM overlay) et le tracker world dans @tempusxr/sdk-tracker-world : un anneau sur la surface devant la caméra, un toucher place l'ancre, et elle reste en place quand vous marchez autour. Anchor.space et TrackerAdapter.reticle sont nouveaux, optionnels pour l'ancien code.
Format de scène :"tracker": { "kind": "world", "anchors": [...] }, positions en mètres. loadScene et le Viewer l'ouvrent.
A-Frame :tracker: world, tempusxr-anchor et tempusxr-reticle, avec un bouton pour lancer la RA.
Tests : un téléphone RA émulé (IWER) avec un sol fait tourner la page Three.js, la page A-Frame et un fichier de scène dans les tests du navigateur.
Pas encore : l'iPhone, l'image de la caméra dans les photos et vidéos prises en RA (3D seule pour l'instant), le toucher sur le contenu en RA.
Les modèles peuvent porter des textures dans le format que le téléphone dessine directement : 4 à 8 fois moins de mémoire graphique. Les couleurs utilisent ETC1S, les cartes de normales UASTC. Un asset de modèle dit "compression": ["meshopt", "ktx2"], loadScene prend le dossier du transcodeur Basis (decoders.basisPath), et le Viewer le fournit. Un test fabrique un modèle KTX2 avec le vrai outil toktx et vérifie que le navigateur le dessine comme une texture compressée.
SDKRelease
Le Viewer, modèles plus légers, hébergement, et son et minuteur pour la capture
Le reste de la phase 3, en deux morceaux.
Le Viewer :view.tempusxr.com/{id} ouvre une expérience depuis un lien, avec un écran de chargement qui montre l'image de marque de la scène, un bouton Démarrer, et le déclencheur photo et vidéo. Pages introuvable et erreur, en français et en anglais. Essayez /demo.
Capture :le son de l'expérience est maintenant dans les vidéos (un test mesure une note dans le fichier), et un bouton Minuteur décompte 3 ou 10 secondes sur la caméra avant une photo ou une vidéo.
Un morceau de la phase 3 qui boucle le chemin d'une affiche jusqu'aux chiffres.
Statistiques de base : quatre événements, opened, found, tap et time, envoyés par lots avec loadScene(url, { analytics: { endpoint } }). Désactivées sans endpoint, aucun cookie, aucun stockage, un identifiant de visite aléatoire différent à chaque chargement, Do Not Track respecté.
On peut maintenant prendre une photo ou filmer une vidéo d'une expérience, et ce qui est enregistré est l'image réelle de la caméra et le contenu 3D ensemble. C'est optionnel : une page qui ne l'importe pas ne paie rien.
Three.js :enableCapture(ar) depuis le nouveau paquet @tempusxr/sdk-capture. A-Frame : deux balises script et tempusxr-capture="video: true".
Un déclencheur façon Snapchat : un grand bouton rond en bas au centre. Touchez pour une photo, maintenez pour une vidéo (un anneau rouge se remplit pendant la durée maximale), glissez vers le haut pour verrouiller l'enregistrement et avoir les mains libres. Puis un aperçu avec Partager, Enregistrer et Fermer. L'interface elle-même n'est pas dans l'image.
Résiste aux redémarrages : un enregistrement continue quand la caméra, le suivi ou toute la session redémarre, et marche avec les traqueurs où la plateforme possède l'image (suivi du monde, WebXR, pont iOS) grâce au nouveau drawBackdrop() facultatif d'un fournisseur de caméra.
Partage depuis un téléphone : la feuille de partage avec le fichier, MP4 sur iPhone, un téléchargement sur ordinateur. Rien n'est envoyé.
loadScene() dans @tempusxr/sdk-three transforme un fichier de scène en expérience de RA qui tourne, comme le Viewer l'ouvrira.
Un seul appel : elle lit et vérifie le fichier, charge les cibles et les assets (quatre à la fois, avec progression), construit le contenu, branche les comportements et attend un toucher pour démarrer, pour que le son et la vidéo marchent sur iPhone.
Cinq types d'assets : modèles GLB (avec animation), images, vidéos, audio et texte, placés en largeurs d'image et convertis en mètres quand une cible a une largeur imprimée.
Comportements : déclencheurs trouvé, perdu, chargement et toucher, avec les actions montrer, cacher, lire, pause et ouvrir un lien. Un toucher sur un nœud peut agir sur un autre.
Erreurs claires :invalid-scene (avec chaque problème), fetch-failed, asset-failed, tracker-unavailable, aborted.
Format de scène : un traqueur a maintenant maxTrack, un toucher peut nommer le nœud visé, et un lien ne s'ouvre que depuis un toucher, car les téléphones bloquent le reste.
Une scène est maintenant un format de fichier documenté et vérifié : la base du Viewer et du Studio.
Nouveau paquet @tempusxr/scene : le schéma, les types TypeScript, parseScene() et une chaîne de migrations, pour que les scènes faites aujourd'hui continuent de se charger.
Une scène, cinq types d'assets : modèles GLB, images, vidéos, audio et texte, posés sur des cibles image avec des déclencheurs (trouvé, perdu, toucher, chargement) et des actions (lire, pause, montrer, cacher, ouvrir un lien).
Des erreurs claires : tous les problèmes reviennent d'un coup avec un code stable et un chemin, prêts à être affichés en français ou en anglais.
De nouveaux exemples montrent les principales fonctions du suivi d'images, chacun en page A-Frame et en page Three.js, avec le code affiché dans la documentation.
Minimal, Basic, Multi-cibles, Multi-pistes, Interface personnalisée, Gestion des événements, Interactif. Ouvrez-les sur un téléphone et visez l'image avec la caméra.
Page du compilateur d'images : fabriquez un fichier .txr dans la documentation, avec une zone de dépôt, une note de qualité et un bouton de téléchargement. Il suit le choix jour ou nuit de la documentation.
Plan vers pièces utilise maintenant un vrai plan : chambres, salles de bain, cuisine, salon, salle à manger, porche et buanderie sortent du dessin, avec les meubles.
Bouton jour et nuit dans l'en-tête de la documentation, et le violet du logo comme couleur de la documentation.
DocsSite
Un centre d'aide pour la documentation, et les exemples en ligne
La documentation devient un centre d'aide : une page d'accueil avec recherche et sujets, une page par section du guide, et cette page pour les nouveautés. Tout le site (documentation, guides et exemples en direct) se construit dans un seul dossier que Vercel publie.
Recherche dans toutes les pages du guide et dans toutes les nouveautés. Touche / pour aller au champ de recherche.
Versions française et anglaise de chaque page, avec un bouton qui garde le même sujet.
Huit exemples en direct avec l'image à viser, pour essayer le SDK sur un téléphone sans rien cloner.
Une page pas à pas pour déployer le site sur Vercel (docs/deploy-vercel.md).
ReleaseSDK
Phases 1 et 2 terminées
Tout ce qui était prévu pour la caméra et le suivi d'images est maintenant dans le SDK.
Vérifications du téléphone :detectCapabilities() lit la plateforme, le navigateur, WebGL 2, WebAssembly, WebXR, la mémoire et les cœurs, et repère les téléphones faibles.
Écrans d'erreur : caméra bloquée, WebGL absent, fichier cible illisible, navigateurs intégrés (Instagram, Facebook, WhatsApp) : chacun a un écran clair avec les étapes pour le téléphone, un bouton Réessayer et un bouton Copier le lien. En français et en anglais.
Panneau de débogage : ajoutez ?debug à l'adresse pour voir les cadences, les saccades et les infos du téléphone.
A-Frame : la balise tempusxr-image-plane donne au plan les vraies proportions de l'image.
Caméra frontale : la vidéo et le canvas 3D sont inversés ensemble.
TensorFlow.js partagé : le traqueur et le compilateur chargent une seule copie.
Cinq exemples finis : carte de visite, affiche avec vidéo, cadre de tableau, arbre dans un cadre, et plan vers pièce.
Boutons de l'overlay : chaque bouton affiche son texte au chargement de la page, puis seulement le texte du bouton touché.
SDKOverlay
L'overlay : une rangée de boutons sur le côté
L'interface au-dessus de la caméra est du HTML simple que vous pouvez modifier. La caméra est toujours en plein écran, et l'overlay s'adapte à tous les écrans, du petit téléphone à l'ordinateur portable.
Une capsule de sept boutons ronds sur le bord droit.
Des emplacements modifiables (top-left, top-right, center, bottom) et des attributs data-tx-* pour montrer, cacher et lier du contenu.
Des boutons pour agrandir, tourner et repositionner le contenu collé à une image.
Messages, valeurs liées et actions personnalisées depuis le code.
FixA-Frame
Le contenu A-Frame reste sur son image
Sur téléphone, A-Frame tournait sa caméra avec le gyroscope, et le contenu 3D glissait hors de l'affiche. La caméra est maintenant bien trouvée, ses contrôles sont coupés et elle reste à l'origine à chaque image. A-Frame dessine aussi avec une densité de pixels limitée pour laisser du temps GPU au traqueur, et son bouton « entrer en VR » est caché.
ReleaseSDK
Suivi d'images et fichiers cibles `.txr` (phase 2)
Suivi de plusieurs images à la fois, sur iPhone, avec le fork MindAR derrière un seul adaptateur.
Le format de fichier cible .txr et un compilateur de cibles dans le navigateur avec une note de qualité.
Des couches Three.js et A-Frame sur le même cœur sans moteur.
Une pose plus douce : elle est filtrée en unités d'image, pas en unités de caméra.
Une image caméra de 640 par 480 par défaut : 35 à 61 poses par seconde sur un iPhone 12 Pro Max, contre 4 à 9 en 1280 par 720.
ReleaseSDK
Le fournisseur de caméra (phase 1)
WebCameraProvider démarre la caméra arrière ou frontale, mesure les images par seconde et s'arrête proprement. Premier résultat sur téléphone : un iPhone 12 Pro Max fait tourner les deux caméras en 720 par 1280, à 60 images par seconde.
Release
Les fondations (phase 0)
Un monorepo pnpm avec TypeScript en mode strict, ESLint et Prettier, des builds Vite du SDK en module ES et en fichier UMD, des tests Vitest et Playwright, un vérificateur de licences, l'intégration continue, un serveur HTTPS local pour tester sur téléphone, et le fork MindAR en sous-module épinglé.