Português

Documentação xr/studio

Ativos

Carregue e gira ficheiros no Asset Manager. Saiba que formatos são suportados e como o Studio processa os seus carregamentos.

Asset Manager

O Asset Manager contém todos os ficheiros do seu workspace. Tudo o que carrega (imagens, vídeos, modelos 3D, Gaussian splats, ficheiros de áudio e fontes) fica armazenado aqui e pode ser reutilizado em todas as histórias do workspace.

Asset Manager: folders, asset grid, Generate AI Asset, and upload controls

Carregar ficheiros

Arraste ficheiros do ambiente de trabalho para o painel Asset Manager, ou carregue em Upload e escolha ficheiros no seu dispositivo. Podem ser carregados vários ficheiros de uma vez.

O tamanho máximo por ficheiro é 2 GB.

Asset Manager upload: My Uploads folder, Drop files to upload area, supported formats and 2 GB limit

  1. Abra o painel Asset Manager.
  2. Arraste ficheiros do ambiente de trabalho para o painel, ou carregue em Upload.
  3. Aguarde que o processamento termine. Um indicador de progresso mostra o estado.
  4. O ativo processado fica pronto a usar em qualquer cena.

Dica: Modelos 3D grandes e vídeos de alta resolução demoram um minuto a processar. Pode continuar a editar entretanto.

Tipos de ficheiro suportados

Estas são as extensões que o xr/studio aceita para novos carregamentos no Asset Manager ou quando arrasta ficheiros para o editor:

  • Imagens raster: BMP, GIF, JPEG, JPG, PNG, TIFF, WebP
  • Mapas de ambiente HDR: HDR, EXR
  • Vetorial: SVG
  • Vídeo: MOV, MP4, WEBM
  • Áudio: AAC, MP3, WAV
  • Modelos 3D: GLB
  • Gaussian splats / formatos splat: KSPLAT, PLY, SOG, SPLAT, SPZ
  • Legendas: VTT
  • Fontes: TTF

Media 360° e panorâmica usa os mesmos formatos de imagem ou vídeo acima (tipicamente vídeo ou imagem equirectangular).

Após o carregamento, o Studio pode converter ativos para reprodução na web (por exemplo vídeos para streams adaptativos como HLS e WebM, modelos GLB através de otimização, splats através de formatos de streaming). Não precisa de gerir a conversão.

Organizar com pastas

Crie pastas dentro do Asset Manager para manter os ativos organizados. Clique com o botão direito numa área vazia para criar uma pasta e depois arraste ativos para dentro. A estrutura de pastas é por workspace.

Adicionar ativos a uma cena

Arraste um ativo do Asset Manager para a cena ativa ou hierarquia enquanto o carregamento ou processamento ainda está em curso. Pode continuar a editar enquanto a conversão termina em segundo plano.

Ou abra o menu de um ativo (⋯) em My Uploads e escolha Insert para o colocar na cena ativa.

Asset Manager: open asset menu and choose Insert to add the asset to the scene

Também pode arrastar ficheiros do ambiente de trabalho diretamente para a cena ou hierarquia. O Studio regista-os no Asset Manager e permite colocar entidades da mesma forma.

O Studio escolhe o tipo de entidade a partir do ativo e da cena em que está. Por exemplo, o mesmo ficheiro de vídeo pode tornar-se um vídeo panorama num fluxo 360°, ou um vídeo GUI numa cena 3D. Cenas planas preferem um flat video ou flat image como primeira camada a ecrã inteiro; depois, largadas adicionais tornam-se GUI video ou GUI image.

Tipos de entidade que pode obter ao largar ou colocar um ativo:

Tipo de ativoTipos de entidade (depende da cena e forma do media)
Imagem raster (BMP, GIF, JPEG, PNG, TIFF, …)Panorama (360° still), Panorama 180 (in a 180° panorama scene), Flat image (first layer in a flat scene), GUI image (most 3D scenes, or additional layers in a flat scene)
Vídeo (MOV, MP4, WEBM)Panorama video, Panorama 180 video, Flat video, GUI video
HDR (.hdr, .exr)HDR
Vetorial (SVG)Flat image, GUI vector, or GUI image
Áudio (AAC, MP3, WAV)Audio global
Modelo 3D (GLB)Custom 3D model
Gaussian splat / formatos splat (KSPLAT, PLY, SOG, SPLAT, SPZ)Splat
Fonte (TTF)Text 3D
Legendas (VTT)Subtitle

O comportamento 360° vs plano usa as dimensões do ativo que o Studio lê do ficheiro (por exemplo equirectangular 360° vs widescreen padrão).

Importar de bibliotecas stock

Abra Public library no Asset Manager para explorar e importar media sem sair do Studio:

  • Pexels e Pixabay — fotos e vídeo
  • Poly Haven e Polyfork — modelos 3D
  • LottieFiles — animações Lottie (JSON)

Os itens importados ficam na biblioteca do workspace com atribuição quando necessário, prontos a arrastar para cenas como qualquer upload.

Pré-visualizar splats e GLB no macOS

Instale xr/quicklook em cyango.com/xr-quicklook para pré-visualizar Gaussian splats e modelos GLB no Finder Quick Look antes de os carregar no Studio. Orbite e desloque-se dentro do painel de pré-visualização para inspecionar geometria e cobertura do splat localmente.