Hotspot Kit

Une apparence, un ordre et un filtre visiteur pour chaque point sensible de votre visite krpano — en 2D et en VR.

69 € Prix unique, HT

Compatibilité

Vérifié pour krpano 1.23.2–1.24

Comment ça marche.

Étape 1 sur 7 **Une apparence pour chaque marqueur** Chaque point sensible de la scène porte le même marqueur à vos couleurs ; sa catégorie décide de la couleur, de l’icône et de la forme.

Pointer un marqueur — Étape 1 sur 7 **Une apparence pour chaque marqueur** Chaque point sensible de la scène porte le même marqueur à vos couleurs ; sa catégorie décide de la couleur, de l’icône et de la forme.

Essayer la démo

Une visite avec des dizaines de points sensibles n’a ni apparence commune ni ordre : chaque scène est mise en forme à la main et un panorama chargé ne laisse au visiteur aucun moyen de ne voir que ce qui l’intéresse. Hotspot Kit donne à chaque point sensible le même marqueur à vos couleurs — icône, couleur, forme, états, infobulle et bulle — les range dans des catégories que le visiteur peut activer ou désactiver, et place jusqu’à six actions derrière un seul marqueur. Les marqueurs sont dessinés comme le panorama lui-même : le même point sensible mis en forme est donc là quand le visiteur met un casque.

Installation.

1
Copier un dossier

Placez le dossier chiffré du plugin dans votre visite et ajoutez un élément plugin à votre XML.
2
Nommer vos catégories

Déclarez une fois les catégories de votre visite, avec leur couleur, leur icône et leur forme, puis donnez la sienne à chaque point sensible.
3
Changer toute la visite en une ligne

Un thème, un style ou une catégorie change tous les marqueurs de toutes les scènes d’un coup — aucune scène n’est retouchée à la main.

Ce qui fait la différence.

Une apparence pour toute la visite

Six thèmes, cinq formes, 69 icônes maison et des couleurs libres donnent à chaque point sensible le même marqueur à vos couleurs.

Le visiteur choisit ce qu’il voit

Des catégories avec panneau de filtre laissent le visiteur masquer ce qui ne l’intéresse pas, avec un compte par scène et le choix conservé.

Des points sensibles mis en forme qui survivent à la VR

Le marqueur, son libellé et son filtre sont dessinés dans le panorama : ils sont donc encore là dans un casque, où HTML et CSS n’arrivent jamais.

Votre visite existante, inchangée

Une règle remet en forme une visite déjà en ligne ; le kit ajoute ses événements à côté des vôtres, et l’arrêter remet chaque valeur en place.

Captures d'écran.

Essayer la démo

**Ordinateur** Quatre marqueurs de trois catégories dans une salle, avec une bulle ouverte sur le lion.

**Smartphone** Sur téléphone, le panneau de filtre s’ouvre en liste complète avec de grandes lignes et le compte par catégorie.

**Détail** Le marqueur sous le pointeur grandit et affiche son texte.

Paramètres.

À définir comme attributs dans le XML de votre visite.

