Partager via


Résolution des problèmes liés à World Locking Tools

Les problèmes ennuyeux seront signalés ici. En outre, voici une stratégie recommandée pour limiter les problèmes de verrouillage de monde.

Problèmes de verrouillage universel

Faible fréquence d’images

World Locking Tools ne devrait pas avoir d’impact significatif sur votre fréquence d’images. (Une exception est que les visualisations finiront par faire baisser votre taux d’images après que de nombreuses ancres aient été créées, mais les visualisations servent seulement aux diagnostics, et ne sont pas conçues pour être livrées avec votre application).

Si une chute de fréquence d’images survient après l’ajout de World Locking Tools à votre application, vérifiez vos journaux Unity. Cela signifie généralement qu’une exception est générée à plusieurs reprises.

Erreurs « DLL manquante »

Ces erreurs proviennent généralement de la DLL Frozen World Engine. Pour les résoudre, suivez les instructions de la documentation d’installation pour mettre à niveau le moteur FrozenWorld vers une version ultérieure. Le fait de suivre ces instructions sans changer le numéro de version répare l’installation.

Vous pouvez également effectuer l’installation avec MR Feature Tool. L’outil gère l’installation des dépendances pour vous.

Espace de nom ’FrozenWorld’ manquant

Erreurs semblables à ce qui suit (généralement beaucoup) :

Assets\WorldLocking.Engine\Plugin.cs(10,37): erreur CS0234 : Le type ou l’espace de noms ’FrozenWorld’ n’existe pas dans l’espace de noms ’Microsoft.MixedReality’ (est-ce qu’il manque une référence d’assembly ?)

La DLL FrozenWorld.Engine est manquante. Consultez Configuration de NuGet.

Vous pouvez également installer à l’aide de MR Feature Tool et faire en sorte que l’installation des dépendances soit gérée pour vous.

Cela ne marche pas.

Recherchez les erreurs et les exceptions dans les journaux Unity.

Confirmez que la caméra de votre scène est fixée à au moins un autre objet. Pour obtenir un exemple, consultez la configuration dans WorldLocking.Examples.WorldLockingPhysicsSample. Si vous effectuez une manipulation de caméra dynamique, vous devrez peut-être garder WorldLockingManager informé de la caméra actuelle. Consultez WorldLockingManager.AdjustmentFrame et WorldLockingManager.CameraParent.

Autres problèmes généraux avec Unity/la réalité augmentée

« DirectoryNotFoundException : impossible de trouver une partie du chemin d’accès »

Le chemin d’accès est devenu trop long. Voir l’explication plus complète ici.

Vous voyez une zone de message « Une opération distante prend plus de temps que prévu », puis le déploiement échoue

Vérifiez votre connexion USB. Un mauvais câble, un mauvais port ou l’absence d’IPOverUSB peuvent tous causer ce problème. Mais c’est probablement quelque part sur le chemin de communication entre votre PC et votre appareil.

Composants du SDK Windows manquants

Incohérence entre la version de Visual Studio indiquée dans Unity et la version de Visual Studio avec laquelle vous essayez de générer. Vérifiez les points suivants :

Unity > File > Build Settings > Visual Studio Version

Cela est particulièrement dangereux si vous réglez cette valeur sur Latest Installed et avez plusieurs versions de Visual Studio installées.

Sur HoloLens, l’application démarre comme une tablette, plutôt que comme une expérience de réalité augmentée.

Si vous visez la prise en charge intégrée de la réalité virtuelle d’Unity, également connue sous le nom de Legacy XR, alors vérifiez ce qui suit :

Unity > Project Settings > Player > XR Settings

Vous devez cocher la case Virtual Reality Supported et sélectionner Windows Mixed Reality dans Virtual Reality SDKs.

Si vous utilisez le kit SDK AR Subsystems / XR d’Unity, vérifiez que vous avez suivi toutes les étapes de notre article Multiplateforme utilisant le système de plug-in SDK XR d’Unity. Causes possibles du problème :

  • L’un des packages requis est manquant.
  • Le profil approprié n’a pas été défini sur l’objet MixedRealityToolkit (si vous utilisez MRTK).

Lorsque l’application est générée pour ARM sur HoloLens2, l’application s’arrête au démarrage, ARM64 fonctionne correctement

Problème connu.

Le correctif consiste à désactiver les tâches graphiques sous

Project Settings > Player > Other Settings > Graphics Jobs

ou simplement générer pour ARM64.

Ce problème a été résolu dans Unity 2019.4 et Unity 2020.3.

Voir aussi