Needle Cloud

Visão Geral

Needle Cloud é um serviço online. Ajuda a armazenar, gerir e partilhar ativos e aplicações 3D na web. É suportada uma variedade de formatos de ficheiro, incluindo glTF, USD, FBX, VRM e mais. As aplicações web espaciais criadas com Needle podem ser implementadas diretamente a partir da integração Unity ou da nossa interface de linha de comando (CLI) Needle Cloud.

Visite Needle Cloud para criar uma conta gratuitamente.

Funcionalidades

1. Hospedar aplicações web espaciais
   As aplicações criadas com Needle podem ser implementadas na cloud diretamente a partir das nossas integrações de motor. Isto permite-lhe dar à sua equipa e clientes acesso público às aplicações facilmente, sem ter de configurar o seu próprio servidor. Se necessário, pode proteger as aplicações com uma palavra-passe.

2. Gerir ativos 3D de forma privada e segura
   Carregue e organize facilmente os seus ficheiros 3D. Graças à nossa rápida CDN (rede de entrega de conteúdo), os seus ficheiros são armazenados de forma segura e podem ser acedidos rapidamente a partir de qualquer parte do mundo. Needle Cloud não é um marketplace, nem uma rede social. Foi projetado para agências, estúdios e criadores gerirem os seus ativos de forma privada e segura.

3. Otimizar ativos 3D a partir de uma variedade de formatos
   Comprima automaticamente os seus ficheiros para reduzir o seu tamanho, mantendo a qualidade visual. Isto faz com que os seus ficheiros carreguem mais rápido e poupa largura de banda e memória nos dispositivos dos utilizadores.

4. Partilha e Controlo de Versões
   As ligações para os seus ficheiros podem ser partilhadas com outros e usadas diretamente nos seus projetos. Pode carregar novas versões de ativos e aplicações. Versões individuais podem ser rotuladas, o que permite fluxos de trabalho de revisão flexíveis: por exemplo, pode rotular uma versão como main ou experimental. Também pode reverter os rótulos para uma versão anterior, se necessário.

5. Ferramentas de Automação e Pipeline via CLI
   A CLI (command line interface) needle-cloud facilita a automatização do carregamento e otimização de ficheiros. Isto é útil para integrar o Needle Cloud no seu pipeline existente, ou para automatizar o carregamento de um grande número de ficheiros.

6. Gestão de Licenças
   As licenças para Needle Engine para criadores individuais e equipas são geridas através do Needle Cloud. Isto garante que apenas utilizadores autorizados podem aceder aos seus ficheiros e projetos. Contacte-nos para licenças Enterprise e Edu.

Implementar a partir do Unity

Needle Cloud está integrado no Unity Editor. Isto permite-lhe implementar as suas aplicações diretamente do Unity para o Needle Cloud. Também pode carregar e transferir ativos do Needle Cloud diretamente no Unity.

1. Instale a integração Unity, se ainda não o fez.
   Consulte esta página para mais informações.

2. Adicione o componente Needle Engine (anteriormente ExportInfo) à sua cena.
   Este componente é usado para configurar as definições de exportação para a sua aplicação.
   Pode usar o item de menu GameObject > Needle Engine > Add Export Info ou criar uma nova cena a partir de um modelo Needle via o item de menu File > New Scene.

3. Clique em Upload to Needle Cloud.
   Isto irá compilar a sua aplicação e carregá-la para o Needle Cloud. Também pode escolher implementar para uma equipa e projeto específicos. O nome de carregamento do projeto, visível ao lado do botão, é guardado na cena. Futuros carregamentos usarão o mesmo nome de carregamento, e todas as versões carregadas serão agrupadas no website do Needle Cloud.

   

Implementar a partir da CLI

Needle Cloud fornece uma interface de linha de comando (CLI) que lhe permite gerir os seus ativos e implementar as suas aplicações eficientemente. Pode usar a CLI para automatizar tarefas e integrar o Needle Cloud nos seus fluxos de trabalho existentes.

