經驗內 UI 容器包含您希望在體驗的 3D 世界中顯示的 GuiObjects。
- SurfaceGui 允許將 UI 物件渲染到 3D 世界中部件的表面,同時也允許基本的用戶互動。
- BillboardGui 是 UI 物件在 3D 空間中顯示的容器,但始終面對相機。
表面 UI
類似於 Decals 和 Textures,附加到 SurfaceGui 的 UI 物件,如 TextLabels 和 ImageLabels,面向的方向與它們所處的表面相同,通過 SurfaceGui.Face 屬性進行編輯。

要將 SurfaceGui 應用到經驗內的 BasePart,只需將其附加到該部件上並設定 SurfaceGui.Face 屬性。子 UI 物件然後出現在父部件的該面上。


另外,您可以將 SurfaceGui 放置於 StarterGui 等容器中,然後將其 Adornee 屬性設定為任何 BasePart,以及目標 Face。設定 Adornee 會覆蓋直接的父級關聯,允許在放置上更具彈性,因為它可以在運行時通過腳本設置。


大小和位置
SurfaceGui 的 "畫布" 占據父物件或 Adornee 部件的整個 Face。作為最佳實踐,建議您對子 UI 物件(例如 ImageLabels)的 大小 和 位置 使用 比例 值。您還可以在 SurfaceGui 的子物件上應用 UIAspectRatioConstraint 以保持其所需的長寬比,而不考慮面的大小。
遮擋模式
AlwaysOnTop 屬性決定 SurfaceGui 是否在 3D 內容上方渲染或被其遮擋。當設定為 false(預設值)時,SurfaceGui 像其他 3D 內容一樣渲染,並被其他 3D 物件遮擋。當設定為 true 時,它始終在 3D 內容上方渲染,且不受 亮度/光影 影響。
亮度和光影影響
Brightness 和 LightInfluence 共同作用來決定環境光下,UI 內容如何影響 SurfaceGui。
Brightness 決定了發射光的比例,範圍從 0 到 1000,讓您使 SurfaceGui 與其環境相匹配。例如,可以通過將 Brightness 增加到 10,在黑暗的房間中使視頻廣告變得更亮。
LightInfluence 控制 SurfaceGui 受到場地照明影響的程度,範圍從 0 到 1。將此設為 1 意味著周圍的光線完全控制外觀,而設為 0 則意味著光線沒有影響。

距離可見性
MaxDistance 控制 SurfaceGui 離相機的最遠顯示距離,超過該距離將停止渲染。值為 0 意味著沒有限制,將無限遠渲染。預設值為 1000,在大多數情況下非常合適。
對於出現在戶外的 SurfaceGuis,建議 MaxDistance 設定得足夠高,以確保容器的 UI 在顯示或隱藏時在螢幕上足夠小,以最小化突出的彈入/彈出效果。
顯示順序
如果在同一面上存在多個 SurfaceGui 容器,您可以通過其 ZOffset 屬性來進行 Z 索引的層疊(更改這個屬性不會在視覺上“抬高”或“下沉”容器)。
廣告 UI
BillboardGui 容器在 3D 空間中顯示 UI 物件,但與 SurfaceGui 不同,BillboardGui 的子物件始終面對相機。這個容器對於在經驗對象上方顯示面向前方的信息非常有用,例如健康計量器或玩家角色的名字,引導玩家到 3D 世界中的對象等。

要將 BillboardGui 連接到經驗內的 BasePart 或 Attachment,只需將其附加到該部件或附件上,並根據需要調整其 大小/位置。


另外,您可以將 BillboardGui 放置於 StarterGui 等容器中,然後將其 Adornee 屬性設定為任何 BasePart 或 Attachment。這種方法提供了更多放置的彈性,因為 Adornee 可以在運行時通過腳本設置,例如在運行時將 BillboardGui 放置於玩家角色的頭部上方。
大小和位置
對於廣告尺寸,Size 屬性的 比例 組件設定廣告在 3D 空間中的大小。例如,設定為 {10, 0},{2, 0} (UDim2.fromScale(10, 2)) 將形成一個長寬比為 10:2 的廣告,其大小會根據距離相機的遠近而變化。
對於定位,StudsOffset 屬性在相機的 X 軸(左/右)、Y 軸(上下)和 Z 軸(前後)相對於相機偏移油廣告畫布。
遮擋模式
AlwaysOnTop 屬性決定 BillboardGui 是否在 3D 內容上方渲染或被其遮擋。當設定為 false(預設值)時,BillboardGui 像其他 3D 內容一樣渲染,並被其他 3D 物件遮擋。當設定為 true 時,它始終在 3D 內容上方渲染,且不受 亮度/光影 影響。
亮度和光影影響
Brightness 和 LightInfluence 共同作用來決定環境光影響 BillboardGui 的 UI 內容。
Brightness 決定了發射光的比例,範圍從 0 到 1000,讓您使 BillboardGui 與其環境相匹配。例如,可以通過將 Brightness 增加到 10,在黑暗的房間中使視頻廣告變得更亮。
LightInfluence 控制 BillboardGui 受到場地照明影響的程度,範圍從 0 到 1。將此設為 1 意味著周圍的光線完全控制外觀,而設為 0 則意味著光線沒有影響。

距離可見性
MaxDistance 控制 BillboardGui 離相機的最遠顯示距離,超過該距離將停止渲染。值為 0 或 inf(預設值)意味著沒有限制,將無限遠渲染。