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
Last updated
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
Last updated
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.
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.
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.
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.
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.
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.
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.
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.
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
.
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.
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.
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.
Usa el comando npx (recomendado)
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:
Ahora, puedes usar el comando needle-cloud
en tu terminal:
Ejemplo: Needle Cloud Github Action
Ejemplo: Desplegar usando un comando CLI
Usa help
para ver todas las opciones de línea de comandos disponibles y ayuda para comandos individuales.
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.
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.
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.
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.
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. :::
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.
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.
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.
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). :::
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. :::
Las siguientes opciones de incrustación están disponibles:
Needle Cloud Viewer
Usa el fragmento de código iframe
para incrustar el visor de Needle Cloud en tu sitio web.
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.
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.
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.
Hay varias formas de usar assets almacenados en Needle Cloud en otros motores como Unity o Unreal.
Descargar e importar Puedes descargar el asset e importarlo en tu proyecto.
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).
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.
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).
¿Qué es Needle Cloud? Es un servicio online para subir, comprimir y compartir assets y escenas 3D.
¿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).
¿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.
¿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.
¿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.
¿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.
¿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.
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.
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.