实例流

游戏中的 实例流 允许 Roblox 引擎动态加载和卸载 Workspace 中的 3D 内容及相关实例。这可以通过以下几种方式改善整体玩家体验：

• 更快的加入时间

  — 玩家可以在世界的一个部分开始游戏，同时背景中的其他区域正在加载。
• 内存效率

  — 游戏可以在内存较少的设备上进行，因为内容是动态流入和流出的。更身临其境和详细的世界可以在更广泛的设备上进行游玩。
• 性能提升

  — 更好的帧率和性能，因为服务器可以在世界和其中的玩家之间花费更少的时间和带宽来同步更改。客户端花费更少的时间来更新对于玩家当前不相关的实例。
• 细节层次

  — 在配置时，即使远处模型、平台化身和地形未被传送到客户端，它们仍然可见，从而保持游戏优化，同时不会完全牺牲背景视觉效果。

实例流通过 Workspace.StreamingEnabled 属性进行控制，对于在 Studio 中创建的新场景默认启用。此属性不能在脚本中设置。

技术行为

范围

流逻辑和功能仅适用于 Workspace 的后代实例，而存储在 ReplicatedStorage 和 ReplicatedFirst 等其他容器中的实例不适合流。例如，将一个 原子 模型放在 ReplicatedStorage 下并不能保证原子的复制。

流入

当玩家加入具有实例流的游戏时：

1. Workspace 中的实例会复制到客户端 不包括 以下内容：

   

   BaseParts （Parts 和 MeshParts）

   

   Models 设置为 原子、持久 或 每玩家持久；请参见 每模型流控制

   

   Models 在 Workspace.ModelStreamingBehavior 设置为 Improved 时设置为 非原子 （默认）。

   

   上述实例的后代

2. 在游戏过程中，服务器可以基于游戏的 流属性、玩家位置、客户端设备性能和其他条件，流入上述延迟类别的实例到客户端。

流出

在游戏过程中，客户端可以基于 Workspace.StreamOutBehavior 设置的行为，从玩家的 Workspace 中移除 BaseParts 区域。该过程始于距离 复制焦点 最远的区域，根据需要向内移动。位于 Workspace.StreamingMinRadius 范围内的区域将始终保留。

请注意，包含无 BasePart 子代的 Model（例如，仅用作非 BasePart 实例（如脚本）的 "容器"）的实例在 除非 它成为 BasePart 的后代，否则是 豁免 出流的。

组件

实际的 组件 作为完整的单元流 进，包括它们相关的 Constraints 和 Attachments，有助于确保客户端上的物理更新一致。唯一的例外是，当组件被 锚定 时，此时仅在流区域内的 BaseParts 及其相关的 Constraints 和 Attachments 会被流入。

在所有的 BaseParts 都符合出流条件之前，组件不会流 出。

流属性

以下属性控制实例流如何应用于您的游戏。所有这些属性都是 不可脚本化 的，必须在 Studio 中设置在 Workspace 对象上。

复制焦点

默认情况下，流动发生在本地玩家角色的 PrimaryPart 周围，尽管您可以通过 Player.ReplicationFocus 指定不同的复制焦点。

您还可以通过 Player:AddReplicationFocus() 和 Player:RemoveReplicationFocus() 添加和移除其他复制焦点，以动态启用游戏多个区域的流。

客户端物理模拟（包括在实现 服务器权限 时的预测和重新模拟）发生在流区域内，即使是对于本地创建的实例和 Persistent 实例。如果您希望某些实例即使距离角色较远也能继续模拟，请在那些实例附近创建额外的复制焦点。

模型流控制

为了避免在每个模型基础上流动的问题，并最小化使用 WaitForChild()，您可以通过 Models 及其子代通过其 ModelStreamingMode 属性自定义流动。

非原子

默认情况下，模型是 Nonatomic 并根据 Workspace.ModelStreamingBehavior 设置为 Legacy （默认）或 Improved 来进行流入/流出。

遗留

当 Workspace.ModelStreamingBehavior 设置为 Legacy （默认）时，Model 容器及其 非 - BasePart 子代（如 Scripts）将在玩家加入时复制到客户端。然后，当模型符合条件时，其 BasePart 子代会流入。

改善

当 Workspace.ModelStreamingBehavior 设置为 Improved 时，模型流行为根据模型是否包含 BasePart 子代或不包含 BasePart 子代而有所不同：

• 包含 BasePart 子代的模型仅在 一个 BasePart 子代符合流入条件时流 入。此时，该模型及其符合条件的 BasePart 一起流入，并与模型的 非 - BasePart 子代一起。

  当最后一个剩余的 BasePart 从模型中流出时，整个模型也将一起流出。

  

• 没有 BasePart 子代的模型（例如，仅用作非 - BasePart 实例的“容器”，如脚本）将在玩家加入后不久复制到客户端。这种类型的模型在 除非 它成为一个 BasePart 的后代，否则是 豁免 出流的。

  

原子

如果将 Model 设置为 Atomic，当一个子代 BasePart 有资格进行流入时，所有初始子代会一起流入。因此，需要访问模型 内部 实例的客户端脚本将需要对模型本身使用 WaitForChild()，而不需要对子代 MeshPart 或 Part 使用，因为它们是与模型一起发送的。

仅当其所有的子代部分都符合出流条件时，原子模型才会流出，此时整个模型会一起流出。

持久

Persistent 模型不受正常流入或流出的限制。它们通常在玩家加入后并在 Workspace.PersistentLoaded 事件触发之前作为一个完整的原子单位发送。持久模型及其子代永远不会流出，但要在客户端脚本中安全处理流入，您应该等待 PersistentLoaded 事件触发。

每玩家持久

设置为 PersistentPerPlayer 的模型对使用 Model:AddPersistentPlayer() 添加的玩家表现得与 Persistent 相同。对于其他玩家，其行为与 Atomic 相同。您可以通过 Model:RemovePersistentPlayer() 将模型从玩家持久性中还原。

暂停屏幕自定义

假设 Workspace.StreamingIntegrityMode 设置为推荐的 PauseOutsideLoadedArea，如果玩家进入一个尚未流向他们的世界区域，游戏将暂停。在这些情况下，Player.GameplayPaused 属性表示玩家的当前暂停状态，可以与 GetPropertyChangedSignal() 连接一起使用，以显示或隐藏自定义 GUI。

LocalScript
local Players = game:GetService("Players")
local GuiService = game:GetService("GuiService")

local player = Players.LocalPlayer

-- 禁用默认暂停模态
GuiService:SetGameplayPausedNotificationEnabled(false)

local function onPauseStateChanged()
	if player.GameplayPaused then
		-- 显示自定义 GUI
	else
		-- 隐藏自定义 GUI
	end
end

player:GetPropertyChangedSignal("GameplayPaused"):Connect(onPauseStateChanged)

运行时调试

引擎包括多个可以通过键盘快捷键在客户端启用的屏幕调试面板。要访问流调试信息：

1. 通过 ShiftCtrlF3 （Windows）或 Shift⌘F3 （Mac）打开 网络摘要 调试叠加。

2. 一旦打开调试叠加，反复按 Shift1 以循环切换可用面板。第四个面板是 流 调试视图，显示有用的运行时信息：

   • 活动流设置
   • 当前加载（流入）区域
   • 流动行为和状态

启用后，颜色高亮的区域会出现在 3D 视口中：