Tempusxr English
Menu
  1. Documentation
  2. 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