Ajouter une target de suivi Mega

Cet article explique comment ajouter et configurer les targets de suivi Mega.

Avant de commencer

Vérifiez Puis-je déjà utiliser ma fonction de localisation ? pour confirmer que le dépôt de localisation a bien été créé et que la carte a été ajoutée.
Importez la dernière version du plugin EasyAR et activez Mega
Comprenez les concepts et l’usage de base de la target de suivi dans Unity AR

Note

Le contenu et les outils suivants s’appliquent uniquement au développement d’applications Unity avec EasyAR Mega.

Si vous développez un mini-programme, consultez Créer et publier une annotation avec Unity Editor (développement de mini-programme).

Si vous ne développez pas d’application Unity mais souhaitez visualiser les résultats de cartographie Mega, consultez Prévisualiser le maillage 3D réel dans le guide Mega.

Si vous ne développez pas d’application Unity mais souhaitez simuler l’exécution pour voir l’effet de localisation, consultez Aperçu des résultats de simulation dans le guide Mega.

Ce contenu suppose que les paquets Unity suivants ont déjà été importés dans le projet :

Version >= 4003
Version 4.7 - 4002

com.easyar.sense

Les targets de suivi Mega sont des objets vides contenant le composant MegaBlockController, qui représente un block dans Unity.

alt text

Note

Si le paquet com.easyar.mega n’est pas importé, les fonctions d’éditeur du block ne sont pas disponibles, mais cela n’affecte ni le résultat de suivi ni les fonctions à l’exécution.

Si la configuration n’active pas correctement la fonction Mega, elle ne sera pas disponible.

alt text

Créer une target de suivi

Version >= 4003
Version 4.7 - 4002

Dans la vue Hierarchy, faites un clic droit dans une zone vide, puis utilisez le menu EasyAR Sense > Mega > Target : Mega Block pour créer une target de suivi Mega.

alt text

Dans le script, vous pouvez utiliser ARSessionFactory.CreateController pour créer.

ARSessionFactory.CreateController<MegaBlockController>();

Ajouter une target de suivi dans l’éditeur

Pour utiliser cette méthode, il faut configurer BlockHolder.BlockRootSource sur External (par défaut) ou Mixed.

Il faut d’abord ajouter l’outil Block Viewer for Unity Developer.

Dans la vue Hierarchy, faites un clic droit dans une zone vide, puis utilisez le menu EasyAR Mega > Tool > Block Viewer for Unity Developer (Edit Mode) pour ajouter l’outil Block Viewer destiné au développement Unity.

Important

Pour développer une application Mega avec Unity, vous devez utiliser l’outil Block Viewer for Unity Developer. Les autres outils du menu EasyAR Mega > Tool ne conviennent pas au développement d’applications Unity.

Même si Annotation Tool offre aussi une fonction similaire, certaines parties de cet outil seront supprimées dans de futures versions, il n’est donc pas recommandé de l’utiliser.

La fonction d’annotation de Annotation Tool (uniquement l’annotation elle-même) va bientôt être migrée vers la page web du centre de développement EasyAR ; le chargement du block mesh et le placement du modèle ne sont pas affectés.

Une fois l’outil ajouté, un nœud EasyAR.Mega.BlockViewer (Dev) et un nœud MegaBlocks apparaissent dans la hiérarchie de la scène.

Utilisez ensuite l’outil pour générer la target de suivi.

Sélectionnez le nœud EasyAR.Mega.BlockViewer (Dev) et, dans le panneau Inspector, renseignez les informations de votre compte EasyAR puis connectez-vous ;

Cliquez sur le bouton situé à droite de Mega Cloud Service ;

Sélectionnez le Mega service de localisation à utiliser, puis cliquez sur Confirmer.

Après la sélection du service, la liste des blocks du dépôt courant s’affiche sous le nœud MegaBlocks et dans le panneau de l’outil.

Astuce

Pourquoi MegaBlocks est-il vide ?

