Ci sono due modi per usare un dispositivo Selettore.
-
Come interruttore fisico con cui i giocatori possono interagire, in combinazione con altri dispositivi, per aprire e chiudere porte o accendere e spegnere luci.
-
Come metodo per filtrare le interazioni con altri dispositivi. Per esempio, se lo stato del selettore è impostato su Sì, trasmetterà su un canale, e se è impostato su No, trasmetterà su un altro canale.
Per trovare il dispositivo Selettore, consulta Trovare e posizionare i dispositivi.
Filtro contestuale
Alcuni dispositivi sono interessati da una funzionalità denominata filtro contestuale. Questa funzionalità nasconde o mostra le opzioni a seconda dei valori selezionati per alcune opzioni correlate. Prevediamo che ridurrà l'ingombro nel riquadro Personalizza e che renderà più facile gestire e consultare le opzioni.
Tuttavia, potrebbe non essere facile riconoscere quali opzioni o valori attivano il filtro contestuale. Per aiutarti a identificarli, tutti i valori che attivano il filtro contestuale sono in corsivo. Verranno elencate tutte le opzioni, comprese quelle interessate dal filtro contestuale; se vengono nascoste o visualizzate in base al valore di un'opzione specifica, ci sarà una nota a riguardo nel campo Descrizione di quell'opzione.
Opzioni del dispositivo
Questo dispositivo ha delle funzionalità di base, come impostare la visibilità del selettore, e scegliere il testo che il giocatore visualizza quando interagisce con esso. Inoltre, ci sono opzioni avanzate che puoi usare se il selettore è in grado di salvare il suo stato.
Puoi configurare questo dispositivo con le opzioni seguenti.
I valori predefiniti sono in grassetto. I valori che attivano il filtro contestuale sono in corsivo.
Opzione | Valore | Descrizione |
---|---|---|
Abilitato all'avvio del gioco | Sì, No | Determina se il dispositivo è abilitato all'inizio della partita. I dispositivi disabilitati ignorano tutti gli eventi tranne Abilita. |
Stato iniziale | No, Sì | Questo è lo stato predefinito iniziale del selettore, quando non c'è nessuno stato derivante da un giocatore che può sovrascriverlo. |
Visibile in gioco | Sì, No | Determina se il dispositivo è visibile ai giocatori durante la partita. |
Attiva il testo | Inserisci testo nel campo | Imposta il testo di interazione da visualizzare quando il selettore viene abilitato. Il campo di testo ha un limite di 150 caratteri. |
Disattiva testo | Inserisci testo nel campo | Imposta il testo di interazione da visualizzare quando il selettore viene disabilitato. Il campo di testo ha un limite di 150 caratteri. |
Modello del dispositivo | Predefinito, Leva antica, Abilita/disabilita selettore, Predefinito (Spento), Leva antica (Spenta), Pulsante rosso, Selettore, Leva preistorica, Casella di spunta | È il modello visivo usato per il selettore. |
Audio | Abilitato, Disabilitato | Determina se il selettore produce o meno un suono quando cambia di stato (da No a Sì, da Sì a No). |
Consenti interazione | Sì, No | Determina se il giocatore possa interagire con il dispositivo. |
Tempo di interazione | Immediato, scegli o inserisci una quantità di secondi | Determina quanto il giocatore dovrà interagire per attivare il dispositivo. |
Limita numero di cambi possibili | No, Sì | Determina la presenza di un limite sulla quantità di volte in cui il dispositivo può cambiare. Se impostata su Sì, verrà visualizzata un’opzione aggiuntiva sotto a questa. |
Numero di cambi possibili | 1, scegli o inserisci un numero | Determina il numero di volte in cui il dispositivo può abilitarsi prima che si disabiliti. |
Recupero infinito | No, Sì | Determina il tempo di recupero fra le interazioni di questo dispositivo. Se impostata su Sì, l’opzione tempo di recupero non verrà visualizzata sotto questa. |
Tempo di recupero | Immediato, scegli un numero di secondi | Questa opzione viene visualizzata solo quando l'opzione Recupero infinito è impostata su No. Determina il tempo di recupero tra le interazioni. |
Classe consentita | Nessuna classe, Qualsiasi, scegli o inserisci una classe | Determina la classe che può attivare il dispositivo. |
Squadre consentite | Qualsiasi, scegli o inserisci una squadra | Determina la squadra che può attivare il dispositivo. |
Raggio d'interazione | 0, scegli o inserisci una distanza del raggio | Permette ai giocatori di interagire guardando in qualsiasi punto entro un raggio della dimensione specificata, anziché guardando direttamente il pulsante. Da utilizzare insieme all'impostazione di Visibilità per far sembrare che i giocatori stiano interagendo con altri oggetti. |
Tempo di ripristino stato | Nessun ripristino, scegli o inserisci una quantità di tempo | Determina l'intervallo di tempo prima che il dispositivo torni allo stato predefinito. |
Esclusione reciproca | Nessuna esclusività, scegli un numero | Impostando questo selettore su Sì, si disattiveranno tutti gli altri selettori che hanno lo stesso numero di indice a Esclusione reciproca. |
Conserva stato per giocatore | Sì, No | Se questa opzione è impostata su Sì, ogni giocatore avrà il proprio stato del selettore. Se questa opzione è impostata su No, lo stato del selettore è lo stesso per tutti i giocatori. Se questa opzione è impostata su No e l'opzione Usa persistenza è impostata su Usa, il selettore utilizzerà l'opzione Risolvi conflitti quando lo stato tenta di caricarsi. |
Usa persistenza | Non usare, Usa | Determina se il dispositivo salva o carica dati dal backend. Se scegli Usa, nella scheda Tutte le opzioni verranno visualizzate opzioni aggiuntive. |
Salvataggio automatico | Sì, No | Questa opzione viene visualizzata solo se l'opzione Usa persistenza è impostata su Usa. Determina se lo stato del selettore viene salvato automaticamente quando cambia. |
Caricamento automatico | Sì, No | Questa opzione viene visualizzata solo se l'opzione Usa persistenza è impostata su Usa. Determina se lo stato del selettore viene caricato automaticamente all'inizio del gioco o se deve essere caricato utilizzando l'associazione eventi. |
Risolvi i conflitti | Primo giocatore, Maggioranza, Priorità attivata, Priorità disattivata | Questa opzione viene visualizzata solo se l'opzione Usa persistenza è impostata su Usa. Determina cosa succede quando lo stato viene caricato e Conserva stato per giocatore è impostato su No. I valori per questa opzione:
|
Controlla stato all'avvio del gioco | Abilitato, Disabilitato | Determina se il selettore verifica lo stato all'avvio del gioco, attivando l'evento Se attivo al controllo o Se disattivo al controllo. |
Controlla stato Selettore se disattivato | Sì, No | Determina se il dispositivo controllerà il suo stato anche quando è disabilitato. |
Sistema di associazione diretta eventi
L'Associazione diretta eventi consente ai dispositivi di comunicare direttamente, offrendo un flusso di lavoro più intuitivo e libero.
Di seguito, troverai funzioni ed eventi per questo dispositivo.
Funzioni
Una funzione resta in ascolto di un evento su un dispositivo, poi esegue un’azione.
- Per qualsiasi funzione, fai clic sull'opzione, poi su Seleziona dispositivo per accedere e selezionarla dal menu a discesa Dispositivo.
- Una volta selezionato un dispositivo, fai clic su Seleziona evento per legare il dispositivo a un evento che attiverà la funzione per il dispositivo.
- Se la funzione viene attivata da più di un dispositivo o evento, premi il pulsante Aggiungi per aggiungere una riga e ripetere questi passaggi.
Opzione | Descrizione |
---|---|
Abilita alla ricezione da | Questa funzione abilita il dispositivo quando si verifica un evento. |
Disabilita alla ricezione da | Questa funzione disabilita il dispositivo quando si verifica un evento. |
Attiva alla ricezione da | Questa funzione attiva il selettore quando si verifica un evento. |
Disattiva alla ricezione da | Questa funzione disabilita il selettore quando si verifica un evento. |
Cambia stato alla ricezione da | Questa funzione fa scattare il selettore quando si verifica un evento. |
Carica stato alla ricezione da | Questa funzione carica lo stato del selettore quando si verifica un evento. |
Salva stato alla ricezione da | Questa funzione salva lo stato del selettore quando si verifica un evento. |
Controlla stato alla ricezione da | Questa funzione verifica lo stato del selettore quando si verifica un evento. |
Cancella persistenza giocatore alla ricezione da | Questa funzione cancella i dati di persistenza del giocatore attivatore quando si verifica un evento. |
Elimina tutti i dati di persistenza dei giocatori attuali alla ricezione da | Questa funzione cancella tutti i dati di persistenza di tutti i giocatori attuali quando si verifica un evento. |
Salva stato per tutti alla ricezione da | Questa funzione salva lo stato del selettore per tutti i giocatori quando si verifica un evento. |
Carica lo stato per tutti alla ricezione da | Questa funzione carica lo stato del selettore per tutti i giocatori quando si verifica un evento. |
Eventi
L'Associazione diretta eventi usa gli eventi come trasmettitori. Un evento ordina a un altro dispositivo di eseguire una funzione.
- Per qualsiasi opzione degli eventi, fai clic sull'opzione, poi su Seleziona dispositivo per accedere e selezionarle dal menu a discesa Dispositivo.
- Una volta selezionato un dispositivo, fai clic su Seleziona funzione per legare l'evento a una funzione per il dispositivo.
- Se più di una funzione è influenzata da un evento, fai clic su Aggiungi per aggiungere una riga e ripeti questi passaggi.
Opzione | Descrizione |
---|---|
Se abilitato invia evento a | Quando il selettore viene attivato, invia un evento al dispositivo selezionato, attivando la funzione selezionata. |
Se disabilitato invia evento a | Quando il selettore viene disattivato, invia un evento al dispositivo selezionato, attivando la funzione selezionata. |
Se abilitato al controllo invia evento a | Se il selettore è attivato quando lo stato viene controllato, invia un evento al dispositivo selezionato, attivando la funzione selezionata. |
Se disabilitato al controllo invia evento a | Se il selettore è disattivato quando lo stato viene controllato, invia un evento al dispositivo selezionato, attivando la funzione selezionata. |
Al salvataggio di stato invia evento a | Quando lo stato del selettore viene salvato, invia un evento al dispositivo selezionato, attivando la funzione selezionata. |
Al cambio di stato invia evento a | Quando lo stato del selettore cambia, invia un evento al dispositivo selezionato, attivando la funzione selezionata. |
Al caricamento dello stato invia evento a | Quando lo stato del selettore viene caricato, invia un evento al dispositivo selezionato, attivando la funzione selezionata. |
All'eliminazione invia evento a | Quando i dati della persistenza del selettore vengono cancellati, invia un evento al dispositivo selezionato, attivando la funzione selezionata. |
Utilizzo del dispositivo Selettore in Verse
Puoi usare il codice di seguito per controllare un dispositivo in Verse. Questo codice mostra come usare gli eventi e le funzioni nelle API del dispositivo selettore. Modificalo per adattarlo alle esigenze della tua esperienza.
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }
# Un dispositivo creativo creato da Verse che può essere posizionato in un livello
switch_device_verse_example := class(creative_device):
# Riferimento al dispositivo Selettore nel livello.
# Nel riquadro Dettagli di questo dispositivo Verse,
# imposta questa proprietà sul tuo dispositivo Selettore.
@editable
MySwitchDevice:switch_device = switch_device{}
# Messaggi localizzabili che puoi utilizzare per impostare il testo rivolto al giocatore
TurnOnInteractionText<localizes>:message = "Il Selettore personalizzato ha attivato il testo!"
# Viene eseguito quando il dispositivo viene avviato in una partita in corso
OnBegin<override>()<suspends>:void=
# Esempio per l'iscrizione a un evento sul dispositivo Creativo.
# Segnalato quando lo stato del selettore cambia.
MySwitchDevice.StateChangesEvent.Subscribe(OnStateChanged)
# Imposta il *Testo di attivazione* in modo che sia visualizzato a un utente quando il selettore è disattivato, e propone di interagire per attivarlo. Il limite è di 150 caratteri.
MySwitchDevice.SetTurnOnInteractionText(TurnOnInteractionText)
# Questa funzione viene eseguita quando il giocatore attiva o disattiva il selettore all’interno del gioco perché si tratta di un gestore di eventi per StateChangesEvent.
OnStateChanged():void=
Print("Lo stato del dispositivo Selettore è cambiato.")
# Interroga il dispositivo per sapere se abbia un singolo stato Sì/No globale o uno stato Sì/No personalizzato per ogni agente individuale.
if (MySwitchDevice.IsStatePerAgent[]):
Print("Lo stato del dispositivo Selettore è impostato su “per agente”.")
# Questo esempio viene ripetuto a tutti i giocatori presenti nell’esperienza per mostrare come compiere operazioni per giocatore sul dispositivo.
for (Player : GetPlayspace().GetPlayers()):
# Restituisce lo stato attuale di questo selettore: true (sì) o false (no). Usa questo sovraccarico di ‘GetCurrentState’ quando questo dispositivo ha *Conserva stato per giocatore* impostato su *Sì*.
if (MySwitchDevice.GetCurrentState[Player]):
Print("Lo stato Current è attivo.")
else:
Print("Lo stato Current è disattivato.")
else:
Print("Lo stato del dispositivo Selettore non è impostato su “per agente”.")
# Restituisce lo stato attuale di questo selettore: true (sì) o false (no). Usa questo sovraccarico di ‘GetCurrentState’ quando questo dispositivo ha *Conserva stato per giocatore* impostato su *No*.
if (MySwitchDevice.GetCurrentState[]):
Print("Lo stato Current è attivo.")
else:
Print("Lo stato Current è disattivato.")
Per utilizzare questo codice nella tua esperienza UEFN, segui i seguenti passaggi.
- Trascina un dispositivo Selettore sulla tua isola.
- Crea un nuovo dispositivo Verse chiamato switch_device_verse_example. Vedi Crea il tuo dispositivo usando Verse per le istruzioni.
- In Visual Studio Code, apri switch_device_verse_example.verse e incolla il codice qui sopra.
- Compila il codice e trascina il tuo dispositivo creato con Verse nella tua isola. Consulta Aggiungere il tuo dispositivo Verse al tuo livello per le istruzioni passo passo.
- Aggiungi un riferimento al tuo dispositivo Verse per il dispositivo Selettore sulla tua isola. Consulta Aggiungere un riferimento a Verse a un dispositivo Creativo nel tuo livello per le istruzioni passo passo.
- Salva il tuo progetto e fai clic su Avvia sessione per testare.
API Verse per il dispositivo Selettore
Consulta il riferimento all’API ‘switch_device’ per avere altre informazioni sull’utilizzo del dispositivo Selettore in Verse.