Needle Engine
  • README
  • Code Of Conduct
  • HOW TO
  • documentation
    • SUMMARY
    • _backlog-mermaid
    • _backlog
    • _meta-test
    • Automatic Component Generation
    • Needle Core Components
    • How To Debug
    • Deployment and Optimization
    • embedding
    • Everywhere Actions
    • Example Projects ✨
    • Exporting Assets, Animations, Prefabs, Materials, Lightmaps...
    • Questions and Answers (FAQ) 💡
    • Feature Overview
    • This page has been moved: continue here
    • getting-started
    • Frameworks, Bundlers, HTML
    • index
    • Additional Modules
    • Networking
    • Needle Engine Project Structure
    • Samples Projects
    • Scripting Examples
    • Creating and using Components
    • Live
    • Live
    • About
    • Live
    • Live
    • Live
    • Live
    • Support, Community & AI
    • Technical Overview
    • Testimonials
    • Testing on local devices
    • Using Needle Engine directly from HTML
    • vision
    • VR & AR (WebXR)
    • blender
      • Needle Engine for Blender
    • cloud
      • Needle Cloud
    • custom-integrations
      • index
    • getting-started
      • Scripting Introduction for Unity Developers
      • Getting Started & Installation
      • Scripting in Needle Engine
    • reference
      • needle.config.json
      • <needle-engine> Configuration
      • @serializable and other decorators
    • three
      • index
    • unity
      • Editor Sync
      • Needle Engine for Unity
    • lang
      • de
        • 404
        • SUMMARY
        • Automatische Komponenten-Generierung
        • Needle-Kernkomponenten
        • Debugging
        • Bereitstellung und Optimierung
        • embedding
        • Everywhere Actions
        • Beispielprojekte ✨
        • Assets, Animationen, Prefabs, Materialien, Lightmaps exportieren...
        • Fragen und Antworten (FAQ) 💡
        • Funktionsübersicht
        • Diese Seite wurde verschoben: hier fortfahren
        • getting-started
        • Frameworks, Bundler, HTML
        • index
        • Zusätzliche Module
        • Netzwerkfunktionen
        • Needle Engine Projektstruktur
        • Beispielprojekte
        • Scripting Beispiele
        • Erstellen und Verwenden von Komponenten
        • Live
        • Live
        • Über
        • Live
        • Live
        • Live
        • Live
        • Support und Community
        • Technischer Überblick
        • Erfahrungsberichte
        • Testen auf lokalen Geräten
        • Needle Engine direkt aus HTML verwenden
        • vision
        • VR & AR (WebXR)
        • blender
          • Needle Engine für Blender
        • cloud
          • Needle Cloud
        • custom-integrations
          • index
        • getting-started
          • Einführung in das Scripting für Unity-Entwickler
          • Erste Schritte & Installation
          • Scripting in Needle Engine
        • reference
          • needle.config.json
          • <needle-engine> Konfiguration
          • @serializable und andere Decorators
        • three
          • index
        • unity
          • Editor Synchronisierung
          • Needle Engine für Unity
      • es
        • SUMMARY
        • Generación Automática de Componentes
        • Componentes principales de Needle
        • Cómo Depurar
        • Despliegue y optimización
        • embedding
        • Acciones Everywhere
        • Proyectos de Ejemplo ✨
        • Exportación de Assets, Animaciones, Prefabs, Materiales, Lightmaps...
        • Preguntas Frecuentes (FAQ) 💡
        • Resumen de Características
        • Esta página ha sido movida: continúe aquí
        • getting-started
        • Frameworks, Bundlers, HTML
        • index
        • Módulos Adicionales
        • Redes
        • Estructura de Proyecto de Needle Engine
        • Proyectos de ejemplo
        • Ejemplos de scripting
        • Crear y usar Components
        • En vivo
        • En Vivo
        • Acerca de
        • En vivo
        • En vivo
        • En vivo
        • En vivo
        • Soporte y Comunidad
        • Resumen técnico
        • Testimonios
        • Testing on local devices
        • Usando Needle Engine directamente desde HTML
        • vision
        • VR & AR (WebXR)
        • blender
          • Needle Engine para Blender
        • cloud
          • Needle Cloud
        • custom-integrations
          • index
        • getting-started
          • Introducción al Scripting para Desarrolladores de Unity
          • Primeros pasos e instalación
          • Scripting in Needle Engine
        • reference
          • needle.config.json
          • Configuración de <needle-engine>
          • @serializable y otros decoradores
        • three
          • index
        • unity
          • Editor Sync
          • Needle Engine para Unity
      • fr
        • SUMMARY
        • Génération automatique de composants
        • Composants principaux de Needle
        • Comment déboguer
        • Déploiement et Optimisation
        • embedding
        • Everywhere Actions
        • Exemples de Projets ✨
        • Exporter des Assets, des Animations, des Prefabs, des Matériaux, des Lightmaps...
        • Questions et Réponses (FAQ) 💡
        • Aperçu des fonctionnalités
        • Cette page a été déplacée : continuez ici
        • getting-started
        • Frameworks, Bundlers, HTML
        • index
        • Modules supplémentaires
        • Réseau
        • Structure du projet Needle Engine
        • Projets d'exemples
        • Exemples de Scripting
        • Créer et utiliser des Components
        • showcase-bike
        • En direct
        • À propos
        • En direct
        • Jouer
        • En direct
        • En direct
        • Support et Communauté
        • Vue d'ensemble technique
        • Témoignages
        • Tester sur les appareils locaux
        • Utiliser Needle Engine directement depuis HTML
        • vision
        • VR & AR (WebXR)
        • blender
          • Needle Engine pour Blender
        • cloud
          • Needle Cloud
        • custom-integrations
          • index
        • getting-started
          • Introduction au Scripting pour les Développeurs Unity
          • Premiers pas et installation
          • Scripting in Needle Engine
        • reference
          • needle.config.json
          • <needle-engine> Configuration
          • @serializable et autres décorateurs
        • three
          • index
        • unity
          • Synchronisation de l'Editor (Editor Sync)
          • Needle Engine pour Unity
      • hi
        • SUMMARY
        • कंपोनेंट का स्वतः जनरेशन
        • नीडल कोर कंपोनेंट्स
        • How To Debug
        • Deployment and Optimization
        • embedding
        • Everywhere Actions
        • उदाहरण प्रोजेक्ट ✨
        • एसेट, एनिमेशन, प्रीफैब, मटेरियल, लाइटमैप्स... को एक्सपोर्ट करना
        • प्रश्न और उत्तर (FAQ) 💡
        • सुविधा अवलोकन
        • यह पृष्ठ स्थानांतरित कर दिया गया है: यहां जारी रखें
        • getting-started
        • Frameworks, Bundlers, HTML
        • index
        • अतिरिक्त मॉड्यूल
        • नेटवर्किंग
        • Needle Engine प्रोजेक्ट स्ट्रक्चर
        • samples-and-modules
        • स्क्रिप्टिंग उदाहरण
        • कंपोनेंट बनाना और उपयोग करना
        • लाइव
        • लाइव
        • परिचय
        • लाइव
        • लाइव
        • लाइव
        • लाइव
        • समर्थन और समुदाय
        • तकनीकी अवलोकन
        • प्रशंसापत्र
        • Testing on local devices
        • HTML से सीधे Needle Engine का उपयोग करना
        • vision
        • VR & AR (WebXR)
        • blender
          • Needle Engine for Blender
        • cloud
          • Needle Cloud
        • custom-integrations
          • index
        • getting-started
          • Unity डेवलपर्स के लिए स्क्रिप्टिंग परिचय
          • आरंभ करना और इंस्टॉलेशन
          • Needle Engine में स्क्रिप्टिंग
        • reference
          • needle.config.json
          • <needle-engine> कॉन्फ़िगरेशन
          • @serializable and other decorators
        • three
          • index
        • unity
          • Editor Sync
          • Unity के लिए Needle Engine
      • ja
        • SUMMARY
        • 自動コンポーネント生成
        • Needleコアコンポーネント
        • デバッグの方法
        • デプロイと最適化
        • embedding
        • Everywhere Actions
        • サンプルプロジェクト ✨
        • アセット、アニメーション、Prefab、マテリアル、ライトマップなどのエクスポート
        • よくある質問(FAQ)💡
        • 機能概要
        • このページは移動しました: こちらからどうぞ
        • getting-started
        • フレームワーク、バンドラー、HTML
        • index
        • 追加モジュール
        • ネットワーキング
        • Needle Engineプロジェクトの構造
        • サンプルプロジェクト
        • スクリプティング例
        • Creating and using Components
        • ライブ
        • showcase-castle
        • 概要
        • ライブ
        • ライブ
        • ライブ
        • ライブ
        • サポートとコミュニティ
        • 技術概要
        • お客様の声
        • ローカルデバイスでのテスト
        • HTMLからNeedle Engineを直接使用する
        • vision
        • VR & AR (WebXR)
        • blender
          • Blender 用 Needle Engine
        • cloud
          • Needle Cloud
        • custom-integrations
          • index
        • getting-started
          • Scripting Introduction for Unity Developers
          • はじめに & インストール
          • Needle Engineでのスクリプティング
        • reference
          • needle.config.json
          • <needle-engine> 設定
          • @serializable およびその他のデコレーター
        • three
          • index
        • unity
          • Editor Sync
          • Unity用Needle Engine
      • pt
        • SUMMARY
        • Automatic Component Generation
        • Componentes Principais do Needle
        • Como Depurar
        • Implementação e Otimização
        • embedding
        • Everywhere Actions
        • Projetos de Exemplo ✨
        • Exportar Recursos, Animações, Prefabs, Materiais, Lightmaps...
        • Perguntas e Respostas (FAQ) 💡
        • Visão Geral dos Recursos
        • Esta página foi movida: continue aqui
        • getting-started
        • Frameworks, Bundlers, HTML
        • index
        • Módulos Adicionais
        • Redes
        • Estrutura do Projeto Needle Engine
        • Projetos de Exemplo
        • Exemplos de Scripting
        • Criar e usar Componentes
        • Ao Vivo
        • Ao Vivo
        • Sobre
        • Ao Vivo
        • Ao Vivo
        • Ao Vivo
        • Ao Vivo
        • Suporte e Comunidade
        • Visão Geral Técnica
        • Depoimentos
        • Testar em dispositivos locais
        • vanilla-js
        • vision
        • VR & AR (WebXR)
        • blender
          • Needle Engine para Blender
        • cloud
          • Needle Cloud
        • custom-integrations
          • index
        • getting-started
          • Introdução à Scripting para Developers Unity
          • Começar e Instalação
          • Scripting no Needle Engine
        • reference
          • needle.config.json
          • needle-engine-attributes
          • @serializable e outros decorators
        • three
          • index
        • unity
          • Sincronização do Editor
          • Needle Engine para Unity
      • vn
        • 404
        • SUMMARY
        • Automatic Component Generation
        • Các Component Cốt lõi của Needle
        • Cách gỡ lỗi
        • Triển khai và Tối ưu hóa
        • embedding
        • Hành động ở mọi nơi (Everywhere Actions)
        • Các Dự Án Ví Dụ ✨
        • Xuất Tài sản, Hoạt ảnh, Prefab, Vật liệu, Lightmap...
        • Câu hỏi thường gặp (FAQ) 💡
        • Tổng quan tính năng
        • Trang này đã được di chuyển: tiếp tục tại đây
        • getting-started
        • Frameworks, Bundlers, HTML
        • index
        • Các Module Bổ Sung
        • Kết nối mạng
        • Cấu trúc dự án Needle Engine
        • samples-and-modules
        • Ví dụ về Scripting
        • Tạo và sử dụng Component
        • Trực tiếp
        • Trực tiếp
        • Giới thiệu
        • Trực tiếp
        • Chơi thử
        • Trực tiếp
        • Demo trực tiếp
        • Hỗ trợ và Cộng đồng
        • Tổng quan kỹ thuật
        • Lời chứng thực
        • Testing on local devices
        • Sử dụng Needle Engine trực tiếp từ HTML
        • vision
        • VR & AR (WebXR)
        • blender
          • Needle Engine cho Blender
        • cloud
          • Needle Cloud
        • custom-integrations
          • index
        • getting-started
          • Giới thiệu về Scripting cho các nhà phát triển Unity
          • Getting Started & Installation
          • Scripting trong Needle Engine
        • reference
          • needle.config.json
          • Cấu hình <needle-engine>
          • @serializable và các decorator khác
        • three
          • index
        • unity
          • Editor Sync
          • Needle Engine cho Unity
      • zh
        • SUMMARY
        • 自动生成组件
        • Needle 核心组件
        • 如何调试
        • 部署与优化
        • embedding
        • Everywhere Actions
        • 示例项目 ✨
        • 导出资源、动画、预制体、材质、光照贴图...
        • 常见问题 (FAQ) 💡
        • 功能概览
        • 此页面已移动:请在此处继续
        • getting-started
        • 框架、打包器、HTML
        • index
        • 附加模块
        • 网络
        • Needle Engine 项目结构
        • 示例项目
        • Scripting Examples
        • Creating and using Components
        • 实时示例
        • 实时
        • 关于
        • 实时演示
        • 在线试玩
        • 实时演示
        • 现场演示
        • 支持与社区
        • 技术概述
        • 用户评价
        • Testing on local devices
        • 使用 Needle Engine 直接从 HTML
        • vision
        • VR & AR (WebXR)
        • blender
          • Needle Engine for Blender
        • cloud
          • Needle Cloud
        • custom-integrations
          • index
        • getting-started
          • Scripting Introduction for Unity Developers
          • 入门与安装
          • 在 Needle Engine 中编写脚本
        • reference
          • needle.config.json
          • <needle-engine> 配置
          • @serializable and other decorators
        • three
          • index
        • unity
          • 编辑器同步
          • Unity 版 Needle Engine
