¿Cómo puedo activar mi Licencia de Needle Engine?

Activando la licencia en Unity

Needle Engine 4.x

Ve a Project Settings/Needle y haz clic en el botón de inicio de sesión. Sigue los pasos e inicia sesión en tu cuenta de Needle. Después verás la información de tu cuenta en la ventana de configuración del proyecto de Unity. Selecciona el equipo con licencia del desplegable.

Needle Engine 3.x

Abre Edit/Project Settings/Needle para acceder a la configuración del plugin Needle Engine. En la parte superior de la ventana encontrarás campos para introducir la información de tu licencia.

• Email - Introduce el email con el que compraste la licencia
• Invoice ID - Introduce uno de los ids de factura que recibiste por email

Nota: Es posible que necesites reiniciar el servidor web local para aplicar la licencia.

Activating the license in Blender

Abre Addon Preferences/Needle Engine para acceder a la configuración del addon Needle Engine

• Email - Introduce el email con el que compraste la licencia
• Invoice ID - Introduce uno de los ids de factura que recibiste por email

Nota: Es posible que necesites reiniciar el servidor web local para aplicar la licencia.

Mi sitio web local muestra un error SSL, por ejemplo, 'Tu conexión no es privada'

Es posible que veas una advertencia en tu navegador sobre la seguridad SSL dependiendo de tu configuración local.

Esto se debe a que, si bien la conexión está encriptada, por defecto no hay un certificado SSL que el navegador pueda validar. Si eso ocurre: haz clic en Advanced y luego en Proceed to Site. En Safari, es posible que necesites actualizar la página después, ya que no procede automáticamente. ¡Ahora deberías ver tu escena en el navegador!

El diálogo solo debería aparecer una vez para el mismo servidor local.

Mi sitio web local se queda en negro

Si eso ocurre, suele haber una excepción en el código del motor o en tu código. Abre las herramientas de desarrollo (Ctrl + Shift + I o F12 en Chrome) y revisa la Consola en busca de errores. En algunos casos, especialmente cuando acabas de actualizar la versión del paquete Needle Engine, esto se puede solucionar deteniendo y reiniciando el servidor de desarrollo local. Para ello, haz clic en la barra de progreso en ejecución en la esquina inferior derecha del Editor, y haz clic en la pequeña X para cancelar la tarea en ejecución. Luego, simplemente vuelve a pulsar Play.

Mis objetos están blancos después de la exportación

Esto suele ocurrir cuando estás usando shaders o materiales personalizados y sus propiedades no se traducen limpiamente a nombres de propiedad conocidos para la exportación glTF. Puedes asegurarte de estar usando materiales y shaders compatibles con glTF, o marcar los shaders como "personalizados" para exportarlos directamente.

• Lee más sobre flujos de trabajo glTF recomendados:
• Lee más sobre shaders personalizados:

Uncaught ReferenceError: NEEDLE_ENGINE_META is not defined / NEEDLE_USE_RAPIER is not defined

Si estás utilizando vite o next.js, asegúrate de añadir los plugins de Needle Engine a tu configuración. Ejemplo para vite:

const { needlePlugins } = await import('@needle-tools/engine/plugins/vite/index.js');
plugins: [needlePlugins(command, needleConfig)]

Ejemplo para next.js

const { needleNext } = await import("@needle-tools/engine/plugins/next/index.js");
return needleNext({}, { modules: { webpack } });

También puedes declarar las variables faltantes, por ejemplo, en tu index.html raíz en una etiqueta script como esta:

<script>
  var NEEDLE_ENGINE_META = {}
  var NEEDLE_USE_RAPIER = true;
</script>

THREE.EXRLoader: provided file doesnt appear to be in OpenEXR format

Por favor, asegúrate de que la codificación de Lightmap (Lightmap Encoding) esté configurada en Normal Quality. Ve a Edit/Project Settings/Player para cambiar la configuración.

Mi sitio web se vuelve demasiado grande / carga lento (demasiados MB)

Esto puede tener muchas razones, pero algunas comunes son:

• demasiadas texturas o texturas demasiado grandes
• los meshes tienen demasiados vértices
• los meshes tienen atributos de vértice que realmente no necesitas (por ejemplo, tienen normales y tangentes pero no las estás usando)
• los objetos están deshabilitados y no ignorados – los objetos deshabilitados también se exportan por si quieres activarlos en tiempo de ejecución. Establece su Etiqueta a EditorOnly para ignorarlos completamente para la exportación.
• tienes múltiples componentes GltfObject en tu escena y todos tienen EmbedSkybox habilitado (solo necesitas tener el skybox una vez por escena que exportas)

