Introdução

O RealityConnect Embed permite colocar um visualizador do RealityTwin interativo e ao vivo diretamente dentro da sua própria aplicação web. O gêmeo é renderizado em um iframe, e um SDK JavaScript leve (@prevu3d/realityconnect-embed) dá à sua página o controle programático sobre ele — assim, seus usuários obtêm um contexto 3D imersivo sem nunca sair das ferramentas que já utilizam.

Como o embed é organizado

Vale a pena conhecer algumas decisões de design antes de começar a desenvolver:

Um visualizador básico que a sua página controla. O gêmeo incorporado é um visualizador 3D sem interface integrada — sem cabeçalho, barra lateral, menus ou barras de ferramentas. A sua aplicação possui toda a moldura ao redor e controla o gêmeo por meio do SDK.
Autorizado através da RealityConnect API. Cada sessão de embed é autorizada usando as credenciais OAuth da sua organização — não existe incorporação anônima. Seu backend solicita uma URL de embed assinada e de curta duração para um determinado gêmeo.
O SDK carrega e instrumenta o visualizador. Sua página entrega essa URL ao SDK, que injeta o iframe e estabelece um canal bidirecional seguro com o gêmeo.
Sua página controla o gêmeo. Assim que o visualizador informa que está pronto, os comandos do SDK ficam disponíveis para controlar o gêmeo (navegação, pontos de interesse, teletransporte para um objeto, captura de uma vista compartilhável) e para assinar o estado ao vivo da cena incorporada.
É a camada visual do RealityConnect. A RealityConnect API conecta seus sistemas e autoriza o acesso, enquanto o RealityConnect Embed renderiza o gêmeo e o expõe ao seu código de front-end.

Como as peças se encaixam

Três componentes colaboram para que uma sessão de embed funcione:

Seu backend autentica-se junto à RealityConnect API com o fluxo Client Credentials e, em seguida, solicita à API que crie uma sessão de embed de curta duração para um gêmeo específico. Este é o único lugar onde reside o client secret do OAuth.
Seu front-end recebe os valores da sessão do seu backend e os entrega ao SDK. O SDK injeta um iframe apontando para a URL de embed assinada e abre um canal postMessage seguro com ele.
O gêmeo incorporado renderiza a cena 3D, executa os comandos enviados pela sua página e transmite o estado ao vivo de volta (objeto selecionado, modo de câmera atual, vistas codificadas e mais).

O que o embed expõe

O SDK oferece à sua página uma API tipada para controlar a cena (navegação da câmera, pontos de interesse, teletransporte de objetos, compartilhamento de vistas, capturas de tela) e para assinar o estado ao vivo que retorna do gêmeo. A superfície completa — namespaces, ações, observáveis e códigos de erro — está documentada no README do SDK.

A tabela abaixo resume o que o embed cobre e o que não cobre hoje. Novas capacidades são adicionadas regularmente, portanto considere isto um instantâneo.

Capacidade	No embed?	Notas
Renderização de cenas 3D	Sim	A experiência completa de visualização do RealityTwin.
Modos de navegação da câmera	Sim	Perspectiva, ortográfica, fotosfera, terceira pessoa.
Pontos de interesse (ver, criar, editar)	Sim	Criação, edição e posicionamento de pontos de interesse.
Seleção de objetos e “teletransporte para”	Sim	Move a câmera para um objeto de negócio específico.
Links de vista compartilháveis	Sim	Codifica a câmera atual como uma cadeia compacta e a restaura depois em qualquer carregamento de página.
Capturas de tela	Sim	Captura a vista atual como bytes PNG.
Assinaturas de estado ao vivo	Sim	Observa a seleção, o passar do cursor, o modo de câmera, o estado da ferramenta de pontos de interesse e mais.
Interface integrada do gêmeo (menus, painéis, modais)	Não	Sua página anfitriã fornece todos os elementos de interface.
Recursos de edição (rascunhos, medições, zonas, RealityPlan Projects, inspeção CAD)	Não	Estes permanecem na aplicação completa do RealityTwin.

Casos de uso comuns

Plataformas de gestão e inspeção de ativos que desejam contexto 3D ao lado dos seus registros
Passeios virtuais e experiências de aprendizado on-line
Qualquer produto web que se beneficie de um gêmeo digital incorporado e navegável

Próximos passos

Primeiros passos: autentique-se, instale o SDK e carregue seu primeiro gêmeo incorporado.
RealityConnect API: a camada de autenticação e dados por trás do embed.
Exemplo ao vivo: uma integração funcional em Vue.js que você pode inspecionar de ponta a ponta.
@prevu3d/realityconnect-embed: repositório de fontes