I contenitori UI in esperienza ospitano GuiObjects che si desidera visualizzare all'interno del mondo 3D della propria esperienza.
- Un SurfaceGui consente il rendering di oggetti UI sulla superficie di un parte nel mondo 3D, consentendo anche l'interazione di base da parte dell'utente.
- Un BillboardGui è un contenitore per oggetti UI che appaiono nello spazio 3D ma che sono sempre rivolti verso la telecamera.
UI Superificiale
Simile a Decals e Textures, oggetti UI come TextLabels e ImageLabels parentati a un SurfaceGui si orientano nella stessa direzione della superficie sulla quale si trovano, modificabile attraverso la proprietà SurfaceGui.Face.
Per applicare un SurfaceGui a un BasePart in esperienza, basta parentarlo a quella parte e impostare la proprietà SurfaceGui.Face. Gli oggetti UI figli appariranno quindi su quella faccia della parte genitore.
In alternativa, puoi posizionare il SurfaceGui all'interno di un contenitore come StarterGui e poi impostare la sua proprietà Adornee su qualsiasi BasePart, così come il target Face. Impostare Adornee sovrascrive l'associazione di parentela diretta, consentendo una maggiore flessibilità nel posizionamento poiché può essere impostato da uno script durante il runtime.
Elementi UI interattivi come ImageButtons e TextButtons all'interno di un SurfaceGui riceveranno input dall'utente solo se parentati al PlayerGui del giocatore, tipicamente posizionando il SurfaceGui all'interno del StarterGui come già notato. Inoltre, la proprietà CanQuery della parte deve essere true affinché l'elemento UI interattivo possa ricevere input.
Per aiutare a scegliere la faccia corretta per un SurfaceGui, fai clic destro sulla parte target e seleziona Mostra Indicatore di Orientamento. Questo visualizza un cerchio blu con una F e una linea attaccata alla faccia Front dell'oggetto, e una freccia verde che punta nella direzione della faccia Top dell'oggetto.
Dimensione e posizione
Il "canvas" di un SurfaceGui occupa l'intera faccia Face della parte genitore o Adornee. Come migliore pratica, è consigliato utilizzare valori scale per la dimensione e posizione degli oggetti UI figli come ImageLabels. Puoi anche applicare un UIAspectRatioConstraint ai figli del SurfaceGui per mantenere il loro rapporto d'aspetto desiderato indipendentemente dalla dimensione della faccia.
Modalità di occlusione
La proprietà AlwaysOnTop determina se il SurfaceGui verrà visualizzato sopra i contenuti 3D o se sarà occluso da essi. Quando impostato su false (predefinito), il SurfaceGui si rende come altro contenuto 3D e viene occluso da altri oggetti 3D. Quando impostato su true, si rende sempre sopra il contenuto 3D e non è influenzato dalla luminosità/luce nell'ambiente 3D.
Luminosità e influenza della luce
Brightness e LightInfluence lavorano insieme per determinare come la luce ambientale influisce sul contenuto UI del SurfaceGui.
Brightness determina il fattore per il quale la luce emessa è scalata in un intervallo da 0 a 1000, permettendoti di abbinare il SurfaceGui al suo ambiente. Ad esempio, un billboard video può essere illuminato all'interno di una stanza buia aumentando il Brightness a 10.
LightInfluence controlla quanto il SurfaceGui è influenzato dall'illuminazione nel luogo, in un intervallo da 0 a 1. Impostarlo su 1 significa che l'illuminazione circostante ha il completo controllo sull'aspetto, mentre impostarlo su 0 significa che l'illuminazione non ha effetti.
Nota che Brightness non è disponibile in Studio e non ha effetti quando LightInfluence è 1 o AlwaysOnTop è true.
Visibilità della distanza
MaxDistance controlla quanto lontano dalla telecamera il SurfaceGui sarà visualizzato prima di smettere di renderizzarlo. Un valore di 0 significa che non c'è limite e verrà reso infinitamente lontano. Il valore predefinito di 1000 funziona bene per la maggior parte dei casi.
Per SurfaceGuis che appaiono all'aperto, è consigliato che MaxDistance sia sufficientemente alto per garantire che l'interfaccia utente del contenitore sia sufficientemente piccola sullo schermo quando appare o scompare, minimizzando il pop‑in/out improvviso.
Ordine di visualizzazione
Se esistono più contenitori SurfaceGui sulla stessa faccia, puoi sovrapporli attraverso la loro proprietà ZOffset (cambiare questo non "solleva" o "affonda" visivamente il contenitore dalla superficie).
UI Billboard
Il contenitore BillboardGui visualizza oggetti UI nello spazio 3D, ma, a differenza del SurfaceGui, i figli di un BillboardGui sono sempre rivolti verso la telecamera. Questo contenitore è utile per mostrare informazioni frontali sopra oggetti in esperienza come misuratori di salute o nomi sopra i personaggi dei giocatori, indicatori per guidare i giocatori a un oggetto nel mondo 3D, e altro ancora.
Per collegare un BillboardGui a un BasePart o Attachment in esperienza, basta parentarlo a quella parte o attacco e, se desiderato, regolare la sua dimensione/posizione.
In alternativa, puoi posizionare il BillboardGui all'interno di un contenitore come StarterGui e poi impostare la sua proprietà Adornee su qualsiasi BasePart o Attachment. Questo metodo offre maggiore flessibilità nel posizionamento poiché Adornee può essere impostato da uno script durante il runtime, ad esempio per posizionare un BillboardGui sopra la testa dei personaggi dei giocatori durante il runtime.
Elementi UI interattivi come ImageButtons e TextButtons all'interno di un BillboardGui riceveranno input dall'utente solo se parentati al PlayerGui del giocatore, tipicamente posizionando il BillboardGui all'interno del StarterGui come già notato.
Dimensione e posizione
Per le dimensioni del billboard, i componenti scale della proprietà Size impostano la dimensione in stud del billboard nello spazio 3D. Ad esempio, un'impostazione di {10, 0},{2, 0} (UDim2.fromScale(10, 2)) crea un billboard con un rapporto d'aspetto di 10:2 che si ingrandisce o rimpicciolisce a seconda della sua distanza dalla telecamera.
Per il posizionamento, la proprietà StudsOffset sposta il canvas del billboard sull'asse X (sinistra/destra), asse Y (su/giù) e asse Z (avanti/indietro) rispetto alla telecamera.
Quando crei un BillboardGui dimensionato che contiene un TextLabel, è utile abilitare la proprietà TextScaled dell'etichetta affinché il suo testo si scaldi insieme al canvas del billboard mentre cambia la distanza dalla telecamera.
Modalità di occlusione
La proprietà AlwaysOnTop determina se il BillboardGui verrà visualizzato sopra i contenuti 3D o se sarà occluso da essi. Quando impostato su false (predefinito), il BillboardGui si rende come altro contenuto 3D e viene occluso da altri oggetti 3D. Quando impostato su true, si rende sempre sopra il contenuto 3D e non è influenzato dalla luminosità/luce nell'ambiente 3D.
Luminosità e influenza della luce
Brightness e LightInfluence lavorano insieme per determinare come la luce ambientale influisce sul contenuto UI del BillboardGui.
Brightness determina il fattore per il quale la luce emessa è scalata in un intervallo da 0 a 1000, permettendoti di abbinare il BillboardGui al suo ambiente. Ad esempio, un billboard video può essere illuminato all'interno di una stanza buia aumentando il Brightness a 10.
LightInfluence controlla quanto il BillboardGui è influenzato dall'illuminazione nel luogo, in un intervallo da 0 a 1. Impostarlo su 1 significa che l'illuminazione circostante ha il completo controllo sull'aspetto, mentre impostarlo su 0 significa che l'illuminazione non ha effetti.
Nota che Brightness non è disponibile in Studio e non ha effetti quando LightInfluence è 1 o AlwaysOnTop è true.
Visibilità della distanza
MaxDistance controlla quanto lontano dalla telecamera il BillboardGui sarà visualizzato prima di smettere di renderizzarlo. Un valore di 0 o inf (predefinito) significa che non c'è limite e verrà reso infinitamente lontano.