Instanz-Streaming

In-Experience- Instanz-Streaming ermöglicht es der Roblox-Engine, 3D-Inhalte und verwandte Instanzen in Regionen der Welt dynamisch zu laden und zu entladen. Dies kann die Gesamterlebnis des Spielers in mehreren Weisen verbessern, z. B.:

• Schnellere Beitrittszeiten — Spieler können in einem Teil der Welt beginnen zu spielen, während mehr der Welt im Hintergrund geladen wird.
• Erinnerungs-Effizienz — Erinnerungen können auf Geräten mit weniger Speicher gespielt werden, da der Inhalt dynamisch gestreamt wird und mehr immersive und detaillierte Welten auf einer breiteren Palette von Geräten gespielt werden können.
• Verbesserte Leistung — Bessere Bildraten und Erfüllung, da der Server weniger Zeit und Bandbreite für die Synchronisierung von Änderungen zwischen der Welt und den Spielern in der Welt verbringen kann. Clients verbringen weniger Zeit, um Instanzen zu aktualisieren, die derzeit nicht relevant für den Spieler:insind.
• Detaillierungsgrad — Ferne Modelle und Terrain bleiben auch wenn sie nicht auf Clients gestreamt werden, noch sichtbar, wodurch die Erfahrung optimiert bleibt, ohne die Hintergrundvisualien völlig aufzuopfern.

Streaming aktivieren

Die Instanz-Streaming wird durch die StreamingEnabled Eigenschaft des Workspace-Objekts in Studio aktiviert. Diese Eigenschaft kann nicht in einem Skript, das. PL: die Skriptsfestgelegt werden. Streaming wird standardmäßig für neue Plätze in Studio aktiviert.

Sobald aktiviert, wird empfohlen, dass Sie sich an die folgenden Praktiken halten:

• Da Clients normalerweise nicht die gesamte Workspace lokal haben, verwenden Sie das entsprechende Werkzeug/API, um sicherzustellen, dass Instanzen vor dem Versuch, auf sie zuzugreifen, in einem LocalScript vorhanden sind. Zum Beispiel verwenden Sie per-Modell-Streaming-Steuerelemente,
• Minimieren Sie die Platzierung von 3D-Inhalten außerhalb von Workspace . Inhalte in Containern wie ReplicatedStorage oder ReplicatedFirst sind nicht für den Streaming-Dienst geeignet und können sich negativ auf die Verbindungszeit und die Erinnerungsnutzung auswirken.
• Wenn Sie den Charakter eines Spieler:inbewegen, indem Sie seine CFrame setzen, tun Sie dies von einem Server-seitigen Script und verwenden Sie Streaming-Anfragen, um Daten schneller um die neue Position des Spielers zu laden.
• Setzen Sie manuell den ReplicationFocus des Spieler:innur in einzigartigen Situationen, wie in Erlebnissen, die keinen Player.Character verwenden. In diesen Fällen stellen Sie sicher, dass der Fokus in der Nähe des Objekts ist, das der Spieler steuert, um sicherzustellen, dass der Inhalt immer um den Interaktionspunkt des Spieler:infließt.

Technisches Verhalten

Streaming in

Standardmäßig werden die Instanzen in der Workspace wenn ein Spieler einer Erfahrung mit dem Streaming-Instanz aktiviert ist, auf den Client repliziert, mit Ausnahme von dem gefolgte Profile:

• Parts oder MeshParts
• Atom , Persistent , oder PersistentPerPlayer Modelle
• Abstammende der oberen Instanzen
• Nicht-Replikations-Instanzen

Dann, während des Gameplay, kann der Server die erforderlichen Instanzen zum Client streamen, da sie benötigt werden.

Modell-Verhalten

Modelle auf nicht-Standard-Verhalten wie Atom- -Strahl unter speziellen Regeln gesetzt, wie in Per-Model-Streaming-Steuerelemente beschrieben. jedoch, Standard (nicht-atomare) -Modelle werden anders gesendet, basierend darauf, ob ModelStreamingBehaviour auf 1> Standard1> (4> Legacy4> ) oder 7> Improved

Wenn ModelStreamingBehavior auf Standard / Legacy eingestellt ist, repliziert sich der 1> Class.Model Container und seine nicht-raumzeitigen Nachkommen wie 4> Class.Script|Scripts4> auf dem Client, wenn der Spieler beitritt. Dann, wenn Sie elegible sind, streamen die Modell-7>

Out-Streaming

