Introductie
Met RealityConnect Embed plaatst u een live, interactieve RealityTwin-viewer rechtstreeks in uw eigen webapplicatie. De twin wordt in een iframe gerenderd, en een lichte JavaScript-SDK (@prevu3d/realityconnect-embed) geeft uw pagina programmatische controle erover — zo krijgen uw gebruikers een meeslepende 3D-context zonder ooit de tools te verlaten die ze al gebruiken.
Hoe de embed is opgebouwd
Section titled “Hoe de embed is opgebouwd”Enkele ontwerpkeuzes zijn de moeite waard om te kennen voordat u begint met bouwen:
- Een kale viewer die uw pagina aanstuurt. De ingesloten twin is een 3D-viewer zonder ingebouwde interface — geen koptekst, zijbalk, menu’s of werkbalken. Uw applicatie bezit al het omringende kader en stuurt de twin aan via de SDK.
- Geautoriseerd via de RealityConnect API. Elke embed-sessie wordt geautoriseerd met de OAuth-referenties van uw organisatie — anoniem insluiten bestaat niet. Uw backend vraagt een ondertekende, kortlevende embed-URL aan voor een bepaalde twin.
- De SDK laadt en instrumenteert de viewer. Uw pagina geeft die URL door aan de SDK, die het iframe injecteert en een beveiligd tweerichtingskanaal met de twin tot stand brengt.
- Uw pagina stuurt de twin aan. Zodra de viewer meldt dat hij gereed is, komen SDK-opdrachten beschikbaar om de twin aan te sturen (navigatie, points of interest, teleporteren naar een object, het vastleggen van een deelbare weergave) en om zich te abonneren op de live status van de ingesloten scène.
- Het is de visuele laag van RealityConnect. De RealityConnect API verbindt uw systemen en autoriseert toegang, terwijl RealityConnect Embed de twin rendert en aan uw front-endcode blootstelt.
Hoe de onderdelen samenwerken
Section titled “Hoe de onderdelen samenwerken”Drie componenten werken samen om een embed-sessie te laten werken:
- Uw backend authenticeert zich bij de RealityConnect API met de Client Credentials-flow en vraagt de API vervolgens om een kortlevende embed-sessie voor een specifieke twin aan te maken. Dit is de enige plek waar uw OAuth-clientgeheim zich bevindt.
- Uw front-end ontvangt de sessiewaarden van uw backend en geeft ze door aan de SDK. De SDK injecteert een iframe dat naar de ondertekende embed-URL wijst en opent er een beveiligd
postMessage-kanaal mee. - De ingesloten twin rendert de 3D-scène, voert de vanaf uw pagina verzonden opdrachten uit en stuurt de live status terug (geselecteerd object, huidige cameramodus, gecodeerde weergaven en meer).
Wat de embed blootstelt
Section titled “Wat de embed blootstelt”De SDK geeft uw pagina een getypeerde API om de scène aan te sturen (cameranavigatie, points of interest, objectteleportatie, weergave delen, schermafbeeldingen) en om zich te abonneren op de live status die van de twin terugkomt. Het volledige oppervlak — namespaces, acties, observables en foutcodes — is gedocumenteerd in de SDK-README.
De onderstaande tabel vat samen wat de embed vandaag wel en niet dekt. Er worden regelmatig nieuwe mogelijkheden toegevoegd, dus beschouw dit als een momentopname.
| Mogelijkheid | In de embed? | Opmerkingen |
|---|---|---|
| Rendering van 3D-scènes | Ja | De volledige RealityTwin-kijkervaring. |
| Cameranavigatiemodi | Ja | Perspectief, orthografisch, fotosfeer, third-person. |
| Points of interest (bekijken, aanmaken, bewerken) | Ja | Aanmaken, bewerken en plaatsen van points of interest. |
| Objectselectie en “teleporteren naar” | Ja | Verplaatst de camera naar een specifiek bedrijfsobject. |
| Deelbare weergavelinks | Ja | Codeert de huidige camera als een compacte reeks en herstelt die later bij elke pagina die wordt geladen. |
| Schermafbeeldingen | Ja | Legt de huidige weergave vast als PNG-bytes. |
| Abonnementen op live status | Ja | Observeert selectie, hover, cameramodus, de status van het points-of-interest-hulpmiddel en meer. |
| Ingebouwde twin-interface (menu’s, panelen, modals) | Nee | Uw hostpagina levert alle interface-elementen. |
| Bewerkingsfuncties (concepten, metingen, zones, RealityPlan Projects, CAD-inspectie) | Nee | Deze blijven in de volledige RealityTwin-applicatie. |
Veelvoorkomende gebruikssituaties
Section titled “Veelvoorkomende gebruikssituaties”- Platforms voor assetbeheer en -inspectie die 3D-context naast hun records willen
- Virtuele rondleidingen en eLearning-ervaringen
- Elk webproduct dat baat heeft bij een ingesloten, navigeerbare digital twin
Volgende stappen
Section titled “Volgende stappen”- Aan de slag: authenticeer, installeer de SDK en laad uw eerste ingesloten twin.
- RealityConnect API: de authenticatie- en gegevenslaag achter de embed.
- Live voorbeeld: een werkende Vue.js-integratie die u van begin tot eind kunt inspecteren.
@prevu3d/realityconnect-embed: broncoderepository