Powered by GitBook
On this page
  • Needle Cloud
  • Visão Geral
  • Funcionalidades
  • Implementar a partir do Unity
  • Implementar a partir do CLI
  • URLs de Implementação
  • Formatos 3D Suportados
  • Ativos na Cloud
  • CLI para Ativos
  • Perguntas Frequentes
Edit on GitHub
  1. documentation
  2. lang
  3. pt
  4. cloud

Needle Cloud

Needle Cloud é um serviço online. Ajuda a armazenar, gerir e partilhar ativos e aplicações 3D na web. Uma variedade de formatos de ficheiro são suportados, incluindo glTF, USD, FBX, VRM, e mais. As ap

PreviouscloudNextcustom-integrations

Last updated 25 days ago

Needle Cloud

Visão Geral

Needle Cloud é um serviço online. Ajuda a armazenar, gerir e partilhar ativos e aplicações 3D na web. Uma variedade de formatos de ficheiro são suportados, incluindo glTF, USD, FBX, VRM, e mais. As aplicações web espaciais criadas com Needle podem ser implementadas na cloud diretamente a partir da integração Unity, e via linha de comando (CLI). A integração Blender chegará numa fase posterior; pode usar o CLI entretanto.

Visite para começar.

Visão Geral do Needle Cloud

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 dar à sua equipa e clientes acesso público a aplicações facilmente, sem ter de configurar o seu próprio servidor. Se necessário, pode proteger 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 (content delivery network), 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. É 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 rótulos para uma versão anterior, se necessário.

  5. Ferramentas de Automação e Pipeline via CLI O needle-cloud CLI (command line interface) torna fácil automatizar o carregamento e otimização de ficheiros. Isto é útil para integrar 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 Needle Cloud. Também pode carregar e transferir ativos de Needle Cloud diretamente no Unity.

  1. Adicione o componente Export Info à 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.

  2. Clique em Upload to Needle Cloud. Isto construirá a sua aplicação e a carregará para 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 Needle Cloud.