A CLI está disponível como um pacote npm, o que significa que precisa de ter o Node.js instalado na sua máquina. Pode verificar se tem o Node.js instalado executando o seguinte comando no seu terminal:

node -v

Se não tiver o Node.js instalado, pode transferi-lo a partir do website do Node.js.

Pode instalar o pacote CLI needle-cloud globalmente ou usá-lo via npx. Isto permite-lhe executar os comandos da CLI sem ter de a instalar globalmente.

1. Use o comando npx (recomendado)

   npx needle-cloud deploy '/dist' --team 'My team' --name 'some-project-id'

2. Ou instale needle-cloud globalmente
   Uma instalação global permite usar a CLI a partir de qualquer lugar no seu sistema. Para instalar a CLI globalmente, execute o seguinte comando no seu terminal:

   npm install -g needle-cloud

   Agora, pode usar o comando needle-cloud no seu terminal:

   needle-cloud deploy '/dist' --team 'My team' --name 'some-project-id'

Implementações Automatizadas

Para implementar a partir de Github Actions ou Stackblitz, pode fornecer um token de acesso como --token <access_token>. Os tokens de acesso podem ser criados na sua página de equipa no Needle Cloud. Certifique-se de criar o seu token com permissões de read/write.

Use a Needle Cloud Github Action para implementar uma atualização a partir do Github (por exemplo, sempre que fizer um push para o repositório)

Exemplo: Needle Cloud Github Action

      - name: Deploy to Needle Cloud
        uses: needle-tools/deploy-to-needle-cloud-action@v1
        id: deploy
        with:
            token: ${{ secrets.NEEDLE_CLOUD_TOKEN }}
            dir: ./dist
            name: vite-template # optional

Exemplo: Implementar usando um comando CLI

# Implementar para Needle Cloud a partir de, por exemplo, uma ação do github
npx needle-cloud deploy '/path/to/output' --team 'My team' --name 'some name or id' --token '<access_token>'

Ajuda da CLI

Use help para ver todas as opções de linha de comando disponíveis e ajuda para comandos individuais.

# ver todas as opções disponíveis
npx needle-cloud help
# obter ajuda para um comando específico, por exemplo, deploy
npx needle-cloud help deploy

URLs de Implementação

Ao implementar para o Needle Cloud, cada carregamento obtém um URL único. Pode partilhar uma ligação para uma versão específica, ou para uma versão rotulada com a sua equipa ou clientes.

No exemplo seguinte, temos uma aplicação que até agora foi implementada duas vezes. Cada implementação obtém um URL específico, também conhecido como URL fixo, uma vez que está fixo a uma versão específica.

1. collaborativesandbox-zubcks1qdkhy-1qdkhy.needle.run
   Esta é a primeira versão que foi carregada.
2. collaborativesandbox-zubcks1qdkhy-2e2spt.needle.run
   Esta é a segunda versão que foi carregada.

A implementação latest está sempre disponível no seguinte URL. Este URL é útil para partilhar com a sua equipa, pois aponta sempre para a versão mais recente da aplicação. Outro nome comum para esta versão é dev ou canary.

• collaborativesandbox-zubcks1qdkhy-latest.needle.run
  Este URL mostra automaticamente a nova versão quando carrega uma nova versão da aplicação.

A implementação main é útil para partilhar com clientes, pois aponta sempre para a versão mais recente da aplicação que promoveu. Outros nomes comuns para esta versão são production, stable ou live.

• collaborativesandbox-zubcks1qdkhy.needle.run
  Este URL não muda quando carrega uma nova versão. Só mudará quando promover explicitamente uma nova versão para main.

Tipicamente, carrega uma nova versão, revê-a e depois decide se a quer promover para main.

O website do Needle Cloud mostra todas as versões implementadas da aplicação, incluindo as versões latest e main. Os rótulos podem ser movidos clicando em ⋮ e selecionando Definir rótulo principal ou Remover rótulo principal.

Formatos 3D Suportados