Si el tiempo de carga en sí es un problema, puedes intentar dividir tu contenido en múltiples archivos glb y cargarlos bajo demanda (esto es lo que hacemos en nuestro sitio web). Para que funcione, puedes poner tu contenido en Prefabs o Scenes y referenciarlos desde cualquiera de tus scripts. Por favor, consulta Scripting/Addressables en la documentación.

Mi UI no renderiza Texto

• Para Unity: Asegúrate de usar el componente UI/Legacy/Text y no el componente TextMeshPro - Text

Mis scripts no funcionan después de la exportación

• Tu código C# existente no se exportará tal cual, tienes que escribir el typescript / javascript correspondiente para él.
• Needle usa typescript / javascript para los componentes y genera stubs C# para ellos.
• Los componentes que ya tienen JS correspondiente lo mostrarán en el Inspector.

Mis lightmaps se ven diferentes / demasiado brillantes

Asegúrate de seguir las best practices for lightmaps y lee sobre mixing baked and non-baked objects

Mi escena es demasiado brillante / la iluminación se ve diferente que en Unity

Asegúrate de que tus luces estén configuradas en "Baked" o "Realtime". "Mixed" no es compatible actualmente.

• Las luces configuradas en mixed (con lightmapping) afectan a los objetos dos veces en three.js, ya que actualmente no hay forma de excluir objetos con lightmap de la iluminación.
• El factor Intensity Multiplier para Skybox en Lighting/Environment no es compatible actualmente y no tiene efecto en Needle Engine.
• La intensidad de la sombra de la luz no se puede cambiar actualmente debido a una limitación de three.js.

Consulta también la documentación sobre mezclar objetos baked y non-baked.

¿La resolución de mi skybox es baja? Cómo cambiar la resolución de mi skybox

• Si usas un custom cubemap: Puedes anular la configuración de importación de textura de la textura del skybox (asignada a tu cubemap).

  

• Si usas el default skybox: Añade un componente SkyboxExportSettings en cualquier parte de tu escena para anular la resolución por defecto.

  

Mis Sombras no son visibles o están cortadas

Por favor, comprueba los siguientes puntos:

• Tu luz tiene sombras habilitadas (either Soft Shadow or Hard Shadow).
• Tus objetos están configurados en "Cast Shadows: On" (see MeshRenderer component).
• For directional lights the position of the light is currently important since the shadow camera will be placed where the light is located in the scene.

Mis colores se ven mal

Asegúrate de que tu proyecto esté configurado en espacio de color Linear colorspace.

Estoy usando networking y Glitch y no funciona si más de 30 personas visitan la página de Glitch al mismo tiempo

• Desplegar en Glitch es una forma rápida de prototipar e incluso puede funcionar para algunas producciones pequeñas. El pequeño servidor allí no tiene la potencia ni el ancho de banda para albergar a mucha gente en una sesión persistente.
• Estamos trabajando en otras ideas de networking, pero mientras tanto puedes alojar el sitio web en otro lugar (con soporte node.js) o simplemente remezclarlo para distribuir la carga entre varios servidores. También puedes alojar el networking backend package itself somewhere else where it can scale e.g. Google Cloud.

Mi sitio web no tiene botones AR/VR

• Asegúrate de añadir el componente WebXR en algún lugar dentro de tu GltfObject raíz.
• Opcionalmente añade un componente AR Session Root en tu GltfObject raíz o dentro de la child hierarchy para especificar la ubicación, scale y orientation para WebXR.
• Opcionalmente añade un componente XR Rig para controlar dónde empiezan los usuarios en VR.

Creé un nuevo script en una sub-escena pero no funciona

Al crear nuevos scripts en npmdefs en sub-scenes (that is a scene that is exported as a reference from a script in your root export scene) you currently have to re-export the root scene again. Esto se debe a que el code-gen that is responsible for registering new scripts currently only runs for scenes with a ExportInfo component. This will be fixed in the future.

Mi servidor local no se inicia / no veo un sitio web

La razón más probable es una instalación incorrecta. Comprueba la consola y el componente ExportInfo en busca de errores o advertencias.

Si estas advertencias/errores no ayudaron, try the following steps in order. Dale algo de tiempo para completarse. Stop once your problem has been resolved. Check the console for warnings and errors.

• Asegúrate de seguir los Prerequisites.
• Instala tu project by selecting your ExportInfo component and clicking Install.
• Ejecuta una clean installation by selecting your ExportInfo component, holding Alt and clicking Clean Install.
• Intenta opening your web project directory in a command line tool and follow these steps:
  • ejecuta npm install and then npm run dev-host
  • Asegúrate de que tanto el local runtime package (node_modules/@needle-tools/engine) as well as three.js (node_modules/three) did install.
  • Puedes ejecutar npm install también en ambos directorios.

