Hay dos formas de usar un interruptor.
-
Como un interruptor físico con el que pueden interactuar los jugadores, usado con otros dispositivos para que los jugadores puedan abrir y cerrar puertas o encender y apagar luces.
-
Como método para filtrar interacciones con otros dispositivos. Por ejemplo, si el estado del interruptor está activado (establecido en Sí), transmitirá en un canal y, si el interruptor está desactivado (establecido en No), transmitirá en otro canal.
Para encontrar el dispositivo de interruptor, echa un vistazo a Buscar y colocar dispositivos.
Filtro contextual
Algunos dispositivos son afectados por una característica llamada filtro contextual. Esta característica oculta o muestra opciones según los valores seleccionados en ciertas opciones relacionadas. Esta característica ordenará el panel Personalizar de una mejor manera y hará que las opciones sean más fáciles de administrar y explorar.
Sin embargo, es posible que no sea fácil reconocer qué opciones o valores activan el filtro contextual. Para ayudarte a identificarlos, los valores que activan el filtro contextual estarán en cursiva. Se mostrarán todas las opciones, incluso las que afecta el filtro contextual. Si alguna se oculta o muestra en función del valor de una opción determinada, habrá una nota que lo informará en el campo Descripción de la opción.
Opciones del dispositivo
Este dispositivo tiene algunas funciones básicas, como establecer la visibilidad del interruptor y qué texto verá el jugador cuando interactúe con él. Además, incluye algunas opciones avanzadas que puedes usar si el interruptor tiene la capacidad de guardar su estado.
Puedes configurar este dispositivo con las siguientes opciones.
Los valores predeterminados están en negrita. Los valores que usan filtro contextual están en cursiva.
Opción | Valor | Descripción |
---|---|---|
Habilitado al inicio de la partida | Sí, No | Determina si el dispositivo está habilitado al inicio de la partida. Los dispositivos deshabilitados ignoran todos los eventos excepto la capacidad de habilitarse. |
Estado inicial | No, Sí | Este es el estado inicial predeterminado del interruptor cuando no hay un estado originado por un jugador para anularlo. |
Visible durante la partida | Sí, No | Determina si el dispositivo será visible para los jugadores durante la partida. |
Texto de activación | Se debe ingresar texto en el campo | Establece el texto que aparece al pasar el interruptor al estado de activado. El campo de texto tiene un límite de 150 caracteres. |
Texto de desactivación | Se debe ingresar texto en el campo | Establece el texto que aparece al pasar el interruptor al estado de desactivado. El campo de texto tiene un límite de 150 caracteres. |
Modelo de dispositivo | Predeterminado, palanca antigua, activar/desactivar interruptor, predeterminado (apagado), palanca antigua (apagada), botón rojo, rompecircuitos, palanca ancestral, casilla | Este es el modelo visual que se usa para el interruptor. |
Sonido | Habilitado, deshabilitado | Determina si el interruptor reproduce un sonido cuando cambia de estado (de Desactivado a Activado y de Activado a Desactivado). |
Permitir interactuar | Sí, No | Determina si los jugadores pueden interactuar con el dispositivo. |
Tiempo de interacción | Inmediato, se debe elegir o ingresar una cantidad de segundos | Determina la cantidad de tiempo que deberá interactuar el jugador para activar al dispositivo. |
Limita las veces que puede cambiar | No, Sí | Determina si hay un límite en la cantidad de veces que puede cambiar el dispositivo. Si está establecida en Sí, aparecerá una opción adicional debajo de esta. |
Las veces que puede cambiar | 1, se debe elegir o ingresar un número | Determina la cantidad de veces que puede activarse o desactivarse el dispositivo antes de que se deshabilite. |
Tiempo de reutilización infinito | No, Sí | Determina el tiempo de reutilización para volver a interactuar con el dispositivo. Si se establece en Sí, no aparecerá la opción Tiempo de reutilización debajo de esta. |
Tiempo de reutilización | Inmediato, se debe elegir una cantidad de segundos | Esta opción solo aparece si la opción Tiempo de reutilización infinito está establecida en No. Determina el tiempo de reutilización que debe transcurrir para volver a interactuar. |
Clase permitida | Ninguna clase, cualquiera, se debe elegir o ingresar una clase | Determina qué clase puede activar el dispositivo. |
Equipo permitido | Cualquiera, se debe elegir o ingresar un equipo | Determina qué equipos pueden activar el dispositivo. |
Radio de interacción | 0, se debe elegir o ingresar una distancia | Permite que los jugadores interactúen al mirar hacia cualquier punto dentro de un radio del tamaño especificado en lugar de tener que mirar directamente hacia el botón. Úsalo en conjunto con el ajuste Visibilidad para que parezca que los jugadores están interactuando con otros objetos. |
Tiempo de restablecimiento del estado | Sin restablecimiento, se debe elegir o ingresar una cantidad de tiempo | Determina la cantidad de tiempo que debe transcurrir antes de que el dispositivo se restablezca a su estado predeterminado. |
Exclusión mutua | Sin exclusión, se debe elegir un número | Mover este interruptor a Sí desactivará los demás interruptores que tengan el mismo número de índice de Exclusión mutua. |
Almacenar estado por jugador | Sí, No | Si se establece en Sí, cada jugador tendrá su propio estado de interruptor. Si se establece en No, todos los jugadores tendrán el mismo estado de interruptor. Si se establece en No y la opción Usar persistencia está establecida en Usar, el interruptor usará la opción Resolver conflictos cuando el estado intente cargarse. |
Usar persistencia | No usar, usar | Establece si este dispositivo debería cargar datos desde el servidor. Si seleccionas Usar, aparecerán opciones adicionales en la pestaña Todas las opciones. |
Guardado automático | Sí, No | Esta opción solo aparece si la opción Usar persistencia está establecida en Usar. Determina si el estado del interruptor se guarda automáticamente al cambiar. |
Carga automática | Sí, No | Determina si el estado del interruptor se carga automáticamente al inicio de la partida o si debe cargarse a partir de la vinculación de eventos. |
Resolver conflictos | Primer jugador, mayoría, priorizar activado, priorizar desactivado | Determina qué ocurre cuando se carga el estado y la opción Almacenar estado por jugador está establecida en No. Valores de esta opción:
|
Comprobar el estado al inicio de la partida | Habilitado, deshabilitado | Determina si el interruptor revisará su estado al inicio de la partida, activando los eventos Activar al comprobar resultado o Desactivar al comprobar resultado. |
Comprobar estado del interruptor al estar deshabilitado | Sí, No | Determina si el dispositivo comprobará su estado incluso cuando esté deshabilitado. |
Sistema de vinculación directa de eventos
La vinculación directa de eventos permite que los dispositivos se comuniquen de forma directa, lo cual hace que el flujo de trabajo sea más intuitivo y te otorga más libertad para centrarte en crear tus ideas de diseño.
A continuación, encontrarás las funciones y eventos de este dispositivo.
Funciones
Una función escucha un evento de un dispositivo y luego realiza una acción.
- Para cualquier función, haz clic en la opción y luego en Seleccionar dispositivo para acceder y seleccionar una desde el menú desplegable del dispositivo.
- Después de seleccionar un dispositivo, haz clic en Seleccionar evento para vincular el dispositivo a un evento que activará la función para el dispositivo.
- Si más de un dispositivo o evento puede activar una función, oprime el botón Añadir para añadir una línea y repite estos pasos.
Opción | Descripción |
---|---|
Habilitar cuando se recibe | Esta función habilitará el dispositivo cuando se produzca un evento. |
Deshabilitar cuando se recibe | Esta función deshabilitará el dispositivo cuando se produzca un evento. |
Se activa cuando se recibe | Esta función activará el interruptor cuando se produzca un evento. |
Se desactiva cuando se recibe | Esta función desactivará el interruptor cuando se produzca un evento. |
Activar/desactivar estado cuando se recibe | Esta función activará o desactivará el interruptor cuando se produzca un evento. |
Cargar estado cuando se recibe | Esta función cargará el estado del interruptor cuando se produzca un evento. |
Guardar el estado cuando se recibe | Esta función guardará el estado del interruptor cuando se produzca un evento. |
Comprobar el estado cuando se recibe | Esta función comprobará el estado del interruptor cuando se produzca un evento. |
Eliminar persistencia del jugador cuando se recibe | Esta función elimina los datos de persistencia de los jugadores instigadores cuando se produzca un evento. |
Eliminar todos los datos de persistencia de los jugadores actuales cuando se recibe | Esta función eliminará todos los datos de persistencia de todos los jugadores actuales cuando se produzca un evento. |
Guardar estado para todos cuando se recibe | Esta función guardará el estado del interruptor de todos los jugadores cuando se produzca un evento. |
Cargar estado para todos cuando se recibe | Esta función cargará el estado del interruptor de todos los jugadores cuando se produzca un evento. |
Eventos
La vinculación directa de eventos usa eventos como transmisores. Un evento le indica a otro dispositivo que realice una función.
- Para cualquier opción de evento, haz clic en la opción y luego en Seleccionar dispositivo para acceder y seleccionar uno desde el menú desplegable del dispositivo.
Opción | Descripción |
---|---|
Al activar enviar evento a | Cuando se active el interruptor, enviará un evento al dispositivo seleccionado para activar la función seleccionada. |
Al desactivar enviar evento a | Cuando se desactive el interruptor, enviará un evento al dispositivo seleccionado para activar la función seleccionada. |
Activar al comprobar resultado enviar evento a | Si el interruptor está activado al comprobar el estado, enviará un evento al dispositivo seleccionado para activar la función seleccionada. |
Desactivar al comprobar resultado enviar evento a | Si el interruptor está desactivado al comprobar el estado, enviará un evento al dispositivo seleccionado para activar la función seleccionada. |
Al guardar el estado enviar evento a | Cuando se guarde el estado del interruptor, enviará un evento al dispositivo seleccionado para activar la función seleccionada. |
Al cambiar el estado enviar evento a | Cuando cambie el estado del interruptor, enviará un evento al dispositivo seleccionado para activar la función seleccionada. |
Al cargar estado enviar evento a | Cuando se cargue el estado del interruptor, enviará un evento al dispositivo seleccionado para activar la función seleccionada. |
Al eliminar enviar evento a | Cuando se eliminen los datos de persistencia del interruptor, enviará un evento al dispositivo seleccionado para activar la función seleccionada. |
Usar el interruptor en Verse
Puedes usar el código que está a continuación para controlar un dispositivo de interruptor en Verse. Este código muestra cómo usar eventos y funciones en la API del dispositivo de interruptor. Puedes modificarlo para que se adapte a las necesidades de tu experiencia.
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }
# Un dispositivo del modo Creativo creado con Verse que puede colocarse en un nivel
switch_device_verse_example := class(creative_device):
# Referencia al dispositivo de interruptor en el nivel.
# En el panel Detalles de este dispositivo de Verse,
# establece esta propiedad en el dispositivo de interruptor.
@editable
MySwitchDevice:switch_device = switch_device{}
# Mensajes localizables que puedes usar para establecer el texto visible para los jugadores
TurnOnInteractionText<localizes>:message = "Texto de activación de interruptor personalizado"
# Se ejecuta cuando el dispositivo se inicia en una partida en curso
OnBegin<override>()<suspends>:void=
# Ejemplo de suscripción a un evento en el dispositivo del modo Creativo.
# Emite una señal cuando cambia el estado del interruptor.
MySwitchDevice.StateChangesEvent.Subscribe(OnStateChanged)
# Establece el *texto de activación* que se mostrará al usuario cuando el interruptor esté desactivado y le permite interactuar para activarlo. Tiene un límite de 150 caracteres.
MySwitchDevice.SetTurnOnInteractionText(TurnOnInteractionText)
# Esta función se ejecuta cuando el jugador activa o desactiva el interruptor en el juego porque es un controlador de eventos de StateChangesEvent.
OnStateChanged():void=
Print("El estado del dispositivo de interruptor cambió.")
# Consulta si este dispositivo tiene un solo estado de activación y desactivación global o si tiene un estado de activación y desactivación personalizado para cada agente individual.
if (MySwitchDevice.IsStatePerAgent[]):
Print("El estado del dispositivo de interruptor está establecido por agente.")
# Este ejemplo se itera con todos los jugadores de la experiencia para mostrar cómo realizar operaciones por jugador en el dispositivo.
for (Player : GetPlayspace().GetPlayers()):
# Regresa el estado actual de este interruptor: true (activado) o false (desactivado). Usa esta sobrecarga de "GetCurrentState" cuando la opción *Almacenar estado por jugador* del dispositivo está establecida en *Sí*.
if (MySwitchDevice.GetCurrentState[Player]):
Print("El estado actual es activado.")
else:
Print("El estado actual es desactivado.")
else:
Print("El estado del dispositivo de interruptor no está establecido por agente.")
# Regresa el estado actual de este interruptor: true (activado) o false (desactivado). Usa esta sobrecarga de "GetCurrentState" cuando la opción *Almacenar estado por jugador* del dispositivo está establecida en *No*.
if (MySwitchDevice.GetCurrentState[]):
Print("El estado actual es activado.")
else:
Print("El estado actual es desactivado.")
Sigue los pasos que están a continuación para usar este código en una experiencia de UEFN.
- Arrastra un dispositivo de interruptor a tu isla.
- Crea un dispositivo nuevo de Verse llamado switch_device_verse_example. Echa un vistazo a Cómo crear tu propio dispositivo con Verse para ver los pasos.
- En Visual Studio Code, abre switch_device_verse_example.verse y pega el código anterior.
- Compila el código y arrastra el dispositivo creado con Verse a tu isla. Echa un vistazo a Cómo añadir el dispositivo de Verse a tu nivel para ver los pasos.
- Añade una referencia para el dispositivo de interruptor de tu isla al dispositivo de Verse. Echa un vistazo a Cómo añadir una referencia de Verse a un dispositivo del modo Creativo de tu nivel para ver los pasos.
- Guarda tu proyecto y haz clic en Comenzar sesión para realizar la prueba de juego.
API del dispositivo de interruptor de Verse
Echa un vistazo a la referencia de la API "switch_device" para obtener más información sobre cómo usar el dispositivo de interruptor en Verse.