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
  • Resumen
  • Características
  • Desplegar desde Unity
  • Desplegar desde la CLI
  • URLs de despliegue
  • Formatos 3D soportados
  • Assets en la nube
  • CLI para Assets
  • Preguntas frecuentes
Edit on GitHub
  1. documentation
  2. lang
  3. es
  4. cloud

Needle Cloud

Needle Cloud es un servicio online. Te ayuda a almacenar, gestionar y compartir assets y apps 3D en la web. Se soporta una variedad de formatos de archivo, incluyendo glTF, USD, FBX, VRM, y más. Las a

PreviouscloudNextcustom-integrations

Last updated 26 days ago

Needle Cloud

Resumen

Needle Cloud es un servicio online. Te ayuda a almacenar, gestionar y compartir assets y apps 3D en la web. Se soporta una variedad de formatos de archivo, incluyendo glTF, USD, FBX, VRM, y más. Las aplicaciones web espaciales hechas con Needle pueden ser desplegadas a la nube directamente desde la integración de Unity, y vía línea de comandos (CLI). La integración de Blender llegará más adelante; mientras tanto, puedes usar la CLI.

Visita para empezar.

Needle Cloud Overview

Características

  1. Alojar aplicaciones web espaciales Las aplicaciones hechas con Needle se pueden desplegar a la nube directamente desde nuestras integraciones de motor. Esto te permite dar acceso público a las aplicaciones a tu equipo y clientes fácilmente, sin tener que configurar tu propio servidor. Si es necesario, puedes proteger las aplicaciones con una contraseña.

  2. Gestionar assets 3D de forma privada y segura Sube y organiza fácilmente tus archivos 3D. Gracias a nuestra rápida CDN (red de entrega de contenido), tus archivos se almacenan de forma segura y se puede acceder a ellos rápidamente desde cualquier parte del mundo. Needle Cloud no es un marketplace ni una red social. Está diseñado para agencias, estudios y creadores para gestionar sus assets de forma privada y segura.

  3. Optimizar assets 3D de una variedad de formatos Comprime automáticamente tus archivos para reducir su tamaño manteniendo la calidad visual. Esto hace que tus archivos se carguen más rápido y ahorra ancho de banda y memoria en los dispositivos de los usuarios.

  4. Compartir y control de versiones Se pueden compartir enlaces a tus archivos con otros y utilizarlos directamente en tus proyectos. Puedes subir nuevas versiones de assets y apps. Las versiones individuales pueden ser etiquetadas, lo que permite flujos de trabajo de revisión flexibles: por ejemplo, puedes etiquetar una versión como main o experimental. También puedes revertir las etiquetas a una versión anterior si es necesario.

  5. Automatización y herramientas de Pipeline vía CLI La CLI (command line interface o interfaz de línea de comandos) de needle-cloud facilita la automatización de la carga y optimización de archivos. Esto es útil para integrar Needle Cloud en tu pipeline existente, o para automatizar la carga de un gran número de archivos.

  6. Gestión de licencias Las licencias de Needle Engine para creadores individuales y equipos se gestionan a través de Needle Cloud. Esto garantiza que solo los usuarios autorizados puedan acceder a tus archivos y proyectos. Contáctanos para licencias Enterprise y Edu.

Desplegar desde Unity

Needle Cloud está integrado en el Editor de Unity. Esto te permite desplegar tus aplicaciones directamente desde Unity a Needle Cloud. También puedes subir y descargar assets desde Needle Cloud directamente en Unity.

  1. Añade el componente Export Info a tu escena. Este componente se utiliza para configurar los ajustes de exportación de tu aplicación. Puedes usar el elemento de menú GameObject > Needle Engine > Add Export Info o crear una nueva escena a partir de una plantilla de Needle a través del elemento de menú File > New Scene.

  2. Haz clic en Upload to Needle Cloud. Esto compilará tu aplicación y la subirá a Needle Cloud. También puedes elegir desplegar en un equipo y proyecto específicos. El upload name del proyecto, visible junto al botón, se guarda en la escena. Las futuras cargas usarán el mismo upload name, y todas las versiones cargadas se agruparán en el sitio web de Needle Cloud.