¿La generación de componentes C# también funciona solo con javascript?

Although generating C# components does technically run with vanilla javascript too we don't recommend it and fully support it since it is more guesswork or simply impossible for the generator to know which C# type to create for your javascript class. Below you find a minimal example on how to generate a Unity Component from javascript if you really want to tho.

import { Behaviour } from "@needle-tools/engine";

export class MyScript extends Behaviour
{
    //@type float
    myField = 5;
}

No tengo ningún botón como "Generate Project" en mis componentes/inspector

Por favor, comprueba que no estás accidentally in the Inspector's Debug mode – switch back to Normal:

No se encuentra Toktx / Toktx no está instalado

• Asegúrate de descargar e instalar toktx.

• En Windows: Asegúrate de haber añadido toktx to your system environment variables. You may need to restart your computer after adding it to refresh the environment variables. La ubicación de default install location is C:\Program Files\KTX-Software\bin.

La instalación del proyecto web tarda una eternidad / nunca termina / EONET: no such file or directory

• Asegúrate de no crear un project on a drive formatted as exFAT because exFAT does not support symlinks, which is required for Needle Engine for Unity prior to version 3.x. Puedes comprobar el formato de tus unidades usando the following steps:

1. Abrir "System Information" (Información del Sistema) (either windows key and type that or enter "msinfo32" in cmd).
2. Select Components > Storage > Drives.
3. Select all (Ctrl + A) on the right side of the screen and copy that (Ctrl + C) and paste here (Ctrl + V).

NPM install fails and there are errors about hard drive / IO

Asegúrate de que tu proyecto esté en un disk that is known to work with node.js. Main reason for failures is that the disk doesn't support symlinks (symbolic links / softlinks), which is a requirement for proper functioning of node.js. El formato NTFS should always work. Known problematic file system formattings are exFAT and FAT32.

Para comprobar el format of your drives, you can:

1. Abrir "System Information" (Información del Sistema) (either Windows key and type "System Information" or enter msinfo32 in cmd Windows + R).
2. Seleccionar "Components > Storage > Drives" (Componentes > Almacenamiento > Unidades).
3. Ahí, puedes ver todas las drives and their formatting listed. Put your projects on a drive that is NTFS formatted.

Estoy recibiendo errores con "Unexpected token @. Expected identifier, string literal, numeric literal or ..."

Needle Engine usa typescript decorators for serialization. Para solucionar this error make sure to enable experimentalDecorators in your tsconfig.json.

Estoy recibiendo un error 'failed to load config ... vite.config.js' al ejecutar comandos npm en Mac OS

Es probable que estés usando una x86_64 version of Unity on an (ARM) Apple Silicon processor. Unity 2020.3 is only available for x86_64, later versions also have Apple Silicon versions. Nuestra Unity integration calling npm will thus do so from an x86_64 process, resulting in the x86_64 version of node and vite/esbuild being used. When you afterwards try to run npm commands in the same project from an Apple Silicon app (e.g. VS Code), npm will complain about mismatching architectures with a long error message.

Para solucionar esto, use an Apple Silicon version of Unity (2021.1 or later).

También puedes solucionarlo temporarily fix it on 2020.3 by deleting the node_modules folder and running npm install again from VS Code. Tendrás que delete node_modules again when you switch back to Unity.

Error de referencia circular

Esto puede ocurrir cuando tienes e.g. a SceneSwitcher (or any other component that loads a scene or asset) and the referenced Asset in Unity contains a GltfObject that has the same name as your original scene with the SceneSwitcher. You can double check this in Unity if you get an error that says something like:

Failed to export ↑ YourSceneName.glb
you seem to have objects with the same name referencing each other.

Para solucionar this you can:

• Eliminar el GltfObject in the referenced Prefab or Scene.
• Renombrar el GameObject with the component that loads the referenced scenes.

Si esto no soluciona el problema, por favor, pregunta en nuestro foro.

Mi escena no carga y la consola contiene una advertencia con 'circular references' o 'failed to update active state'

Por favor, consulta la sección error de referencia circular.

¿Mi máquina soporta WebGL 2?

Usa un detector como este para determinar si tu device supports WebGL 2, it also hints at what could be the cause of your problem, but generally make sure you have updated your browser and drivers. WebGL 1 is not supported.

Dispositivos conocidos que causan problemas:

• Lenovo Thinkpad - T495

Quiero usar Needle AI con mi modelo de IA local

Si quieres (o tienes que) ejecutar tu IA localmente, you can use the Needle llms.txt files as context for your local AI (e.g. Ollama):

• llms.txt
• llms-full.txt

¿Aún tienes preguntas?

Pregunta en nuestro foro

Página traducida automáticamente usando IA