Rapport de problème et retour d'information

Nous accordons une grande importance à vos retours, ils sont essentiels pour nous aider à améliorer les produits et services EasyAR Mega. Pour nous permettre d'identifier et de résoudre rapidement et précisément les problèmes que vous rencontrez, veuillez prendre quelques minutes pour lire ce guide avant de soumettre un rapport.

Nos coordonnées

Vous pouvez nous soumettre un rapport de problème via les canaux suivants :

• Communauté/forum officiel des développeurs - Recommandé pour les questions générales et les échanges communautaires.

  • Les utilisateurs chinois cliquent ici
  • Les autres utilisateurs cliquent ici

• Groupe WeChat d'entreprise - Convient aux utilisateurs professionnels nécessitant un support confidentiel ou plus formel.

  • Scannez le code QR ci-dessous pour rejoindre le groupe
    

• Autres coordonnées - En tant qu'option alternative.

  • Pour obtenir les coordonnées, cliquez ici

Éléments clés pour soumettre un rapport de haute qualité

Un rapport contenant les informations suivantes nous aidera grandement à reproduire et résoudre le problème. Plus les informations sont complètes, plus la résolution est rapide.

Liste de contrôle générique (nécessaire pour tous les problèmes)

1. Description claire du problème :

   • Quel était l'effet attendu ?
   • Que s'est-il réellement passé ? (par exemple : plantage de l'application, échec de localisation, dérive du contenu)
   • Fréquence du problème (reproductible à chaque fois/occasionnel) ? Dans quelles conditions se produit-il ?

2. Informations sur l'appareil et l'environnement :

   • Modèle de l'appareil : Par exemple, iPhone 14 Pro, Samsung Galaxy S23 Ultra, Apple Vision Pro.
   • Version du système d'exploitation : Par exemple, iOS 17.2, Android 14, visionOS 26.
   • Version du SDK EasyAR : Par exemple, EasyAR Sense Unity Plugin v4.6.0.
   • Environnement de test : Intérieur/Extérieur, conditions d'éclairage, environnement dynamique ou non.

3. Données EIF (preuve la plus importante) :

   • Veuillez impérativement fournir le fichier d'enregistrement EIF permettant de reproduire le problème.
   • Les données EIF contiennent toutes les informations des capteurs et des images au moment du problème, c'est notre outil de diagnostic le plus puissant. Consultez Enregistrement des données de simulation d'exécution pour savoir comment enregistrer.

4. Fichier de journal (Log) :

   • Veuillez fournir le journal complet de l'application au moment du problème.
   • Android : Sortie Logcat.
   • iOS : Journal Console.app ou sortie de la console Xcode.
   • Unity : Journal Console de l'éditeur Unity.
   • Mini-programme WeChat : Fichier de journal obtenu via session.dumpLog().

5. Enregistrement d'écran ou capture d'écran :

   • Un enregistrement vidéo de l'écran ou une capture d'écran haute définition au moment du problème, cela montre visuellement le phénomène décrit.
   • Des guides pour différents appareils sont disponibles : Enregistrement d'écran sur mobile, Enregistrement d'écran sur casque.

6. Informations sur la bibliothèque de localisation Mega

   • Les informations de diagnostic des blocs utilisés pour exporter l'application dans Unity / les informations de service de la bibliothèque de localisation Mega. Méthode d'exportation :
   • Développement Unity, version du plugin >= 4003
   • Développement Unity, version du plugin 4.7 - 4002
   • Développement de mini-programme

   

Liste supplémentaire pour des types de problèmes spécifiques

Pour un diagnostic plus précis, veuillez fournir les informations supplémentaires suivantes en fonction du type de problème :

A. Échec ou instabilité de la localisation

• Avez-vous déjà essayé de valider à l'emplacement identique en utilisant Mega Toolbox ou l'outil PC, et indiqué le résultat.
• Avez-vous vérifié que la carte chargée dans la bibliothèque de localisation correspond à l'espace physique actuel.
• Indiquez l'emplacement approximatif où le problème se produit (par exemple, atrium d'un centre commercial, entrée d'un site touristique).

B. Contenu non affiché

• Avez-vous fourni le résultat de la validation de la localisation à l'aide d'un outil externe.
• Avez-vous confirmé que le placement du contenu ou la logique du code ne pose pas de problème.
• S'il s'agit d'un problème de rendu, veuillez fournir une capture d'écran ou une description du modèle, du Shader ou de l'effet utilisé.

C. Sauts ou dérive du contenu

• Avez-vous indiqué le mode de déplacement de l'appareil (déplacement stable/rapide).
• Avez-vous décrit la texture et l'éclairage de l'environnement, et la présence éventuelle de zones de confusion extrêmement similaires.
• Avez-vous expliqué la logique de traitement de l'attitude dans l'application et confirmé le bon placement du contenu.

D. Problèmes de mini-programme WeChat

• Avez-vous fourni une capture d'écran montrant que l'utilisateur a activé les autorisations de service Mega dans WeChat.
• Avez-vous indiqué si le modèle de téléphone de l'utilisateur figure dans la liste officielle des appareils pris en charge par WeChat.
• Avez-vous fourni l'AppID du mini-programme et une description du scénario métier spécifique.

E. Problèmes de performance (ralentissements, consommation élevée)

• Avez-vous indiqué le modèle d'appareil sur lequel le problème se produit.
• Avez-vous fourni des informations sur l'utilisation du CPU/GPU ou la température de l'appareil pendant l'exécution de l'application (si possible).
• Avez-vous indiqué le niveau de complexité du contenu 3D (nombre de polygones des modèles, taille des textures).
• Avez-vous indiqué si une configuration multi-cartes est utilisée.

Utilisation de l'EasyAR Sense Unity Plugin pour exporter les informations de développement Unity

En particulier, pour le développement d'applications Mega sur la plateforme Unity, nous avons préparé un outil plus pratique pour générer les informations de retour. Les étapes détaillées sont les suivantes :

1. Ouvrez EasyAR > Sense > Question dans la barre de menus
   
2. Dans Question, fournissez les informations suivantes :

• Cochez l'environnement d'exécution (case unique), par exemple Android.
• Copiez les informations de l'appareil. Dans ARSession, définissez DiagnosticsController.DumpSession sur Log, copiez la sortie d'une frame et collez le résultat dans la zone d'informations de l'appareil.
  
• Cochez toutes les fonctionnalités EasyAR utilisées par votre application, sélection multiple possible.
• Assurez-vous d'avoir effectué les quatre vérifications de la page et coché les cases, il est recommandé de décrire comment reproduire le problème dans l'échantillon lors de la question.
• Cliquez sur la fonction de copie en haut à droite, cela termine la collecte des informations de développement Unity.
  

Suggestions pour le processus de soumission de rapport

1. Préparer les documents : Rassemblez EIF, journaux, captures/écrans d'enregistrement, informations de service, informations de développement, etc., selon la liste ci-dessus.
2. Rédiger le rapport : Décrivez clairement le problème et joignez tous les documents.
3. Soumettre : Soumettez le rapport via le canal de votre choix.
4. **Suivi