Introducción

RealityConnect Embed le permite colocar un visor de RealityTwin interactivo y en vivo directamente dentro de su propia aplicación web. El gemelo se renderiza en un iframe, y un ligero SDK de JavaScript (@prevu3d/realityconnect-embed) le da a su página control programático sobre él, de modo que sus usuarios obtienen un contexto 3D inmersivo sin salir nunca de las herramientas que ya utilizan.

Consejo

Hay una integración funcional de Vue.js disponible en rcembed-example.prevu3d.io. El código fuente completo está en GitHub en prevu3d/realityconnect-embed-example: un buen punto de partida si prefiere copiar una configuración funcional en lugar de crear una desde cero.

---

Cómo está organizado el embed

Vale la pena conocer algunas decisiones de diseño antes de empezar a desarrollar:

• Un visor básico que controla su página. El gemelo incrustado es un visor 3D sin interfaz integrada: sin encabezado, barra lateral, menús ni barras de herramientas. Su aplicación posee todo el marco circundante y controla el gemelo a través del SDK.
• Autorizado mediante la RealityConnect API. Cada sesión de embed se autoriza usando las credenciales OAuth de su organización; no existe la incrustación anónima. Su backend solicita una URL de embed firmada y de corta duración para un gemelo determinado.
• El SDK carga e instrumenta el visor. Su página entrega esa URL al SDK, que inyecta el iframe y establece un canal bidireccional seguro con el gemelo.
• Su página controla el gemelo. Una vez que el visor indica que está listo, los comandos del SDK quedan disponibles para controlar el gemelo (navegación, puntos de interés, teletransporte a un objeto, captura de una vista compartible) y para suscribirse al estado en vivo de la escena incrustada.
• Es la capa visual de RealityConnect. La RealityConnect API conecta sus sistemas y autoriza el acceso, mientras que RealityConnect Embed renderiza el gemelo y lo expone a su código de front-end.

Cómo encajan las piezas

Tres componentes colaboran para que funcione una sesión de embed:

1. Su backend se autentica ante la RealityConnect API con el flujo de Client Credentials y, a continuación, solicita a la API que cree una sesión de embed de corta duración para un gemelo específico. Este es el único lugar donde reside el client secret de OAuth.
2. Su front-end recibe los valores de sesión de su backend y los entrega al SDK. El SDK inyecta un iframe que apunta a la URL de embed firmada y abre un canal postMessage seguro con él.
3. El gemelo incrustado renderiza la escena 3D, ejecuta los comandos enviados desde su página y transmite el estado en vivo de vuelta (objeto seleccionado, modo de cámara actual, vistas codificadas y más).

Qué expone el embed

El SDK ofrece a su página una API tipada para controlar la escena (navegación de la cámara, puntos de interés, teletransporte a objetos, uso compartido de vistas, capturas de pantalla) y para suscribirse al estado en vivo que devuelve el gemelo. La superficie completa (namespaces, acciones, observables y códigos de error) está documentada en el README del SDK.

La siguiente tabla resume lo que el embed cubre y lo que no cubre hoy. Se añaden capacidades nuevas con regularidad, así que considérelo una instantánea.

Capacidad	¿En el embed?	Notas
Renderizado de escenas 3D	Sí	La experiencia completa de visualización de RealityTwin.
Modos de navegación de la cámara	Sí	Perspectiva, ortográfica, fotoesfera, tercera persona.
Puntos de interés (ver, crear, editar)	Sí	Creación, edición y colocación de puntos de interés.
Selección de objetos y «teletransporte a»	Sí	Mueve la cámara a un objeto de negocio específico.
Enlaces de vista compartibles	Sí	Codifica la cámara actual como una cadena compacta y la restaura después en cualquier carga de página.
Capturas de pantalla	Sí	Captura la vista actual como bytes PNG.
Suscripciones al estado en vivo	Sí	Observa la selección, el paso del cursor, el modo de cámara, el estado de la herramienta de puntos de interés y más.
Interfaz integrada del gemelo (menús, paneles, modales)	No	Su página anfitriona proporciona todos los elementos de interfaz.
Funciones de edición (borradores, mediciones, zonas, RealityPlan Projects, inspección CAD)	No	Estas permanecen en la aplicación completa de RealityTwin.

Nota

RealityConnect Embed está disponible en los planes Enterprise y se habilita por organización desde sus ajustes de Seguridad. Si no lo ve, póngase en contacto con su gestor de cuenta o su contacto de éxito del cliente.

Casos de uso comunes

• Plataformas de gestión e inspección de activos que desean un contexto 3D junto a sus registros
• Recorridos virtuales y experiencias de aprendizaje en línea
• Cualquier producto web que se beneficie de un gemelo digital incrustado y navegable

Próximos pasos

• Primeros pasos: autentíquese, instale el SDK y cargue su primer gemelo incrustado.
• RealityConnect API: la capa de autenticación y datos detrás del embed.
• Ejemplo en vivo: una integración funcional de Vue.js que puede inspeccionar de principio a fin.
• @prevu3d/realityconnect-embed: repositorio de fuentes