- Documentation
- Outils
Héberger votre scène
Une scène est un dossier de fichiers : le scene.json, les fichiers cibles, et les modèles, images, vidéos et sons qu'il nomme. Mettez le dossier sur n'importe quel hébergeur statique (Vercel, Netlify, Cloudflare Pages, GitHub Pages ou R2) et ouvrez-le avec loadScene('https://votre-hote/scene.json') ou tempusxr-scene="src: https://votre-hote/scene.json".
Les fichiers
- Les chemins dans
scene.jsonsont relatifs au fichier de scène, ou des adresseshttpscomplètes. - Gardez le total léger : environ 2 Mo, c'est ce qui s'ouvre en 4 secondes en 4G. Réduisez les images à 2048 pixels au plus, et gardez les vidéos courtes.
- Nommez un fichier d'après son contenu si vous pouvez (
chair.3f9a1c2b.glb) : un nom qui ne change jamais pour le même contenu peut être mis en cache un an.
Les en-têtes
| Quoi | Règle | Pourquoi |
|---|---|---|
| Fichiers avec une empreinte dans le nom | Cache-Control: public, max-age=31536000, immutable | Ils ne changent jamais : le téléphone les garde. |
scene.json | Cache-Control: public, max-age=60, stale-while-revalidate=600 | Une mise à jour se voit en une minute. |
| Tout | Access-Control-Allow-Origin: *, Cross-Origin-Resource-Policy: cross-origin | WebGL refuse une texture ou une vidéo d'une autre adresse sans eux. |
| Tout | Accept-Ranges: bytes | Les vidéos démarrent avant d'être entièrement chargées. |
La plupart des hébergeurs envoient un CORS ouvert pour les fichiers statiques par défaut ; vérifiez le vôtre si une image ou une vidéo ne s'affiche pas. Sur Vercel, ajoutez les règles à vercel.json sous headers.
Vérifier
Ouvrez la page sur un téléphone avec ?test dans l'adresse : la console de test liste chaque fichier que la scène charge et ceux qui échouent. Une scène invalide liste chaque problème avec sa place dans le fichier.