For the complete documentation index, see llms.txt. This page is also available as Markdown.

Smart Items - Avanzado

Usa smart items en tu escena para añadir interactividad.

La mayoría de los smart items tienen un módulo básico donde puedes configurar fácilmente solo los ajustes más comunes, pero puedes desplazarte hacia abajo y pasar el marcador Advanced para personalizar casi cualquier aspecto del comportamiento del elemento.

El siguiente elemento tiene un componente Transform y un módulo básico que muestra solo los campos básicos para configurar un botón. Sin embargo, si te desplazas hacia abajo y pasas el marcador Advanced , encontrarás todos los ajustes disponibles.



📔 Nota: La mayoría de los ajustes del módulo básico también están disponibles en los componentes de más abajo. Los cambios que hagas en el módulo básico se reflejan en los componentes de más abajo, y viceversa, salvo en algunos casos en los que los ajustes básicos son una abstracción de varios ajustes de más abajo. En esos casos, si cambias los ajustes avanzados por valores que no admite el módulo básico, el campo del módulo básico aparecerá como undefined.

Configuración avanzada

Las propiedades se agrupan en components. Los distintos smart items pueden tener diferentes componentes, según su funcionalidad.

El comportamiento de la mayoría de los elementos se controla mediante:

  • Actions: el componente Actions define las cosas que puede hacer el elemento. Por ejemplo, reproducir un sonido o una animación, moverse hacia arriba o volverse invisible.

  • Triggers: el componente Triggers asigna los eventos que hacen que se ejecuten esas acciones. Por ejemplo, cuando el jugador hace clic en el elemento, cuando entra en un área o cuando se carga la escena por primera vez.

Por ejemplo, en un smart item de puerta, el componente Actions incluye las acciones «Open» y «Close». El componente Triggers de ese elemento incluye un trigger On Click que activa la acción «Open» cuando el jugador hace clic en la puerta.

Los triggers de un smart item pueden activar acciones de cualquier smart item de la escena, no solo de ese mismo smart item. Por ejemplo, un smart item de botón puede tener un componente Triggers que activa la acción «move up» definida en el componente Actions de una plataforma flotante.

Los triggers también pueden activarse de forma condicional. Por ejemplo, los smart items de puerta incluyen dos triggers On Click en su componente Triggers: uno abre la puerta si está cerrada y el otro la cierra si está abierta. Para obtener más detalles, consulta Estados y lógica condicional.

Interacciones entre elementos

Para hacer que los elementos interactúen entre sí:

  • Un elemento debe tener al menos una acción definida en un componente Actions .

  • El otro elemento debe tener un trigger en el componente Triggers que apunte a esa acción.

Por ejemplo, para hacer que un botón abra una puerta:

  1. Añade cualquier smart item de botón y abre su componente Triggers . Tiene un evento trigger predeterminado que reproduce un sonido y una animación para el propio botón.

  2. Haz clic en el signo + junto a Assigned Actionspara añadir una tercera acción a ese mismo evento trigger.

  3. En el primer menú desplegable, selecciona el smart item de la puerta.

  4. En el segundo menú desplegable, selecciona la acción «Open».



💡 Consejo: También puedes crear un nuevo evento Trigger que solo gestione la acción de la puerta. Ambos eventos Trigger se ejecutan cada vez que se hace clic en el botón.



Cualquier elemento puede activar cualquier acción de otro elemento, siempre que la acción esté definida. Consulta Triggers para conocer más formas de activar una acción.

Puedes usar estados y lógica condicional para activar una acción solo si se cumple una condición. La condición incluso puede comprobar el estado de un tercer smart item. Por ejemplo, un botón solo abre la puerta si el estado de un smart item personalizado de «generador eléctrico» está configurado como «On».

Acciones

