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.

Instalar o Pacote Unity

Arraste e largue o ficheiro .unitypackage descarregado para um projeto Unity e confirme que o pretende importar.
Aguarde um momento para que a instalação e importação terminem. Uma janela pode abrir indicando que "A new scoped registry is now available in the Package Manager.". Este é o nosso registo de Pacotes Needle. Pode fechar essa janela em segurança.
Explorar Exemplos.
Selecione a opção de menu Needle Engine > Explore Samples para ver, abrir e modificar todas as cenas de exemplo disponíveis.

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

Começar a partir de 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, consulte a nossa página de Exemplos.

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

Vá para Needle Engine > Explore Samples para procurar exemplos
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)
Escolha qualquer exemplo e clique em Abrir Cena.

Os Exemplos são só de leitura – o que os torna fáceis de atualizar.

As nossas cenas de exemplo fazem parte de um pacote UPM no Unity. Isto significa que não pode editar os assets e scripts diretamente nelas – são só de leitura. Para editar um asset do pacote de exemplos, copie-o para a pasta Assets do seu projeto. Para editar um script do pacote de exemplos, copie-o para a pasta src do seu projeto web.

Começar a partir de um template

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

Clique em Ficheiro > Nova Cena
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.
Clique em Play para instalar e iniciar o seu novo projeto web.

20220822-140539-wqvW-Unity_oC0z-needle

Começar do zero

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

Criar uma nova cena vazia
Configurar a sua cena para exportação
Adicione um GameObject vazio, nomeie-o "Exporter" e adicione o componente Needle Engine a ele (anteriormente chamado Export Info).
Neste componente, 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 Directory Name onde pretende criar o seu novo projeto web. O caminho é relativo ao seu projeto Unity.
Escolher 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.
Clique em Play para instalar e iniciar o seu novo projeto web

Defina os seus próprios templates

Se se encontrar a criar muitos projetos semelhantes, pode criar os seus próprios templates locais ou remotos usando o menu de contexto da Vista do Projeto em Criar/Needle Engine/Project Template. Os templates podem ser locais no disco (uma pasta a ser copiada) ou repositórios remotos (um repositório git a ser clonado).

Pastas e Ficheiros do Projeto

Assets/: É aqui que residem os assets específicos/exclusivos do projeto.
Packages/: É aqui que residem os pacotes instalados para este projeto. Um pacote pode conter qualquer tipo de asset, e pode ser adicionado a múltiplos projetos Unity. É, portanto, um ótimo método para partilhar código ou assets. Para saber mais sobre pacotes, consulte a documentação Unity sobre pacotes.
Packages/Needle Engine/: Needle Engine para Unity é um pacote que contém todos os ficheiros necessários para exportar a sua cena Unity para um projeto web. Contém também os componentes incorporados e as ferramentas para criar projetos web interativos. Pode atualizar o pacote através do Unity Package Manager.
Packages/Needle Engine/Core/
Packages/Needle Engine/Core/Runtime/
Packages/Needle Engine/Core/Runtime/Components/: Contém todos os componentes incorporados do Needle Engine. Pode aprender mais sobre eles na Referência de Componentes. Analisar exemplos e explorar esta pasta são ótimas maneiras de ver quais os componentes disponíveis e como podem ser usados nos seus projetos.

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

Unity ExportInfo local templates

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 Definitions são pacotes npm firmemente integrados no Editor Unity, o que torna fácil partilhar scripts entre múltiplos projetos web ou projetos Unity.

Stubs de componente C# para ficheiros TypeScript também serão gerados automaticamente para scripts dentro de pacotes NpmDef.

Criar e instalar um NpmDef

Para criar uma 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 componente Needle Engine (anteriormente Export Info) e adicionando-o à lista de dependencies (isto efetivamente adiciona o pacote NpmDef ao package.json do seu projeto web no array dependencies tal como faria manualmente ou executando npm i <path/to/package>).

Não se esqueça de instalar o pacote recém-adicionado, por exemplo, clicando em Instalar no componente 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 vscode workspace que acompanha cada npmdef.

Próximos Passos

Página traduzida automaticamente usando IA

File Tree: Projeto Unity