Tempusxr English
Menu
  1. Documentation
  2. Construire avec le SDK

L'interface au-dessus de la caméra (overlay)

La caméra remplit toujours l'écran. Au-dessus se trouve du HTML simple que vous pouvez modifier, compléter ou remplacer. Il s'adapte aux téléphones, tablettes et ordinateurs, en portrait et en paysage.

L'interface intégrée a une capsule de sept boutons-icônes à droite (info, recharger, partager, agrandir, repositionner, tourner, quitter), une consigne « pointez la caméra vers l'image », une ligne de message et un panneau d'information. Libellés : au chargement de la page, chaque bouton affiche son texte pour qu'on comprenne à quoi il sert (environ cinq secondes, ou jusqu'au premier toucher) ; un toucher affiche ensuite le texte de ce bouton un instant, et avec une souris un libellé s'affiche au survol. Choix avec buttonLabels: 'intro' | 'always' | 'never' (introMs, tapLabelMs règlent les durées). Agrandir fait passer le contenu par 1x, 1,5x, 2x, 0,5x. Tourner le fait pivoter d'un quart de tour dans le plan de l'image. Repositionner remet les deux à zéro.

Apportez la vôtre. Écrivez un bloc HTML avec la classe tx-overlay. Ses enfants directs vont dans des emplacements. Les attributs font le travail :

<div id="my-ui" class="tx-overlay">
  <div data-tx-slot="top-left">Score <b data-tx-bind="score">0</b></div>
  <div data-tx-slot="center" data-tx-show="scanning">Trouvez l'affiche</div>
  <div data-tx-slot="bottom">
    <button class="tx-cta" data-tx-show="found" data-tx-action="play">Jouer</button>
  </div>
</div>
AttributRôle
data-tx-slot="top-left, top-right, center, bottom"Où va le bloc.
data-tx-action="info, close, share, reload, exit, fullscreen, scale, rotate, reposition"Un bouton intégré. Tout autre nom est le vôtre : le clic est signalé.
data-tx-show="loading scanning found lost error"L'élément n'est visible que dans ces états.
data-tx-bind="nom"Texte rempli par overlay.set('nom', valeur). message affiche les textes de chargement et d'erreur.
data-tx-modal="info"Un panneau ouvert par data-tx-action="info" ou overlay.open('info').

Pour l'utiliser : A-Frame tempusxr="overlay: #my-ui", Three.js create({ overlay: document.getElementById('my-ui') }). Depuis le code : overlay.toast('+50') (un texte flottant), overlay.set('score', 12), overlay.open('info'), overlay.on('action', handler).

Thème avec des variables CSS sur l'interface : --tx-accent, --tx-bg, --tx-rail-bg, --tx-danger, --tx-border, --tx-radius, --tx-font, --tx-text. L'exemple A-Frame contient une interface personnalisée prête : ouvrez-le avec ?ui=custom.