Implementação e Otimização
Last updated
Last updated
Implementação é o processo de tornar a sua aplicação disponível ao público num website. Needle Engine garante que o seu projeto seja o menor e mais rápido possível, utilizando as mais recentes técnicas de compressão, como KTX2, Draco e Meshopt.
Ótimo para aplicações web espaciais e partilha de assets.
Ótimo para experimentação e mexer em código do lado do servidor.
Ótimo para alojar o seu próprio website e nomes de domínio personalizados.
Frequentemente usado para jogos.
Alojamento gratuito de páginas estáticas.
Plataforma para developers frontend
Implemente diretamente em qualquer servidor com suporte FTP. FTP e SFTP são suportados.
Ao compilar para uma pasta, pode fazer upload dos ficheiros para qualquer servidor web ou outro serviço de alojamento.
Plataforma de jogos no Facebook e Facebook Messenger.
::: tip Sente que algo está em falta? Por favor, informe-nos no nosso ! :::
Consulte os guias acima sobre como aceder às opções a partir do seu Editor (por exemplo, Unity ou Blender).
Geralmente recomendamos fazer compilações de produção para otimizar o tamanho do ficheiro e a velocidade de carregamento (veja mais informações abaixo).
As compilações de produção por padrão comprimirão texturas usando KTX2 (ETC1S ou UASTC, dependendo do seu uso no projeto), mas também pode selecionar a compressão WebP e escolher um nível de qualidade.
Como escolho entre a compressão ETC1S, UASTC e WebP?
Uso de Memória da GPU
Baixo
Baixo
Alto (uncompressed)
Tamanho do Ficheiro
Baixo
Alto
Muito baixo
Qualidade
Médio
Muito alto
Depende da configuração de qualidade
Uso Típico
Funciona para tudo, mas é melhor para texturas de cor
Texturas de dados de alta detalhe: mapas normais, rugosidade, metálico, etc.
Ficheiros onde a qualidade ETC1S não é suficiente, mas UASTC é demasiado grande
Tem a opção de selecionar a compressão de textura e opções de carregamento progressivo por Textura, usando o Needle Texture Importer no Unity ou no separador Material no Blender.
Por padrão, uma compilação de produção comprimirá malhas usando compressão Draco. Use o componente MeshCompression para selecionar entre draco e mesh-opt por glTF exportado.
Adicionalmente, pode configurar a simplificação de malha para reduzir a contagem de polígonos para compilações de produção nas configurações de importação de malha (Unity). Ao visualizar a sua aplicação no navegador, pode adicionar ?wireframe ao seu URL para pré-visualizar as malhas.
Como escolho entre Draco e Meshopt?
Uso de Memória da GPU
Médio
Baixo
Tamanho do Ficheiro
Mais baixo
Baixo
Compressão de Animação
Não
Sim
:::details Como posso definir configurações de compressão draco e meshopt? Adicione o componente MeshCompression para selecionar qual compressão deve ser aplicada por glTF exportado.
Para alterar a compressão da cena atual, basta adicioná-lo em qualquer lugar na sua cena raiz.
Para alterar a compressão de um prefab ou NestedGltf, adicione-o a um GltfObject ou ao prefab que é referenciado/exportado por qualquer um dos seus componentes.
Para alterar a compressão de uma cena referenciada, basta adicioná-lo à cena referenciada que é exportada :::
Também pode adicionar o componente Progressive Texture Settings em qualquer lugar na sua cena, para fazer com que todas as texturas no seu projeto sejam carregadas progressivamente. O carregamento progressivo não é aplicado a lightmaps ou texturas de skybox neste momento.
Com o carregamento progressivo, as texturas serão primeiro carregadas usando uma versão de resolução mais baixa. Uma versão de qualidade total será carregada dinamicamente quando a textura se tornar visível. Isto geralmente reduz significativamente o carregamento inicial da sua cena.
:::details Como posso ativar o carregamento progressivo de texturas?
Desde o Needle Engine 3.36, geramos automaticamente malhas LOD e alternamos entre elas em tempo de execução. Os LODs são carregados sob demanda e apenas quando necessário, de modo que este recurso reduz tanto o tempo de carregamento quanto o desempenho.
Principais Benefícios
Tempo de carregamento inicial mais rápido
Tempo de renderização mais rápido devido a menos vértices no ecrã em média
Raycasting mais rápido devido ao uso de malhas LOD
Pode desativar a geração de LODs para todo o seu projeto no componente Progressive Loading Settings ou nas configurações do Mesh Importer.
Pode implementar para glitch adicionando o componente DeployToGlitch à sua cena e seguindo as instruções.
Observe que projetos gratuitos alojados no glitch podem não exceder ~100 MB. Se precisar de fazer upload de um projeto maior, considere usar um alvo de implementação diferente.
:::details Como implemento para Glitch a partir do Unity?
Adicione o componente DeployToGlitch ao GameObject que também tem o componente ExportInfocomponent.
Assim que a Chave de Implementação for recebida, pode clicar no botão Build & Deploy para fazer upload para o glitch.
:::
:::details Como implemento para Glitch a partir do Blender?
Encontre o painel Deploy To Glitch no separador Cena
Clique no botão Remix on glitch no componente
O seu navegador abrirá o modelo de projeto glitch
Espere que o Glitch gere um novo projeto
Copie e cole o URL do projeto no painel DeployToGlitch do Blender como o nome do projeto (pode colar o URL completo, o painel extrairá as informações necessárias)
No Glitch, abra o ficheiro .env e insira uma password no campo Variable Value ao lado de DEPLOY_KEY
Insira a mesma password no Blender no campo Key
Clique no botão DeployToGlitch para compilar e fazer upload do seu projeto para o glitch. Um navegador abrirá quando o upload terminar. Tente atualizar a página se ela aparecer em preto depois de a abrir.
:::
Resolução de Problemas do Glitch
:::details Como implemento para Netlify a partir do Unity?
Basta adicionar o componente DeployToNetlify à sua cena e seguir as instruções. Pode criar novos projetos com o clique de um botão ou implementando para projetos existentes.
Crie um novo projeto no Vercel
Adicione o seu projeto web a um repositório github
Adicione o repositório ao seu projeto no Vercel
:::details Como implemento para itch.io a partir do Unity?
Espere que a compilação termine, abrirá uma pasta com o zip final quando terminar
Guarde a sua página itch e visualize a página do projeto itch. Agora deve carregar o seu projeto Needle Engine 😊
Configurações opcionais
:::details Itch.io: falha ao encontrar index.html
Falha ao encontrar index.html
:::
:::details Como implemento para o meu servidor FTP a partir do Unity?
Adicione o componente DeployToFTP¹ a um GameObject na sua cena (é uma boa prática adicioná-lo ao mesmo GameObject que o ExportInfo - mas não é obrigatório)
Atribua um asset de servidor FTP e preencha servidor, username e password, se ainda não o tiver feito ²Este asset contém as informações de acesso ao seu servidor FTP - obtém-nas ao criar uma nova conta FTP no seu fornecedor de alojamento
Clique no botão Build & Deploy no componente DeployToFTP para compilar o seu projeto e fazer upload para a sua conta FTP
:::details Como implemento para o meu servidor FTP manualmente?
Abra File > Build Settings, selecione Needle Engine e clique em Build
Espere que a compilação termine - a pasta dist resultante abrirá automaticamente após a execução de todos os passos de compilação e compressão.
Copie os ficheiros da pasta dist para o seu armazenamento FTP.
É isso! 😉
Nota: Se o resultado não funcionar ao fazer upload, pode ser que o seu servidor web não suporte a servir ficheiros gzipped. Tem duas opções para resolver o problema: Opção 1: Pode tentar ativar a compressão gzip no seu servidor usando um ficheiro htaccess! Opção 2: Pode desativar a compressão gzip nas configurações de compilação em File/Build Window e selecionando a plataforma Needle Engine.
Nota: Se estiver a ter erros durante a compressão, por favor, informe-nos e reporte um bug! Se o seu projeto funciona localmente e só falha ao fazer compilações de produção, pode resolver o problema imediatamente fazendo uma Compilação de Desenvolvimento. Para isso, basta ativar
Development Buildnas Configurações de Compilação.
:::
Ativando gzip usando um ficheiro .htaccess
Para ativar a compressão gzip no seu servidor FTP, pode criar um ficheiro chamado .htaccess no diretório onde deseja fazer upload (ou num diretório pai).
Insira o seguinte código no seu ficheiro .htaccess e guarde/faça upload para o seu servidor:
:::details Como implemento para Github Pages a partir do Unity?
:::
Resolução de problemas do github pages
Implementei para github pages, mas nenhuma ação está a correr / o website não está online
Se implementou pela primeira vez, pode demorar alguns minutos até que o seu website fique disponível. Pode verificar o separador Actions no github (/actions) para ver o processo de implementação.
Se o seu website não estiver online após alguns minutos ou não vir nenhuma execução de fluxo de trabalho no separador Actions no github, aceda à página de configurações Github Pages (/settings/pages) e certifique-se de que o Branch está definido para gh-pages
Com o Needle Engine, pode compilar para Facebook Instant Games automaticamente Não são necessários ajustes manuais à sua aplicação web ou jogo.
:::details Como implemento para Facebook Instant Games a partir do Unity?
Clique no botão Build For Instant Games
Depois que a compilação terminar, obterá um ficheiro ZIP que pode carregar para a sua aplicação do Facebook.
É isso - pode então clicar no botão Play ao lado de cada versão para testar o seu jogo no facebook.
:::
:::details Como crio uma aplicação no Facebook (com capacidades de Instant Games)
No Unity, abra File/Build Settings e selecione Needle Engine para opções:
Para compilar o seu projeto web para fazer upload para qualquer servidor web, pode clicar em Build na Janela de Configurações de Compilação do Unity Editor. Pode ativar a caixa de seleção Development Build para omitir a compressão (veja abaixo), o que exige que o toktx esteja instalado na sua máquina.
Para pré-visualizar localmente a sua compilação final, pode usar o botão Preview Build na parte inferior da janela. Este botão primeiro realizará uma compilação regular e depois iniciará um servidor local no diretório com os ficheiros finais, para que possa ver o que obtém assim que carregar estes ficheiros para o seu servidor web.
Nodejs é apenas necessário durante o desenvolvimento. O website distribuído (usando o nosso modelo vite padrão) é uma página estática que não depende de Nodejs e pode ser colocada em qualquer servidor web regular. Nodejs é necessário se quiser executar o nosso servidor de rede minimalista no mesmo servidor web (automaticamente contido no processo de implementação do Glitch).
É possível criar projetos Unity regulares onde pode compilar tanto para Needle Engine como para plataformas Unity regulares, como Desktop ou até mesmo WebGL. A nossa abordagem de "mapeamento de componentes" significa que nenhuma lógica de runtime é modificada dentro do Unity - se desejar, pode usar regularmente o Modo Play e compilar para outras plataformas alvo. Em alguns casos, isto significará que tem código duplicado (código C# e lógica TypeScript correspondente). A quantidade de trabalho extra com isto depende do seu projeto.
Needle Engine para Unity suporta vários argumentos de linha de comando para exportar assets individuais (Prefabs ou Cenas) ou para compilar um projeto web completo em modo batch (sem janela).
A lista seguinte apresenta uma tabela das opções disponíveis:
-scene
caminho para uma cena ou um asset a ser exportado, por exemplo, Assets/path/to/myObject.prefab ou Assets/path/to/myScene.unity
-outputPath <path/to/output.glb>
definir o caminho de saída para a compilação (apenas válido ao compilar uma cena)
-buildProduction
executar uma compilação de produção
-buildDevelopment
executar uma compilação de desenvolvimento
-debug
abrir uma janela de consola para debugging
Página traduzida automaticamente usando IA
A principal diferença para uma compilação de produção é que não realiza a compressão e (para redução do tamanho do ficheiro e velocidade de carregamento), nem a opção de carregar progressivamente texturas de alta qualidade.
Para fazer uma compilação de produção, precisa de ter o instalado, que fornece compressão de textura usando o formato de supercompressão KTX2. Por favor, aceda à e descarregue e instale a versão mais recente (v4.1.0 no momento da escrita). Poderá precisar de reiniciar o Unity após a instalação.Se tem a certeza de que instalou o toktx e ele faz parte do seu PATH, mas ainda não consegue encontrá-lo, por favor, reinicie a sua máquina e tente compilar novamente.
:::details Avançado: Extensões glTF personalizadas
Se planeia adicionar as suas próprias extensões glTF personalizadas, a compilação para produção exige o tratamento dessas extensões em gltf-transform. Consulte para referência.
:::
:::details Unity: Como posso definir configurações de compressão por textura? :::
:::details Blender: Como posso definir configurações de compressão por textura? Selecione o separador Material. Verá opções de compressão para todas as texturas usadas por esse material. :::
:::details Toktx não pode ser encontrado
Windows: Certifique-se de que adicionou toktx às suas variáveis de ambiente do sistema. Poderá precisar de reiniciar o computador após adicioná-lo para atualizar as variáveis de ambiente. O local de instalação padrão é C:\Program Files\KTX-Software\bin
:::
:::details Onde encontrar opções de simplificação de malha para reduzir a contagem de vértices ao compilar para produção? Selecione uma Malha e abra as opções do importador Needle para ver as opções disponíveis para a malha selecionada: :::
:::
oferece uma forma rápida e gratuita para todos alojarem websites pequenos e grandes. Oferecemos uma forma fácil de remixar e implementar para uma nova página Glitch (baseada no nosso starter), e também de executar um servidor de rede minimalista na mesma página Glitch, se necessário.
Clique no botão Create new Glitch Remix no componente
O Glitch irá agora criar um remix do modelo. Copie o URL do seu navegador
Abra o Unity novamente e cole o URL no campo Project Name do seu componente Deploy To Glitch
Espere alguns segundos até que o Unity tenha recebido a sua chave de implementação do glitch (esta chave é armazenada de forma segura no ficheiro .env no glitch. Não a partilhe com outros, qualquer pessoa com esta chave poderá fazer upload para o seu website no glitch)
Se clicar em Create new Glitch Remix e o navegador mostrar um erro como there was an error starting the editor, pode clicar em OK. Depois, aceda a e certifique-se de que está autenticado. Depois disso, tente clicar no botão novamente no Unity ou no Blender.
:::
Consulte o nosso para a configuração do projeto
Crie um novo projeto em
Defina Kind of project como HTML
Adicione o componente DeployToItch à sua cena e clique no botão Build
Faça upload do zip final para itch.io
Selecione This file will be played in the browser
:::
Se vir este erro após fazer upload do seu projeto, certifique-se de que não faz upload de um index.html gzipped.
Pode desativar a compressão gzip em vite.config.js na pasta do seu projeto web Needle. Basta remover a linha com viteCompression({ deleteOriginFile: true }). Compile o seu projeto novamente e faça upload para itch.
¹ Componente Deploy to FTP
² Asset de servidor FTP contendo as informações de acesso da sua conta de utilizador FTP
Componente Deploy To FTP depois do asset de servidor atribuído. Pode implementar diretamente para uma subpasta no seu servidor usando o campo path :::
Adicione o componente DeployToGithubPages à sua cena e copie/cole o repositório github (ou o url do github pages) para onde deseja implementar.
Adicione o componente Deploy To Facebook Instant Games à sua cena:
No Facebook, adicione o módulo Instant Games e aceda a Instant Games/Web hosting
Pode carregar o seu zip usando o botão Upload version (1). Depois que o upload terminar e o zip for processado, clique no botão Stage for testing para testar a sua aplicação (2, aqui o botão azul) ou Push to production (o botão com o ícone de estrela)
e selecione Other. Depois clique em Next
Selecione o tipo Instant Games
Depois de criar a aplicação, adicione o produto Instant Games
Aqui pode encontrar no facebook.Nota que tudo o que precisa fazer é criar uma aplicação com capacidades de instant games. Nós trataremos de tudo o resto e não são necessários ajustes manuais ao seu website Needle Engine. :::
Entrar no Modo Play no Unity
Em Project Settings > Needle Engine, pode desativar Override Play Mode e Override Build settings para alternar entre o processo de compilação do Needle e o processo de compilação do Unity:
