實例傳輸

經驗內的 實例傳輸 允許 Roblox 引擎動態載入和卸下世界各地的 3D 內容和相關實例。這可以以多種方式提升整體玩家體驗，例如：

• 加入時間更快 — 玩家可以在世界的一個部分開始玩遊戲，而更多的世界在背景中載入。
• 記憶體效率 — 體驗可以在記憶體更少的裝置上播放，因為內容會動態地進入和退出。更沉浸和詳細的世界可以在更廣泛的裝置上播放。
• 改善效能 — 服務器可以花較少時間和帶寬同步世界與其中的玩家之間的變更，因此履約能提升。客戶花較少時間更新不與玩家目前相關的實例。
• 細節程度 — 遠端模型和地形在不傳送到客戶端時仍然可見，保持體驗最佳化，而不是完全犧牲背景視覺。

啟用傳輸串流

實例傳輸通過 Studio 的 StreamingEnabled 屬性的 工作區 對象啟用。此屬性無法在腳指令碼中設置。新建在 Studio 創建的地點預設啟用傳輸。

啟用後，建議您遵守以下做法：

• 因為客戶通常不會擁有整個 Workspace 本地可用，請使用適當的工具/API 確保在 LocalScript 嘗試存取它們之前，實例存在。例如，使用 每個模型的串流控件 , 偵測實例串流 , 或使用 WaitForChild() 在可能不存在的對象上。
• 盡量將 3D 內容放置在 Workspace 之外。像 ReplicatedStorage 或 ReplicatedFirst 這樣的容器內容不適合傳輸，可能會對加入時間和記憶使用產生負面影響。
• 如果你移動玩家的角色，設置其 CFrame ,從服務器側 Script 進行操作，並使用 傳輸請求 來更快地載入角色新位置周圍的數據。
• 手動設置玩家的 ReplicationFocus 只在獨特情況下，例如在不使用 Player.Character 的體驗中。在這些情況下，請確保焦點靠近玩家控制的對物件(s)，以確保內容仍然在玩家的互動點周圍傳送。

技術行為

在流中

預設情況下，當玩家加入啟用實例傳輸的體驗時，在 Workspace 中的實例會複製到客戶端， 除了 以追蹤中內容：

• Parts or MeshParts
• 原子、持久或PersistentPerPlayer模型
• 上述實例的後裔
• 非重複實例

然後，在遊玩期間，伺服器可能會將必要的實例傳送給客戶端，因為它們是需要的。

模型行為

模型設為非預設行為，例如 原子 傳輸在特定規則中，如 《模型傳輸控制》所述。但是，預設（非原子）模型會根據是否將 ModelStreamingBehavior 設置為 預設 （ 傳承 ）或 改進 來不同地傳送。

當 模型傳輸行為 設為 預設 / 舊版 時，容器和其非空間子孫，例如 會在玩家加入時複製到客戶端。然後，當符合資格時，模型的BasePart後裔進入。

輸出流

在遊玩期間，客戶端可能會流出（從玩家的 Workspace 區域中移除）和包含在其中的 BaseParts 區域，根據 StreamOutBehavior 設置的行為。過程從離玩家角色最遠的區域開始(或ReplicationFocus)，隨需要靠近移動。在 StreamingMinRadius 範圍內的區域永遠不會流出。

當一個實例傳出時，它會被指派給 nil 以便任何現有的 Luau 狀態重新連接，如果實例重新傳入。因結果，移除信號，例如 ChildRemoved 或 DescendantRemoving 在其 父親 或 祖先 上發射，但實例本身不會以與 Instance:Destroy() 相同的方式被摧毀。

為了進一步預測流出，請考慮這些情況：

模型行為

如果您將 模型傳輸行為 設置為 改進 ，引擎可能在適當時寫出 預設 ( 非原子 ) 模型，可能會釋放客戶端的記憶，並減少需要更新的實例。

在 改進 模型傳輸行為下，從 預設 ( 非原子 ) 模型中傳輸出是基於模型是否為 空間 (包含 子孫) 或 非空間 (沒有子孫)。

• 空間模型只有在最後一個剩餘的 BasePart 子模型流出時才完全流出，因為模型的一些空間部分可能靠近玩家/複製焦點，而另一些則很遠。
• 非空間模型只在祖先輸出時才會輸出，相當於舊版本輸出行為。

組裝和機制

