Smart Items - Básico
Usar Smart Items en tu escena para añadir interactividad.
Algunos de los elementos del catálogo de Scene Editor son Smart Items. Los jugadores pueden interactuar con ellos, tienen propiedades configurables y pueden activar acciones en otros smart items. Por ejemplo: puertas que pueden abrirse y cerrarse, plataformas que suben y bajan, 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 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 una vista previa de la escena para probarlo.
Estos son 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, trigger areas, etc.
Botones: Al hacer clic, reproducen sonido y una animación como retroalimentación. Añade más acciones a sus trigger events para activar otros smart items.
Palancas: Al hacer clic, alternan entre dos estados. Haz que cada posición de la palanca realice diferentes acciones en otros smart items.
Cofres: Funcionan como las puertas; de forma predeterminada 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 de tween para controlar a dónde se mueven, su velocidad, etc.
Área de trigger: Un elemento invisible que puede activar otros smart items cuando el jugador entra en su área. Ver About trigger areas.
Video Player: Una pantalla para mostrar videos o transmisiones en vivo. Ver Reproducción de Videos.
Audio Stream: Reproduce audio desde una transmisión en vivo. Ver Reproducción de Audio Streams
NFT: Muestra una imagen de un NFT como un retrato. Ver Mostrando NFTs
Todos los smart items pueden configurarse para comportarse de formas personalizadas. Por ejemplo, qué tan lejos 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 de hover: 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
Pointer es Botón izquierdo del mouse
Action3 es la tecla 1
Action4 es la tecla 2
Action5 es la tecla 3
Action6 es la tecla 4
Al hacer clic: Selecciona qué acción se realiza cuando se interactúa con el elemento, usando el botón del campo Interacción . Puedes activar tantas acciones como quieras; estas pueden ser acciones en ese mismo elemento o también en otros elementos.
Cada elemento tiene sus propios ajustes específicos, que pueden variar de un elemento a otro.
Todos los elementos tienen un Modo avanzado 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 añadir 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 añadir lógica condicional para activar algo solo en ciertos escenarios. Ver Smart Items - Advanced.
Llamar una acción en otro elemento
Los smart items pueden activar acciones en otros smart items, de modo que sucedan cada vez que se activa el elemento. Solo selecciona el elemento que quieres llamar, desde una lista de todos los elementos de la escena, y luego selecciona una acción. Diferentes elementos exponen diferentes acciones.
Por ejemplo, aquí hay un botón que abre o cierra una puerta. Cada vez que se presiona 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 diferentes de distintos elementos para que se activen juntas. Solo haz clic en + Assign Action.
Elimina acciones haciendo clic en los tres puntos junto a una acción y seleccionando Remove action.
También puedes encadenar acciones. Por ejemplo, si la puerta que se abre con la palanca incluye una acción en su propio campo When Opened esta acción también se activará indirectamente mediante la palanca.
Si usas el Modo avanzado 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:
Trigger areas
Usa el smart item Trigger Area para activar una acción cuando el jugador entra en un área.
Usa la On Player Enters Area y On Player Leaves Area tipos de trigger en el Triggers components. Las acciones de estos trigger events se activan cada vez que el jugador entra o sale del área.
Consulta Área de trigger 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 una 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 en el 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 con el cursor hacia él.
Reproducción de videos
Reproduce videos desde cualquiera de estas fuentes:
Archivos locales
Stream desde una URL
Stream en vivo desde Decentraland Cast
Stream en vivo desde RTMP Software (OBS, XSplit, StreamYard, etc.)
📔 Nota: Evita reproducir más de un video al mismo tiempo en tu escena, porque puede afectar gravemente el rendimiento para los jugadores. Detén siempre los otros videos antes de reproducir un segundo video.
Consulta Reproducir videos para más información.
Reproducción de audio streams
Reproduce un audio stream desde una URL, usando el Audio Stream smart item.
📔 Nota: No todos los servicios de streaming 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 al 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.
Contrato de colección NFT: El smart contract de la colección NFT.
Token ID: El token ID de este NFT en particular.
Puedes obtener esta información de OpenSea, comprobando la pestaña La pestaña de 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 con lo siguiente:
Red: ethereum
Contrato: 0x32b7495895264ac9d0b12d32afd435453458b1c6
Token: 1956
También puedes configurar un color de fondo; esto es especialmente útil para NFTs con un fondo transparente.
También puedes elegir un estilo de marco, para enmarcar el NFT con una variedad de estilos diferentes, clásicos y modernos.
Consulta Mostrar un NFT para más detalles.
Barras de salud
El El smart item Health Bar es un gran bloque de construcción para varios mecánicas de juego. Puede usarse de diversas maneras:
Anídalo bajo el Player para mostrar la salud del jugador sobre el avatar
Anídalo bajo el Camera para mostrarlo fijo en la UI
Anídalo literalmente debajo de cualquier elemento de la escena para hacer seguimiento de la salud de ese elemento
Otros elementos pueden interactuar con la barra de salud para añadir o restar salud de ella.
Elementos como los Spikes o Robot Enemy pueden reducir la salud
elementos como First Aid o el Healing Pad pueden restaurarla.
Debes configurar la Health Bar para definir qué ocurrirá cuando la salud sea 0. Podrías reaparecer al jugador en la posición de un Respawn Pad smart item, reiniciar el contador de su puntuación, reaparecer a cualquier enemigo, mostrar un texto de UI o lo que tenga sentido en la lógica de tu juego.
También puedes activar acciones cuando la salud sea menor que cierto valor; por ejemplo, reproducir una música especial o mostrar una pista de UI cuando la salud sea inferior a 3.
¡Las barras de salud pueden configurarse para afectar cualquier cosa! Por ejemplo, añade una barra de salud anidada bajo el 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. Para que esto funcione, configura la barra de salud para que realice una acción sobre su elemento padre cuando su valor sea 0.
Armas como la Sword pueden ser recogidas por el jugador, y luego usadas para causar daño a cualquier otro elemento con una barra de salud 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 el jugador 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, entonces la escena se restablece 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 para que las acciones de un jugador no saboteen la escena para otros que lleguen después. Por ejemplo, si la escena es un juego de puzzles, puedes usar una acción de delay en un smart item de tools para hacer que todos los elementos de la escena se reinicien a su estado inicial unos segundos después de resolver el puzzle.
También puedes deshabilitar el comportamiento multijugador de un elemento; consulta Smart Items - Advanced.
Solución de problemas
Un elemento en mi escena debería ser clickable, 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 una collider mesh que tiene una geometría simplificada que podría estar obstruyendo tu elemento, aunque su forma visible no parezca hacerlo. Intenta mover el elemento para ver qué ocurre.
See also
Última actualización