Smart Items - Básico
Usa smart items en tu Scene para agregar interactividad.
Algunos de los elementos del catálogo de Scene Editor son Smart Items. Los jugadores pueden interactuar con estos, tienen propiedades configurables y pueden activar acciones en otros smart items. Por ejemplo: puertas que se pueden abrir y cerrar, plataformas que se mueven hacia arriba y hacia abajo, o botones y palancas que pueden activar otros elementos.
Puedes reconocer estos elementos en el explorador de asset packs porque tienen un icono de rayo y un fondo de color diferente.
Puedes reconocer qué elementos de tu escena son smart items porque tienen el icono de rayo junto a ellos en el entity tree.
Usar elementos
Para usar un smart item, arrástralo a la escena como cualquier otro elemento. Todos los elementos incluyen un comportamiento predeterminado; ejecuta un preview de la escena para probarlo.
Aquí tienes algunos elementos comunes y sus comportamientos predeterminados:
Puertas: Las puertas se abren o cierran al hacer clic. Puedes cambiar este comportamiento para que se abran mediante botones, áreas de activación, etc.
Botones: Al hacer clic, reproducen un sonido y una animación como retroalimentación. Añade más acciones a sus eventos de activación para activar otros smart items.
Palancas: Al hacer clic, alternan entre dos estados. Haz que cada posición de la palanca realice distintas acciones sobre otros smart items.
Cofres: Se comportan como las puertas; por defecto se abren o cierran al hacer clic. Puedes colocar elementos más pequeños dentro de ellos.
Plataformas: Se mueven entre dos posiciones. Usa sus acciones tween para controlar hacia dónde se mueven, su velocidad, etc.
Área de activación: Un elemento invisible que puede activar otros smart items cuando el jugador entra en su área. Ver Acerca de las áreas de activación.
Video Player: Una pantalla para mostrar videos o transmisiones en vivo. Ver Reproducción de videos.
Transmisión de audio: Reproduce audio desde una transmisión en vivo. Ver Reproducción de transmisiones de audio
NFT: Muestra la imagen de un NFT como un retrato. Ver Mostrando NFTs
Todos los smart items pueden configurarse para comportarse de formas personalizadas. Por ejemplo, hasta dónde se mueve una plataforma o qué activa un botón.
Configurar un elemento
Selecciona un elemento en Scene Editor para ver todas sus propiedades a la derecha.
Algunos campos típicos que puedes encontrar en muchos elementos son:
Texto al pasar el cursor: Qué texto se muestra en la UI como pista cuando el jugador pasa el cursor sobre el elemento. Por ejemplo, una puerta podría decir "Abrir"
Interacción: ¿Con qué botón se activa el elemento? En un teclado típico:
Primario es E
Secundario es F
Puntero es Botón izquierdo del mouse
Acción3 es la tecla 1
Acción4 es la tecla 2
Acción5 es la tecla 3
Acción6 es la tecla 4
Cuando se hace clic: Selecciona qué acción se realiza cuando se interactúa con el elemento, usando el botón del Interacción campo. Puedes activar tantas acciones como quieras; pueden ser acciones sobre ese mismo elemento o también sobre otros elementos.
Cada elemento tiene sus propios ajustes específicos, que pueden variar de un elemento a otro.
Todos los elementos tienen un Advanced Mode que te permite configurar casi cualquier cosa sobre ellos. Esto incluye cosas como qué sonidos se reproducen o en qué dirección se mueve una plataforma. También puedes agregar acciones personalizadas que incluyan todo tipo de cosas, como teletransportar al jugador, reproducir animaciones del avatar, adjuntar un elemento a las manos del jugador, etc. También puedes agregar lógica condicional para activar algo solo en determinados escenarios. Ver Smart Items - Advanced.
Llamar una acción en otro elemento
Los smart items pueden activar acciones en otros smart items, para que ocurran cada vez que se active el elemento. Solo selecciona el elemento al que quieres llamar, de una lista de todos los elementos de la escena, y luego selecciona una acción. Distintos elementos exponen distintas acciones.
Por ejemplo, aquí hay un botón que abre o cierra una puerta. Cada vez que se pulsa el botón, la puerta se abrirá o se cerrará.
Aquí hay una palanca que abre una puerta cuando se activa y cierra esa puerta cuando se desactiva.
Puedes añadir tantas acciones distintas de diferentes elementos como quieras para que se activen juntas. Solo haz clic + Asignar acción.
Elimina acciones haciendo clic en los tres puntos junto a una acción y seleccionando Eliminar acción.
También puedes encadenar acciones. Por ejemplo, si la puerta que se abre con la palanca incluye una acción en su propio Cuando se abre campo, esta acción también se activará indirectamente por la palanca.
Si usas el Advanced mode también puedes añadir lógica condicional a este tipo de acciones.
Smart items especiales
Algunos smart items tienen características únicas que los hacen muy útiles para escenarios comunes:
Áreas de activación
Usa el smart item Trigger Area para activar una acción cuando el jugador entra en un área.
Usa la Player Enters Area y Player Leaves Area tipos de trigger en el Triggers componentes. Las acciones de estos eventos de activación se activan cada vez que el jugador entra o sale del área.
Consulta Área de activación para más información.
Paredes invisibles
Una colección de formas invisibles que pueden impedir que los jugadores atraviesen o hagan clic a través de un área.
Estas paredes invisibles pueden ser útiles al importar un modelo 3D que no tiene un collider mesh, o cuando quieres crear una pared que no sea visible para el jugador.
Consulta Colliders para más información.
Área de clic
Un cubo invisible que los jugadores pueden hacer clic para activar acciones en cualquier otro smart item. Este elemento puede ser habilitado o deshabilitado por cualquier otro smart item; cuando está deshabilitado, no se puede hacer clic en él. También puedes establecer el texto que los jugadores ven cuando apuntan el cursor hacia él.
Reproducción de videos
Reproduce videos desde cualquiera de estas opciones:
Archivos locales
Transmitir desde una URL
Transmitir en vivo desde Decentraland Cast
Transmitir en vivo desde Software RTMP (OBS, XSplit, StreamYard, etc.)
📔 Nota: Reproducir videos exige mucho rendimiento, así que mantén bajo el número de videos que se reproducen al mismo tiempo. El engine limita cuántos videos pueden reproducirse simultáneamente según los ajustes de calidad de cada jugador (1 en bajo, 5 en medio, 10 en alto) y pausa cualquier video que supere ese límite. Ver Reproducir videos.
Consulta Reproducir videos para más información.
Reproducción de transmisiones de audio
Reproduce una transmisión de audio desde una URL, usando el Transmisión de audio smart item.
📔 Nota: No todos los servicios de streaming te permiten reproducir su audio fuera de su sitio. Los siguientes son algunos ejemplos que funcionan en Decentraland:
Puedes ajustar el volumen de tu stream. Ten en cuenta que el audio del stream no es posicional; se escucha con el mismo volumen en toda tu escena.
Mostrando NFTs
Para mostrar un NFT en un marco, usa el NFT smart item. Debes proporcionar los siguientes campos:
Red
📔 Nota: Actualmente ethereum es la única red compatible.
NFT Collection Contract: el smart contract de la colección de NFT.
Token ID: el ID del token de este NFT en particular.
Puedes obtener esta información en OpenSea, comprobando la Detalles pestaña debajo de la imagen del NFT.
📔 Nota: También puedes obtener esta información desde la URL de OpenSea. Por ejemplo, si la URL del NFT es la siguiente:
https://opensea.io/assets/ethereum/0x32b7495895264ac9d0b12d32afd435453458b1c6/1956
Puedes completar los campos de la siguiente manera:
Red: ethereum
Contrato: 0x32b7495895264ac9d0b12d32afd435453458b1c6
Token: 1956
También puedes configurar un color de fondo; esto es particularmente útil para NFTs con fondo transparente.
También puedes elegir un Frame style, para enmarcar el NFT en una variedad de estilos diferentes, clásicos y modernos.
Consulta NFTs para más detalles.
Barras de salud
El Health Bar smart item es un excelente bloque de construcción para varias mecánicas de juego. Puede usarse de varias maneras:
Anídalo debajo de Player para mostrar la salud del jugador sobre el avatar
Anídalo debajo de Camera para mostrarlo fijo en la UI
Anídalo debajo de literalmente cualquier elemento de la escena para hacer un seguimiento de la salud de ese elemento
Otros elementos pueden interactuar con la health bar para sumar o restarle salud.
Elementos como Spikes ni Robot Enemy pueden reducir la salud
elementos como First Aid o el Healing Pad pueden restaurarla.
Debes configurar la Health Bar para definir qué sucederá cuando la salud sea 0. Puedes hacer que el jugador reaparezca en la posición de un Respawn Pad smart item, restablecer el contador de su puntuación, reaparecer cualquier enemigo, mostrar texto en la UI o lo que tenga sentido en la lógica de tu juego.
También puedes activar acciones cuando la salud sea inferior a cierto valor; por ejemplo, reproducir una música especial o mostrar una pista en la UI cuando la salud sea menor que 3.
Las health bars pueden configurarse para afectar a cualquier cosa. Por ejemplo, añade una health bar anidada debajo de la Wooden Door smart item. Esta barra puede ver reducida su salud por el jugador usando el Sword smart item, pero también por una explosión del Barrel o el ataque del Robot Enemy.
Armas como la Sword pueden ser recogidas por el jugador y luego usarse para causar daño a cualquier otro elemento con una health bar que esté cerca del jugador al realizar la acción.
Multiplayer
Casi todos los smart items tienen comportamiento multijugador, de modo que todos los jugadores de la escena comparten la misma experiencia a medida que los elementos cambian de estado. Si el jugador A abre una puerta, el jugador B también ve esa puerta abierta. Si luego la jugadora C entra en la escena mientras los otros jugadores todavía están allí, ella también verá la puerta ya abierta.
Sin embargo, si no hay jugadores cerca de la escena, la escena se restaura a su estado predeterminado. Así que si todos los jugadores se van, pero luego el jugador A regresa, encontrará la puerta cerrada (si ese era el estado predeterminado de la puerta).
Asegúrate de diseñar tu escena de modo que las acciones de un jugador no arruinen la escena para otros que lleguen después. Por ejemplo, si la escena es un juego de puzles, puedes usar una delay acción sobre un tools smart item para hacer que todos los elementos de la escena se restablezcan a su estado inicial unos segundos después de resolver el puzle.
También puedes desactivar el comportamiento multijugador de un elemento, ver Smart Items - Advanced.
Solución de problemas
Un elemento de mi escena debería ser clicable, pero no se puede hacer clic en él.
Asegúrate de que no esté obstruido por otra cosa. No puedes hacer clic a través de otros elementos. Algunos elementos tienen un collider mesh que tiene una geometría simplificada que puede estar obstruyendo tu elemento, aunque su forma visible no parezca hacerlo. Intenta mover el elemento para ver qué ocurre.
Ver también
Última actualización