Utilisation de l'éditeur de carte BeaconFence

De RAD Studio

Remonter à BeaconFence


Vous pouvez créer des cartes avec l'éditeur de carte BeaconFence. Pour créer une scène (carte avec beacons, zones, chemins et noeuds), le composant TBeaconMapFencing doit exister dans votre projet.

Assurez-vous que vous liez la propriété PainControl au contrôle qui affichera la carte.

Double-cliquez sur le composant TBeaconMapFencing pour ouvrir l'éditeur de carte BeaconFence.

Pour créer et configurer de nouvelles scènes, vous devez garder certains éléments à l'esprit :

Notions de base concernant l'utilisation de l'éditeur de carte BeaconFence

Voici les informations de base dont vous avez besoin pour savoir comment utiliser l'éditeur de carte BeaconFence.

  • Déplacer la vue de la carte avec tous les objets : cliquez sur le bouton central de la molette de la souris, et maintenez-le enfoncé pendant que vous déplacez la souris vers l'emplacement souhaité.
  • Zoomer en avant/en arrière : faites tourner la molette vers l'avant et vers l'arrière pour zoomer vers l'avant et vers l'arrière.
  • Sélection d'objets : cliquez sur le bouton Select Object situé parmi les boutons de la barre d'outils pour activer la sélection d'objets. Vous pouvez également appuyer sur la touche Echap à tout moment pour sélectionner cet outil.
  • Déplacement d'objets : vous pouvez déplacer des objets, situés sur la carte, à tout moment sans les sélectionner. Cliquez sur l'objet et déplacez-le en le faisant glisser.
  • Suppression d'objets : pour supprimer un objet, sélectionnez-le et appuyez sur la touche Suppr. Pour supprimer une carte, voir la procédure de configuration des cartes.
Remarque: Lorsque vous supprimez un noeud, vous supprimez toutes les connexions de ce noeud.
  • Faire un zoom avant sur un objet : pour faire un zoom avant sur un objet particulier, sélectionnez cet objet dans la carte ou dans l'arborescence, puis cliquez sur le bouton Zoom to Selection situé parmi les boutons de la barre d'outils.
  • Chargement et enregistrement de projets : utilisez les options de menu Fichier > Charger un projet et Fichier > Enregistrer le projet pour respectivement charger et enregistrer des projets. Vous pouvez enregistrer un projet pour avoir une copie de votre projet au format XML, de manière à disposer d'une sauvegarde, ou à transférer les informations vers un autre ordinateur.
Lorsque vous fermez l'éditeur de carte BeaconFence, l'éditeur vous demande si vous souhaitez enregistrer les changements. Gardez à l'esprit que ces changements sont enregistrés au format XML dans le fichier FMX.

Ajout et configuration de cartes

Ajout de nouvelles cartes

Cliquez sur le bouton Create New Map situé parmi les boutons de la barre d'outils de l'éditeur de carte FeaconFence pour créer une nouvelle carte.

Vous pouvez avoir plusieurs cartes dans un projet. L'éditeur de carte FeaconFence affiche chaque carte dans un onglet différent.

Configuration des cartes

Lorsque vous créez une carte, il convient de définir au moins les options suivantes :

  • BitmapPath : ajoutez l'image du bitmap à votre carte, si vous en avez une. Cliquez sur le bouton Load from file de la propriété BitmapPath dans le panneau Propriétés de l'objet, naviguez jusqu'à l'image de la carte, sélectionnez-la, puis cliquez sur Open.
Cliquez sur le bouton Clear pour supprimer l'image du bitmap. L'image est enregistrée au format XML dans le fichier FMX. Si vous apportez des modifications à l'image d'origine, cliquez sur le bouton Refresh pour charger à nouveau l'image du bitmap à partir du chemin.
  • Scale Map : il est important d'utiliser cette option pour définir l'échelle de la propriété de la carte. Nous vous recommandons de définir l'échelle de la carte avant d'ajouter un objet. Vous devez fournir des mesures physiques concernant l'image de carte chargée, en cliquant sur deux points de l'image, et en indiquant la distance entre eux.
Pour définir l'échelle de la carte, cliquez sur le bouton Scale Map situé parmi les boutons de la barre d'outils, cliquez sur un point dans la carte, cliquez sur un second point dans la carte, et écrivez la distance entre ces deux dans la même unité de mesure que celle indiquée dans la propriété MeasureUnits.
  • Delete Map : sélectionnez la carte que vous voulez supprimer pour l'afficher. Cliquez sur le bouton Delete Map situé parmi les boutons de la barre d'outils, puis cliquez sur Yes lorsque vous êtes invité à supprimer la carte.
Avertissement: Lorsque vous supprimez une carte, vous supprimez toutes ses propriétés, ainsi que les objets positionnés sur la carte. Une fois qu'une carte a été supprimée, il est impossible de la récupérer ; cette action ne peut pas être annulée.

Après avoir défini les propriétés ci-dessus, vous pouvez passer à la définition des autres propriétés requises. Voir les autres propriétés de la carte.

Ajout et configuration de zones

Ajout de nouvelles zones