Vérifiez Puis-je déjà utiliser ma fonction de localisation ? pour confirmer que le dépôt de localisation a bien été créé et que la carte a été ajoutée.

À ce stade, la target de suivi block a été générée. Chaque nœud enfant commençant par Block_ sous MegaBlocks représente une target de suivi block.
Ajouter automatiquement une target lors de la localisation réussie

Pour utiliser cette méthode, BlockHolder.BlockRootSource doit être configuré sur Internal ou Mixed.

Dans ces deux modes, si un nouveau block est localisé et que ce block n’existe pas sous le nœud BlockHolder.BlockRoot, ce nouveau block sera automatiquement ajouté sous ce nœud. Si BlockHolder.BlockRoot n’existe pas, il sera créé automatiquement.

Astuce

Lors de l’ajout automatique d’une target après localisation réussie, le modèle block ne peut pas être chargé ; seule la target de suivi block peut être ajoutée.
Ajouter une target dans le script

Pour utiliser cette méthode, BlockHolder.BlockRootSource doit être configuré sur Internal ou Mixed. Dans ce cas, si BlockHolder.BlockRoot n’existe pas, il sera créé automatiquement. Vous pouvez aussi définir à l’avance l’objet BlockHolder.BlockRoot dans l’éditeur lorsque BlockHolder.BlockRootSource est External.

Note

Si le block n’existe pas dans le dépôt de localisation, il ne pourra pas être localisé même s’il est ajouté dans la scène via le script.

Vous pouvez utiliser la méthode BlockHolder.Hold pour ajouter un nouveau block sous le nœud BlockHolder.BlockRoot. Cette méthode est généralement utilisée lors de l’utilisation de fichiers d’annotations ema, lorsque le script lit les informations d’annotation puis ajoute le block.

Par exemple, le code suivant montre comment ajouter un block à partir des informations contenues dans un fichier d’annotation :
```
foreach (var item in ema.blocks)
{
    var info = new BlockController.BlockInfo { ID = item.id.ToString(), Timestamp = item.timestamp };
    if (!item.keepTransform && item.location.OnSome)
    {
        blockHolder.Hold(info, item.location.Value);
    }
    else
    {
        blockHolder.Hold(info, item.transform.ToUnity());
    }
}
```
Astuce

Lors de l’ajout d’une target de suivi à l’exécution via un script, le modèle block ne peut pas être chargé ; seule la target de suivi block peut être ajoutée.

Configurer la target de suivi

Configurer la source de données de target

Version >= 4003
Version 4.7 - 4002

Une target de suivi ne peut être reconnue et suivie que si sa source est correctement configurée.

Dans la vue Hierarchy, après avoir sélectionné le nœud block, vous pouvez renseigner l’ID et le nom du block.

Dans le script, vous pouvez modifier, avant MonoBehaviour.Start() du composant, Source pour définir la source du block.

block.Source = new MegaBlockController.BlockInfoSourceData(id, name);

où

le block id est l’identifiant unique du block et doit être renseigné
le block name est le nom du block et peut être rempli librement selon les besoins ; il est généralement conseillé de renseigner le vrai nom du block pour l’identification

Astuce

Le block id et le nom peuvent être récupérés depuis le dépôt de localisation correspondant dans le centre de développement EasyAR.

Si le dépôt de localisation ne contient pas de données block, il faut ajouter les blocks nécessaires dans le dépôt de localisation, puis revérifier que le dépôt cloud est valide.

Dans MegaTrackerFrameFilter, spécifiez le target utilisé, c’est-à-dire le block.

Dans la plupart des cas, il est recommandé de conserver la configuration par défaut, à savoir importer le block dans l’éditeur avec Mega Studio.

Sélectionnez l’objet Mega Tracker sous la session ; l’option Block Root Source doit rester sur External (par défaut).

En même temps, il faut spécifier Block Root comme l’objet MegaBlocks de la scène.

