Table of Contents

Foire aux questions Mega

Rencontrer des problèmes pendant le développement est courant. Ce guide vise à vous aider à identifier et résoudre rapidement les problèmes les plus fréquents. Nous commençons par une liste de questions fréquemment posées (FAQ). Si vous ne trouvez pas de réponse ici, veuillez consulter les sections suivantes ou nous soumettre un rapport de problème.

Questions fréquemment posées (FAQ)

Voici quelques problèmes courants rencontrés par les développeurs lors de l'intégration et de l'utilisation d'EasyAR Mega, ainsi que leurs solutions.

Q : Pourquoi mon application indique-t-elle Invalid Key ?

R : Cela est généralement dû aux raisons suivantes :

  1. License invalide ou expirée
  2. La License ne correspond pas au Bundle ID / Package Name
  3. Les appareils de réalité virtuelle nécessitent une licence XR distincte
  4. Les fonctionnalités de caméra personnalisée nécessitent une licence officielle
Q : Pourquoi mon application affiche-t-elle un filigrane ?

R : Cela indique que vous utilisez une licence d'essai et non une version officielle.

Q : Pourquoi mon application affiche-t-elle un compte à rebours (timeout within * seconds) ?

R : Il s'agit d'une limitation pendant la période d'essai du produit. L'utilisation d'une licence officielle EasyAR Sense et du service EasyAR Mega officiel résout ce problème.

Q : Pourquoi mon application s'ouvre sur un écran noir ?

R : Dans ce cas, la cause de l'erreur est généralement indiquée dans les informations à l'écran ou dans les journaux. Vous pouvez résoudre le problème en fonction de la raison spécifique affichée par le système. Si vous ne parvenez pas à résoudre le problème, veuillez fournir des informations techniques (y compris les journaux, des captures d'écran, des informations détaillées sur l'appareil, etc.).

Q : Pourquoi mon application ne peut-elle pas se localiser, renvoyant toujours l'état NotFound ?

R : Cela est généralement dû aux raisons suivantes :

  1. Le service de localisation est en cours de démarrage :
    Le service de localisation n'a pas encore complètement chargé toutes les cartes Mega, il ne peut donc pas garantir une localisation réussie dans une zone donnée.
  2. Hors de la zone couverte par la carte :
    Assurez-vous que votre position physique actuelle se trouve dans la zone couverte par la carte Mega que vous avez chargée.
  3. Erreur de configuration du test de simulation :
    Ne fonctionne pas sur site, mais MegaLocationInputMode a été incorrectement défini sur Onsite.
  4. Conditions environnementales médiocres :
    Un éclairage extrême (trop sombre ou trop lumineux), de grandes surfaces murales ou au sol unies (comme un mur blanc, un sol poli) affectent la localisation visuelle.
Q : Pourquoi mon application ne peut-elle pas se localiser, renvoyant un état anormal ?

R : Cela est généralement dû aux raisons suivantes :

  1. Délai de requête dépassé :
    Le système renvoie alors RequestTimeout.
  2. Intervalle entre les requêtes trop court :
    Le système renvoie alors RequestIntervalTooLow.
  3. Autres erreurs anormales :
    Le système renvoie alors UnknownError. Généralement, ce type d'anomalie correspond à un échec lors de la connexion ou de la transmission, ou à une erreur du service Mega lui-même. Des détails peuvent être obtenus via l'interface MegaBlockLocalizationResponse.ErrorMessage.
Q : Pourquoi ma demande d'utilisation du plugin pour mini-programme a-t-elle échoué ?

R : Cela est dû au fait que les plugins de mini-programmes ne sont pas pris en charge en mode "visiteur" de l'outil de développement WeChat, ni sur les mini-programmes dont le sujet est une personne physique. Veuillez utiliser l'AppId d'un mini-programme WeChat dont le sujet est une entreprise pour faire la demande.

Q：Pourquoi mon mini-programme n'a-t-il pas été autorisé ?

