Smart Items - Básico
Usar smart items en tu escena para añadir interactividad.
Algunos de los elementos en el catálogo del 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 en 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 por defecto, ejecuta una vista previa de la escena para probarlo.
Aquí hay algunos elementos comunes y sus comportamientos por defecto:
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 eventos trigger 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 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 a dónde se mueven, su velocidad, etc.
Trigger area: 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: Reproducir audio desde una transmisión en vivo. Ver Reproducción de streams de audio
NFT: Mostrar una imagen NFT como retrato. Ver Mostrar NFTs
Todos los smart items pueden configurarse para comportarse de formas personalizadas. Por ejemplo, cuánto se desplaza una plataforma o qué activa un botón.
Configurar un elemento
Selecciona un elemento en el Scene Editor para ver todas sus propiedades a la derecha.
Algunos campos típicos que puedes encontrar en muchos elementos son:
Hover text: 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 "Open"
Interaction: ¿Con qué botón se activa el elemento? En un teclado típico:
Primary es E
Secondary es F
Pointer es Mouse Left Button
Action3 is key 1
Action4 is key 2
Action5 is key 3
Action6 is key 4
Al hacer clic: Selecciona qué acción se realiza cuando se interactúa con el elemento, usando el botón del campo Interaction Puedes activar tantas acciones como quieras; estas pueden ser acciones en ese mismo elemento o en otros elementos también.
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 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 ocurran cada vez que se activa el elemento. Simplemente selecciona el elemento que quieres llamar, desde una lista de todos los elementos en la escena, y luego selecciona una acción. Diferentes elementos exponen distintas 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 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. Simplemente haz clic + 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 When Opened campo, esta acción también será activada 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:
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 componente Triggers components. Las acciones en estos eventos trigger se activan cada vez que el jugador entra o sale del área.
Ver Trigger area para más info.
Paredes invisibles
Una colección de formas invisibles que pueden impedir que los jugadores caminen o hagan clic a través de un área.
Estas paredes invisibles pueden ser útiles al importar un modelo 3D que no tiene una malla collider, o cuando quieres crear una pared que no sea visible para el jugador.
Ver Colliders para más info.
Área de clic
Un cubo invisible que los jugadores pueden hacer clic para activar acciones en cualquier otro smart items. Este elemento puede ser habilitado o deshabilitado por cualquier otro smart item; cuando está deshabilitado no será clicable. También puedes establecer el texto que los jugadores ven al apuntar su cursor hacia él.
Reproducción de videos
Reproduce videos desde:
Local files
Transmitir desde una URL
Transmitir en vivo desde Decentraland Cast
Transmitir 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 severamente el rendimiento para los jugadores. Detén siempre otros videos antes de reproducir un segundo video.
Ver Reproducir Videos para más info.
Reproducción de streams de audio
Reproduce un stream de audio desde una URL, usando el Audio Stream smart item.
Puedes ajustar el volumen de tu stream. Ten en cuenta que el audio del stream no es posicional; se escucha a un volumen uniforme en toda tu escena.
Mostrar NFTs
Para mostrar un NFT en un marco de imagen, usa el NFT smart item. Debes proporcionar los siguientes campos:
Network
NFT Collection Contract: El contrato inteligente de la colección NFT.
Token ID: El ID del token de este coleccionable NFT en particular.
Puedes obtener esta información desde OpenSea, comprobando la Detalles pestaña bajo la imagen del NFT.
También puedes configurar un color de fondo; esto es especialmente ú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.
Ver Mostrar un NFT para más detalles.
Barras de salud
El Health Bar smart item es un gran bloque de construcción para varias mecánicas de juego. Puede usarse de diversas maneras:
Anidarlo bajo el Player para mostrar la salud del jugador sobre el avatar
Anidarlo bajo el Camera para mostrarla fijada en la UI
Anidarlo bajo literalmente cualquier elemento en la escena para llevar el control de la salud de ese elemento
Otros elementos pueden interactuar con la barra de salud para añadir o restar vida de la misma.
Elementos como los Spikes u 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 igual a 0. Podrías respawnear al jugador en la posición de un Respawn Pad smart item, reiniciar el contador de su puntuación, respawnear a cualquier enemigo, mostrar un 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 menor que cierto valor; por ejemplo, reproducir una música especial o mostrar una pista en la UI cuando la salud sea menor que 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 vida 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 usarse 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 en 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 verá esa puerta abierta. Si el jugador C entra luego en la escena mientras los otros jugadores siguen allí, ella también verá la puerta ya abierta.
Sin embargo, si no hay jugadores cerca de la escena, entonces la escena se restaura a su estado por defecto. Así que si todos los jugadores se van y luego el jugador A regresa, ella encontrará la puerta cerrada (si ese era el estado por defecto de la puerta).
Asegúrate de diseñar tu escena para que las acciones de un jugador no saboteen la experiencia para otros que lleguen después. Por ejemplo, si la escena es un juego de rompecabezas, puedes usar una delay action en un tools smart item para hacer que todos los elementos de la escena se restablezcan a su estado inicial unos segundos después de que se resuelva el rompecabezas.
También puedes desactivar el comportamiento multijugador de un elemento; ver Smart Items - Advanced.
Solución de problemas
Un elemento en mi escena debería ser clicable, pero no se puede hacer clic.
Asegúrate de que no esté siendo 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é sucede.
Ver también
Última actualización