- Documentation
- Pour commencer
Votre premier fichier de scène
Un fichier de scène décrit toute une expérience en JSON : ce qu'il faut suivre, ce qu'il faut montrer dessus, et ce qui se passe quand on le regarde ou qu'on le touche. Vous n'écrivez aucun JavaScript. Le même fichier tourne dans A-Frame, dans Three.js et dans le Viewer.
1. Écrivez la scène
Enregistrez ceci sous scene.json. Elle suit l'affiche d'exemple, y écrit un titre, et y joue un clip.
{
"version": 1,
"id": "my-first-scene",
"tracker": {
"kind": "image",
"targets": [{ "id": "poster", "file": "https://tempusxr.vercel.app/starter/poster.txr" }]
},
"assets": [
{ "id": "clip", "type": "video", "src": "https://tempusxr.vercel.app/starter/clip.mp4", "loop": true },
{ "id": "title", "type": "text", "text": "Hello AR", "color": "#fecb02", "size": 0.1 }
],
"nodes": [
{ "id": "video", "asset": "clip", "anchor": "poster", "fit": "image", "position": [0, 0, 0.01] },
{ "id": "heading", "asset": "title", "anchor": "poster", "position": [0, 0.7, 0.05] }
],
"behaviors": [
{ "on": "found", "target": "poster", "do": "play", "node": "video" },
{ "on": "lost", "target": "poster", "do": "pause", "node": "video" },
{ "on": "tap", "node": "heading", "do": "openUrl", "url": "https://dreamxr.io" }
]
}
Les positions sont en largeurs d'image : 1 est la largeur de l'image, et +Z sort de l'image vers vous.
2. Écrivez la page
Avec A-Frame, un seul attribut ouvre la scène :
<script src="https://aframe.io/releases/1.8.0/aframe.min.js"></script>
<script src="https://tempusxr.vercel.app/v1/tempusxr-aframe.min.js"></script>
<script src="https://tempusxr.vercel.app/v1/tempusxr-image.min.js"></script>
<a-scene tempusxr-scene="src: scene.json" renderer="alpha: true" vr-mode-ui="enabled: false">
<a-camera look-controls="enabled: false" wasd-controls="enabled: false"></a-camera>
</a-scene>
La page affiche une ligne de chargement, puis un bouton Démarrer (un toucher permet au téléphone de lancer le son et la vidéo). Avec Three.js, c'est un seul appel, loadScene('scene.json', { container: '#ar' }) : voir Ouvrir une scène avec loadScene.
3. Mettez les deux fichiers en ligne et ouvrez la page sur un téléphone
Mettez index.html et scene.json dans un dossier sur n'importe quel hébergeur HTTPS (voir votre première expérience pour les moyens les plus rapides), ouvrez l'adresse sur le téléphone, autorisez la caméra, et visez https://tempusxr.vercel.app/starter/poster.png sur un autre écran.
Pour aller plus loin
- Remplacez le clip par un modèle 3D :
{ "id": "chair", "type": "model", "src": "chair.glb" }et un nœud avec"size": 0.5. - Ajoutez un bouton :
"controls": [{ "id": "go", "type": "button", "label": "Go" }]et un comportement{ "on": "press", "control": "go", "do": "openUrl", "url": "https://…" }. - Ouvrez la référence du Format de scène pour chaque champ, et la Bibliothèque d'expériences pour des scènes prêtes à copier.
- Une scène fausse n'est pas silencieuse : la page liste chaque problème avec sa place dans le fichier (par exemple
nodes[0].asset).