當少於一部分的 裝配 可以在線傳輸時，所有裝配的零件也會在線傳輸。然而，裝配將不會在所有零件都可以傳輸出來之前傳輸出。在傳輸時，所有從 Constraints 和 Attachments 下降的 BaseParts 和原子或永久 Models 也會傳串流，幫助確保在客戶端上保持一致的物理更新。

請注意，裝配具有 錨定部件 的裝配與只有未錨定部件的裝配的對待方式略有不同：

時間延遲

當零件在伺服器上創建和複製到客戶端之間可能會發生稍微延遲的 ~10 毫秒。在以下各種情況下，您可能需要使用 WaitForChild() 和其他技巧，而不是假設事件和屬性更新總是在部分傳輸與同時發生。

傳輸屬性

下列屬性控制如何使實例傳輸適用於您的體驗。這些屬性都是 非可寫入 的，必須在 Studio 的 工作區 對象上設置。

模型傳輸行為

控制是否在玩家加入時複製預設（非原子）模型，或只在必要時傳送。如果此屬性設為 改進 ，在 中的模型只會在需要時傳送給客戶，可能會加快加入時間。請參閱技術行為以獲得更多細節。

傳輸完整性模式

如果玩家移動到世界上一個尚未傳送給他們的區域，您的體驗可能會以預期之外的方式運作。 傳輸完整性 功能提供一種方法來避免這些可能問題的情況。請參閱 Enum.StreamingIntegrityMode 文件以獲得更多詳情。

傳輸最小範圍

傳輸最小範圍 屬性指示玩家角色周圍的範圍 (或 )，在哪些情況下傳輸以最高優先級傳輸。當增加預設值時，應該小心，因為這會需要更多記憶和更多伺服器帶寬，而忽略其他組件。

傳輸目標範圍

傳輸目標範圍 屬性控制在傳輸到的案件中最遠離玩家角色 (或 ) 的最大距離。請注意，引擎可以保留先前載入的實例超出目標範圍，且記憶允許。

較小的 傳輸目標範圍 減少服務器負載，因為服務器不會在設置值之外的額外實例進行傳輸。然而，目標範圍也是玩家能夠看到您體驗全部細節的最大距離，因此您應該選擇一個值，可以創建這些之間的良好平衡。

傳輸出行為

StreamOutBehavior 屬性設置 傳輸出 行為，根據以下值之一：

每個模型的傳輸控制

全球上，模型傳輸行為屬性讓你控制模型在加入時如何傳輸。此外，為了避免以每個模型為基礎的串流問題和減少使用 WaitForChild() 的使用，您可以自定義如何 Models 和其子孫通過其 ModelStreamingMode 屬性進行串流。

預設/非原子

當 Model 設為 預設 或 非原子 時，傳輸行為會根據 ModelStreamingBehavior 是否設為 預設 ( 舊版本 ) 或 改進 來變化。

查看 技術行為 以獲得更多細節。

原子

如果 Model 被更改為 原子 ，當子孫 BasePart 有資格時，所有子孫都會一起傳送。因結果，需要存取模型中的實例的單獨 LocalScript 將需要使用 WaitForChild() 在模型本身上，但不是在子孫 MeshPart 或 Part 上，因為它們與模型一起傳送。

原子模型只會在所有下級零件都可以傳送時才會傳送出去，此時整個模型一起傳送出去。如果只有某些原子模型零件通常會被傳送出去，整個模型和其子模型都會留在客戶端上。

本地脚本
local Workspace = game:GetService("Workspace")

-- 原子模型在載入時不存在；使用 WaitForChild()
local model = Workspace:WaitForChild("Model")

-- 下一代零件會與模型一起流入並立即可用
local meshPart = model.MeshPart
local part = model.Part

持久

永久 模型不受通常的串流輸入或輸出。它們很快就會被發送為完整的原子單位，在玩家加入和 Workspace.PersistentLoaded 事件發生之前。永久模型和其子模型永遠不會被傳送出去，但要安全地在單獨的 LocalScript 中處理傳輸，您應該在父模型上使用 WaitForChild() 或等待 PersistentLoaded 事件發觸發。

本地脚本
local Workspace = game:GetService("Workspace")

-- 永久模型在載入時不存在；使用 WaitForChild()
local model = Workspace:WaitForChild("Model")

-- 下一代零件會與模型一起流入並立即可用
local meshPart = model.MeshPart
local part = model.Part

持久的每個玩家