R : Vous devez obtenir une licence de plugin de mini-programme Mega depuis le centre de développement et vous assurer que l'AppId que vous utilisez correspond à celui indiqué dans la licence.

Q：Pourquoi mon mini-programme ne fonctionne-t-il pas sur les téléphones XX ?

R : L'intégration de la dépendance Mega sur le mini-programme repose sur le composant VisionKit de WeChat. Consultez la documentation WeChat pour connaître les exigences système et la liste des appareils pris en charge.

Q：Le positionnement a réussi, mais la position du contenu virtuel semble décalée ou dériver ?

R : Les problèmes liés à l'effet de positionnement sont souvent complexes. Les causes possibles sont les suivantes :

  1. Problème de précision de la cartographie :
    La carte Mega de cette zone peut présenter des erreurs de précision intrinsèques. Cela se produit généralement lors de la phase d'acquisition ou de reconstruction de la carte. Contactez le service commercial pour confirmer.
  2. Saut lors de l'initialisation :
    Pendant les premières secondes du positionnement, la position peut légèrement sauter. Ceci est dû au système SLAM de l'appareil qui n'a pas encore terminé son initialisation, un processus particulièrement visible dans les mini-programmes WeChat (et qui peut même être assez long sur certains appareils).
  3. Changements dynamiques de l'environnement :
    Si l'environnement physique a subi des changements significatifs (comme le déplacement de grands éléments, l'ajout de panneaux d'exposition temporaires), cela peut entraîner une inadéquation entre la carte et la réalité. Dans ce cas, une mise à jour de la carte est nécessaire.
  4. Erreur système de l'appareil :
    Sur la plupart des appareils, après un fonctionnement continu prolongé, l'erreur cumulative du système SLAM peut provoquer une dérive.
  5. Problème d'erreur de positionnement :
    Le positionnement visuel comporte intrinsèquement une erreur de précision, qui n'affecte généralement pas l'expérience visuelle du contenu virtuel. Si l'erreur est suffisamment importante pour causer un décalage ou une dérive perceptibles, une analyse détaillée nécessitant des données spécifiques est alors requise pour la résolution. Reportez-vous à la méthode décrite dans Diagnostic et rapport de problèmes pour collecter les données et les transmettre.
Q：Comment collecter et utiliser les données EIF pour le débogage ?

R : Les données EIF sont un outil de débogage puissant. Reportez-vous aux chapitres suivants :

  • Comment collecter : Lisez Enregistrement des données de simulation d'exécution pour apprendre à enregistrer un fichier EIF sur un téléphone ou un casque.
  • Comment rejouer : Selon votre environnement de développement (Unity ou mini-programme WeChat), reportez-vous au guide de relecture correspondant dans ce chapitre.

Trouver une aide plus spécifique

Si la FAQ ci-dessus ne résout pas votre problème, vous pouvez consulter les pages thématiques suivantes pour des solutions plus approfondies :

Signaler un nouveau problème

Si vous rencontrez un problème non couvert ci-dessus, suspectant un bug du SDK ou de la plateforme elle-même, aidez-nous à améliorer notre produit. Pour des instructions détaillées, consultez : Signaler un problème.

Avant de soumettre un rapport, assurez-vous d'avoir préparé les informations suivantes, cela nous aidera grandement à résoudre le problème :

  1. Description du problème : Décrivez clairement le phénomène observé, sa fréquence et les étapes pour le reproduire.
  2. Informations sur l'appareil : Modèle de l'appareil, version du système d'exploitation, version du SDK EasyAR.
  3. Données EIF : Fournissez impérativement le fichier d'enregistrement EIF permettant de reproduire le problème. C'est la preuve diagnostique la plus importante.
  4. Fichiers journaux : Les journaux complets de l'application (sortie Logcat ou Console).
  5. Capture d'écran ou enregistrement vidéo : Capture d'écran ou enregistrement vidéo montrant le problème en cours.

Veuillez soumettre ces informations via le forum, l'e-mail ou votre contact commercial. Merci pour votre retour !