Während des Gameplaykann ein Client Regionen auslassen (entfernen Sie sie aus dem Charakter des Spieler:inWorkspace ) und die in ihnen enthaltenen BaseParts basierend auf dem Verhalten, das von StreamOutBehavior festgelegt. Der Prozess beginnt

Wenn eine Instanz ausgeht, wird sie mit nil in Verbindung gebracht, damit jeder bestehende Luau-Zustand wiederverbindet, wenn die Instanz zurückgeht. Ergebniswerden Entfernungszeichen wie Class.Instance.ChildRemoved|ChildRemoved</

Um die Stream-Ausgabe weiter vorherzusagen, untersuchen Sie diese Szenarien:

Modell-Verhalten

Wenn Sie ModelStreamingBehavior auf Verbessert setzen, kann der Engine Standard ( 1> Nichtatomische1> ) Modelle streamen, wenn sie berechtigt sind, stream auszugehen, und dies möglicherweise Freier Speicher auf dem Client und Reduzieren der Instanzen, die Eigenschaftsaktualisierungen benötigen.

Unter Verbessertem Modell- Streaming-Verhalten, Streaming aus Standard- ( nichtatomaren ) -Modellen basiert auf der Tatsache, dass das Modell 1>raumlich1> (enthält 4> Class.BasePart4> -Nachkommen) oder 7> nichtraumlos7> (enthält keine 0> Class

• Ein Raummodell wird nur vollständig ausgegeben, wenn seine letzten verbleibenden BasePart -Descendant-Strahlen ausgegeben werden, da einige der Raumteile des Modells in der Nähe des Spielers/der Replikation stehen und einige weit entfernt sind.
• Ein nicht-raumzeitliches Modell streamt nur aus, wenn ein Vorgänger streamt, was der ähnelt Verhalten wie Legacy-Streaming.

Assemblies und Mechanismen

Wenn mindestens ein Teil einer Assembly zum Streaming berechtigt ist, streamt alle Teile derAssembly auch. Allerdings streamt eineAssembly nicht, bis alle Teile der Asia-Server zum Streaming berechtigt sind. Während des Streamings fließen

Beachten Sie, dass Montagen mit verankerten Teilen etwas anders behandelt werden als Montagen mit nur nicht verankerten Teilen:

Zeitverzögerung

Es kann eine leichte Verzögerung von ~10 Millisekunden zwischen der Erstellung einer Teil auf dem Server und dem Zeitpunkt, an dem sie auf Clients repliziert wird, geben. In jedem der folgenden Szenarien müssen Sie WaitForChild() und andere Techniken verwenden, anstatt zu behaupten, dass Ereignis- und Eigenschaftsaktualisierungen immer in der selben Zeit wie die Teil- Streaming-Sitzung stattfinden.

Streaming-Eigenschaften

Die folgenden Eigenschaften steuern, wie die Instanz-Übertragung auf Ihr Erlebnis angewendet wird. Alle dieser Eigenschaften sind nicht-skriptbar und müssen auf dem Arbeitsbereich-Objekt in Studio festgelegt sein.

Modell-Streaming-Verhalten

Steuert, ob Standard ( Nichtatomar ) Modelle repliziert werden, wenn ein Spieler beitritt, oder nur gesendet werden, wenn nötig. Wenn diese Eigenschaft auf Verbessert gesetzt ist, werden nur Modelle in 1> Class.Arbeitsbereich1> gesendet, wenn nötig, und das möglicherweise die Beitrittszeiten beschleunigt. Siehe 4> Technisches Verhalten</

Streaming Integrity Mode

Ihr Erlebnis kann in unbeabsichtigten Weise verhalten, wenn ein Spieler in eine Region der Welt bewegt, die nicht an ihn gestreamt wurde. Die Streaming- Integrität-Funktion bietet einen Weg, um diese potenziell problematischen Situationen zu vermeiden. Bitte sehen Sie die Enum.StreamingIntegrityMode-Dokumentation für weitere Informationen.

Minradius-Strreaming

Die StreamingMinRadius -Eigenschaft zeigt den Radius um den Charakter des Spieler:in(oder Class.Player.ReplicationFocus|ReplicationFocus) in der die Streams in der höchsten Priorität in der Anwendung sind. Vorsicht beim Erhöhen des Standard ist, da dies mehr Speicher und mehr Server-Bandbreite im Sinne anderer Komponenten erfordern wird.

TargetRadius

Die StreamingTargetRadius -Eigenschaft kontrolliert die maximale Entfernung vom Charakter des Spieler:in(oder Class.Player.ReplicationFocus|ReplicationFocus) in denen sich die Streams in ähnlichen Fällen streamen. Beachten Sie, dass der Engine ursprünglich geladene Instanzen jenseits des Zielradius behalten kann, Memorie erlaubt.

Ein kleineres StreamingTargetRadius reduziert die Serverlast, da der Server nicht in zusätzlichen Instanzen über dem festgelegten Wert streamen wird. Die Zielreichweite ist jedoch auch die maximale Entfernung, die Spieler von deinem Erlebnis sehen können, so dass du einen Wert auswählen solltest, der ein schönes Gleichgewicht zwischen diesen schafft.

StreamOutVerhalten

Die StreamOutBehavior-Eigenschaft setzt das Streaming-aus-Verhalten-Verhalten entsprechend einem der folgenden Werte:

Per-Model- Streaming-Steuerelemente

Weltweit ermöglicht die ModelStreamingBehaviour-Eigenschaft, wie Modelle beim Beitreten gestreamt werden. Darüber hinaus, um Probleme mit dem Streaming auf einer pro-modell-Basis zu vermeiden und die Verwendung von WaitForChild() zu minimieren, können Sie die Eigenschaftenändern, wie

Standard/Nicht-Atomar

Wenn ein Model auf Standard oder Nichtatomar eingestellt ist, variiert das Streaming-Verhalten basierend darauf, ob 1> ModelStreamingBehaviour1> auf 4> Standard4> ( 7> Legacy7> ) oder 0> Improved0> eingestellt ist.

Siehe technisches Verhalten für weitere details.

Atomar

Wenn ein Model in Atomar geändert wird, werden alle seine Nachkommen in einem zusammen gestreamt, wenn ein Nachkommen BasePart ist, das auf

Ein Atommodell wird nur ausgegeben, wenn alle seine Nachkommen Teile für den Streaming-Ausfall berechtigt sind, und zwarumdem die gesamte Modell-Kette zusammen ausgegeben wird. Wenn nur einige Teile eines Atommodells normalerweise Streaming-Ausgaben erhalten, bleibt das gesamte Modell und seine Nachkommen auf dem Client.

Lokales Skript
-- Atommodell existiert beim Laden nicht; verwende WaitForChild()
local model = workspace:WaitForChild("Model")

-- Absteigende Teile stream in mit dem Modell und sind sofort zugänglich
local meshPart = model.MeshPart
local part = model.Part

Dauerhaft

PersistenteModelle sind nicht auf normale Streaming in oder aus. Sie werden als vollständige Atomeneinheit gesendet, sobald der Spieler beitritt und vor dem Workspace.PersistentLoaded -Ereignis. PersistenteModelle und ihre Nach

Lokales Skript
-- Das persistente Modell existiert beim Laden nicht; verwenden Sie WaitForChild()
local model = workspace:WaitForChild("Model")

-- Absteigende Teile stream in mit dem Modell und sind sofort zugänglich
local meshPart = model.MeshPart
local part = model.Part

persistentPerSpieler

Modelle auf PersistentPerPlayer verhalten sich so, als wäre Persistent für Spieler, die mit Model:AddPersistentPlayer() hinzugefügt wurden, dasselbe. Für andere Spieler ist das Verhalten so, als wäre 2> Atomar2>. Sie können ein Model von der persistenz eines Spielers über 5> Class.Model:RemovePersistentPlayer() 5> zurückrufen.

Area-Streaming anfordern

Wenn Sie den CFrame eines Spielerscharakters in eine Region setzen, die derzeit nicht geladen ist, wird die Stream-Pause gestreamt, wenn es aktiviert ist. Wenn Sie den Charakter beweisen, dass er sich in einen bestimmten Bereich bewegt, können Sie Class.Player:RequestStreamAroundAsync() 1> aufrufen, um zu verlangen, dass der Server Regionen in diesem Bereich an den Client sendet1>.

Die folgenden Skripte zeigen, wie man ein client-to-server Remote-Ereignis feuert, um einen Spieler innerhalb eines Ortes zu teleportieren, der bei der Streaming-Anfrage vor dem Verschieben des Charakters in ein neues CFrame liefert.

Script - Teleportieren Spieler Charakter
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local teleportEvent = ReplicatedStorage:WaitForChild("TeleportEvent")

local function teleportPlayer(player, teleportTarget)
	-- Fordern Sie die Streaming-Lokalisierung um die Ziel位置 an
	player:RequestStreamAroundAsync(teleportTarget)

	-- Teleportieren Sie den Charakter
	local character = player.Character
	if character and character.Parent then
		local currentPivot = character:GetPivot()
		character:PivotTo(currentPivot * CFrame.new(teleportTarget))
	end
end

-- Rufe die Teleport-Funktion auf, wenn der Client das Remote-Ereignis auslöst
teleportEvent.OnServerEvent:Connect(teleportPlayer)

Lokales Skript - Feuer-Remote-Ereignis
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

-- Feuere das Remote-Ereignis
teleportEvent:FireServer(teleportTarget)

Instanz-Streaming erkennen

In einigen Fällen ist es notwendig, zu erkennen, wenn ein Objekt einsteigt oder ausgeht und auf dieses Ereignis reagiert. Ein nützliches Muster für die Stream-Erkennung ist wie folgt:

1. Mit dem Tags-Abschnitt der Eigenschaften eines Instanzen oder mit dem Tag-Editor von Studio wird ein logisches CollectionService-Tag für alle betroffenen Objekte zugewiesen.

2. Von einem einzigen LocalScript , entdecken Sie, wenn ein markiertes Objekt durch GetInstanceAddedSignal() und GetInstanceRemovedSignal() strreamt, und behandeln Sie das Objekt entsprechend.

   Lokales Skript - CollectionScript-Streaming-Erkennung
   local CollectionService = game:GetService("CollectionService")
   
   local tagName = "FlickerLightSource"
   local random = Random.new()
   local flickerSources = {}
   
   -- Erkennen Sie derzeit und neue getaggte Teile, die in oder ausgestreamt werden
   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)
   
   -- Flicker-Loop
   while true do
   	for light in flickerSources do
   		light.Brightness = 8 + random:NextNumber(-0.4, 0.4)
   	end
   
   	task.wait(0.05)
   end

