Skip to main content

Mise à jour des projets

Cibles d'image​

Si votre projet utilise des cibles d'image, vous devez les configurer au début de votre expérience.

Pour activer les cibles d'image, appelez XR8.XrController.configure avant tout autre code :

const onxrloaded = () => {
  XR8.XrController.configure({
    imageTargetData: [
      require('../image-targets/target1.json'),
      require('../image-targets/target2.json'),
    ],
  })
}
window.XR8 ? onxrloaded() : window.addEventListener('xrloaded', onxrloaded)
info

Les cibles chargées automatiquement auront une propriété "loadAutomatically" : true dans le fichier json.

Ensembles d'actifs​

Il peut être nécessaire de mettre à jour les références aux ensembles d'actifs. Les liasses d'actifs sont désormais des dossiers simples.

Par exemple, le projet d'exemple de terrain de jeu physique utilise un ensemble de ressources gLTF. Lors de la première exécution du projet, nous rencontrons une erreur de compilation :

Pour résoudre le problème, nous devons mettre à jour toutes les références afin de refléter l'emplacement et le nom corrects de l'actif.

Dans ce cas, nous devons mettre à jour le chemin gLTF de :

/assets/models/props/cannonball.gltf

à :

/assets/models/props/cannonball.gltf/Prop_CannonBall.gltf

Optimisation​

Si vous n'utilisez pas le moteur XR, vous pouvez supprimer la balise de script xr.js de l'index.html et supprimer le dossier external/xr/ pour économiser de la bande passante.

Si vous utilisez le moteur XR, vous pouvez également personnaliser le chargement de face, slam, ou les deux, sur l'attribut data-preload-chunks.