体验内 UI 容器持有 GuiObjects,您希望在体验的 3D 世界中显示这些对象。
- SurfaceGui 允许在 3D 世界中将 UI 对象渲染到零件表面,同时还允许进行基本的用户交互。
- BillboardGui 是一个容器,用于在 3D 空间中显示 UI 对象,但始终面向摄像头。
表面 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 内容上渲染,并且不受 亮度/光 在 3D 环境中的影响。
亮度和光的影响
Brightness 和 LightInfluence 协同工作,以确定环境光如何影响 SurfaceGui 的 UI 内容。
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 内容上渲染,并且不受 亮度/光 在 3D 环境中的影响。
亮度和光的影响
Brightness 和 LightInfluence 协同工作,以确定环境光如何影响 BillboardGui 的 UI 内容。
Brightness 确定发射光的缩放因子,范围为 0 到 1000,让您使 BillboardGui 与其环境匹配。例如,视频广告牌可以通过将 Brightness 增加到 10 来在黑暗房间里增亮。
LightInfluence 控制 BillboardGui 受放置中光线的影响程度,范围为 0 到 1。将此设置为 1 意味着周围的光线完全控制外观,而将其设置为 0 意味着光线没有影响。

距离可见性
MaxDistance 控制 BillboardGui 在停止渲染之前距摄像机的最大显示距离。值为 0 或 inf(默认为)意味着没有限制,可以无限远地渲染。