Vous pouvez ajouter des zones en utilisant trois types de forme différents : rectangulaire, circulaire et polygonale. Vous pouvez déplacer et redimensionner les zones après les avoir créées. Assurez-vous d'avoir défini l'échelle de la propriété de la carte avant de placer des zones. Si ce n'est déjà fait, consultez la procédure de définition de l'échelle de la carte.

  • Création de zones rectangulaires : cliquez sur le bouton Create Rectangular Zone situé dans les boutons de la barre d'outils, cliquez sur l'angle de la zone que vous voulez créer, faites glisser la souris jusqu'à l'angle opposé, puis relâchez le bouton de la souris une fois la zone rectangulaire entièrement couverte.
  • Création de zones circulaires : cliquez sur le bouton Create Circular Zone parmi les boutons de la barre d'outils, cliquez sur un bord de la zone que vous voulez créer, faites glisser la souris jusqu'au bord opposé, puis relâchez le bouton de la souris une fois la zone circulaire entièrement couverte.
Vous pouvez activer ou désactiver la case à cocher PerfectCircle pour déterminer si le cercle peut être étiré.
  • Création de zones polygonales : cliquez sur le bouton Create Polygonal Zone parmi les boutons de la barre d'outils, cliquez sur les sommets du polygone l'un après l'autre pour les définir dans le bon ordre. Lorsque vous cliquez sur le dernier sommet à créer, cliquez sur le bouton droit de la souris ou appuyez sur Echap pour fermer la zone polygonale. Lorsque vous créez le polygone, vous pouvez supprimer le dernier sommet ajouté en utilisant le raccourci clavier Ctrl+Z, ou en cliquant sur le bouton de la barre d'outils.
Vous pouvez déplacer les sommets après avoir créé la zone polygonale. Sélectionnez la zone polygonale, cliquez sur le sommet à déplacer, faites-le glisser et relâchez-le à l'emplacement souhaité.
Avertissement: Lors de la création de zones polygonales. nous vous recommandons de ne pas croiser les côtés. Cela risque de fausser la détection de la zone.

Configuration des zones

Il n'y a pas de paramètres obligatoires minimum requis pour configurer une zone. Après avoir créé une zone, vous pouvez configurer les propriétés requises de votre choix ; voir les différentes propriétés de zone disponibles.

Ajout et configuration de beacons

Ajout de nouveaux beacons

Placez les beacons sur l'image de la carte au même endroit que dans l'environnement réel. Assurez-vous d'avoir défini l'échelle de la propriété de la carte avant de placer les beacons. Si ce n'est déjà fait, consultez la procédure de définition de l'échelle de la carte.

Pour ajouter un nouveau beacon à la carte, cliquez sur le bouton Create beacon parmi les boutons de la barre d'outils, déplacez la souris vers l'emplacement sur l'image de la carte où vous voulez placer le beacon, et cliquez pour l'insérer. Vous pouvez continuer à cliquer pour placer différents beacons. Une fois le dernier beacon placé, cliquez avec le bouton droit ou appuyez sur Echap pour terminer.

Les lignes horizontale et verticale que vous voyez lorsque vous déplacez le beacon montrent la distance jusqu'à la fin de l'image ; cette distance s'affiche dans la même unité de mesure que celle définie dans la propriété MeasureUnits de la carte.

Configuration des beacons

Lorsque vous ajoutez un nouveau beacon, vous devez définir au minimum les propriétés suivantes :

  • GUID : ajoutez le GUID du beacon. Il s'agit de l'identifiant unique qui identifie un groupe de beacons. Lorsque vous définissez des beacons avec le même GUID, vous pouvez ajouter le GUID pour un beacon, sélectionner un autre beacon, et utiliser le menu déroulant pour assigner le même GUID à ce beacon.
  • Major : ajoutez l'ID majeur du beacon. Il s'agit de la sous-région au sein du GUID.
  • Minor : ajoutez l'ID mineur du beacon. Il s'agit de la sous-région supplémentaire au sein de l'ID majeur.

Les trois propriétés ci-dessus sont les propriétés minimales que vous devez définir pour configurer un beacon dans l'éditeur de carte. Vous pouvez configurer d'autres propriétés de beacon.

  • Définition de la distance entre les beacons : vous pouvez définir manuellement la distance entre deux beacons situés sur la carte. Cliquez sur le bouton Set Distance Between Beacons de la barre d'outils, cliquez sur le premier beacon, puis sur le second beacon, et écrivez la distance entre deux beacons dans la même unité de mesure que celle indiquée dans la propriété de la carte MeasureUnits.
Remarque: Lorsque vous définissez la distance entre deux beacons, le premier beacon sert de référence et le second beacon est celui qui se déplace pour s'ajuster sur la distance fournie.

Ajout et configuration de chemins et de noeuds

Ajout de nouveaux chemins et noeuds

