Développeur

Concepts VisioWeb (SDK Web) pour la configuration de la scène

Navigation par flèches

Retour

Concepts VisioWeb (SDK Web) pour la configuration de la scène

Type de vue? ou Type de caméra? Et le type d'animation?

Un explorateur muni d'un appareil photo. C'est vrai. Mais que fait-il ?

Une vue multi-bâtiments ? A quoi cela sert-il si je n'ai qu'un seul bâtiment ?

En travaillant récemment sur les itinéraires à plusieurs étages, nous nous sommes rendu compte que tous ces concepts, bien qu'ils permettent aux développeurs de façonner leur expérience cartographique de manière toujours plus précise, peuvent être déroutants pour les nouveaux arrivants.

Ce billet a donc pour but de clarifier les principaux concepts que vous devrez maîtriser lors de l'intégration de VisioWeb dans votre application.

J'espère que cela vous aidera !

Type de vue :

VisioWeb propose 3 paradigmes différents pour l'affichage de sites complexes comportant un ou plusieurs bâtiments, chacun comportant un ou plusieurs étages. Le type de vue est initialisé en tant que paramètre passé à Mapviewer#setupMultiBuildingView.

  • multibâtiment - les étages sont étroitement empilés les uns sur les autres depuis le niveau du sol jusqu'à l'étage sélectionné.
Capture d'écran du 2019-12-05 16-36-31
  • multifloor - en mode bâtiment, les étages sont tous affichés dans un carrousel vertical, avec un écart important entre eux. En mode étage, l'extérieur est caché.

Capture d'écran du 2019-12-05 16-35-40

La liste est interactive et permet à l'utilisateur de choisir l'étage actuel. Par défaut, les seules interactions possibles sont le défilement vers le haut ou vers le bas de la liste et la sélection de l'étage actuel en touchant le centre de l'écran. A partir de VisioWeb 1.9.6les développeurs pourront remplacer cette fonction et activer le zoom, la rotation, l'inclinaison et même cliquer sur des lieux interactifs (au lieu de la sélection de l'étage).

L'écart peut être configuré à partir de VisioMapEditorétage par étage. A partir de VisioWeb 1.9.6il est possible de remplacer les valeurs de stackGap lors de l'appel à Mapviewer#setupMultiBuildingView.

  • singlefloor - les étages sont affichés un par un.
Capture d'écran du 2019-12-05 16-37-42

Lorsque l'utilisateur change d'étage, l'étage précédent est animé (voir Type d'animation, ci-dessous) et remplacé par le nouvel étage.

Mode d'affichage :

Il existe 3 modes différents pour interagir avec la carte. Le changement de mode se fait explicitement en utilisant MultiBuildingView#goTo ou automatiquement par le CameraDrivenExplorer.

  • global - le point de vue englobe l'ensemble du site, ce qui permet à l'utilisateur de choisir un bâtiment pour commencer à l'explorer.
Capture d'écran de 2019-12-05 16-46-41
  • bâtiment - activé uniquement dans le type de vue multi-étages , tous les étages du bâtiment actuel sont affichés sous forme de liste (ce mode est désactivé par défaut dans le type de vue multi-étages, et non pertinent dans le type de vue mono-étage).
Capture d'écran du 2019-12-05 16-35-40
  • étage - un étage est sélectionné, le bâtiment correspondant est "ouvert" et l'utilisateur peut explorer, modifier le point de vue, interagir avec les lieux.
Capture d'écran du 2019-12-05 16-47-31

Type d'animation :

Il existe deux types d'animation disponibles lorsque l'on affiche/masque certains étages, typiquement en appelant MultiBuildingView#goTo. Le type d'animation est initialisé en tant que paramètre transmis à Mapviewer#setupMultiBuildingView.

  • traduction - le sol est renvoyé vers le haut ou vers le bas ou il vient de loin vers le haut ou vers le bas.
animationtype_translation
  • opacité - le sol disparaît en devenant transparent ou apparaît en devenant opaque.
animationtype_opacity
  • les deux - les deux types d'animation sont combinés ensemble.
animationtype_both

Type de caméra :

Il existe deux types de caméra pour afficher la scène 3D. Le type de caméra est initialisé en tant que paramètre passé à Mapviewer#initialize.

  • perspective - la scène 3D est affichée telle que l'œil humain la verrait. Cette projection fournit des informations sur la profondeur à l'observateur : les objets plus éloignés sont plus petits à l'écran que ceux qui sont plus proches. Cette projection est généralement utilisée pour l'orientation.
Capture d'écran du 2019-12-05 16-55-04
  • orthographique - la scène 3D est projetée sur l'écran sans donner d'informations sur la profondeur, les distances et les tailles sont préservées. Cette projection est généralement utilisée lorsque la carte sert de support au contrôle d'autres couches de données géographiques. Le type de vue d'un seul étage est plus adapté à ce type de caméra.
Capture d'écran du 2019-12-05 16-59-57
Explorateur équipé d'une caméra :

La classe CameraDrivenExplorer est chargée de deviner si les utilisateurs sont intéressés par un bâtiment particulier du site. Elle déclenche la sélection d'un bâtiment lorsque...

  • l'utilisateur zoome vers elle
zoom_caméra
  • l'utilisateur visualise déjà la carte d'assez près et la survole
cameradriven_pan

Vue de plusieurs bâtiments :

La classe MultiBuildingView est responsable de la gestion de toutes les animations de scène et de caméra qui rendent vos cartes si vivantes et interactives.

Il a gagné son nom parce qu'il a été introduit pour soutenir les sites multi-bâtiments à une époque où toutes ces interactions étaient impossibles ou très difficiles à réaliser.

Mais n'ayez pas peur, l'utilisation de MultiBuildingView n'est pas réservée aux sites multi-bâtiments : vous pouvez bénéficier de ses fonctionnalités même si vous ne vous occupez que d'un seul bâtiment.