1. glTF e GLB Exemplo
   O formato glTF é o formato mais amplamente suportado para 3D na web. É um formato leve que pode armazenar modelos 3D, animações e texturas. Os ficheiros GLB são versões binárias de ficheiros glTF, onde todos os dados são armazenados num único ficheiro. glTF suporta técnicas de compressão avançadas como Draco, KTX2 e Meshopt, que são totalmente suportadas pelo Needle Cloud e Needle Engine.

2. OpenUSD
   USD é um formato poderoso para intercâmbio de dados 3D. É conhecido pelo seu uso na indústria cinematográfica e de VFX, e está a ganhar popularidade na indústria de jogos. Needle Cloud suporta ficheiros USDZ e USD nativamente através do nosso trabalho em USD-WASM, e também converte ficheiros USD para glTF para processamento e otimização adicionais.

3. FBX
   FBX tem sido um formato popular para intercâmbio de dados 3D por muitos anos, mas carece de uma série de funcionalidades modernas como materiais PBR e extensões. Needle Cloud converte ficheiros FBX para glTF para processamento e otimização adicionais.

4. VRM
   VRM é um formato para avatares humanoides. Baseia-se em glTF com restrições adicionais através do uso de extensões glTF. Needle Cloud suporta ficheiros VRM nativamente, e pode otimizá-los como outros ficheiros glTF, incluindo extensões VRM complexas como phonemes, toon shading e dynamic bones.

5. OBJ
   OBJ é um formato simples baseado em texto para modelos 3D. Suporta materiais básicos através de ficheiros MTL, animações e hierarquias de objetos. Needle Cloud converte ficheiros OBJ para glTF para processamento e otimização adicionais.

Cloud Assets

Carregar Ativos

Pode carregar os seus ficheiros facilmente arrastando-os para o website ou selecionando-os do seu computador. Os ficheiros não glTF são automaticamente convertidos para glTF para processamento adicional, mas os ficheiros originais são mantidos para transferência e visualização web.

Versões de Ativos

Ao visitar a Página de Edição de um ativo, pode ver todas as versões que foram carregadas até agora por si ou pela sua equipa. Também pode etiquetar versões para as marcar como "main" ou "experimental". "Latest" é a etiqueta padrão para a versão mais recente.

Partilhar Ligações para Ativos

Pode criar ligações para partilhar ficheiros específicos ou ficheiros etiquetados com a sua equipa ou clientes. As ligações etiquetadas atualizarão automaticamente quando mover a etiqueta – assim, pode partilhar uma ligação "main" uma vez e continuar a atualizar o ficheiro sem ter de enviar uma nova ligação.

Utilizar Cloud Assets no Needle Engine

Os ficheiros armazenados no Needle Cloud podem ser facilmente levados diretamente para projetos Needle Engine. O componente Needle Cloud Asset aceita uma ligação para um ativo e carrega-o em runtime. Isto permite manter o tamanho do seu projeto pequeno e carregar ativos sob demanda que ainda podem ser atualizados na cloud.

Incorporar o Cloud Viewer no Seu Website

Uma maneira rápida de trazer 3D para o seu próprio website é incorporar o viewer do Needle Cloud. Para fazê-lo, vá à Página de Edição de um ativo e clique em Incorporar. Pode então copiar o snippet de código iframe e colá-lo no seu website.

Incorporar noutros frameworks

As seguintes opções de incorporação estão disponíveis:

1. Needle Cloud Viewer
   Use o snippet de código iframe para incorporar o viewer do Needle Cloud no seu website.

2. Needle Engine
   Use o snippet de código fornecido para incorporar Needle Engine no seu website como web component.

3. model-viewer
   O projeto model-viewer fornece um web component para renderizar modelos 3D simples e não interativos no browser.

4. three.js
   Se estiver familiarizado com three.js, pode usar o snippet de código fornecido como ponto de partida para uma aplicação three.js que suporta Needle Progressive Loading e carrega ficheiros eficientemente a partir do Needle Cloud.

