- Documentation
- Outils
Le Viewer
Le Viewer ouvre une expérience depuis un lien : view.tempusxr.com/abc123. Il tourne sur le SDK. On scanne un QR code, on voit un écran de chargement à votre image, on touche Démarrer, et la caméra s'ouvre. Le déclencheur photo et vidéo est là, et les statistiques sont actives si vous donnez un endpoint.
Essayez : pnpm --filter @tempusxr/viewer dev, puis ouvrez /demo.
Comment il ouvre une expérience
- L'adresse donne l'identifiant :
/abc123. - Le Viewer récupère
{sceneBase}/abc123/scene.json(par défaut/s/abc123/scene.json). - L'écran de chargement montre l'image de marque de la scène (
meta.brand: nom, logo, couleur) et une barre de progression. Les parties lourdes (Three.js, le traqueur) se chargent maintenant, pas avant le premier affichage. - Un bouton Démarrer. Le toucher est ce qui permet au téléphone d'ouvrir la caméra et de jouer le son et la vidéo.
- L'expérience tourne, avec le déclencheur pour les photos et les vidéos.
Une scène qui n'existe pas affiche une page « introuvable ». Une scène non valide, ou un fichier qui ne se charge pas, affiche une erreur avec ce qui ne va pas et un bouton Réessayer. Le Viewer parle français ou anglais (?lang=fr, sinon la langue du téléphone).
Réglages
Définissez-les avant les scripts :
<script>
window.TEMPUSXR_VIEWER = {
sceneBase: 'https://cdn.tempusxr.com/s',
analyticsEndpoint: 'https://a.tempusxr.com/e',
};
</script>
Comment il est construit
Un petit site statique, apps/viewer : index.html est la page principale et ouvre une expérience, not-found.html est la page pour un identifiant qui n'existe pas. assets/js/common.js est partagé par toutes les pages (réglages, langue et textes, écrans de chargement et d'erreur), assets/js/utils.js contient les fonctions utilitaires partagées, et chaque page a son propre script (page-experience.js, page-not-found.js). Il est construit avec Vite. Sur Vercel, une réécriture envoie /{id} vers index.html.