Anpassung des Pause-Bildschirms

Die Player.GameplayPaused-Eigenschaft zeigt den aktuellen Pause-Status des Spieler:inan. Dieses Eigenschaft kann mit einer Class.Instance:GetPropertyChangedSignal()|GetPropertyChangedSignal() -Verbindung verwendet werden, um eine benutzerdefinierte grafische Benutzeroberflächeanzuzeigen oder auszublenden.

Lokales Skript
local Players = game:GetService("Players")
local GuiService = game:GetService("GuiService")
local player = Players.LocalPlayer

-- Deaktivieren Sie die Standard-Pause-Modalk
GuiService:SetGameplayPausedNotificationEnabled(false)

local function onPauseStateChanged()
	if player.GameplayPaused then
		-- Benutzerdefinierte grafische Benutzeroberflächeanzeigen
	else
		-- grafische Benutzeroberflächeausblenden
	end
end

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

Modellierungsgrad der Detaillierung

Wenn Streaming aktiviert ist, werden Models außerhalb der derzeit gestreamten Bereich nicht standardmäßig sichtbar. jedoch können Sie die Engine bitten, niedrigere Auflösung "imposter"-Meshes für Modelle zu rendern, die nicht auf Clients durch jedes Modell's LevelOfDetail Eigenschaftennicht vorhanden sind.