El componente Actions enumera las acciones que puede realizar el elemento. Cada smart item incluye un conjunto de acciones predefinidas. Puedes personalizar las acciones existentes o añadir otras nuevas. Están disponibles los siguientes tipos de acciones:

  • Reproducir animación: Reproduce una animación en el modelo 3D del elemento. Consulta Acerca de la reproducción de animaciones

  • Detener animación: Detiene todas las animaciones que reproduce el modelo 3D del elemento.

  • Reproducir sonido: Reproduce un sonido desde un archivo en la ubicación del elemento. Consulta Acerca de la reproducción de sonidos

  • Detener sonido: Detiene todos los sonidos que se reproducen desde el elemento.

  • Iniciar Tween: Realiza un cambio gradual de posición, rotación o escala durante un período determinado. Consulta Mover, rotar o cambiar la escala.

  • Establecer visibilidad: Hace que el elemento sea visible o invisible.

  • Adjuntar al jugador: Establece el elemento como hijo del Avatar del jugador. Por ejemplo, para llevarlo en la mano o sobre la cabeza.

  • Separar del jugador: Separa el elemento del Avatar del jugador.

  • Abrir enlace: Abre un enlace a un sitio web externo en una pestaña del navegador. Se pregunta a los jugadores si confían en el dominio antes de abrirlo.