Paramètre	Type	Par défaut	Description
`active`	Oui / Non	`true`	Active ou désactive le kit à l’exécution ; false rend à chaque point sensible son apparence et ses événements d’origine (par défaut true).
`theme`	Liste	`solid`	Le niveau le plus large de l’apparence : les six thèmes sont des jeux de valeurs par défaut pour chaque clé de style (par défaut solid). `solidglassoutlineminimaldarklight`
`default_style`	Texte	—	Nom d’un élément <z360_hotspot_kit_style> utilisé par tout marqueur sans style propre (par défaut : aucun).
`adopt`	Liste	`marked`	marked ne prend que les points sensibles portant un attribut z360_hotspot_kit_* ; rules prend en plus ce qu’une <z360_hotspot_kit_rule> sélectionne (par défaut marked). `markedrules`
`debug`	Oui / Non	`false`	Écrit dans la console du navigateur combien de points sensibles ont été pris en charge et restaurés (par défaut false).
`animation_max`	Nombre	`20`	Combien de marqueurs peuvent jouer leur animation au repos en même temps, les plus proches du centre de la vue d’abord (0–200, par défaut 20).
`visited_memory`	Liste	`session`	session retient les marqueurs visités pour la session du navigateur, none les oublie aussitôt (par défaut session). Rien n’est stocké au-delà de la session. `sessionnone`
`reduced_motion`	Liste	`auto`	auto suit le réglage système « réduire les animations », on coupe toujours le mouvement, off anime toujours (par défaut auto). `autoonoff`
`keyboard`	Liste	`auto`	auto donne des marqueurs focalisables au clavier aux appareils avec souris et des marqueurs WebGL aux appareils tactiles ; true force partout les marqueurs clavier, false partout les marqueurs WebGL (par défaut auto). `autotruefalse`
`panel`	Oui / Non	`true`	Affiche le panneau de filtre du visiteur ; false garde les catégories mais n’affiche aucun panneau (par défaut true).
`panel_slot`	Liste	`middle-left`	Où se place le panneau de filtre à l’écran ; le noyau commun évite que nos plugins s’y recouvrent (par défaut middle-left). `top-lefttop-centertop-rightmiddle-leftmiddle-rightbottom-leftbottom-centerbottom-right`
`panel_offset`	Texte	`12\|0`	Distance du panneau de filtre au bord de son emplacement, en x\|y pixels de scène (par défaut 12\|0).
`panel_start`	Liste	`collapsed`	Si le panneau de filtre démarre en petit bouton ou déjà ouvert (par défaut collapsed). `collapsedopen`
`panel_counts`	Liste	`scene`	scene affiche combien de marqueurs d’une catégorie sont dans la scène courante, none n’affiche aucun compte ; il décide seulement de l’affichage du nombre, jamais de ce que connaît panel_empty (par défaut scene). `scenenone`
`panel_empty`	Liste	`disable`	Ce qu’il advient d’une catégorie sans marqueur dans la scène : la masquer, l’afficher en grisé ou normalement — la rangée de pastilles VR suit la même règle (par défaut disable). `hidedisableshow`
`panel_show_all`	Oui / Non	`true`	Affiche les boutons « Tout afficher » et « Tout masquer » en bas du panneau de filtre (par défaut true).
`panel_max_height`	Nombre	`60`	Hauteur maximale du panneau ouvert en pourcentage de l’écran ; une liste plus longue défile en interne (20–100, par défaut 60).
`text_panel_title`	Texte	`Filter`	Le titre du panneau de filtre et le texte de son bouton replié ; avec lang_keys c’est une clé, et sans entrée on obtient « Filter » (par défaut « Filter »).
`text_show_all`	Texte	`Show all`	Le texte du bouton « afficher toutes les catégories » ; avec lang_keys c’est une clé, et sans entrée on obtient « Show all » (par défaut « Show all »).
`text_hide_all`	Texte	`Hide all`	Le texte du bouton « masquer toutes les catégories » ; avec lang_keys c’est une clé, et sans entrée on obtient « Hide all » (par défaut « Hide all »).
`remember`	Liste	`session`	session conserve le filtre pour la visite et le lit depuis un lien, url le lit uniquement depuis le lien, none ne retient rien (par défaut session). Le kit n’écrit jamais l’adresse de la page. `sessionurlnone`
`tooltip`	Liste	`hover`	hover affiche le texte d’un marqueur au survol, always les textes des marqueurs visibles, zoomed seulement sous labels_fov_below, none jamais (par défaut hover). `hoveralwayszoomednone`
`tooltip_touch`	Liste	`first-tap`	Sur écran tactile : first-tap affiche le texte et le second appui exécute l’action, long-press l’affiche après une demi-seconde, direct exécute tout de suite (par défaut first-tap). `first-taplong-pressdirect`
`tooltip_delay`	Nombre	`0.15`	Secondes entre le survol d’un marqueur et l’apparition de l’infobulle (0–2, par défaut 0.15).
`tooltip_max_width`	Nombre	`260`	Largeur maximale d’une infobulle en pixels de scène ; un texte plus long passe à la ligne (80–600, par défaut 260).
`tooltip_position`	Liste	`auto`	auto choisit le côté qui tient et garde l’infobulle à l’écran ; un côté nommé est conservé et seulement décalé (par défaut auto). `autotopbottomleftright`
`callout_line`	Texte	`1\|#FFFFFFCC`	La ligne de rappel d’une bulle, sous la forme largeur\|couleur, ou none pour aucune ligne (par défaut 1\|#FFFFFFCC).
`labels_fov_below`	Nombre	`0`	Champ de vision en degrés en dessous duquel les libellés permanents et les infobulles zoomed apparaissent ; 0 signifie aucun seuil (0–179, par défaut 0).
`navigate_mode`	Liste	`event`	event laisse la transition de scène à la visite et à nos autres plugins, native laisse le kit choisir le fondu de navigate_blend (par défaut event). `eventnative`
`navigate_blend`	Texte	`BLEND(0.6)`	L’expression de fondu krpano utilisée quand navigate_mode vaut native (par défaut BLEND(0.6)).
`send_track`	Oui / Non	`true`	Envoie un événement z360_track lors d’un clic sur un marqueur, d’une action de menu et d’un changement de filtre, pour les statistiques de la visite (par défaut true).
`pause_on_media`	Oui / Non	`true`	Arrête les animations au repos pendant qu’une vidéo ou un son d’un autre plugin z360 est lu, et ne relance que ce qu’il a arrêté (par défaut true).
`scale_mode`	Liste	`fixed`	fixed garde chaque marqueur de la même taille à tout zoom, zoom le fait grandir et rétrécir avec le zoom dans les bornes de size_limits (par défaut fixed). `fixedzoom`
`size_limits`	Texte	`16\|72`	Taille minimale\|maximale du marqueur en pixels écran pour scale_mode="zoom" (par défaut 16\|72).
`hide_fov_above`	Nombre	`0`	Au-delà de ce champ de vision en degrés, les marqueurs priority="low" sont masqués et désactivés ; 0 désactive la règle (0–179, par défaut 0).
`declutter`	Nombre	`0`	Nombre maximal de libellés permanents à l’écran, les plus proches du centre d’abord ; 0 les affiche tous (0–50, par défaut 0).
`distance_fade`	Texte	`0\|0`	Estompe les marqueurs selon leur distance à la caméra, sous la forme début\|fin en unités krpano – pas en centimètres ; 0\|0 désactive. Nécessite une scène depthmap ou 3D, ou un depth propre à chaque point sensible (par défaut 0\|0).
`vr_scale`	Nombre	`1.6`	De combien les marqueurs grandissent quand le visiteur met un casque (1–4, par défaut 1.6).
`vr_hit_padding`	Nombre	`0.5`	Cible invisible supplémentaire autour de chaque marqueur en VR, en multiple de sa taille ; 0 la désactive (0–2, par défaut 0.5).
`vr_dwell`	Liste	`auto`	auto ajoute une sélection au regard seulement si la configuration VR de la visite n’en a pas, on toujours, off jamais (par défaut auto). `autoonoff`
`vr_dwell_time`	Nombre	`1.5`	Secondes pendant lesquelles le regard doit rester sur un marqueur avant sa sélection (0.5–5, par défaut 1.5).
`vr_labels`	Liste	`gaze`	En VR : gaze affiche l’infobulle d’un marqueur regardé, always celles des marqueurs visibles, none aucune (par défaut gaze). `gazealwaysnone`
`vr_panel`	Liste	`hide`	hide laisse le filtre hors de la VR, compact dessine sous l’horizon une rangée de pastilles de catégories que le visiteur regarde vers le bas, chacune avec le libellé et le compte de sa ligne à l’écran (par défaut hide). `hidecompact`
`lang_keys`	Oui / Non	`false`	Lit chaque texte du kit comme une clé des tables <languages> de la visite, pour que les marqueurs changent de langue avec elle ; les trois textes du kit — le titre du panneau et ses deux boutons — reviennent à un anglais lisible quand les tables ne répondent pas à leur clé, tandis que vos propres textes (noms de catégorie, infobulles, légendes, noms d’action) sont affichés exactement tels que vous les avez écrits : une clé sans entrée est donc montrée au visiteur telle quelle (par défaut false).
`hide_on_compare`	Oui / Non	`true`	Masque et désactive les marqueurs pendant qu’un comparatif de notre plugin Compare Views est affiché, puis les rétablit (par défaut true).
`search_reveal`	Oui / Non	`true`	Réaffiche une catégorie quand le visiteur trouve l’un de ses marqueurs via la recherche de notre Tour Navigator, pour qu’aucun résultat ne soit mort (par défaut true).
`icon`	Texte	`dot`	Lequel des 69 pictogrammes le marqueur affiche, par exemple info, star, door, wc ou plane (par défaut dot).
`shape`	Liste	`circle`	La forme de la pastille derrière l’icône ; un pin pose sa pointe sur la position du point sensible, toute autre forme y est centrée (par défaut circle). `circleroundedsquarepinnone`
`size`	Nombre	`36`	Taille du marqueur en pixels écran (16–128, par défaut 36 ; le thème minimal utilise 28).
`color`	Couleur	`#FFFFFF`	Couleur de l’icône dans la pastille (par défaut #FFFFFF, issue du thème).
`bg_color`	Couleur	`#1E88E5E6`	Couleur de la pastille, avec transparence facultative en #RRGGBBAA (par défaut #1E88E5E6, issue du thème).
`border`	Texte	`2\|#FFFFFF`	Le contour de la pastille sous la forme largeur\|couleur, ou none (par défaut 2\|#FFFFFF, issu du thème).
`shadow`	Oui / Non	`true`	Dessine une ombre douce sous le marqueur pour qu’il reste lisible sur un panorama clair (par défaut true, issu du thème).
`label`	Liste	`none`	Où se place le libellé permanent d’un marqueur, ou none pour aucun (par défaut none). Sur un point sensible, la position s’écrit z360_hotspot_kit_label_pos. `nonerightleftabovebelow`
`text_css`	Texte	—	CSS supplémentaire pour le libellé, l’infobulle et la bulle, par exemple une police ou une taille plus grande (par défaut : aucun).
`animation`	Liste	`ring`	L’animation au repos qui rend un marqueur visible : pulsation, anneau qui s’élargit, petit rebond, fondu respirant ou halo doux (par défaut ring). `nonepulseringbouncebreatheglow`
`animation_interval`	Nombre	`4`	Secondes de pause entre deux passages de l’animation au repos ; 0 ne fait jamais de pause (0–60, par défaut 4).
`hover_scale`	Nombre	`1.15`	De combien un marqueur grandit au survol ou lorsqu’il a le focus clavier (1–2, par défaut 1.15).
`hover_bg_color`	Couleur	—	Couleur de la pastille au survol ; vide mélange sa propre couleur à 18 % vers le blanc (par défaut : vide).
`active_mode`	Liste	`ring`	Comment un marqueur montre que la fenêtre qu’il a ouverte est ouverte : un anneau, une pastille pleine ou rien (par défaut ring). `ringfillnone`
`visited_mode`	Liste	`dim`	À quoi ressemble un marqueur déjà ouvert : atténué, avec une petite coche ou inchangé (par défaut dim). `dimchecknone`

Exemple

<!-- hotspotkit.xml, included once by your tour.xml -->
<plugin name="z360_hotspot_kit"
        url="plugins/z360_hotspot_kit/z360_hotspot_kit.js"
        keep="true"
        theme="solid"
        declutter="4"
        vr_panel="compact" />

<z360_hotspot_kit_category name="exhibits" label="Exhibits" order="1" icon="star" bg_color="#1E88E5E6" />
<z360_hotspot_kit_category name="rooms"    label="Rooms"    order="2" icon="door" bg_color="#7C3AEDE6" shape="pin" />

<z360_hotspot_kit_action name="go_hall" type="navigate" label="Mammal hall" icon="door" scene="scene_hall_of_mammals" />

<!-- in your scene: an ordinary krpano hotspot, with no image of its own -->
<hotspot name="poi_lion" ath="-30" atv="12.7"
         z360_hotspot_kit_category="exhibits"
         z360_hotspot_kit_tooltip="Lion diorama, mounted 1904"
         z360_hotspot_kit_callout="-7|-15" />

Fonctionnalités

Six thèmes, cinq formes, couleurs et contours libres, et 69 icônes dessinées pour ce produit
États survol, focus clavier, actif et visité, chacun avec un vrai fondu
Cinq animations au repos avec un budget, et respect complet de « réduire les animations »
Catégories avec panneau de filtre, compte par scène, choix conservé pour la visite ou transporté dans un lien
Infobulles conscientes des bords avec trois modes tactiles, et bulles ancrées dans le panorama avec ligne de rappel
De une à six actions derrière un marqueur : changer de scène, regarder, ouvrir une page, appeler une action ou parler à un autre plugin
Taille liée au zoom, budget de libellés et estompage par la distance pour les scènes depthmap et 3D
VR : marqueurs plus grands, cible invisible élargie, sélection au regard, libellés au regard et rangée de filtre compacte — vérifié dans le mode VR simulé de krpano, pas encore sur un casque VR
Navigation au clavier avec un vrai ordre de focus, et un menu pour les lecteurs d’écran
Prend en charge par règle les points sensibles d’une visite existante et restaure chaque valeur à l’arrêt
Fonctionne à côté de nos autres plugins krpano : Tour Navigator, Floor Plan, Info Cards, Media Gallery, Compare Views, Walk Navigation et Detail Loupe