Un chemin représente un parcours sur lequel vous pouvez être positionné. Par exemple, dans un supermarché, les chemins seraient les allées et les zones dans lesquelles vous pouvez marcher. Vous devez placer les chemins dans l'image de la carte au même endroit que dans l'environnement réel, puisque la position est ajustée sur les chemins existants. Assurez-vous d'avoir défini l'échelle de la propriété de la carte avant de placer les chemins. Si ce n'est déjà fait, consultez la procédure de définition de l'échelle de la carte.

Les chemins peuvent comporter un ou plusieurs noeuds. Les noeuds représentent des points spéciaux sur la carte où vous pouvez ajouter des informations. Vous devez placer un noeud lorsqu'un chemin comporte un virage ou se divise, ainsi que pour signaler un point d'intérêt sur la carte.

Pour ajouter un nouveau chemin à la carte, cliquez sur le bouton Create Path de la barre d'outils, cliquez sur la position où vous souhaitez placer le premier noeud, puis cliquez l'un après l'autre sur les noeuds à placer sur le chemin. Lorsque vous cliquez pour ajouter le dernier noeud, cliquez sur le bouton droit de la souris ou appuyez sur Echap pour terminer le chemin. Si vous faites une erreur en plaçant un noeud lorsque vous ajoutez le chemin, vous pouvez appuyer sur Ctrl+Z pour annuler votre dernière action et supprimer le dernier noeud.

Configuration des chemins et des noeuds

Il n'y a pas de paramètres obligatoires minimum requis pour configurer un chemin ou un noeud. Après avoir créé un noeud/chemin, vous pouvez configurer les propriétés requises de votre choix. Voir les différentes propriétés de chemins et de noeuds disponibles.

Lorsque des chemins ne sont pas joints, ce sont des chemins différents. Dès que vous joignez un noeud d'un chemin avec un noeud d'un autre chemin, ces chemins sont fusionnés pour créer un seul chemin.

  • Jointure de deux chemins : pour joindre deux chemins, vous devez joindre un noeud d'un chemin à un noeud d'un autre chemin. Gardez à l'esprit que le second chemin fusionnera avec le premier, et que le nom du chemin joint sera identique au nom du premier chemin.
Remarque: Une fois que vous avez joint deux chemins, vous ne pouvez pas les séparer à nouveau.
  • Connexion de noeuds : il y a deux manières de connecter des noeuds :
  • Cliquez sur le bouton Create Path de la barre d'outils, cliquez sur le premier noeud, puis sur le second, et cliquez sur d'autres noeuds si vous devez ajouter des connexions supplémentaires. Une fois terminé, cliquez sur le bouton droit de la souris ou appuyez sur Echap.
  • Sélectionnez un noeud, puis maintenez enfoncée la touche Ctrl en sélectionnant l'autre noeud, et appuyez sur C pour les connecter.
  • Déconnexion des noeuds : pour déconnecter des noeuds, sélectionnez un noeud puis maintenez enfoncée la touche Ctrl en sélectionnant un autre noeud, et appuyez sur D pour les déconnecter.

Définition des connexions entre les cartes

Vous pouvez connecter deux noeuds de différentes cartes pour indiquer une connexion de ces noeuds dans l'environnement réel. Par exemple, vous pouvez connecter deux noeuds situés dans des escaliers ou un ascenseur connectant deux étages différents.

Lorsque vous avez plusieurs cartes et que vous voulez connecter au moins un chemin de chaque, connectez les noeuds des différentes cartes en procédant comme suit :

  1. Cliquez sur le bouton de la barre d'outils pour ouvrir l'éditeur Connect Maps.
  2. Utilisez la souris pour faire glisser et déplacer les cartes, et afficher les noeuds que vous voulez connecter.
  3. Sélectionnez un noeud dans une carte, puis maintenez enfoncée la touche Ctrl en sélectionnant un noeud dans l'autre carte, et appuyez sur la touche C pour les connecter.

Cette opération ne peut pas être annulée. Si vous voulez déconnecter des noeuds de différentes cartes, répétez les étapes ci-dessus, et une fois les deux noeuds sélectionnés, cliquez sur D pour les déconnecter.

Définition de la description des points d'intérêt

Par défaut, les objets de votre carte sont considérés comme des points d'intérêt qui vous permettent de :

  • Naviguer dans votre carte en suivant les chemins prédéfinis.
  • Obtenir des informations sur une zone spécifique associée à un point d'intérêt.
  • Demander des messages d'information lorsqu'un périphérique BLE arrive dans une zone associée à un point d'intérêt.
Remarque: Utilisez OnArrivedToPOI pour gérer des actions personnalisées lorsqu'un périphérique BLE arrive au point d'intérêt de destination.

Pour ajouter une description avec des informations aux points d'intérêt de votre carte, vous devez :

  • Utiliser le panneau Propriétés de l'objet de l'éditeur de carte BeaconFence et définir une description de paire clé et valeur dans la propriété DescriptionList de l'objet souhaité de la carte. Cliquez sur pour ajouter une nouvelle clé. Cliquez sur pour supprimer une clé.

Voir aussi

Récupérée de « https://docwiki.embarcadero.com/RADStudio/Florence/f/index.php?title=Utilisation_de_l%27éditeur_de_carte_BeaconFence&oldid=219186 »