Guide de dépannage pour les anomalies de maillage Mega

Dans le développement de l'application Mega, le placement des contenus virtuels s'effectue via un maillage (Mesh). La précision et l'apparence visuelle du modèle Mesh influencent la précision du positionnement des contenus virtuels, voire la qualité finale du positionnement Mega. Ce document décrit certains problèmes visuels et de précision potentiels liés aux modèles Mesh, vous aidant à identifier correctement les défauts du modèle et à signaler les problèmes critiques.

Qu'est-ce qu'un modèle Mesh

Le Mesh Mega est un modèle géométrique tridimensionnel reconstruit à partir des données d'environnement collectées. Sa fonction principale est de fournir une référence physique réelle aux contenus virtuels, permettant aux objets virtuels d'être correctement occultés par les murs, sols, meubles et autres éléments du monde réel, pour une expérience de fusion réalité-virtuelle plus authentique.

Le modèle Mesh Mega est reconstruit automatiquement par des algorithmes cloud à partir de vidéos capturées, et non modélisé manuellement avec précision. Il présente donc naturellement certaines imperfections.

Attentes correctes :

La couleur globale correspond globalement à l'environnement réel, avec des teintes correctes pour les grandes surfaces (murs, sols, objets principaux).
Les textures des structures principales sont reconnaissables (motifs de carrelage, papier peint, apparence d'objets exposés).
Le modèle offre une bonne fusion des lumières et couleurs en réalité augmentée (AR).

Des imperfections mineures sont tout à fait normales et courantes :

Dans les zones à éclairage complexe, la texture peut présenter des anomalies (trop sombre, trop claire, décolorée).
Les objets éloignés ou les zones périphériques peuvent avoir une texture légèrement floue ou étirée.
Mega fournit un modèle LOD (Level of Detail) ; des différences de couleur de texture peuvent exister entre les blocs LOD adjacents.
Aux jonctions entre différentes perspectives, de petites zones de texture peuvent être décalées ou présenter des coutures.
Les détails fins comme les textes ou panneaux peuvent manquer de netteté.
Les objets dynamiques (personnes, véhicules) peuvent laisser de légères traînées ou taches de couleur.
Les objets transparents/réfléchissants (verre, eau) peuvent présenter des manques de structure ou des affaissements.
Les murs ou sols ne sont pas parfaitement lisses, présentant de légères aspérités ou "pics".
Présence de petits trous dans le modèle.

Ces imperfections n'affectent généralement pas gravement l'expérience et relèvent des limites raisonnables de la reconstruction automatique. Aucun traitement particulier n'est requis.

Quelles anomalies de modèle nécessitent une intervention

Les situations suivantes constituent des défauts graves, impactant directement l'efficacité de l'application, et nécessitent attention et correction.

Type de problème	Manifestation typique	Impact potentiel
Manque ou trou important	Un mur entier (non réfléchissant/non transparent) est complètement absent du Mesh, empêchant l'occlusion correcte des objets virtuels.	Impossibilité d'obtenir une occlusion correcte dans cette zone.
Erreur structurelle majeure	Un mur entier reconstruit de travers, ou des dimensions de pièce gravement inexactes par rapport à la réalité.	Décalage des objets virtuels par rapport à l'environnement réel, occlusion gravement compromise.
Déformation ou inclinaison sévère	Sol visiblement incliné, mur tordu, position d'objets gravement décalée.	Positionnement erratique des contenus virtuels, occlusion anormale.
Bruit ou points parasites sévères	Présence de nombreux fragments flottants dans les airs.	Occlusion scintillante, baisse des performances.
Erreur complète dans une zone clé	Mesh complètement incorrect dans des zones d'interaction importantes (escaliers, présentoirs, etc.).	Échec des interactions utilisateur, expérience dégradée.
Modèle en couches (dédoublement)	Sol ou mur apparaissant en plusieurs couches superposées au même endroit.	Occlusion erronée, positionnement incorrect.
Couleur complètement erronée sur une grande surface	Textures de murs, sols, etc., affichant des couleurs étranges ou totalement incorrectes.	Environnement global irréaliste, incohérence visuelle.

Traitement et signalement des problèmes

Si vous rencontrez l'un de ces défauts graves de modèle, collectez les informations suivantes et signalez-les pour nous aider à identifier et résoudre rapidement le problème.

Collecte des informations nécessaires

Captures d'écran ou vidéo
- Captures d'écran : Au moins 3 prises sous différents angles, avec la zone problématique clairement indiquée.
- Vidéo : Enregistrez une vidéo de 10 à 30 secondes (via smartphone ou logiciel de capture d'écran) montrant la zone de Mesh anormale.
Description du problème

Lors du signalement, fournissez impérativement :
- Étendue du problème : Problème sur toute la carte ou seulement dans une zone locale spécifique.
- Type de carte : Mega propose différents modes de cartographie ; précisez le type concerné par le problème.
- Emplacement, zone du problème : Lieu précis où le problème survient. Ex: pour une carte unique : "Présentoir central du hall principal du musée, rez-de-chaussée". Pour une carte à grande échelle : indiquez quelles sous-cartes présentent un dédoublement à leur jonction (ex: "Dédoublement entre la partie ouest de la sous-carte A et la partie est de la sous-carte B").
- Description détaillée : En vous appuyant sur les captures/vidéos, décrivez précisément la zone affectée et le phénomène anormal. Pour les cartes multiples, nommez les sous-cartes concernées. Ex: "Mur ouest du couloir au 3ème étage du bâtiment bureau de la carte XX est incliné d'environ 15 degrés". Évitez les formulations vagues comme "le modèle est mauvais" ou "le Mesh est laid", qui retardent considérablement le traitement.
Informations sur la carte
- Rapport de cartographie : Fournissez le rapport de cartographie de la carte problématique depuis Mega Block.
- Informations du service de localisation : Exportables depuis Unity.

Soumission du signalement

Envoyez les captures/vidéos, la description du problème et les informations de carte au personnel EasyAR. Après analyse, nous vous informerons de la démarche à suivre.

Processus de traitement : Nous examinerons les données brutes de capture et les résultats de reconstruction cloud en fonction des éléments fournis.
Causes possibles : Changement environnemental pendant la capture, problème matériel, ou limitation de l'algorithme dans un scénario spécifique.
Si la capture n'est pas conforme : Nous évaluerons la nécessité d'une nouvelle capture ou d'une capture complémentaire de la zone, suivie d'une recartographie.
Si les données de capture sont normales : La méthode de reconstruction cloud pourrait présenter une insuffisance. Nous l'optimiserons dans une future version et vous proposerons une solution pour résoudre le problème.