实例流

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

• 更快的加入时间

  — 玩家可以在世界的一部分开始游戏，同时更多的世界在后台加载。
• 内存效率

  — 游戏可以在内存较少的设备上运行，因为内容是动态流入和流出的。更具沉浸感和细节的世界可以在更广泛的设备上运行。
• 性能提升

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

  — 当配置时，远处的模型、平台化身和地形即使在未流入客户端时仍然可见，保持游戏优化而不完全牺牲背景视觉效果。SLIM 为模型和化身提供最高保真度的细节层次。

实例流通过 Workspace.StreamingEnabled 属性进行控制，默认情况下在 Studio 中创建的新地方启用。此属性不能在脚本中设置。

技术行为

范围

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

流入

当玩家加入启用实例流的游戏时：

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

   

   BaseParts (Parts 和 MeshParts)

   

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

   

   当 Workspace.ModelStreamingBehavior 设置为 Improved 时，设置为 非原子 (默认) 的 Models

   

   上述实例的后代

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 实例也是如此。如果您有希望即使在远离角色时也保持模拟的实例，请在这些实例附近创建额外的复制焦点。

预测流

预测流是一个可选功能，使用引擎信号来预测玩家移动并主动流入玩家可能很快需要的区域。当通过将 PredictiveStreamingMode 设置为 Enabled 启用时，它可以减少流暂停和视觉突现，而无需任何代码更改。

预测流是 累加的。它在现有的 复制焦点 之外创建小的临时流焦点，流入少量额外内容，并且不会更改您的游戏逻辑或流合同。如果不需要预测，预测区域会在短时间后过期，引擎会卸载内容。引擎还会考虑客户端内存和性能，在资源受限的设备上跳过预测。

当 PredictiveStreamingMode 为 Enabled 时，以下预测功能处于活动状态：

模型流控制

为了避免每模型流动的问题并最小化使用 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。

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 视口中：