📔 Nota: Esta acción solo puede ejecutarse como resultado de hacer clic en un elemento. No se puede activar al entrar caminando en un área Trigger.

  • Mover jugador: Cambia la posición del jugador a un conjunto de coordenadas locales dentro de la escena. Solo es posible mover al jugador dentro de la misma escena.

  • Teletransportar jugador: Teletransporta a un jugador a otra ubicación de Decentraland. Usa el menú desplegable Teleport Mode para enviarlo A coordenadas de otra escena en Genesis City, o bien A World, indicando el nombre de un World. Los jugadores aparecerán en el punto de aparición de la escena de destino.

  • Reproducir Emote: Hace que el Avatar del jugador realice una de las animaciones predeterminadas (por ejemplo, saludar o aplaudir).

  • Reproducir Emote personalizado: Hace que el Avatar del jugador realice una animación personalizada desde un archivo cargado en la escena.

  • Mostrar texto: Muestra texto en la UI de la pantalla; se oculta al cabo de unos segundos. Ideal para pistas, líneas de diálogo, notificaciones, etc.

  • Ocultar texto: Oculta cualquier texto de la UI que se esté mostrando.

  • Iniciar retraso: Retrasa otra acción del mismo elemento tantos segundos como necesites.

  • Detener retraso: Cancela cualquier acción retrasada del elemento.

  • Iniciar bucle: Repite una acción del mismo elemento de forma recurrente con un intervalo determinado.

  • Detener bucle: Cancela cualquier acción en bucle del elemento.

  • Reproducir video: Reproduce un video como Material en una forma primitiva.

  • Detener video: Detiene los videos que se estén reproduciendo.

  • Reproducir transmisión de audio: Reproduce una transmisión de audio.

  • Detener transmisión de audio: Detiene las transmisiones de audio que se estén reproduciendo.

  • Clonar: Duplica un elemento en la posición indicada.

  • Generar Entity: Crea una nueva copia de un elemento en la escena, en una posición relativa al elemento que realiza la acción. No es necesario que el elemento que se va a generar esté colocado en la escena. Consulta Acerca de la generación de Entities.

  • Eliminar: Elimina un elemento de la escena.

  • Mostrar imagen: Muestra una imagen en la UI, posiblemente durante un tiempo limitado. También puede incluir un pie de foto.

  • Ocultar imagen: Oculta cualquier imagen que se esté mostrando en la UI mediante la acción Mostrar imagen.

  • Infligir daño: Reduce la salud de cualquier barra de salud que esté cerca. La Layer propiedad puede determinar si solo actúa sobre las barras de salud del jugador o también sobre las de otros elementos.

  • Mover jugador aquí: Cambia la posición del jugador a la de este elemento.

  • Colocar sobre el jugador: Cambia la posición del elemento a la del jugador.

  • Rotar como el jugador: Cambia la rotación del elemento para que coincida con la del jugador.

  • Colocar sobre la cámara: Cambia la posición del elemento a la de la cámara.

  • Rotar como la cámara: Cambia la rotación del elemento para que coincida con la de la cámara.

  • Establecer posición: Cambia la posición del elemento a una específica. Puede ser absoluta o relativa a su posición actual.

  • Establecer rotación: Cambia la rotación del elemento a una específica. Puede ser absoluta o relativa a su rotación actual.

  • Establecer escala: Cambia la escala del elemento a una específica. Puede ser absoluta o relativa a su escala actual.

  • Seguir al jugador: Empieza a moverse y girar en dirección a la posición del jugador. Ignora cualquier obstáculo que encuentre en el camino. Puedes establecer la velocidad y hacer que solo se mueva en determinados ejes. La distancia mínima determina qué tan cerca se acercará al jugador.

  • Dejar de seguir al jugador: Detiene la acción Seguir al jugador.

  • Acción aleatoria: Cada vez que se ejecuta la acción aleatoria, se reproduce al azar una de las acciones de esta lista, con la misma probabilidad. Puedes incluir cualquiera de las acciones que pertenezcan al elemento.

  • Acciones por lotes: Cada vez que se ejecuta la acción por lotes, se reproducen simultáneamente todas las acciones de esta lista. Puedes incluir cualquiera de las acciones que pertenezcan al elemento.

  • Curar al jugador: Restaura la salud en la barra de salud del jugador.

  • Hacer que el jugador mire al elemento: Hace que el Avatar del jugador gire para mirar al elemento.

  • Inmovilizar al jugador: Impide que el jugador se mueva, salte o haga Emotes.

  • Desinmovilizar al jugador: Restablece la capacidad del jugador para moverse después de la acción Inmovilizar al jugador.

  • Encender luces: Enciende el componente Light Source del elemento.

  • Apagar luces: Apaga el componente Light Source del elemento.

  • Modificar luces: Cambia las propiedades del componente Light Source del elemento, como el color o la intensidad.

  • Seleccionar cámara: Cambia la vista del jugador a una Virtual Camera, ya sea de este elemento o de otra Entity.

  • Cambiar texto: Cambia el texto de un elemento que tenga el componente Text Shape . También puede cambiar el tamaño y el color de la fuente.

  • Detener Tween: Detiene cualquier movimiento Tween que esté en curso en el elemento.

  • Deslizar Texture: Desliza continuamente la Texture del Material del elemento en una dirección determinada, para crear efectos como agua en movimiento o cintas transportadoras.

  • Cambiar colisiones: Activa o desactiva los Colliders del elemento, tanto para la física como para los Pointer Events.

  • Cambiar Skybox: Cambia el Skybox de la Scene a una hora fija del día, expresada en segundos desde la medianoche.

  • Restablecer Skybox: Restablece el Skybox de la Scene a su configuración predeterminada.

  • Registrar en la consola: Imprime un mensaje en la consola, útil para depurar mientras desarrollas la Scene.

  • Eliminar: Elimina el elemento y todos sus elementos secundarios de la escena.

Consulta los estados y la lógica condicional para obtener información sobre otras acciones relacionadas con las condiciones lógicas, como Set State y las acciones de contador.

El componente Actions define las acciones posibles, pero estas no hacen nada en la escena a menos que se activen. Las acciones se activan mediante un trigger, ya sea del mismo smart item o de uno diferente.

Para añadir una acción nueva a un elemento, haz clic en el botón Add New Action en la parte inferior del componente Action. Luego, asígnale un nombre, selecciona un tipo y completa los campos adicionales específicos del tipo de acción.



Triggers

