UI-Container innerhalb der Erfahrung halten GuiObjects, die Sie in der 3D-Welt Ihrer Erfahrung anzeigen möchten.
- Ein SurfaceGui ermöglicht das Rendern von UI-Objekten auf der Oberfläche eines Teils in der 3D-Welt und erlaubt gleichzeitig grundlegende Benutzerinteraktionen.
- Ein BillboardGui ist ein Container für UI-Objekte, die im 3D-Raum erscheinen, aber immer der Kamera zugewandt sind.
Surface UI
Ähnlich wie Decals und Textures zeigen UI-Objekte wie TextLabels und ImageLabels, die einem SurfaceGui untergeordnet sind, in die gleiche Richtung wie die Oberfläche, auf der sie sich befinden, und sind über die SurfaceGui.Face-Eigenschaft editierbar.
Um ein SurfaceGui auf einem in-experience BasePart anzuwenden, fügen Sie es einfach diesem Teil hinzu und setzen Sie die SurfaceGui.Face-Eigenschaft. Kind-UI-Objekte erscheinen dann auf dieser Fläche des übergeordneten Teils.
Alternativ können Sie das SurfaceGui in einen Container wie StarterGui legen und dann die Adornee-Eigenschaft auf einen beliebigen BasePart und die Ziel-Face setzen. Die Einstellung von Adornee überschreibt die direkte Elternzugehörigkeit, wodurch mehr Flexibilität bei der Platzierung ermöglicht wird, da sie zur Laufzeit von einem Skript gesetzt werden kann.
Interaktive UI-Elemente wie ImageButtons und TextButtons innerhalb eines SurfaceGui empfangen Benutzereingaben nur, wenn sie dem PlayerGui des Spielers untergeordnet sind, typischerweise durch Platzierung des SurfaceGui innerhalb von StarterGui, wie oben erwähnt. Darüber hinaus muss die CanQuery-Eigenschaft des Teils true sein, damit das interaktive UI-Element Eingaben empfangen kann.
Um bei der Auswahl der richtigen Fläche für ein SurfaceGui zu helfen, klicken Sie mit der rechten Maustaste auf das Zielteil und wählen Sie Orientierungsindikator anzeigen. Dies zeigt einen blauen Kreis mit einem F und einer Linie, die an die Front-Fläche des Objekts angeschlossen ist, sowie einen grünen Pfeil, der in die Richtung der Top-Fläche des Objekts zeigt.
Größe und Position
Die "Leinwand" eines SurfaceGui nimmt die gesamte Face des übergeordneten oder Adornee-Teils ein. Als beste Praxis wird empfohlen, Skalierungswerte für die Größe und Position der Kind-UI-Objekte wie ImageLabels zu verwenden. Sie können auch eine UIAspectRatioConstraint auf die Kinder des SurfaceGui anwenden, um ihr gewünschtes Seitenverhältnis unabhängig von der Größe der Fläche beizubehalten.
Okklusionsmodus
Die AlwaysOnTop-Eigenschaft bestimmt, ob das SurfaceGui über 3D-Inhalten gerendert wird oder von ihnen verdeckt wird. Wenn auf false (Standard) gesetzt, rendert das SurfaceGui wie andere 3D-Inhalte und wird von anderen 3D-Objekten verdeckt. Wenn es auf true gesetzt ist, wird es immer über 3D-Inhalten gerendert und ist nicht von Helligkeit/Licht in der 3D-Umgebung beeinflusst.
Helligkeit und Lichteinfluss
Brightness und LightInfluence arbeiten zusammen, um zu bestimmen, wie sich das Umgebungslicht auf den UI-Inhalt des SurfaceGui auswirkt.
Brightness bestimmt den Faktor, mit dem das emittierte Licht in einem Bereich von 0 bis 1000 skaliert wird, sodass Sie das SurfaceGui an seine Umgebung anpassen können. Zum Beispiel kann ein Video-Billboard in einem dunklen Raum durch Erhöhen von Brightness auf 10 aufgehellt werden.
LightInfluence steuert, wie stark das SurfaceGui von der Beleuchtung im Platz beeinflusst wird, in einem Bereich von 0 bis 1. Die Einstellung auf 1 bedeutet, dass die umgebende Beleuchtung die vollständige Kontrolle über das Erscheinungsbild hat, während die Einstellung auf 0 bedeutet, dass die Beleuchtung keine Wirkung hat.
Beachten Sie, dass Brightness im Studio nicht zugänglich ist und keine Auswirkungen hat, wenn entweder LightInfluence 1 oder AlwaysOnTop true ist.
Sichtbarkeit auf Entfernung
MaxDistance steuert, wie weit vom Kamerapunkt das SurfaceGui angezeigt wird, bevor es das Rendern stoppt. Ein Wert von 0 bedeutet, dass es kein Limit gibt, und es wird unendlich weit entfernt gerendert. Der Standardwert von 1000 funktioniert in den meisten Fällen gut.
Für SurfaceGuis, die im Freien erscheinen, wird empfohlen, dass MaxDistance hoch genug ist, um sicherzustellen, dass die Benutzeroberfläche des Containers auf dem Bildschirm ausreichend klein ist, wenn sie erscheint oder verschwindet, um den plötzlichen Pop-in/out-Effekt zu minimieren.
Anzeige Reihenfolge
Wenn mehrere SurfaceGui-Container auf derselben Fläche vorhanden sind, können Sie sie durch den Z-Index über die ZOffset-Eigenschaft übereinanderlegen (das Ändern davon "hebt" oder "senkt" den Container visuell nicht von der Oberfläche).
Billboard UI
Der BillboardGui-Container zeigt UI-Objekte im 3D-Raum an, aber im Gegensatz zu SurfaceGui sind die Kinder eines BillboardGui immer der Kamera zugewandt. Dieser Container ist nützlich, um frontale Informationen über Objekten innerhalb der Erfahrung anzuzeigen, wie z. B. Gesundheitsanzeigen oder Namen über Spielercharakteren, Marker, um Spieler zu einem Objekt in der 3D-Welt zu führen, und mehr.
Um ein BillboardGui mit einem in-experience BasePart oder Attachment zu verknüpfen, fügen Sie es einfach diesem Teil oder dieser Anlage hinzu und passen Sie, wenn gewünscht, dessen Größe/Position an.
Alternativ können Sie das BillboardGui in einen Container wie StarterGui legen und dann die Adornee-Eigenschaft auf einen beliebigen BasePart oder Attachment setzen. Diese Methode bietet mehr Flexibilität bei der Platzierung, da Adornee zur Laufzeit von einem Skript gesetzt werden kann, zum Beispiel um ein BillboardGui über dem Kopf der Spielercharaktere während der Laufzeit zu platzieren.
Interaktive UI-Elemente wie ImageButtons und TextButtons innerhalb eines BillboardGui empfangen Benutzereingaben nur, wenn sie dem PlayerGui des Spielers untergeordnet sind, typischerweise durch Platzierung des BillboardGui innerhalb von StarterGui, wie oben erwähnt.
Größe und Position
Für die Größe von Billboards setzen die Skalierungs-Komponenten der Size-Eigenschaft die Größe des Billboards in 3D-Raum. Zum Beispiel bildet eine Einstellung von {10, 0},{2, 0} (UDim2.fromScale(10, 2)) ein Billboard mit einem 10:2-Seitenverhältnis, das größer oder kleiner wird, je nach Entfernung zur Kamera.
Für die Positionierung verschiebt die StudsOffset-Eigenschaft die Billboard-Leinwand auf der X-Achse (links/rechts), Y-Achse (oben/unten) und Z-Achse (vorne/hinten) relativ zur Kamera.
Beim Erstellen eines größen-skalierbaren BillboardGui, das ein TextLabel enthält, ist es nützlich, die TextScaled-Eigenschaft des Labels zu aktivieren, damit der Text zusammen mit der Billboard-Leinwand skaliert, während sich die Kameradistanz ändert.
Okklusionsmodus
Die AlwaysOnTop-Eigenschaft bestimmt, ob das BillboardGui über 3D-Inhalten gerendert wird oder von ihnen verdeckt wird. Wenn auf false (Standard) gesetzt, rendert das BillboardGui wie andere 3D-Inhalte und wird von anderen 3D-Objekten verdeckt. Wenn es auf true gesetzt ist, wird es immer über 3D-Inhalten gerendert und ist nicht von Helligkeit/Licht in der 3D-Umgebung beeinflusst.
Helligkeit und Lichteinfluss
Brightness und LightInfluence arbeiten zusammen, um zu bestimmen, wie sich das Umgebungslicht auf den UI-Inhalt des BillboardGui auswirkt.
Brightness bestimmt den Faktor, mit dem das emittierte Licht in einem Bereich von 0 bis 1000 skaliert wird, sodass Sie das BillboardGui an seine Umgebung anpassen können. Zum Beispiel kann ein Video-Billboard in einem dunklen Raum durch Erhöhen von Brightness auf 10 aufgehellt werden.
LightInfluence steuert, wie stark das BillboardGui von der Beleuchtung im Platz beeinflusst wird, in einem Bereich von 0 bis 1. Die Einstellung auf 1 bedeutet, dass die umgebende Beleuchtung die vollständige Kontrolle über das Erscheinungsbild hat, während die Einstellung auf 0 bedeutet, dass die Beleuchtung keine Wirkung hat.
Beachten Sie, dass Brightness im Studio nicht zugänglich ist und keine Auswirkungen hat, wenn entweder LightInfluence 1 oder AlwaysOnTop true ist.
Sichtbarkeit auf Entfernung
MaxDistance steuert, wie weit von der Kamera das BillboardGui angezeigt wird, bevor es das Rendern stoppt. Ein Wert von 0 oder inf (Standard) bedeutet, dass es kein Limit gibt und es wird unendlich weit entfernt gerendert.