模型設為 PersistentPerPlayer 與 永久 對使用 Model:AddPersistentPlayer() 添加的玩家行為相同。對於其他玩家，行為與 原子 相同。您可以透過 Model:RemovePersistentPlayer() 將模型從玩家持久性中恢復。

請求區域傳輸

如果您將玩家角色的 CFrame 設置為未載入的區域,則會發生直播暫停，如果啟用。如果您知道角色將移動到特定區域，您可以呼叫 Player:RequestStreamAroundAsync() 要求服務器將該位置附近的區域傳送給客戶端。

以下的腳本顯示如何發射客戶端到服務器的 遠端事件 來傳送玩家到一個空間，在移動角色到新的 CFrame 之前，在傳輸要求中產生。

腳本 - 傳送玩家角色
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local teleportEvent = ReplicatedStorage:WaitForChild("TeleportEvent")

local function teleportPlayer(player, teleportTarget)
	-- 請求在目標位置附近進行傳輸串流
	player:RequestStreamAroundAsync(teleportTarget)

	-- 傳送角色
	local character = player.Character
	if character and character.Parent then
		local currentPivot = character:GetPivot()
		character:PivotTo(currentPivot * CFrame.new(teleportTarget))
	end
end

-- 當客戶端發射遠端事件時，呼叫傳送功能
teleportEvent.OnServerEvent:Connect(teleportPlayer)

本地腳本 - 發射遠端事件
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local teleportEvent = ReplicatedStorage:WaitForChild("TeleportEvent")
local teleportTarget = Vector3.new(50, 2, 120)

-- 發射遠端事件
teleportEvent:FireServer(teleportTarget)

偵測實例傳輸

在某些情況下，需要偵測當對象傳入或傳出時，並對該事件做出反應。一個有用的流式偵測模式如下：

1. 使用實個體、實例的 標籤 部分或 Studio 的 標籤編輯器 ，為所有受影響的對象分配一個邏輯的 CollectionService。

2. 從單一 LocalScript 偵測標籤對象通過 GetInstanceAddedSignal() 和 GetInstanceRemovedSignal() 傳送進入或退出，然後依照情況處理對象。例如，下面的代碼將標籤 Light 對象添加到"閃爍"循環中，當它們傳入時移除它們，當它們傳出時移除它們。

   本地腳本 - 收集服務傳輸偵測
   local CollectionService = game:GetService("CollectionService")
   
   local tagName = "FlickerLightSource"
   local random = Random.new()
   local flickerSources = {}
   
   -- 偵測目前和新標記的零件在內或外流式傳輸
   for _, light in CollectionService:GetTagged(tagName) do
   	flickerSources[light] = true
   end
   
   CollectionService:GetInstanceAddedSignal(tagName):Connect(function(light)
   	flickerSources[light] = true
   end)
   
   CollectionService:GetInstanceRemovedSignal(tagName):Connect(function(light)
   	flickerSources[light] = nil
   end)
   
   -- 閃爍迴圈
   while true do
   	for light in flickerSources do
   		light.Brightness = 8 + random:NextNumber(-0.4, 0.4)
   	end
   
   	task.wait(0.05)
   end

自訂暫停螢幕

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)

模型細節程度

啟用傳輸時，當前傳輸區域外的 Models 將無法預設顯示。然而，您可以通過每個模型的 LevelOfDetail 屬性指示引擎渲染更低解析度的「捣乱者」網格給不存在於客戶端的模型。

>

>

當使用捣乱者網格時，請注意以下事項：

• 捣乱者網格設計為在 1024 單位遠離相機 或更遠處可見。如果您將 傳輸目標範圍 減少到像 256 這樣的更小值，擾亂者網格可能不適合替換的模型。
• 如果模型 和 其子模型都設為 傳輸網格 ，只有最高級祖先模型被渲染為捣乱者網格，包括祖先和子模型下的所有幾何圖形。為了提高履約，建議您使用 停用 來創建子模型。
• 不支持紋理；擾亂者網格被渲染為光滑網格。
• 雖然 Model 尚未完全傳輸，但捣乱者網格會被渲染，而不是模型的個別部分。一旦所有個別零件都傳送進來，它們將渲染並忽略捣乱者網格。
• 捣乱者網格沒有物理意義，並且在 射線投射、碰撞偵測 和物理模擬方面作為不存在。
• 在 Studio 編輯模型，例如添加/刪除/重新定位子零件或重設顏色，會自動更新代表網格。