El componente Triggers define los eventos de trigger, que activan acciones cuando ocurre un evento determinado. Existen los siguientes tipos de eventos de trigger:

  • On Click: Cuando el jugador hace clic en el elemento. Consulta Acerca de los triggers de clic

  • On Input Action: Cuando el jugador pulsa un botón de entrada mientras apunta al elemento.

  • On Global Click: Cuando el jugador hace clic con el puntero en cualquier lugar, sin necesidad de apuntar al elemento.

  • On Global Primary: Cuando el jugador pulsa el botón Primary (E) en cualquier lugar.

  • On Global Secondary: Cuando el jugador pulsa el botón Secondary (F) en cualquier lugar.

  • Player Enters Area: Cuando el jugador entra en un área. Consulta Trigger Area

  • Player Leaves Area: Cuando el jugador sale de un área. Consulta Trigger Area

  • On Spawn: Cuando se inicia la escena o se genera el elemento en la escena. Consulta Trigger al generarse

  • On Delay: Cuando finaliza la cuenta regresiva de una acción Start Delay del elemento.

  • On Loop: En cada iteración de una acción Start Loop del elemento.

  • On Clone: Cuando se clona el elemento mediante una acción Clone , la nueva copia activa este trigger.

  • Al hacer clic en la imagen: Cuando el jugador hace clic en una imagen mostrada por una Mostrar imagen acción.

  • Al recibir daño: Cuando el elemento recibe daño de una Infligir daño acción.

  • Al curar al jugador: Cuando el jugador recibe curación mediante una Curar al jugador acción.

  • En cada tick: En cada tick de la escena, una vez por fotograma. Úsalo con precaución, ya que las acciones que activa se ejecutan con mucha frecuencia.

Consulta estados y lógica condicional para conocer otros activadores relacionados con las condiciones lógicas, como Al cambiar el estado, Al cambiar el contador y Al finalizar Tween.

Para añadir un nuevo activador, haz clic en Añadir nuevo evento de activación en la parte inferior del componente Trigger. A continuación, selecciona el tipo de activador, la entidad que quieres activar y una acción de esa entidad.



📔 Nota: Es necesario definir una acción en el componente Actions de la entidad antes de poder activarla. Los activadores solo pueden afectar a entidades que tengan un componente Actions.

Acerca de la reproducción de animaciones

Usa una acción de tipo Play Animation para ejecutar una animación en el modelo 3D del elemento inteligente. La animación debe existir ya como parte del archivo del modelo 3D. El menú desplegable Seleccionar animación muestra una lista de todas las animaciones disponibles en el modelo 3D.

El campo Modo de reproducción te permite elegir si una animación debe reproducirse una sola vez o repetirse en bucle.



Una vez creada la acción, puedes activarla mediante el componente Triggers de ese mismo elemento o de cualquier otro.

Usa la acción Stop Animation para detener todas las animaciones del elemento, tanto las que se repiten en bucle como las que no.

💡 Consejo: Para revisar fácilmente el contenido de un modelo 3D, ver qué animaciones incluye y cómo se ven, una buena herramienta es Babylon Sandbox. Solo tienes que arrastrar el archivo del modelo 3D hasta la ventana. En la parte inferior debería aparecer un menú desplegable con una lista de sus animaciones.

Para obtener más información sobre las animaciones y cómo crear las tuyas como parte de un modelo 3D, consulta Animaciones.

Acerca de la reproducción de sonidos

Usa una acción de tipo Reproducir sonido para reproducir un archivo de sonido. Puedes reproducir cualquier archivo de sonido siempre que se haya importado al proyecto de la escena. El sonido se escucha de forma posicional, desde la ubicación del elemento; es decir, suena más fuerte cuanto más cerca está el jugador.

💡 Consejo: En lugar de escribir la ruta del archivo de sonido, puedes arrastrarlo hasta el campo Ruta desde el menú de navegación de archivos situado en la parte inferior del Scene Editor.

Usa el campo Modo de reproducción para elegir si quieres reproducir el sonido una sola vez o repetirlo continuamente.



Una vez creada la acción, puedes activarla mediante el componente Triggers de ese mismo elemento o de cualquier otro.

