Developer Networks
Créez avec les technologies GraphicStream
Librairie GraphicStream d'articles techniques, de tutoriaux et de ressources d'apprentissage
GraphicStream est un éditeur de logiciels et l’éditeur d’Immersive. Le Developer Network accompagne les équipes qui développent à partir de ses produits et technologies.
Bien démarrer
Les ressources essentielles
Une sélection éditoriale pour comprendre l’écosystème GraphicStream et commencer à créer autour d’Immersive.
Présentation de l’interface du Beholder
Prenez rapidement vos repères dans le Beholder en découvrant comment l’écran s’organise entre vue 3D, liste d’équipements, alarmes et menus. Ce chapitre montre où agir, quoi observer et comment sélectionner un équipement aussi bien depuis le jumeau numérique que depuis les panneaux latéraux. Vous comprendrez immédiatement la signification des codes couleur et des indicateurs visuels pour repérer un défaut, une déconnexion ou un équipement en travaux sans perdre de temps. Il explique aussi le rôle des widgets 3D, des objets graphiques et des annotations pour lire le contexte terrain avec plus de précision. À la fin, vous saurez naviguer de façon fluide dans l’application et interpréter l’état global d’un parc d’équipements en un coup d’œil.
Lire la ressourceHub : Présentation générale
Comprenez en quelques minutes comment le Hub Immersive orchestre l’accès aux données entre vos applications et des sources hétérogènes comme OPC UA, Excel, MQTT ou SQL. Cette présentation montre concrètement comment un même mécanisme unifie les requêtes, les mises à jour et les statuts de qualité, sans exposer la complexité des protocoles. Vous verrez le rôle précis des handles, des sessions et des connecteurs, et comment le Hub distribue les bonnes valeurs aux bons consommateurs au bon moment. À la lecture, vous saurez modéliser un accès à une donnée, suivre le cycle de vie d’une session et comprendre comment brancher ou concevoir un connecteur adapté à vos besoins. Vous saurez aussi interpréter les états d’erreur, les timeouts et les remontées de défauts pour fiabiliser supervision et maintenance.
Lire la ressourceBinding : Introduction
Cette introduction vous montre comment relier proprement un objet de la scène 3D à un équipement métier Immersive, pour que données, états, alarmes et interactions pointent toujours vers la bonne cible. Vous comprendrez la logique du modèle objet, des familles, des instances, des handles et des scopes, sans rester au niveau théorique. La formation s’appuie sur un cas concret, BuildingSensorSimulator, pour apprendre à identifier les équipements à créer et à structurer un contrat de données fiable. À la lecture, vous saurez préparer un binding stable entre vue 3D et DOM, éviter les mappings fragiles et concevoir une base exploitable pour le scripting, l’UI et la supervision. C’est le point de départ indispensable pour bâtir un jumeau numérique cohérent, évolutif et fidèle au terrain.
Lire la ressourceExplorer
Parcourir les domaines du GSDN
Chaque rayon regroupe les documents, guides et références d’un même domaine fonctionnel ou technique.
Forge
Forge est l’environnement de **création intégré** de la plateforme Immersive. Conçu pour les développeurs, intégrateurs, comemrciaux et formateurs, Forge permet de créer, personnaliser et déployer des expériences pour Immersive adaptées à une multitude de cas d’usage.
16 documentsForge Interface
Forge est l’environnement de **création intégré** de la plateforme Immersive. Conçu pour les développeurs, intégrateurs, comemrciaux et formateurs, Forge permet de créer, personnaliser et déployer des expériences pour Immersive adaptées à une multitude de cas d’usage.
0 documentsBinding
Binding concepts and guides.
1 documentArticles
Technical articles and transversal topics.
1 documentCommons
Common setup and shared fundamentals.
0 documentsConnaissances de base
Explorez les guides, références et exemples de ce domaine.
1 documentHub
Le Hub Immersive est le cœur de l’infrastructure de données de la solution Immersive. C’est l’intermédiaire universel entre : * Les sources de données : capteurs IoT, automates (OPC UA, Modbus, MQTT…), fichiers Excel, bases SQL, API REST… * Les consommateurs : applications Beholder 3D, superviseurs, synoptiques web, ou tout autre service métier. Le Hub agit comme un **chef d’orchestre** : Il centralise les données hétérogènes provenant de multiples protocoles, il synchronise en temps réel les valeurs utiles avec les applications clientes et assure la cohérence et la fiabilité des informations pour la supervision et la maintenance.
4 documents
Rest Frontage
Le RestFrontage, l’Enhancer de la solution Immersive, transforme un socle riche de données, de services et de règles de sécurité en une expérience claire, accessible et exploitable. Interfaces web, API, administration et intégration s’y rejoignent pour offrir aux utilisateurs comme aux applications une façade cohérente sur tout l’écosystème Immersive. **Une porte d’entrée unique, du socle technique jusqu’aux usages métier.**
19 documentsScripting
Apprenez à donner vie à vos plan en réagissant aux données recçus et en offrant une interface adaptée aux besoins de vos utilisateurs.
16 documentsÀ découvrir
Poursuivez votre exploration
Des ressources choisies aléatoirement dans la bibliothèque pour découvrir d’autres possibilités offertes par Immersive et les technologies GraphicStream.
Scripting : Géolocalisation
Ce tutoriel montre comment exploiter les données GPS d’un équipement pour l’afficher et le faire évoluer automatiquement dans le jumeau numérique 3D, sans écrire de JavaScript. Vous comprendrez quand utiliser GeoTracking, GeoMove ou NavMeshMove selon la précision des positions, la fréquence de remontée et le type de déplacement attendu. Le document détaille aussi la configuration exacte à prévoir côté variables, du format `longitude;latitude` aux champs d’orientation ou de marche arrière. À la lecture, vous saurez choisir le bon comportement natif, éviter les pièges liés au WGS 84 et obtenir un suivi visuel cohérent, du simple téléport à l’animation fluide sur graphe de navigation.
DécouvrirMy Building - Contrôle des lampes
Ce tutoriel montre comment rendre les lampes réellement interactives dans le jumeau numérique, au-delà d’un simple affichage d’état. Vous apprendrez à faire varier l’icône et la couleur d’une bulle selon l’allumage, pour repérer en un coup d’œil les équipements actifs. Il explique aussi comment ajouter une Quick Action contextuelle pour allumer ou éteindre une lampe directement depuis l’interface. À la fin, vous saurez lire la variable d’état, adapter le rendu visuel en 2D/3D et déclencher une commande vers l’API avec un retour utilisateur clair en cas de succès ou d’erreur.
DécouvrirAccorder des droits conditionnels
Comprenez comment accorder une permission sans jamais élargir le périmètre d’accès déjà acquis. Ce document montre, avec un cas concret autour de `See` et `Modify`, comment un droit conditionnel s’évalue sur le même objet et pourquoi il évite les sur-autorisations comme les maintenances manuelles ingérables. Vous verrez dans quel ordre la sécurité examine refus, droits directs et règles conditionnelles, ainsi que les effets réels d’un groupe fonctionnel combiné à des droits de visibilité. Vous saurez aussi créer, activer, désactiver ou supprimer ces règles depuis l’interface d’administration ou via l’API, en comprenant les contrôles d’intégrité, les dépendances autorisées et les limites à respecter.
DécouvrirColorer
Apprenez à utiliser la couleur comme un vrai outil de lecture dans Forge, bien au-delà d’un simple habillage visuel. Cette formation montre comment créer des matériaux, les attribuer aux zones, structures et objets, puis ajuster l’ambiance générale d’une carte en agissant aussi sur l’environnement. Vous verrez également comment personnaliser finement les modèles 3D, soit globalement, soit uniquement pour une carte donnée grâce aux styles. À la fin, vous saurez construire une carte plus claire, mieux hiérarchisée et visuellement cohérente, y compris pour des cas concrets comme la représentation de vides ou d’objets traversant plusieurs étages.
DécouvrirActiver un type d’objet pour la sécurité
Ce guide montre précisément ce que change le toggle d’un type d’objet dans la sécurité RestFrontage, et surtout ce qu’il ne fait pas. Vous verrez comment activer ou désactiver un type comme `Map`, `Equipment` ou `Workspace`, puis où enchaîner pour définir les permissions et les droits automatiques utiles. Le document aide à éviter les confusions fréquentes : un type actif n’accorde aucun accès par lui-même, et un type inactif ne supprime ni les droits existants ni les contrôles déjà branchés. En le parcourant, vous saurez lire l’état réel d’un type, comprendre l’impact d’une modification sur la configuration en mémoire et réagir correctement si un toggle est bloqué, ignoré ou revient à son état précédent.
Découvrir