經驗內 UI 容器

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

經驗內 UI 容器包含您希望在體驗的 3D 世界中顯示的 GuiObjects

  • SurfaceGui 允許將 UI 物件渲染到 3D 世界中部件的表面,同時也允許基本的用戶互動。
  • BillboardGui 是 UI 物件在 3D 空間中顯示的容器,但始終面對相機。

表面 UI

類似於 DecalsTextures,附加到 SurfaceGui 的 UI 物件,如 TextLabelsImageLabels,面向的方向與它們所處的表面相同,通過 SurfaceGui.Face 屬性進行編輯。

SurfaceGui 在 3D 部件上的圖示,並帶有 ImageLabel 子物件以描繪屏幕控制台。

要將 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 內容上方渲染,且不受 亮度/光影 影響。

亮度和光影影響

BrightnessLightInfluence 共同作用來決定環境光下,UI 內容如何影響 SurfaceGui

Brightness 決定了發射光的比例,範圍從 01000,讓您使 SurfaceGui 與其環境相匹配。例如,可以通過將 Brightness 增加到 10,在黑暗的房間中使視頻廣告變得更亮。

LightInfluence 控制 SurfaceGui 受到場地照明影響的程度,範圍從 01。將此設為 1 意味著周圍的光線完全控制外觀,而設為 0 則意味著光線沒有影響。

距離可見性

MaxDistance 控制 SurfaceGui 離相機的最遠顯示距離,超過該距離將停止渲染。值為 0 意味著沒有限制,將無限遠渲染。預設值為 1000,在大多數情況下非常合適。

對於出現在戶外的 SurfaceGuis,建議 MaxDistance 設定得足夠高,以確保容器的 UI 在顯示或隱藏時在螢幕上足夠小,以最小化突出的彈入/彈出效果。

顯示順序

如果在同一面上存在多個 SurfaceGui 容器,您可以通過其 ZOffset 屬性來進行 Z 索引的層疊(更改這個屬性不會在視覺上“抬高”或“下沉”容器)。

廣告 UI

BillboardGui 容器在 3D 空間中顯示 UI 物件,但與 SurfaceGui 不同,BillboardGui 的子物件始終面對相機。這個容器對於在經驗對象上方顯示面向前方的信息非常有用,例如健康計量器或玩家角色的名字,引導玩家到 3D 世界中的對象等。

BillboardGui,帶有 TextLabel 描述其上方的屏幕控制台。

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

另外,您可以將 BillboardGui 放置於 StarterGui 等容器中,然後將其 Adornee 屬性設定為任何 BasePartAttachment。這種方法提供了更多放置的彈性,因為 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 內容上方渲染,且不受 亮度/光影 影響。

亮度和光影影響

BrightnessLightInfluence 共同作用來決定環境光影響 BillboardGui 的 UI 內容。

Brightness 決定了發射光的比例,範圍從 01000,讓您使 BillboardGui 與其環境相匹配。例如,可以通過將 Brightness 增加到 10,在黑暗的房間中使視頻廣告變得更亮。

LightInfluence 控制 BillboardGui 受到場地照明影響的程度,範圍從 01。將此設為 1 意味著周圍的光線完全控制外觀,而設為 0 則意味著光線沒有影響。

距離可見性

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

©2026 Roblox Corporation、Roblox、Roblox 標誌及 Powering Imagination 是我們在美國及其他國家地區的部分註冊與未註冊商標。