- Documentation
- Construire avec le SDK
Ouvrir une scène dans A-Frame
Un fichier de scène tourne dans une page A-Frame avec un seul attribut. C'est le même JSON que loadScene et le Viewer ouvrent, dessiné par la scène A-Frame de votre page. Vous écrivez du HTML, pas de JavaScript.
Un premier exemple
<script src="aframe.min.js"></script>
<script src="tempusxr-aframe.min.js"></script>
<script src="tempusxr-tracker-image.min.js"></script>
<script src="tempusxr-aframe-scene.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>
Chargez le script du traqueur dont la scène a besoin (image, world ou les deux), puis le script de scène en dernier. La page montre une ligne de chargement, puis un bouton Démarrer. Le toucher sur Démarrer permet au téléphone de lancer le son et la vidéo.
Essayez : ouvrez la page de scène A-Frame, ou donnez-lui votre fichier avec ?scene=votre.json.
L'attribut
| Propriété | Ce qu'elle fait |
|---|---|
src | L'adresse du fichier de scène. Par défaut scene.json. |
gate | Montre la ligne de chargement et le bouton Démarrer. Par défaut true. Avec false, l'expérience démarre dès qu'elle est chargée. |
dracoPath | Le dossier des fichiers du décodeur Draco, pour les modèles à géométrie Draco. |
basisPath | Le dossier des fichiers du transcodeur Basis, pour les modèles à textures KTX2. |
Ce que vous pouvez faire
Tout ce que dit le format de scène marche comme avec loadScene : modèles et animations, images, vidéos, son, texte, comportements, boutons, points d'intérêt, boutons virtuels, la visionneuse 3D d'une scène du monde et son bouton Voir en RA, et les murs. C'est la scène qui décide, pas la page.
Les photos et les vidéos marchent aussi. Ajoutez les scripts de capture et l'attribut tempusxr-capture :
<a-scene tempusxr-scene="src: scene.json" tempusxr-capture="video: true; microphone: true"></a-scene>
Événements et expérience
Sur l'élément <a-scene> :
tempusxr-scene-ready: la scène est chargée et rien n'a démarré.event.detailest l'expérience :start(),dispose(),scene,nodes(le groupe 3D de chaque nœud, par id),audio.tempusxr-scene-error: la scène n'a pas pu s'ouvrir.event.detail.error.codedit pourquoi (invalid-scene,fetch-failed,asset-failed,tracker-unavailable,unsupported).
Comment c'est construit
Le chargeur de scène est celui de loadScene, avec loadScene({ host }) qui lui donne la scène A-Frame au lieu d'une session Three.js à lui. Le script de scène utilise le Three.js qu'A-Frame porte déjà : rien n'est chargé deux fois. Les chargeurs glTF, Draco et KTX2 sont ceux d'A-Frame.
Un même fichier de scène donne donc trois pages : la page du Viewer, une page Three.js et une page A-Frame.