Desplegar desde la CLI

Needle Cloud proporciona una interfaz de línea de comandos (CLI) que te permite gestionar tus assets y desplegar tus aplicaciones de forma eficiente. Puedes usar la CLI para automatizar tareas e integrar Needle Cloud en tus flujos de trabajo existentes.

node -v

Puedes instalar el paquete needle-cloud de la CLI globalmente o usarlo vía npx. Esto te permite ejecutar los comandos de la CLI sin tener que instalarlo globalmente.

  1. Usa el comando npx (recomendado)

    npx needle-cloud deploy '/dist' --team 'My team' --name 'some-project-id'
  2. O instala needle-cloud globalmente Una instalación global permite usar la CLI desde cualquier lugar de tu sistema. Para instalar la CLI globalmente, ejecuta el siguiente comando en tu terminal:

    npm install -g needle-cloud

    Ahora, puedes usar el comando needle-cloud en tu terminal:

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

Despliegues automatizados

Ejemplo: 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

Ejemplo: Desplegar usando un comando CLI

# Deploy to Needle Cloud from e.g. a github action
npx needle-cloud deploy '/path/to/output' --team 'My team' --name 'some name or id' --token '<access_token>'

Ayuda de la CLI

Usa help para ver todas las opciones de línea de comandos disponibles y ayuda para comandos individuales.

# ver todas las opciones disponibles
npx needle-cloud help
# obtener ayuda para un comando específico, por ejemplo, deploy
npx needle-cloud help deploy

URLs de despliegue

Al desplegar en Needle Cloud, cada carga obtiene una URL única. Puedes compartir un enlace a una versión específica o a una versión etiquetada con tu equipo o clientes.


En el siguiente ejemplo, tenemos una aplicación que hasta ahora se ha desplegado dos veces. Cada despliegue obtiene una URL específica, también conocida como URL fijada, ya que está fijada a una versión específica.

El despliegue latest siempre está disponible en la siguiente URL. Esta URL es útil para compartir con tu equipo, ya que siempre apunta a la versión más reciente de la aplicación. Otro nombre común para esta versión es dev o canary.

El despliegue main es útil para compartir con clientes, ya que siempre apunta a la versión más reciente de la aplicación que promoviste. Otros nombres comunes para esta versión son production, stable o live.

Típicamente, subes una nueva versión, la revisas y luego decides si quieres promocionarla a main.


El sitio web de Needle Cloud muestra todas las versiones desplegadas de la aplicación, incluyendo las versiones latest y main. Las etiquetas se pueden mover haciendo clic en ⋮ y seleccionando Set main label o Remove main label.

Formatos 3D soportados

  1. OpenUSD USD es un formato potente para el intercambio de datos 3D. Es conocido por su uso en la industria del cine y VFX, y está ganando popularidad en la industria de los videojuegos. Needle Cloud soporta archivos USDZ y USD de forma nativa a través de nuestro trabajo en USD-WASM, y también convierte archivos USD a glTF para su posterior procesamiento y optimización.

  2. FBX FBX ha sido un formato popular para el intercambio de datos 3D durante muchos años, pero carece de una serie de características modernas como materiales PBR y extensiones. Needle Cloud convierte archivos FBX a glTF para su posterior procesamiento y optimización.

  3. VRM VRM es un formato para avatares humanoides. Se basa en glTF con restricciones adicionales mediante el uso de extensiones de glTF. Needle Cloud soporta archivos VRM de forma nativa, y puede optimizarlos como otros archivos glTF, incluyendo extensiones complejas de VRM como fonemas, toon shading y dynamic bones.

  4. OBJ OBJ es un formato sencillo basado en texto para modelos 3D. Soporta materiales básicos a través de archivos MTL, animaciones y jerarquías de objetos. Needle Cloud convierte archivos OBJ a glTF para su posterior procesamiento y optimización.

:::tip Usa glTF o USD cuando sea posible Recomendamos glTF y USD como formatos principales para el intercambio de datos 3D. Son ampliamente soportados, tienen características modernas y un buen modelo de material. :::

Assets en la nube

Subir Assets

