Table of Contents

Exécuter rapidement l'exemple de projet du plug-in Mega pour mini-programme WeChat

Cet article explique comment exécuter rapidement l'exemple de projet du plug-in Mega pour mini-programme WeChat. Vous apprendrez comment :

  • Configurer l'environnement de développement de l'exemple de projet.
  • Exécuter certaines fonctionnalités de l'exemple : utiliser la localisation cloud Mega.

Avant de commencer

Confirmer que le mini-programme est sous entité d'entreprise

Important

Le plug-in Mega pour mini-programmes ne prend en charge que les entités d'entreprise. Les mini-programmes sous entité personnelle ne peuvent pas utiliser le plug-in Mega pour mini-programmes.

Vérifiez dans l'administration du mini-programme que Paramètres > Informations de base > Informations sur l'entité affiche Personne morale ou entreprise individuelle.

Comme les fonctionnalités Mega sont fournies sous forme de plug-in, vous devez disposer d'un mini-programme WeChat sous entité d'entreprise comme environnement hôte.

Même pour exécuter notre exemple de projet, vous devez configurer votre propre AppID de mini-programme WeChat pour pouvoir déboguer et prévisualiser dans l'outil de développement.

Télécharger l'exemple de projet

  1. Accédez à la page de téléchargement des outils de développement.

  2. Confirmez la politique de confidentialité d'EasyAR puis cliquez sur télécharger.

    Télécharger l'exemple

  3. Après le téléchargement, décompressez le fichier .zip localement.

Configurer l'exemple de projet

  1. Connectez-vous à l'outil de développement de mini-programme WeChat.

  2. Importez le projet exemple avec l'outil de développement.

    • Après avoir ouvert l'outil, cliquez sur le bouton d'importation, sélectionnez le répertoire local décompressé.

    Importation dans l'outil de développement

    Sélection du répertoire local

    • Vérifiez que l'AppID correspond à l'AppID renseigné lors de la demande de licence Mega, le mode de développement est mini-programme, cliquez sur Créer.
    Note

    Un AppID différent entraînera l'échec de la validation de la licence

    Options d'importation

  3. Configurez la licence Mega et les services cloud

    Ouvrez le fichier miniprogram/components/sample-data/easyar-settings.ts, renseignez les champs correspondants avec les informations de licence et de service préparées :

    • Licence Mega
    /** Votre licence Mega pour mini-programme */
export const EasyARLicenseKey: string = "";
    Comment obtenir une licence Mega pour WeChat Mini Program

    Dans le Centre de développement EasyAR, sélectionnez Mega WeChat Mini Program.

    Liste des licences

    La liste doit contenir la licence Mega pour WeChat Mini Program à utiliser. (Si aucune licence n'est disponible, vérifiez que votre compte est identique à celui utilisé pour créer la bibliothèque de localisation Mega).

    Cliquez sur le nom du mini-programme pour obtenir la licence Mega (copiez à droite, puis collez-la dans le fichier easyar-settings.ts comme valeur de EasyARLicenseKey). Vérifiez que l'AppID associé correspond exactement à celui de votre mini-programme.

    Détails de la licence


    • Clé API et Secret des services cloud
    /** Votre clé API et Secret des services cloud */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
    Comment obtenir la clé API et le Secret

    Dans le Centre de développement EasyAR, sélectionnez Clé API des services cloud.

    Si vous avez déjà créé une clé API et un Secret, copiez-les à droite puis collez-les dans easyar-settings.ts comme valeurs de EasyARAPIKey et EasyARAPISecret.

    Clé API des services cloud

    Si aucune clé n'existe, créez-en une :

    Allez dans Clé API des services cloud > Créer une clé API.

    Création d'une clé API

    Détails de création

    Saisissez le nom de l'application, sélectionnez les services cloud nécessaires : Mega Block et/ou Mega Landmark, cliquez sur OK.


    • ServerAddress et AppID des services cloud :
    /** ServerAddress et AppID de votre bibliothèque de localisation cloud Mega */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
    Comment obtenir le ServerAddress et l'AppID

    Dans le Centre de développement EasyAR, choisissez Localisation cloud Block, puis sélectionnez votre groupe de services de localisation cloud Mega.

    Sélection du groupe de services

    Sélectionnez votre bibliothèque de localisation cloud Mega :

    Sélection de la bibliothèque

    Obtenir les informations

    Cliquez sur Clé, récupérez l'AppID et le Server Address de la bibliothèque (copiez à droite, puis collez-les dans easyar-settings.ts comme valeurs de MegaTrackerAppID et MegaTrackerServerAddress).

Exécuter l'exemple sur appareil physique

  1. Cliquez sur le bouton de prévisualisation en temps réel dans la barre supérieure de l'outil de développement de mini-programme, et chargez-le sur le téléphone de développement en scannant le code QR.

    [!ATTENTION] Il est impossible de simuler directement l'exécution de composants xr-frame avec fonctionnalité AR dans l'outil de développement. Simulation d'exécution

    Chargement par code QR

    Note

    Lorsque vous exécutez le projet exemple pour la première fois dans l'outil de développement WeChat, si les autorisations du plugin n'ont pas encore été obtenues, l'outil affiche généralement une fenêtre contextuelle indiquant que le plugin n'est pas autorisé. Vous pouvez autoriser automatiquement via l'outil de développement WeChat, ou consulter le Processus d'intégration du plugin

  2. Cliquez sur EasyAR Mega Samples pour accéder à la scène AR du projet exemple.

    Entrée de l'échantillon

    Note

    Si vous ne parvenez pas à accéder à la scène AR du projet exemple, cela peut être dû au fait que l'appareil actuel ne prend pas en charge le composant d'algorithme visuel VisionKit de WeChat. Pour plus de détails, reportez-vous aux Limitations des modèles d'appareils.

  3. L'affichage à l'écran de EasyAR Session is initializing indique que la détection de plan WeChat est en cours d'initialisation.

    Astuce

    Assurez-vous de tester dans un environnement bien éclairé, en évitant les murs ou sols unis de grande surface.

    Pointez le téléphone vers le sol ou un autre plan et balancez-le régulièrement de gauche à droite pour accélérer ce processus.

    Initialisation

  4. Une fois l'initialisation terminée, tenez le téléphone verticalement pour que l'appareil photo capture une vue normale de la réalité. Lorsque le positionnement réussit, le mot Found apparaît dans les informations de débogage et l'indicateur d'état en bas à droite passe du blanc au vert.

    Positionnement

Étapes suivantes

Sujets connexes