+

Needle Engine para Unity

O Needle Engine para Unity permite criar aplicações web altamente interativas, flexíveis e leves diretamente no Unity. Utilize as poderosas ferramentas do editor Unity para configurar visualmente as suas cenas 3D, animar e criar designs. O Needle Engine para Unity trata da exportação da sua cena para glTF e integra-se facilmente com qualquer framework de frontend web.

Instale o Pacote Unity

1. Arraste e largue o ficheiro .unitypackage descarregado para um projeto Unity e confirme que o pretende importar.

2. Aguarde um momento para que a instalação e importação terminem. Uma janela pode abrir indicando que "Um novo registo com escopo está agora disponível no Package Manager.". Este é o nosso registo de Pacotes Needle. Pode fechar essa janela em segurança.

3. Explorar Exemplos.
   Selecione a opção de menu Needle Engine > Explorar Exemplos para ver, abrir e modificar todas as cenas de exemplo disponíveis.

Tutorial em Vídeo de Início Rápido

Comece por um Exemplo

Existem mais de 100 exemplos que abrangem uma vasta gama de tópicos, casos de uso e indústrias.
Para uma visão geral rápida, veja a nossa página de Exemplos.

Todos estes exemplos estão disponíveis diretamente no Unity:

1. Vá para Needle Engine > Explorar Exemplos para procurar exemplos
2. Clique em "Instalar Exemplos" para instalar o pacote de exemplos diretamente no seu editor (ou descarregue o unitypackage de exemplos para instalar o pacote manualmente)
3. Escolha qualquer exemplo e clique em Abrir Cena.

Comece por um template

Fornecemos vários Scene Templates para iniciar rapidamente novos projetos.
Estes permitem que vá de uma ideia a um protótipo em poucos cliques.

1. Clique em Ficheiro > Nova Cena

2. Selecione um dos templates com (needle) no nome e clique em Criar.
   Recomendamos o template Collaborative Sandbox que é uma ótima maneira de começar com interatividade, multiplayer e adição de assets.

3. Clique em Play para instalar e iniciar o seu novo projeto web.

Comece do zero

Se não quiser começar de um scene template, pode seguir estes passos.
Efetivamente, vamos recriar o template "Minimal (Needle)" que vem com o pacote.

1. Crie uma nova cena vazia

2. Configure a sua cena para exportação
   Adicione um GameObject vazio, dê-lhe o nome "Exporter" e adicione o component Needle Engine (anteriormente chamado Export Info).
   Neste component, cria e acede rapidamente ao seu projeto runtime exportado.
   Também o avisa se algum dos nossos pacotes e módulos estiver desatualizado ou não estiver instalado localmente no seu projeto web.

   Nome do Projeto e Nome da Cena

   Por predefinição, o nome do projeto corresponde ao nome da sua cena. Se quiser alterar isso, pode escolher ou inserir um Nome de Diretório onde pretende criar o seu novo projeto web. O caminho é relativo ao seu projeto Unity.

3. Escolha um template de projeto web Agora, selecione um template de projeto web para o seu projeto. O template predefinido é baseado em Vite, um bundler rápido de aplicações web.
   
   

4. Clique em Play para instalar e iniciar o seu novo projeto web

Pastas e Ficheiros do Projeto

Ao criar um novo projeto web no Unity, pode optar por criá-lo a partir de um template local (por predefinição, fornecemos um template web baseado em vite).

Também pode referenciar templates remotos introduzindo um URL de repositório no caminho do projeto ExportInfo (isto pode ser guardado com a sua cena, por exemplo). Ao criar um novo projeto web, o repositório será clonado ou descarregado (dependendo se tem o git instalado) e procurado um ficheiro needle.config.json. Se nenhum for encontrado no repositório clonado, o diretório raiz será usado. Exemplos de projetos de template remotos podem ser encontrados em github.com/needle-engine

Projetos Temporários

Se estiver a planear adicionar apenas ficheiros personalizados via NpmDefs e não alterar a configuração do projeto (por exemplo, para um teste rápido em ecrã completo), pode prefixar o caminho do projeto com Library. O projeto será gerado na Biblioteca de Projetos Unity e não precisa de ser adicionado ao controlo de código-fonte (a pasta Library deve ser excluída do controlo de código-fonte). Chamamos a estes projetos de projetos temporários. São ótimos para testar ideias rapidamente!

Typescript no Unity

NPM Definition são pacotes npm firmemente integrados no Editor Unity, o que torna fácil partilhar scripts com múltiplos projetos web ou até mesmo Unity.

Stubs de component C# para ficheiros typescript também serão gerados automaticamente para scripts dentro de pacotes npmdef.

Criar e instalar um npmdef

Para criar um NPM Definition clique com o botão direito no navegador de Projeto Unity e selecione Criar/NPM Definition.
Pode instalar um pacote NPM Definition para o seu projeto runtime, por exemplo, selecionando o seu component Export Info e adicionando-o à lista de dependencies (internamente, isto apenas adicionará o pacote npm subjacente ao seu package.json).

Não se esqueça de instalar o pacote recém-adicionado, por exemplo, clicando em Install no component ExportInfo, e também reiniciar o servidor se já estiver a correr.

Para editar o código dentro de um pacote NPM Definition, basta fazer duplo clique no asset NPM Definition no seu navegador de projeto e abrirá o workspace do vscode que acompanha cada npmdef.

Próximos Passos

• Conceito: Projetos Web
• Conceito: Exportar Assets
• Conceito: Implementação (Partilhe o seu website)
• Components: Saiba mais sobre Everywhere Actions
• Scripting para Iniciantes: Fundamentos de Typescript
• Scripting para Iniciantes: Como escrever components personalizados

Página traduzida automaticamente usando IA