Développeur

Routes multi-étages VisioWeb

Navigation par flèches

Retour

Routes multi-étages VisioWeb

Depuis VisioWeb 1.9.6, nous avons apporté plusieurs améliorations à l'API pour permettre aux développeurs de modifier la vue dans le contexte de l'affichage d'un itinéraire.

Dans ce cas particulier, nous avons reçu des commentaires nous indiquant que les utilisateurs (en particulier les utilisateurs de bornes interactives) apprécieraient de voir l'itinéraire complet à travers tous les étages qu'il traverse, mais seulement ceux-là, d'où les"itinéraires à plusieurs étages" que nous avons introduits.

Capture d'écran de 2019-12-10 11-52-47

Nous sommes conscients que cela peut prêter à confusion, afin d'éviter de mélanger ce concept avec d'autres, que vous soyez un utilisateur expérimenté de VisioWeb ou un nouvel utilisateur.

Pour activer cette fonctionnalité, il suffit d'ajouter une nouvelle option lors de l'instanciation de l'objet Route, appelée "floorFilter".

Il peut prendre 3 valeurs différentes :

  • all - comportement par défaut, les étages ne sont pas filtrés, l'itinéraire est affiché comme avant VisioWeb 1.9.6 (voir les cas multi-bâtiments et multi-étages ci-dessous)
Capture d'écran de 2019-12-06 11-10-52

   

Capture d'écran de 2019-12-10 12-00-02

  • impliqué - seuls les étages impliqués dans l'affichage de l'itinéraire sont affichés
Capture d'écran du 2019-12-10 11-55-25

  • traversé - même chose qu'impliqué mais les étages intermédiaires sont également indiqués
Capture d'écran du 2019-12-10 11-57-07

Ajustements :

Cette fonction modifie l'affichage de la carte à bien des égards. Voici donc quelques bonnes pratiques pour tirer le meilleur parti de cette fonction :

initialiser la vue

Juste après avoir appelé Route#show :

passer à l'instruction précédente/suivante

Par défaut, l'appel à Navigation#displayPrevInstruction ou Navigation#displayNextInstruction animera la caméra et appellera MultiBuildingView#goTo en mode plancher.

Il est donc recommandé de désactiver le comportement par défaut en appelant ces méthodes avec l'argument animateCamera à false et d'adapter manuellement la façon dont la caméra doit être animée lorsque l'on parcourt les instructions.

Voici notre suggestion pour l'instruction précédente :

Et pour la prochaine instruction :

stackGap

En fonction du type de vue choisi, l'activation de ces itinéraires à plusieurs étages nécessitera un espace plus important entre les étages afin de mieux visualiser l'itinéraire.

Pour ce faire, vous pouvez remplacer les valeurs d'écart par défaut définies pour chaque étage en utilisant la propriété publique stackGap de MultiBuildingView :

N'oubliez pas de le remettre à 0 (sa valeur par défaut) lorsque vous effacez l'itinéraire, afin de vous assurer que les valeurs d'écart étage par étage seront utilisées lorsqu'aucun itinéraire n'est affiché :