Introduction

RealityConnect Embed vous permet de placer un visualiseur RealityTwin interactif et en direct directement dans votre propre application web. Le jumeau est rendu dans une iframe, et un SDK JavaScript léger (@prevu3d/realityconnect-embed) donne à votre page un contrôle programmatique sur celui-ci — vos utilisateurs bénéficient ainsi d’un contexte 3D immersif sans jamais quitter les outils qu’ils utilisent déjà.

Comment l’embed est organisé

Quelques choix de conception méritent d’être connus avant de commencer à développer :

Un visualiseur nu que votre page contrôle. Le jumeau intégré est un visualiseur 3D sans interface intégrée — pas d’en-tête, de barre latérale, de menus ni de barres d’outils. Votre application possède tout l’habillage environnant et pilote le jumeau via le SDK.
Autorisé via la RealityConnect API. Chaque session d’embed est autorisée à l’aide des identifiants OAuth de votre organisation — il n’y a pas d’intégration anonyme. Votre back-end demande une URL d’embed signée et de courte durée pour un jumeau donné.
Le SDK charge et instrumente le visualiseur. Votre page transmet cette URL au SDK, qui injecte l’iframe et établit un canal bidirectionnel sécurisé avec le jumeau.
Votre page pilote le jumeau. Une fois que le visualiseur signale qu’il est prêt, les commandes du SDK deviennent disponibles pour contrôler le jumeau (navigation, points d’intérêt, téléportation vers un objet, capture d’une vue partageable) et pour s’abonner à l’état en direct de la scène intégrée.
C’est la couche visuelle de RealityConnect. La RealityConnect API connecte vos systèmes et autorise l’accès, tandis que RealityConnect Embed effectue le rendu du jumeau et l’expose à votre code front-end.

Comment les éléments s’assemblent

Trois composants collaborent pour faire fonctionner une session d’embed :

Votre back-end s’authentifie auprès de la RealityConnect API avec le flux Client Credentials, puis demande à l’API de créer une session d’embed de courte durée pour un jumeau spécifique. C’est le seul endroit où réside le client secret OAuth.
Votre front-end reçoit les valeurs de session de votre back-end et les transmet au SDK. Le SDK injecte une iframe pointant vers l’URL d’embed signée et ouvre un canal postMessage sécurisé avec celle-ci.
Le jumeau intégré effectue le rendu de la scène 3D, exécute les commandes envoyées depuis votre page et renvoie l’état en direct (objet sélectionné, mode de caméra actuel, vues encodées, et plus encore).

Ce que l’embed expose

Le SDK offre à votre page une API typée pour piloter la scène (navigation de la caméra, points d’intérêt, téléportation vers un objet, partage de vue, captures d’écran) et pour s’abonner à l’état en direct renvoyé par le jumeau. La surface complète — namespaces, actions, observables et codes d’erreur — est documentée dans le README du SDK.

Le tableau ci-dessous résume ce que l’embed couvre et ne couvre pas aujourd’hui. De nouvelles capacités sont ajoutées régulièrement ; considérez donc ceci comme un instantané.

Capacité	Dans l’embed ?	Notes
Rendu de scène 3D	Oui	L’expérience de visualisation RealityTwin complète.
Modes de navigation de la caméra	Oui	Perspective, orthographique, photosphère, troisième personne.
Points d’intérêt (voir, créer, modifier)	Oui	Création, modification et placement de points d’intérêt.
Sélection d’objet et « téléportation vers »	Oui	Déplace la caméra vers un objet métier spécifique.
Liens de vue partageables	Oui	Encode la caméra actuelle sous forme de chaîne compacte, puis la restaure ultérieurement à n’importe quel chargement de page.
Captures d’écran	Oui	Capture la vue actuelle sous forme d’octets PNG.
Abonnements à l’état en direct	Oui	Observe la sélection, le survol, le mode de caméra, l’état de l’outil de points d’intérêt, et plus encore.
Interface intégrée du jumeau (menus, panneaux, modales)	Non	Votre page hôte fournit tous les éléments d’interface.
Fonctions d’édition (brouillons, mesures, zones, RealityPlan Projects, inspection CAO)	Non	Celles-ci restent dans l’application RealityTwin complète.

Cas d’utilisation courants

Plateformes de gestion et d’inspection d’actifs souhaitant un contexte 3D à côté de leurs enregistrements
Visites virtuelles et expériences d’apprentissage en ligne
Tout produit web qui bénéficie d’un jumeau numérique intégré et navigable

Prochaines étapes

Premiers pas : authentifiez-vous, installez le SDK et chargez votre premier jumeau intégré.
RealityConnect API : la couche d’authentification et de données derrière l’embed.
Exemple en direct : une intégration Vue.js fonctionnelle que vous pouvez inspecter de bout en bout.
@prevu3d/realityconnect-embed : dépôt des sources