Pular para o conteúdo
AstraDOCS

Importar um pacote pela Biblioteca

Passo a passo para trazer uma pasta de pacote (por exemplo, um pacote Unity extraído): catalogar, revisar, preparar o perfil e pôr na cena.

Validado no aparelho · APK 0.4.0 · fluxo usado no POCO F7 com pacotes de teste em 16 e 19/10

Copie a pasta do pacote para o aparelho (por exemplo, /sdcard/Astra/Pacotes/MeuPacote). Se for um .unitypackage, extraia antes no computador.

Barra superior › Importar › Pasta de pacote › escolha a pasta no seletor do Android. A Astra copia e cataloga cada arquivo: “Pacote preservado e catalogado; conversões são ações explícitas por item.” Nada é convertido ainda.

  • O trilho de tipos filtra: Todos, Modelos, Clipes, Materiais, Texturas, Prefabs, Cenas, Código, Documentos, Outros, Controllers, Projeto.
  • Cada cartão tem um selo: ✓ pronto, ⤓ a converter, ⚠ recusado (≈ quando é aproximado).
  • O cartão Materiais Unity mostra Completos, Aproximados e Sem conversão; tocar num bloco filtra a lista.

Toque o modelo › Abrir. O importador abre com as abas Resumo, Estrutura, Malhas, Texturas, Perfil e Rig/Takes.

No Perfil (páginas com Anterior / Próxima): Escala, Textura máxima, Compressão (ASTC), Normais, Tangentes, LOD, Gerar UV de lightmap e, no FBX, FBX rig/takes/morph, Mais de 4 influências (Reduzir top 4 ou Recusar perda), Steps e a taxa de Bake dos takes. Depois toque Preparar. Mudar o perfil depois pede preparar de novo.

Nas outras abas: Só recurso (fica no projeto) ou Na cena (põe na cena). Se a estrutura for ambígua, escolha Pela ordem ou Como novos.

Toque um prefab de efeito › Abrir. A Astra converte em cascata o que ele usa: materiais, sons WAV, prefabs de impacto e a malha das partículas. O resultado é um prefab Astra com Sistema de partículas e, conforme o efeito, Linha, Laser, Projétil, Instanciar ao colidir, Som repetido, Girar ou Seguir câmera. Ponha Na cena e aperte Play.

  • Para ouvir os sons 3D, a cena precisa de um Ouvinte de áudio: o projeto novo já traz um na Main Camera, e sem Ouvinte o Play ouve pela câmera do jogo.
  • O que não converte aparece no detalhe do item como perda ou aproximação; o efeito abre sem a parte que faltou.
  • Nenhum asset de pacote vem com a Astra: você importa os pacotes que tem.

.mat, .anim, .prefab e .controller convertem ao tocar Abrir. Para um clipe Humanoid, selecione antes o personagem na cena. Um prefab precisa das malhas e materiais já convertidos (“Converta primeiro a dependência pela Biblioteca”).

O detalhe do item mostra o motivo em chips (Conversão…, Aproximação…). As fontes ficam preservadas: dá para reimportar depois que a Astra ganhar o conversor.