Docs do NodaroIncorporações
As duas formas de levar o Nodaro ao seu produto: um miniapp que executa um workflow publicado e o viewport de cena 3D sem estado, e quando usar cada uma.
As incorporações colocam uma parte do Nodaro dentro do seu próprio produto. Existem duas, e elas resolvem problemas diferentes. A incorporação de miniapp executa um workflow publicado para os seus usuários, e o viewport de cena 3D mostra uma cena 3D, e opcionalmente a edita, sem executar nada.
Qual incorporação escolher
| Miniapp | Viewport de cena 3D | |
|---|---|---|
| O que faz | Executa um miniapp publicado: coleta as entradas, inicia uma execução e mostra o resultado. | Desenha um plano de cena 3D: o viewport, a reprodução, a lista de objetos, os editores de pose e o histórico de revisões. |
| Como incorporar | Sua própria interface sobre a API REST, ou um iframe com o código de incorporação do miniapp. | Um iframe em /embed/scene3d, controlado por postMessage. |
| Autenticação | Sua própria interface usa um token de API pessoal ou um token OAuth, guardado no seu servidor. O iframe usa a própria sessão do Nodaro de quem está vendo a página. | Nenhuma. O iframe não tem sessão e não faz nenhuma chamada de rede. |
| Créditos | Cada execução custa créditos, pagos pela conta em nome da qual a execução é feita. | Nunca. O visualizador não executa nenhum job. |
| Onde fica o estado | As execuções ficam armazenadas no Nodaro. | Sua página guarda a cena. O iframe não guarda nada de um carregamento para outro. |
Quando incorporar um miniapp
- Você publicou um workflow como miniapp, e seus usuários devem executá-lo a partir do seu site ou do seu app. Veja Apps.
- Você quer seu próprio formulário e seu próprio visual em volta do app. Crie os dois sobre a API REST.
- Você quer o caminho mais rápido. Cole o código de incorporação do miniapp na sua página.
Leia Incorporar um miniapp.
Quando incorporar o viewport de cena 3D
- Seu produto armazena planos de cena 3D, vindos de jobs de Gerar cena 3D (Generate 3D Scene) e de Editar cena 3D (Edit 3D Scene), e seus usuários devem vê-los.
- Seus usuários devem reproduzir uma cena, percorrer a linha do tempo e selecionar objetos nela, no modo somente leitura por padrão.
- Seus usuários devem editar poses, cores e bloqueios, e sua página salva cada nova revisão.
Leia Incorporar o viewport de cena 3D e, para os dados que o viewport desenha, Formato de cena 3D.
As duas mantêm os tokens fora do navegador
Nenhuma das incorporações coloca um token do Nodaro na sua página web. Quando você cria sua própria interface de miniapp, o token fica no seu servidor. O viewport de cena 3D nunca leva um token nas mensagens: sua página busca os assets da cena com a própria sessão e envia os bytes.
Perguntas frequentes
Páginas relacionadas
Incorporar um miniapp
Incorporar o viewport de cena 3D
Formato de cena 3D
Apps (miniapps)
Última atualização
Catálogos de seletores
Crie seletores do Nodaro em seu app com @nodaro/prompts, converta seleções em trechos de prompt, traduza rótulos, mostre imagens ou leia catálogos via API.
Incorporar um miniapp
Execute um miniapp do Nodaro no seu produto com o código de incorporação ou um formulário próprio na API REST: entradas, execuções, resultados e erros.