I container di interfaccia utente in-experience contengono GuiObjects che vuoi visualizzare all'interno del Mondo3D della tua esperienza.
- Un SurfaceGui consente il rendering di oggetti UI sulla superficie di una parte nel mondo 3D mentre consente anche che si Si verificanol'interazione utente di base.
- Un BillboardGui è un container per gli oggetti UI da apparire nello spazio 3D ma sempre di fronte alla Telecamera.
Interfaccia utente superficie
Simile a e , gli oggetti dell'interfaccia utente come e sono parenti con una superficie, modificabili attraverso la Proprietà.
Per applicare un SurfaceGui a un'esperienza in corso BasePart, semplicemente genialo a quella parte e imposta la ProprietàSurfaceGui.Face.Gli oggetti UI figli quindi appaiono su quel lato della parte genitrice.
In alternativa, puoi posizionare il SurfaceGui all'interno di un container come StarterGui e quindi impostare la sua proprietà Adornee a qualsiasi BasePart , oltre al bersaglio Face.Impostazione Adornee sovrascrivendo l'associazione diretta del genitore, consentendo una maggiore flessibilità nel posizionamento poiché può essere impostata da uno script durante l'esecuzione.
Gli elementi dell'interfaccia utente interattiva come ImageButtons e TextButtons all'interno di un SurfaceGui riceveranno solo l'input dell'utente se sono parentedati al Giocatoredi PlayerGui , tipicamente posizionando il SurfaceGui all'interno di StarterGui come notato sopra.
Per aiutare a scegliere il volto corretto per un SurfaceGui , fai clic con il pulsante destro del mouse sulla parte target e seleziona Mostra indicatore di orientamento .Questo visualizza un cerchio blu con un F e una linea attaccata alla faccia dell'oggetto Front e una freccia verde che punta nella direzione della faccia dell'oggetto Top.
Dimensione e posizione
Il " canvas " di un SurfaceGui occupa l'intero Face della parte genitrice o Adornee della parte.Come migliore pratica, si consiglia di utilizzare scala valori per la dimensione e posizione di oggetti UI figli come ImageLabels.Puoi anche applicare un UIAspectRatioConstraint ai figli del SurfaceGui per mantenere la loro proporzione desiderata indipendentemente dalla dimensione del viso.
Modalità occlusione
La proprietà AlwaysOnTop determina se il SurfaceGui renderizzerà sopra il contenuto 3D o sarà oscurato da esso.Quando è impostato su false (predefinito), il SurfaceGui rende come altri contenuti 3D e viene occluso da altri oggetti 3D.Quando è impostato su true , rende sempre sopra la 3D contenuto e non è influenzato da luminosità/luce nell'Ambiente3D.
Luminosità e influenza della luce
Brightness e LightInfluence lavorano in sinergia per determinare come la luce ambientale influisca sul contenuto dell'interfaccia utente del SurfaceGui .
Brightness determina il fattore con cui la luce emessa viene scala in un intervallo di 0 a 1000 , permettendoti di abbinare il SurfaceGui al suo Ambiente.Ad esempio, un video billboard può essere illuminato all'interno di una stanza buia aumentando Brightness a 10.
LightInfluence controlla quanto il SurfaceGui è influenzato dalla luce nel Posto, in un intervallo da 0 a 1 .Impostare questo a 1 significa che la luce circostante ha il completo controllo sull'aspetto, mentre impostarlo a 0 significa che la luce non ha alcun effetto.
Nota che Brightness non è accessibile in Studio e non ha alcun effetto quando LightInfluence è 1 o AlwaysOnTop è true .
Visibilità a distanza
MaxDistance controlla quanto lontano dalla fotocamera verrà visualizzato SurfaceGui prima che smetta di rendere.Un valore di 0 significa che non c'è alcun limite e si renderà infinitamente lontano.Il valore predefinito di 1000 funziona bene per la maggior parte dei casi.
Per SurfaceGuis quelli che appaiono all'aperto, è consigliato che MaxDistance sia abbastanza alto per garantire che l'interfaccia utente del contenitore sia sufficientemente piccola sullo schermo quando appare o scompare, minimizzando l'effetto pop-in/out improvviso.
Ordine di visualizzazione
Se esistono più container SurfaceGui sul lato stesso, puoi stratificarli per Z‑index attraverso la loro proprietà ZOffset (il cambiamento di questa non "levanta" o "affonda" visivamente il container dalla superficie).
Interfaccia utente Billboard
Il contenitore BillboardGui mostra oggetti dell'interfaccia utente nello spazio 3D, ma, a differenza di SurfaceGui , i figli di un BillboardGui sono sempre rivolti alla Telecamera.Questo container è utile per visualizzare le informazioni a faccia in avanti sopra gli oggetti in-experience come i misuratori di salute o i nomi sopra i personaggi del giocatore, i segnalatori che guidano i giocatori a un oggetto nel Mondo3D e altro ancora.
Per collegare un BillboardGui a un'esperienza BasePart o Attachment , semplicemente genialo a quella parte o allegato e, se desiderato, regolalo la sua dimensione/posizione .
In alternativa, puoi posizionare il BillboardGui dentro un container come StarterGui e quindi impostare la sua proprietà Adornee a qualsiasi BasePart o Attachment.Questo metodo offre maggiore flessibilità nel posizionamento poiché Adornee può essere impostato da uno script durante l'esecuzione, ad esempio per posizionare un BillboardGui sopra la testa dei personaggi del giocatore durante l'esecuzione.
Gli elementi dell'interfaccia utente interattiva come ImageButtons e TextButtons all'interno di un BillboardGui riceveranno solo l'input dell'utente se sono parentedati al Giocatoredi PlayerGui , tipicamente posizionando il BillboardGui all'interno di StarterGui come notato sopra.
Dimensione e posizione
Per la dimensione della vetrina, i componenti scala del set di proprietà Size impostano la dimensione dello studio della vetrina nello Spazio3D.Ad esempio, una impostazione di {10, 0},{2, 0}( UDim2.fromScale(10, 2) ) forma un cartello con una proporzione 10:2 che scala più grande o più piccola a seconda della sua distanza dalla Telecamera.
Per la posizionamento, la proprietà StudsOffset sposta la canvas del billboard sull'asse X (sinistra/destra), sull'asse Y (su/giù) e sull'asse Z (avanti/indietro) rispetto alla Telecamera.
Quando si crea una dimensione scala BillboardGui che contiene un TextLabel , è utile abilitare la proprietà del EtichettaTextScaled in modo che il suo testo scala insieme alla canvas del billboard come la distanza della fotocamera cambia.
Modalità occlusione
La proprietà AlwaysOnTop determina se il BillboardGui renderizzerà sopra il contenuto 3D o sarà oscurato da esso.Quando è impostato su false (predefinito), il BillboardGui rende come altri contenuti 3D e viene occluso da altri oggetti 3D.Quando è impostato su true , rende sempre sopra la 3D contenuto e non è influenzato da luminosità/luce nell'Ambiente3D.
Luminosità e influenza della luce
Brightness e LightInfluence lavorano in sinergia per determinare come la luce ambientale influisca sul contenuto dell'interfaccia utente del BillboardGui .
Brightness determina il fattore con cui la luce emessa viene scala in un intervallo di 0 a 1000 , permettendoti di abbinare il BillboardGui al suo Ambiente.Ad esempio, un video billboard può essere illuminato all'interno di una stanza buia aumentando Brightness a 10.
LightInfluence controlla quanto il BillboardGui è influenzato dalla luce nel Posto, in un intervallo da 0 a 1 .Impostare questo a 1 significa che la luce circostante ha il completo controllo sull'aspetto, mentre impostarlo a 0 significa che la luce non ha alcun effetto.
Nota che Brightness non è accessibile in Studio e non ha alcun effetto quando LightInfluence è 1 o AlwaysOnTop è true .
Visibilità a distanza
MaxDistance controlla quanto lontano dalla fotocamera verrà visualizzato BillboardGui prima che smetta di rendere.Un valore di 0 o inf (predefinito) significa che non c'è alcun limite e si renderà infinitamente lontano.