Implementar a partir do 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 o CLI para automatizar tarefas e integrar Needle Cloud nos seus fluxos de trabalho existentes.

node -v

Pode instalar o pacote needle-cloud CLI globalmente ou usá-lo via npx. Isto permite-lhe executar os comandos do CLI sem ter de o 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 o CLI a partir de qualquer lugar no seu sistema. Para instalar o 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

Exemplo: Needle Cloud Github Action

      - name: Deploy to Needle Cloud
        uses: needle-tools/deploy-to-needle-cloud-action@v1.0.2
        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, por exemplo, de uma github action
npx needle-cloud deploy '/path/to/output' --team 'My team' --name 'some name or id' --token '<access_token>'

Ajuda do 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 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.

A implementação mais recente 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.

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.

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


O website 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 Set main label ou Remove main label.

Formatos 3D Suportados

  1. OpenUSD USD é um formato poderoso para intercâmbio de dados 3D. É conhecido pelo seu uso na indústria cinematográfica e 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.

  2. 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.

  3. 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 fonemas, sombreamento toon e ossos dinâmicos.

  4. 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.

:::tip Utilize glTF ou USD sempre que possível Recomendamos glTF e USD como formatos primários para intercâmbio de dados 3D. São amplamente suportados, têm funcionalidades modernas e um bom modelo de material. :::