Puedes subir tus archivos fácilmente arrastrándolos al sitio web o seleccionándolos desde tu ordenador. Los archivos que no son glTF se convierten automáticamente a glTF para su posterior procesamiento, pero los archivos originales se conservan para descargar y ver en la web.

Versiones de Assets

Cuando visitas la Página de Edición de un asset, puedes ver todas las versiones que han sido subidas hasta ahora por ti o tu equipo. También puedes etiquetar versiones para marcarlas como "main" o "experimental". "Latest" es la etiqueta predeterminada para la versión más reciente.

Compartir enlaces a Assets

Puedes crear enlaces para compartir archivos específicos o archivos etiquetados con tu equipo o clientes. Los enlaces etiquetados se actualizarán automáticamente cuando muevas la etiqueta, de modo que puedes compartir un enlace "main" una vez y seguir actualizando el archivo sin tener que enviar un nuevo enlace.

Usar Assets en la Nube en Needle Engine

Los archivos almacenados en Needle Cloud se pueden importar directamente a proyectos de Needle Engine fácilmente. El componente Needle Cloud Asset toma un enlace a un asset y lo carga en tiempo de ejecución. Esto te permite mantener el tamaño de tu proyecto pequeño y cargar assets bajo demanda que aún pueden ser actualizados en la nube.

::: tip Usa Progressive Loading siempre que sea posible Los assets almacenados en Needle Cloud se optimizan automáticamente para un uso ideal en tiempo de ejecución utilizando nuestra tecnología Progressive Loading. Para cada malla y textura, se generan múltiples versiones con diferentes niveles de detalle, y solo las partes del asset que se necesitan se cargan en tiempo de ejecución.

Esto ahorra mucho ancho de banda y memoria (típicamente un 90% o más en comparación con la carga completa del asset). :::

Incrustar el Cloud Viewer en tu sitio web

Una forma rápida de llevar 3D a tu propio sitio web es incrustar el visor de Needle Cloud. Para hacerlo, ve a la Página de Edición de un asset y haz clic en Embed. Luego puedes copiar el fragmento de código iframe y pegarlo en tu sitio web.

::: tip Incrustar versiones específicas También puedes incrustar el visor con un enlace directo al asset, o con una etiqueta específica. Esto te permite actualizar el asset en Needle Cloud sin tener que actualizar el código de incrustación en tu sitio web. :::

Incrustar en otros frameworks

Las siguientes opciones de incrustación están disponibles:

  1. Needle Cloud Viewer Usa el fragmento de código iframe para incrustar el visor de Needle Cloud en tu sitio web.

  2. three.js Si estás familiarizado con three.js, puedes usar el fragmento de código proporcionado como punto de partida para una aplicación three.js que soporte Needle Progressive Loading y cargue archivos de Needle Cloud de forma eficiente.

  3. React-Three-Fiber Si estás usando React-Three-Fiber, puedes usar el fragmento de código proporcionado como punto de partida para un proyecto que soporte Needle Progressive Loading y cargue archivos de Needle Cloud de forma eficiente.

  4. Unity Si estás usando Unity, puedes integrar assets de Needle Cloud directamente en tus proyectos usando el componente Needle Cloud Asset para una carga y optimización fluidas.

Usar Assets en la Nube con otros motores como Unity o Unreal

Hay varias formas de usar assets almacenados en Needle Cloud en otros motores como Unity o Unreal.

  1. Descargar e importar Puedes descargar el asset e importarlo en tu proyecto.

  2. Enlace directo Puedes usar el enlace directo al asset en tu proyecto. De esta manera, puedes actualizar el asset en Needle Cloud y se actualizará automáticamente en tu proyecto. Qué enlace usar depende del motor y sus capacidades glTF:

    • Soporte para glTF con Draco y KTX2: Usa el enlace Optimized.

    • Soporte para glTF, pero sin extensiones de compresión: Usa el enlace Upload (para cargas gltf/glb) o Converted (para otras cargas).

  3. Componente Needle Cloud Asset Si estás usando Needle Engine, puedes usar el componente Needle Cloud Asset para cargar assets en tiempo de ejecución. Elegirá automáticamente el mejor enlace para tu plataforma y cargará el asset con Progressive Loading. Esto también es compatible en tiempo de ejecución en Unity Builds.