Usa la acción Detener sonido para detener todos los sonidos del elemento, tanto los que se repiten como los que no. Esto también detiene los sonidos del componente AudioSource .

Para que un elemento reproduzca siempre un sonido en bucle, por ejemplo, de ambiente o música, es más fácil usar el componente AudioSource en lugar de usar Actions y Triggers. Este componente solo requiere que indiques la ruta de un archivo y marques las casillas Iniciar reproducción y Bucle.



📔 Nota: Un smart item solo puede reproducir un sonido a la vez. Al iniciar un segundo sonido, se interrumpirán los demás que estén sonando. Esto también se aplica a los sonidos del componente AudioSource . Si necesitas que suenen dos sonidos a la vez, considera añadir una entidad invisible en la misma ubicación que contenga una acción Reproducir sonido .

Consulta sonidos para obtener más información sobre cómo reproducir sonidos en Decentraland.

Mover, rotar o cambiar la escala

Usa una acción Start Tween para cambiar la posición, escala, o la rotación, del elemento durante un periodo de tiempo. Todas las acciones Start Tween parten del estado original del elemento y lo cambian a un estado final a lo largo de un periodo de tiempo.

Los Tweens de posición pueden ser relativos o absolutos. Un Tween absoluto de posición mueve el elemento a una posición fija con respecto a la escena. El elemento se moverá desde donde esté hasta esa posición. Si ya está allí, no parecerá moverse. Un Tween relativo de posición mueve el elemento una distancia determinada desde su ubicación actual; por ejemplo, un Tween a una posición relativa de 1, 0, 0 mueve el elemento 1 metro hacia delante, en la dirección en la que está orientado. Si ejecutas la acción Tween por segunda vez, el elemento avanzará otro metro.

Los Tweens de rotación también pueden ser relativos o absolutos. Una rotación relativa se suma a la rotación actual del elemento. Un Tween absoluto de rotación orientará el elemento hacia una dirección específica con respecto a la escena.

Usa el campo Duración para establecer cuánto debe durar todo el movimiento, en segundos. Ten en cuenta que el control deslizante llega hasta los 100 segundos, pero también puedes escribir manualmente un número mayor si lo necesitas.



Una vez creada la acción, puedes activarla mediante el componente Triggers de ese mismo elemento o de cualquier otro.

Los Tweens pueden seguir distintos Tipos de curva que afectan al ritmo del cambio a lo largo del tiempo. Una curva lineal curva (predeterminada), significa que la velocidad del cambio es constante de principio a fin. Hay muchas opciones para elegir, que trazan curvas de distintas formas según si el inicio y/o el final comienzan lentamente, y en qué medida. Una easeinexpo curva comienza lentamente y termina rápido, aumentando la velocidad de forma exponencial; por el contrario, una easeoutexpo curva comienza rápido y termina lentamente.



💡 Consejo: Prueba distintas curvas de movimiento. Las diferencias suelen ser sutiles, pero interpretamos de forma subconsciente información a partir del movimiento de las cosas, como su peso, fricción o incluso personalidad.

Usa Al finalizar el Tween para activar eventos en el componente Triggers y ejecutar una acción cuando termine un Tween. Usa estados y lógica condicional para describir una trayectoria en bucle para una plataforma flotante, de modo que se mueva continuamente entre dos ubicaciones.

Cuando un elemento realiza un Tween, esto afecta a todo el elemento. Por ejemplo, si cambia su escala, cambia la escala de su modelo 3D visible y también la de la geometría invisible del Collider, el tamaño del texto, etc. Si el elemento tiene hijos (anidados en el árbol de entidades de la izquierda), estas entidades hijas también se ven afectadas por el Tween.

📔 Nota: Cada entidad solo puede realizar un Tween a la vez. Por ejemplo, no puedes hacer que un elemento se mueva hacia un lado y gire al mismo tiempo. Como alternativa, puedes usar entidades con una relación padre-hijo. Por ejemplo, puedes tener una entidad padre invisible que se mueva hacia un lado y una entidad hija visible que gire.