5. React-Three-Fiber
   Se estiver a usar React-Three-Fiber, pode usar o snippet de código fornecido como ponto de partida para um projeto que suporta Needle Progressive Loading e carrega ficheiros eficientemente a partir do Needle Cloud.

6. Unity
   Se estiver a usar Unity, pode integrar ativos do Needle Cloud diretamente nos seus projetos usando o componente Needle Cloud Asset para carregamento e otimização contínuos.

Utilizar Cloud Assets com outros engines como Unity ou Unreal

Existem várias maneiras de usar ativos armazenados no Needle Cloud noutros engines como Unity ou Unreal.

1. Transferir e Importar
   Pode transferir o ativo e importá-lo para o seu projeto.

2. Ligação Direta
   Pode usar a ligação direta para o ativo no seu projeto. Desta forma, pode atualizar o ativo no Needle Cloud e este atualizará automaticamente no seu projeto. Que ligação usar depende do engine e das suas capacidades glTF:

   • Suporte para glTF com Progressive Loading:
     Use a ligação Progressive-World ou Progressive-Product. Consulte npm:@needle-tools/gltf-progressive para mais informações sobre carregamento progressivo e como ativá-lo para o seu engine.

   • Suporte para glTF com Draco e KTX2: Use a ligação Optimized.

   • Suporte para glTF, mas sem extensões de compressão:
     Use a ligação Upload (para carregamentos gltf/glb) ou Converted (para outros carregamentos).

3. Componente Needle Cloud Asset
   Se estiver a usar Needle Engine, pode usar o componente Needle Cloud Asset para carregar ativos em runtime. Ele escolherá automaticamente a melhor ligação para a sua plataforma e carregará o ativo com Progressive Loading. Isto também é suportado em runtime em Unity Builds.

CLI para Ativos

A interface de linha de comando (CLI) para Needle Cloud permite automatizar o carregamento e a compressão de ficheiros. A CLI pode ser usada como parte de um passo de build (substituindo um ativo por uma versão otimizada), ou como uma ferramenta autónoma (para processamento em batch de ficheiros).

Consulte npm:needle-cloud para mais informações sobre a CLI e como usá-la.

RBAC (controlo de acesso baseado em funções)

As equipas são compostas por membros, e cada membro de uma equipa pode ter uma função atribuída. Estas funções definem o que pode e não pode fazer dentro de uma equipa no Needle Cloud.

À medida que o seu projeto cresce e adiciona mais membros à equipa, pode atribuir-lhes funções para garantir que têm as permissões certas para trabalhar nos seus projetos.

Perguntas Frequentes

1. O que é Needle Cloud?
   É um serviço online para carregar, comprimir e partilhar ativos e cenas 3D.

2. Como carrego ativos para o Needle Cloud?
   Pode carregar ficheiros arrastando-os para o website, ou carregando-os diretamente de integrações suportadas. Se tiver muitos ficheiros, pode usar a CLI (interface de linha de comando) ou a API (interface de programação de aplicações).

3. Como transfiro ficheiros otimizados do Needle Cloud?
   Pode transferir ficheiros do website. Clique em Partilhar e depois em Transferir. Também pode usar a CLI para transferir ficheiros.

4. Posso partilhar os meus ficheiros com outros?
   Sim, pode criar ligações para partilhar os seus ficheiros. As ligações podem ser ligações de transferência direta, ou ligações para o viewer do Needle Cloud.

5. Existe um limite para o tamanho dos ficheiros?
   Os limites de carregamento dependem do seu plano. Verifique os detalhes da sua conta para mais informações.

6. Os ficheiros Needle Cloud podem ser usados com outras ferramentas?
   Sim, pode usar os seus ficheiros noutros programas exportando-os como glTF. A exportação USD estará disponível numa fase posterior.

7. O que acontece se ficar sem espaço de armazenamento?
   Pode precisar de atualizar o seu plano ou eliminar ficheiros antigos para libertar espaço.

8. Mais respostas
   Visite as Perguntas Frequentes do Needle Cloud

Página traduzida automaticamente usando IA