En modifiant l’option Block Root Source, vous pouvez définir d’autres modes de source de block, par exemple lors de l’import de données ema, on choisit généralement Internal ou Mixed.

Dans le script, vous pouvez modifier BlockHolder.BlockRootSource pour obtenir le même effet.

Configurer le tracker utilisé par la target

Version >= 4003
Version 4.7 - 4002

La target de suivi est chargée par le tracker configuré et suivie une fois localisée correctement.

Dans la vue Hierarchy, après avoir sélectionné le nœud block, choisissez le Mega Tracker de la session.

Dans le script, vous pouvez modifier Tracker pour définir le tracker du block.

block.Tracker = megaTracker;

Tracker peut être modifié à tout moment à l’exécution ; le chargement et le déchargement se feront pendant l’exécution de la session. Si vous définissez Tracker sur null, cette target sera déchargée du tracker précédemment défini. Le chargement du block est un processus virtuel et ne peut pas échouer.

Note

Il existe plusieurs conditions clés pour qu’un target soit suivi :

L’id de MegaBlockController.Source doit être correctement configuré avant MonoBehaviour.Start().
Le block correspondant à l’id de cette Source doit exister dans le dépôt de localisation.
MegaBlockController.Tracker doit être configuré avec le bon dépôt de localisation.

En général, aucune configuration supplémentaire n’est nécessaire, mais si vous avez besoin d’un contrôle multi-target, vous pouvez effectuer les réglages correspondants.

Dans la plupart des cas d’usage Mega, il n’est pas nécessaire d’utiliser plusieurs targets. Tant que vous ne maîtrisez pas la manière d’éviter que plusieurs blocks s’influencent mutuellement, il est recommandé de n’avoir qu’un seul block dans un dépôt de localisation.

Astuce

En principe, Mega calcule la position de l’appareil dans tous les blocks, plutôt que de sélectionner uniquement le block visible par l’appareil dans le dépôt de localisation. Une utilisation mal pensée peut dégrader les résultats en raison d’une confusion des données.

Sélectionnez l’objet Mega Tracker sous la session, puis modifiez l’option Multi Block pour activer ou désactiver la fonction de suivi multi-target.

Dans le script, vous pouvez modifier BlockHolder.MultiBlock pour obtenir le même effet.

Avertissement

En général, un dépôt de localisation ne peut contenir qu’un seul block à la fois.

Modifier la configuration multi-target affecte les résultats de suivi et n’est généralement pas recommandé. Veuillez l’utiliser sous la direction du support technique EasyAR.

Si cette configuration a été modifiée pendant l’exécution de l’application, veillez à le préciser lorsque vous signalez un problème à EasyAR.

Cycle de vie de la target de suivi

Version >= 4003
Version 4.7 - 4002

Le cycle de vie typique d’une target de suivi est le suivant :

flowchart LR
  sstart((session démarrée))
  sstop([session arrêtée])
  
  start("Target.Start")
  load("Charger")
  tracking[["Suivi continu"]]

  sstart --> load --> tracking --> sstop
  start -. "Target.Tracker = tracker" .-> load

Le flux se décompose en plusieurs étapes :

Chargement : la target de suivi est chargée par le tracker configuré, ce qui se produit après le Start() de la target elle-même et après le démarrage de la session.
Processus de suivi : une fois la target localisée, le tracker continue de suivre sa position et son état jusqu’à ce qu’une autre target soit localisée.
Déchargement : la target de suivi est déchargée du tracker, et le tracker ne suit plus cette target. Cela se produit lorsque la session s’arrête ou lorsque la target est définie pour ne pas utiliser de tracker.

Table of Contents

Ajouter une target de suivi Mega

Avant de commencer

Note

Targets de suivi Mega

Note

Créer une target de suivi

Important

Astuce

Astuce

Note

Astuce

Configurer la target de suivi

Configurer la source de données de target

Astuce

Configurer le tracker utilisé par la target

Note

Astuce

Avertissement

Cycle de vie de la target de suivi

Étapes suivantes

Sujets associés