Ativos na Cloud

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 Ativos da Cloud no Needle Engine

Os ficheiros armazenados em 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 tempo de execução. Isto permite manter o tamanho do seu projeto pequeno e carregar ativos sob demanda que ainda podem ser atualizados na cloud.

::: tip Utilize Carregamento Progressivo sempre que possível Os ativos armazenados em Needle Cloud são otimizados automaticamente para uso ideal em tempo de execução usando a nossa tecnologia de Carregamento Progressivo. Para cada malha e textura, são geradas múltiplas versões de nível de detalhe, e apenas as partes do ativo que são necessárias são carregadas em tempo de execução.

Isto poupa muita largura de banda e memória (tipicamente 90% ou mais em comparação com o carregamento do ativo completo). :::

Incorporar o Visualizador da Cloud no Seu Website

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

::: tip Incorporar versões específicas Também pode incorporar o visualizador com uma ligação direta para o ativo, ou com uma etiqueta específica. Isto permite-lhe atualizar o ativo em Needle Cloud sem ter de atualizar o código de incorporação 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 visualizador Needle Cloud no seu website.

  2. 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 de Needle Cloud.

  3. 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 de Needle Cloud.

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

Utilizar Ativos da Cloud com outros motores como Unity ou Unreal

Existem várias maneiras de usar ativos armazenados em Needle Cloud noutros motores 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 em Needle Cloud e este atualizará automaticamente no seu projeto. Que ligação usar depende do motor e das suas capacidades glTF:

    • 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 tempo de execução. Ele escolherá automaticamente a melhor ligação para a sua plataforma e carregará o ativo com Progressive Loading. Isto também é suportado em tempo de execução 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. O CLI pode ser usado como parte de um passo de construção (substituindo um ativo por uma versão otimizada), ou como uma ferramenta autónoma (para processamento em lote de ficheiros).

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 Needle Cloud? Pode carregar ficheiros arrastando-os para o website, ou carregando-os diretamente de integrações suportadas. Se tiver muitos ficheiros, pode usar o CLI (command line interface) ou a API (application programming interface).

  3. Como transfiro ficheiros otimizados de Needle Cloud? Pode transferir ficheiros do website. Clique em Share e depois em Download. Também pode usar o 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 visualizador 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 chegará 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.