Bei der Verwendung von Imposter-Meshes beachten Sie gefolgte Profile:

• Imposter-Meshes sind so konzipiert, dass sie 1024 Studs entfernt von der Kamera oder weiter entfernt zu sehen sind. Wenn Sie StreamingTargetRadius auf einen viel kleineren Wert wie 256 reduziert haben, können imposter-Meshes für das Modell, das sie ersetzen, möglicherweise nicht visuell ansprechend sein.
• Wenn ein Modell und seine Nachkommenmodelle auf StreamingMesh eingestellt sind, werden nur die oberste Stufen-Vormodellierungsmodelle als Imposter-Meshes gerendert, die alle Geometrien unter dem Vorgänger sowie seine Nachkommen umwickeln. Für eine bessere Erfüllungwird empfohlen, 1> Disabled1> für Nachkommenmodelle zu verwenden.
• Texturen werden nicht unterstützt; Imposter-Meshes werden als glatte Meshes gerendert.
• Während ein Model nicht vollständig gestreamt ist, wird die Imposter-Maschine stattdessen rendert, anstatt einzelne Teile des Modells. Sobald alle einzelnen Teile gestreamt sind, werden sie rendert und die Imposter-Maschine ignoriert.
• Imposter-Meshes haben keine physische Bedeutung und agieren als nicht existierend in Bezug auf Raycasting, Kollisionserkennung und Physiksimulation.
• Das Bearbeiten eines Modells in Studio, wie das Hinzufügen/Löschen/Verlagern von Kindern Teilen oder das Festlegen von Farben, aktualisiert automatisch das Repräsentant-Mesh.