CLI para Assets

La interfaz de línea de comandos (CLI) para Needle Cloud permite automatizar la carga y compresión de archivos. La CLI se puede usar como parte de un paso de compilación (reemplazando un asset por una versión optimizada), o como una herramienta independiente (para el procesamiento por lotes de archivos).

Preguntas frecuentes

  1. ¿Qué es Needle Cloud? Es un servicio online para subir, comprimir y compartir assets y escenas 3D.

  2. ¿Cómo subo assets a Needle Cloud? Puedes subir archivos arrastrándolos al sitio web, o subiéndolos directamente desde las integraciones soportadas. Si tienes muchos archivos, puedes usar la CLI (interfaz de línea de comandos) o la API (interfaz de programación de aplicaciones).

  3. ¿Cómo descargo archivos optimizados desde Needle Cloud? Puedes descargar archivos desde el sitio web. Haz clic en Share y luego en Download. También puedes usar la CLI para descargar archivos.

  4. ¿Puedo compartir mis archivos con otros? Sí, puedes crear enlaces para compartir tus archivos. Los enlaces pueden ser enlaces de descarga directa o enlaces al visor de Needle Cloud.

  5. ¿Hay un límite de tamaño de archivos? Los límites de subida dependen de tu plan. Revisa los detalles de tu cuenta para más información.

  6. ¿Se pueden usar los archivos de Needle Cloud con otras herramientas? Sí, puedes usar tus archivos en otros programas exportándolos como glTF. La exportación a USD llegará más adelante.

  7. ¿Qué pasa si me quedo sin espacio de almacenamiento? Es posible que necesites actualizar tu plan o eliminar archivos antiguos para liberar espacio.

Página traducida automáticamente con IA

Instala la integración de Unity, si aún no lo has hecho. Consulta para más información.

Needle Cloud Unity Integration

La CLI está disponible como un , lo que significa que necesitas tener Node.js instalado en tu máquina. Puedes comprobar si tienes Node.js instalado ejecutando el siguiente comando en tu terminal:

Si no tienes Node.js instalado, puedes descargarlo desde el .

Para desplegar desde Github Actions o Stackblitz puedes proporcionar un token de acceso como --token <access_token>. Los tokens de acceso se pueden crear en en Needle Cloud. Asegúrate de crear tu token con permisos de read/write.

Usa la para desplegar una actualización desde Github (por ejemplo, cada vez que haces push al repositorio)

Esta es la primera versión que se subió.

Esta es la segunda versión que se subió.

Esta URL muestra automáticamente la nueva versión cuando subes una nueva versión de la aplicación.

Esta URL no cambia cuando subes una nueva versión. Solo cambiará cuando promociones explícitamente una nueva versión a main.

Needle Cloud Version List

glTF and GLB El formato glTF es el formato más ampliamente soportado para 3D en la web. Es un formato ligero que puede almacenar modelos 3D, animaciones y texturas. Los archivos GLB son versiones binarias de los archivos glTF, donde todos los datos se almacenan en un único archivo. glTF soporta técnicas avanzadas de compresión como Draco, KTX2 y Meshopt, que son totalmente soportadas por Needle Cloud y Needle Engine.

Needle Engine Usa el fragmento de código proporcionado para incrustar Needle Engine en tu sitio web como .

model-viewer El proyecto proporciona un web component para renderizar modelos 3D simples y no interactivos en el navegador.

Soporte para glTF con Progressive Loading: Usa el enlace Progressive-World o Progressive-Product. Consulta para más información sobre progressive loading y cómo habilitarlo para tu motor.

Consulta para más información sobre la CLI y cómo usarla.

esta página
paquete npm
sitio web de Node.js
la página de tu equipo
Needle Cloud Github Action
collaborativesandbox-zubcks1qdkhy-1qdkhy.needle.run
collaborativesandbox-zubcks1qdkhy-2e2spt.needle.run
collaborativesandbox-zubcks1qdkhy-latest.needle.run
collaborativesandbox-zubcks1qdkhy.needle.run
Ejemplo
web component
model-viewer
npm:@needle-tools/gltf-progressive
npm:needle-cloud
Needle Cloud