Página traduzida automaticamente usando IA

Instale a integração Unity, se ainda não o fez. Consulte para mais informações.

Integração Needle Cloud Unity

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

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

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 no Needle Cloud. Certifique-se de criar o seu token com permissões de read/write.

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

Esta é a primeira versão que foi carregada.

Esta é a segunda versão que foi carregada.

Este URL mostra automaticamente a nova versão quando carrega uma nova versão da aplicação.

Este URL não muda quando carrega uma nova versão. Só mudará quando promover explicitamente uma nova versão para main.

Lista de Versões do Needle Cloud

glTF e GLB 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 por Needle Cloud e Needle Engine.

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

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

Suporte para glTF com Progressive Loading: Use a ligação Progressive-World ou Progressive-Product. Consulte para mais informações sobre carregamento progressivo e como ativá-lo para o seu motor.

Consulte para mais informações sobre o CLI e como usá-lo.

esta página
pacote npm
website Node.js
sua página de equipa
Needle Cloud Github Action
collaborativesandbox-zubcks1qdkhy-1qdkhy.needle.run
collaborativesandbox-zubcks1qdkhy-2e2spt.needle.run
collaborativesandbox-zubcks1qdkhy-latest.needle.run
collaborativesandbox-zubcks1qdkhy.needle.run
Exemplo
web component
model-viewer
npm:@needle-tools/gltf-progressive
npm:needle-cloud
Needle Cloud