Smart Items - Básico

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

Algunos de los elementos del catálogo del Scene Editor son Smart Items. Los jugadores pueden interactuar con estos, tienen propiedades configurables y pueden desencadenar acciones en otros smart items. Por ejemplo: puertas que se pueden abrir y cerrar, plataformas que se mueven hacia arriba y 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 porque tienen el icono de rayo junto a ellos en el árbol de entidades.

Uso de 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.

Aquí hay 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 sonido y una animación como retroalimentación. Agrega 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 ejecute diferentes acciones en 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 de tween para controlar a 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 About trigger areas.

  • Video Player: Una pantalla para mostrar videos o transmisiones en vivo. Ver Reproducción de videos.

  • Transmisión de audio: Reproduce audio de una transmisión en vivo. Ver Reproducción de transmisiones de audio

  • NFT: Muestra una imagen NFT como retrato. Ver Mostrar NFTs

Todos los smart items pueden configurarse para comportarse de maneras personalizadas. Por ejemplo, qué tanto se mueve 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:

  • Texto emergente: 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"

  • 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 ratón

    • Acción3 es la tecla 1

    • Acción4 es la tecla 2

    • Acción5 es la tecla 3

    • Acción6 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 Interacción campo. Puedes activar tantas acciones como quieras; éstas pueden ser acciones sobre ese mismo ítem o sobre otros ítems también.

Cada ítem tiene sus propios ajustes específicos, que pueden variar de un ítem a otro.

Todos los ítems 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 ítem 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 a una acción en otro ítem

Los smart items pueden activar acciones en otros smart items, de modo que ocurran cada vez que se active el ítem. Simplemente selecciona el ítem que quieres llamar, desde una lista de todos los ítems en la escena, y luego selecciona una acción. Diferentes ítems 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 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 ítems para que se activen juntas. Simplemente haz clic en + Assign Action.

Quita acciones haciendo clic en los tres puntos junto a una acción y seleccionando Quitar 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 When Opened campo, esta acción también será activada indirectamente por 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:

Áreas de activación

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 activador en los Triggers componentes del ítem. Las acciones en estos eventos de activación se activan cada vez que el jugador entra o sale del área.

Ver Área de activación para más información.

Paredes invisibles

Una colección de formas invisibles que pueden bloquear a los jugadores para que no atraviesen o hagan clic en un área.

Estas paredes invisibles pueden ser útiles al importar un modelo 3D que no tiene una malla de collider, o cuando quieres crear una pared que no sea visible para el jugador.

Ver Colliders para más información.

Área clicable

Un cubo invisible que los jugadores pueden clicar para activar acciones en cualquier otro smart item. Este ítem puede ser habilitado o deshabilitado por cualquier otro smart item; cuando está deshabilitado no será clicable. También puedes configurar el texto que los jugadores ven al apuntar su cursor sobre él.

Reproducción de videos

Reproducir videos desde:

  • Archivos locales

  • Transmitir desde una URL

  • Transmitir en directo desde Decentraland Cast

  • Transmitir en directo desde Software RTMP (OBS, XSplit, StreamYard, etc.)

circle-exclamation

Ver Reproducir Videos para más información.

Reproducción de streams de audio

Reproduce un stream de audio desde una URL, usando el Transmisión de audio smart item.

circle-info

📔 Nota: No todos los servicios de streaming permiten reproducir su audio fuera de su sitio. A continuación hay 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 a un volumen uniforme en toda tu escena.

Mostrar NFTs

Para mostrar un NFT en un marco de imagen, utiliza el NFT smart item. Debes proporcionar los siguientes campos:

  • Network

circle-info

📔 Nota: Actualmente ethereum es la única red compatible.

  • NFT Collection Contract: El contrato inteligente de la colección de NFT.

  • Token ID: El ID del token de este coleccionable NFT en particular.

NFT shape

Puedes obtener esta información de OpenSeaarrow-up-right, comprobando la Detalles pestaña bajo la imagen del NFT.

OpenSea details

circle-info

📔 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:

  • Network: ethereum

  • Contract: 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.

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 formas:

  • Anidarlo bajo el Player para mostrar la salud del jugador sobre el avatar

  • Anidarlo bajo el Camera para mostrarlo fijo en la UI

  • Anídalo literalmente bajo cualquier elemento de la escena para hacer seguimiento de la salud de ese elemento

Otros elementos pueden interactuar con la barra de salud para sumar o restar salud de la misma.

  • Elementos como los Spikes o Robot Enemy pueden bajar 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. Podrías hacer que el jugador reaparezca en la posición de un Respawn Pad smart item, reiniciar el contador de su puntuación, reaparecer 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 esté por debajo de 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 la Wooden Door elemento inteligente. Esta barra puede ver reducida su salud por el jugador usando el Sword elemento inteligente, 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 en su elemento padre cuando su valor sea 0.

Armas como la Sword pueden ser recogidas por el jugador y luego utilizadas para causar daño a cualquier otro elemento con una barra de salud que esté cerca del jugador al ejecutar 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 ve esa puerta abierta. Si el jugador C entra en la escena mientras los otros jugadores aún 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 restaura a su estado predeterminado. Así que si todos los jugadores se van y luego el jugador A regresa, ella 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 los que lleguen después. Por ejemplo, si la escena es un juego de rompecabezas, puedes usar una delay acción en un tools elemento inteligente para hacer que todos los elementos de la escena se reinicien a su estado inicial unos segundos después de que se resuelva el rompecabezas.

También puedes desactivar el comportamiento multijugador de un elemento, consulta Smart Items - Advanced.

Troubleshooting

  • Un elemento en mi escena debería ser clicable, pero no se puede clicar.

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 malla collider 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