Documentação xr/studio
Conceitos Fundamentais
Aprenda os blocos fundamentais do xr/studio: workspaces, histórias, cenas, Gestor de Ativos, entidades e o inspetor.
Workspace
O seu primeiro workspace é criado automaticamente quando se regista. Um Workspace agrupa as suas histórias e ativos. Os colegas de equipa partilham tudo dentro de um workspace. Controla o acesso com funções: os Owners podem gerir faturação e membros, os Editors podem criar e editar histórias, os Viewers só podem pré-visualizar.
Nota: Enquanto estiver dentro de uma história no editor, use Back (←) para voltar primeiro ao dashboard; a gestão do workspace fica no cabeçalho do dashboard, não na barra de ferramentas do editor.
Story (Experience)
Uma Story é a sua experiência XR completa. Tem um título, definições, uma ou mais cenas, entidades, prefabs, ativos e vive na web.
Como tudo se liga
Workspace → Stories → Scenes → Entities / Assets

- Um Workspace contém as suas histórias, colegas de equipa, funções, definições, subscrições, prefabs, ativos e muito mais
- Uma Story pertence a um workspace. Armazena a versão de rascunho, a versão publicada, definições, cenas, ativos e ligação opcional a loja.
- Uma Scene pertence a uma história. Contém entidades, ações ao nível da cena, definições de timeline, física, regras de visibilidade, controlos de câmara e controlos do jogador.
- Uma Entity pertence a uma cena. As entidades podem estar aninhadas umas nas outras, animadas, etiquetadas, tornadas interativas ou ligadas a ativos.
- Um Asset pode ser reutilizado entre histórias e cenas. Dentro de uma história, os ativos também registam que cenas e entidades os utilizam para o Studio saber o que carregar e publicar.
Scene
Uma Scene é um "espaço" dentro da sua história. Pense em capítulos de um livro. Uma cena pode ser um ambiente 3D, um panorama 360°, um mapa, um feed de webcam, uma livestream, etc. Cada tipo tem capacidades diferentes.
As cenas reproduzem-se por ordem por defeito, ou pode deixar os utilizadores saltar entre elas usando ações.
Asset Manager
O Asset Manager é onde vivem todos os ficheiros que carrega: imagens, vídeos, modelos 3D, áudio, fontes e muito mais. Carregue uma vez, use em qualquer história dentro do mesmo workspace.
O Studio converte automaticamente os ficheiros carregados em formatos otimizados para a web: o vídeo torna-se HLS + WebM, os modelos 3D recebem compressão Draco, os Gaussian splats tornam-se formato SOG. Nunca precisa de lidar com o processamento bruto.
Entities
Tudo o que coloca numa cena é uma Entity. Existem mais de 50 tipos de entidade: imagens, vídeos, modelos 3D, luzes, câmaras, painéis GUI, fontes de áudio e muito mais. As entidades vivem numa hierarquia, para poder fazer parenting entre elas e movê-las em grupo.
As entidades também podem ter ações, tags, física, regras de visibilidade e animações de timeline. As ações podem visar uma entidade diretamente ou visar várias entidades por tag, o que é útil para mostrar, ocultar, animar ou navegar em grupo.
Prefabs
Um Prefab é um grupo reutilizável de entidades armazenado no seu workspace. Use prefabs para estruturas repetidas como cartões de produto, grupos de hotspots, painéis de UI com marca ou configurações de sala.
Quando coloca um prefab numa história, o Studio cria entidades reais na cena. As edições locais ficam nessa instância, para poder ajustar uma cópia sem quebrar o prefab original.
Published Story
Quando a sua história estiver pronta, carregue em Publish. O Studio gera um URL partilhável. Cada publicação atualiza esse mesmo URL, para que os espectadores que já têm o link vejam sempre a versão mais recente. Controla quem pode aceder: público, protegido por palavra-passe ou apenas equipa.