Acerca de la generación de entidades

Usa una acción Spawn Entity para crear una copia nueva de un elemento en la escena mientras se está ejecutando. A diferencia de la acción Clone , no es necesario colocar primero en la escena el elemento que generas.

Haz que un elemento se pueda generar

Antes de poder generar un elemento, debe estar disponible en los archivos de tu proyecto. Para añadir un elemento sin colocarlo en la escena:

  1. En el panel Assets , busca el elemento en el catálogo o en Custom Items.

  2. Haz clic derecho en el elemento y selecciona Añadir al sistema de archivos.

Esto copia el elemento en tu proyecto para que puedas generarlo más adelante. No añade nada visible a la escena. Luego, el elemento aparece en el menú desplegable Source de cualquier acción Spawn Entity .

Configura la acción

Una acción Spawn Entity tiene dos campos:

  • Source: El elemento que se va a generar. Elige entre los elementos añadidos a los archivos de tu proyecto.

  • Position: Las coordenadas X, Y y Z donde aparece la nueva copia, relativas al elemento que realiza la acción.

Si el elemento que generas también es un smart item, cada copia generada conserva sus propias acciones y Triggers, que funcionan de forma independiente.

💡 Consejo: Para generar elementos desde el código, consulta Composites. Los elementos añadidos a los archivos de tu proyecto se almacenan como Composites, el mismo formato que utiliza la función spawn del SDK.

Acerca de los Triggers de clic

Para activar una acción al hacer clic en un elemento, crea un Al hacer clic activador. La acción se activará cada vez que el jugador haga clic en la Entity.



Consulta Convertir cualquier elemento en Smart item para obtener más detalles.

📔 Nota: Al usar modelos 3D personalizados, el modelo debe tener una geometría Collider invisible para que se pueda hacer clic en él. Consulta Colliders.

Como alternativa, puedes configurar el componente GLTF del elemento para que su Visible Layer de colisión esté configurada como Pointer.

Otra alternativa es añadir un Smart item Click Area para dibujar un cubo que se superponga al elemento en el que quieres hacer clic. El Smart item Click Area es un elemento invisible.

Activar al aparecer

Los activadores de tipo Al aparecer activan una acción cuando se carga la Scene. En lugar de esperar a que el jugador interactúe con un elemento, la acción se ejecuta de inmediato.

Por ejemplo, puedes usar esto para hacer que una plataforma se mueva continuamente. Usa un activador Al aparecer para activar una acción Tween. Después, usa activadores Al cambiar de estado para mantenerla en movimiento entre dos o más posiciones.



Multijugador

Todos los Smart items son multijugador de forma predeterminada. Consulta Smart Items - Básico para obtener más detalles.

Puedes cambiar o ajustar este comportamiento multijugador para sincronizar solo algunos componentes del elemento.

En el componente Multiplayer marca las casillas de los componentes que quieras compartir.

Por ejemplo, una puerta comparte su Animator para que todos vean las animaciones de apertura, su AudioSource para que todos oigan el sonido, y su State para que todos puedan saber si está abierta o cerrada en ese momento. La puerta no comparte su componente Visibility , porque normalmente siempre está visible. Si incluyes acciones para activar y desactivar su visibilidad, quizá también quieras marcar este componente para que los cambios se sincronicen entre todos los jugadores.

Elementos invisibles

Algunos elementos no están pensados para que los vea el jugador, pero son visibles mientras editas la Scene para que sea más fácil gestionarlos. Este es el caso de elementos como Ambience, Trigger Area, Click Area, etc.

En el modo avanzado, estos elementos tienen un Visibility component establecido como invisible. Este component no afecta la visibilidad de los elementos en Scene Editor, pero los jugadores no verán ningún elemento establecido como invisible al ejecutar una vista previa.

Ver también

Última actualización