Introduzione

RealityConnect Embed ti consente di collocare un visualizzatore RealityTwin interattivo e in tempo reale direttamente all’interno della tua applicazione web. Il gemello viene renderizzato in un iframe e un leggero SDK JavaScript (@prevu3d/realityconnect-embed) offre alla tua pagina il controllo programmatico su di esso, in modo che i tuoi utenti ottengano un contesto 3D immersivo senza mai lasciare gli strumenti che già utilizzano.

Come è organizzato l’embed

Vale la pena conoscere alcune scelte di progettazione prima di iniziare a sviluppare:

Un visualizzatore essenziale controllato dalla tua pagina. Il gemello incorporato è un visualizzatore 3D privo di interfaccia integrata: nessuna intestazione, barra laterale, menu o barra degli strumenti. La tua applicazione possiede tutta la cornice circostante e pilota il gemello tramite l’SDK.
Autorizzato tramite la RealityConnect API. Ogni sessione di embed è autorizzata utilizzando le credenziali OAuth della tua organizzazione: non esiste l’incorporamento anonimo. Il tuo backend richiede un URL di embed firmato e di breve durata per un determinato gemello.
L’SDK carica e strumenta il visualizzatore. La tua pagina passa quell’URL all’SDK, che inietta l’iframe e stabilisce un canale bidirezionale sicuro con il gemello.
La tua pagina pilota il gemello. Una volta che il visualizzatore segnala di essere pronto, i comandi dell’SDK diventano disponibili per controllare il gemello (navigazione, punti di interesse, teletrasporto verso un oggetto, acquisizione di una vista condivisibile) e per sottoscrivere lo stato in tempo reale della scena incorporata.
È il livello visivo di RealityConnect. La RealityConnect API collega i tuoi sistemi e autorizza l’accesso, mentre RealityConnect Embed renderizza il gemello e lo espone al tuo codice front-end.

Come si combinano i pezzi

Tre componenti collaborano affinché una sessione di embed funzioni:

Il tuo backend si autentica presso la RealityConnect API con il flusso Client Credentials, quindi chiede all’API di creare una sessione di embed di breve durata per un gemello specifico. Questo è l’unico punto in cui risiede il client secret OAuth.
Il tuo front-end riceve i valori della sessione dal tuo backend e li passa all’SDK. L’SDK inietta un iframe che punta all’URL di embed firmato e apre un canale postMessage sicuro con esso.
Il gemello incorporato renderizza la scena 3D, esegue i comandi inviati dalla tua pagina e trasmette lo stato in tempo reale (oggetto selezionato, modalità camera corrente, viste codificate e altro).

Cosa espone l’embed

L’SDK offre alla tua pagina un’API tipizzata per pilotare la scena (navigazione della camera, punti di interesse, teletrasporto di oggetti, condivisione delle viste, screenshot) e per sottoscrivere lo stato in tempo reale che torna dal gemello. La superficie completa — namespace, azioni, observable e codici di errore — è documentata nel README dell’SDK.

La tabella seguente riassume ciò che l’embed copre e ciò che non copre oggi. Vengono aggiunte regolarmente nuove capacità, quindi consideralo un’istantanea.

Capacità	Nell’embed?	Note
Rendering di scene 3D	Sì	L’esperienza di visualizzazione completa di RealityTwin.
Modalità di navigazione della camera	Sì	Prospettica, ortografica, fotosfera, terza persona.
Punti di interesse (visualizzare, creare, modificare)	Sì	Creazione, modifica e posizionamento dei punti di interesse.
Selezione di oggetti e «teletrasporto verso»	Sì	Sposta la camera verso un oggetto aziendale specifico.
Link di vista condivisibili	Sì	Codifica la camera corrente come stringa compatta, quindi la ripristina in seguito a qualsiasi caricamento della pagina.
Screenshot	Sì	Acquisisce la vista corrente come byte PNG.
Sottoscrizioni allo stato in tempo reale	Sì	Osserva selezione, passaggio del cursore, modalità camera, stato dello strumento punti di interesse e altro.
Interfaccia integrata del gemello (menu, pannelli, modali)	No	La tua pagina host fornisce tutti gli elementi di interfaccia.
Funzioni di modifica (bozze, misurazioni, zone, RealityPlan Projects, ispezione CAD)	No	Queste rimangono nell’applicazione completa RealityTwin.

Casi d’uso comuni

Piattaforme di gestione e ispezione degli asset che desiderano un contesto 3D accanto ai propri record
Tour virtuali ed esperienze di eLearning
Qualsiasi prodotto web che tragga vantaggio da un gemello digitale incorporato e navigabile

Prossimi passi

Per iniziare: autenticati, installa l’SDK e carica il tuo primo gemello incorporato.
RealityConnect API: il livello di autenticazione e dati dietro l’embed.
Esempio dal vivo: un’integrazione Vue.js funzionante che puoi ispezionare da cima a fondo.
@prevu3d/realityconnect-embed: repository dei sorgenti