インスタンスストリーミング

ゲーム内のインスタンスストリーミングにより、RobloxエンジンはWorkspace内で3Dコンテンツおよび関連インスタンスを動的に読み込みおよびアンロードできます。これにより、プレイヤー体験がいくつかの方法で改善されます。具体的には：

• より速い参加時間

  — プレイヤーは、世界のある部分でプレイを開始し、他の部分がバックグラウンドで読み込まれている間にプレイできます。
• メモリ効率

  — コンテンツが動的に読み込まれるため、メモリの少ないデバイスでもゲームがプレイ可能になります。より没入感があり詳細な世界をさまざまなデバイスでプレイできます。
• パフォーマンスの向上

  — サーバーが世界とその中のプレイヤーとの間の変更を同期するのにかかる時間と帯域幅が減るため、フレームレートとパフォーマンスが向上します。クライアントは、現在プレイヤーに関連しないインスタンスの更新にかかる時間が減ります。
• 詳細レベル

  — 設定されている場合、遠くのモデル、プラットフォームアバター、地形は、クライアントにストリーミングされていなくても表示されたままとなり、バックグラウンドのビジュアルを全面的に犠牲にすることなくゲームを最適化します。

インスタンスストリーミングは、Workspace.StreamingEnabledプロパティを介して制御され、新しいスタジオで作成された場所ではデフォルトで有効になっています。このプロパティはスクリプト内で設定できません。

技術的動作

スコープ

ストリーミングのロジックと機能はWorkspaceの子孫であるインスタンスにのみ適用され、ReplicatedStorageやReplicatedFirstなどの他のコンテナに格納されているインスタンスはストリーミングの対象外です。たとえば、ReplicatedStorageの下にアトミックモデルを配置しても、アトミックな複製が保証されるわけではありません。

ストリームイン

プレイヤーがインスタンスストリーミングが有効なゲームに参加すると：

1. Workspace内のインスタンスはクライアントに複製されますが、以下を除外します：

   

   BaseParts（PartsおよびMeshParts）

   

   アトミック、永続的またはプレイヤーごとに永続的に設定されたModels；モデル毎のストリーミング制御を参照

   

   ModelsがImprovedに設定されているときに、非アトミック（デフォルト）

   

   上記インスタンスの子孫

2. ゲームプレイ中、サーバーはゲームのストリーミングプロパティ、プレイヤーの位置、クライアントデバイスのパフォーマンス、およびその他の条件に基づいて、上記の遅延カテゴリのインスタンスをクライアントにストリーミングできる場合があります。

ストリームアウト

ゲームプレイ中、クライアントはWorkspace.StreamOutBehaviorで設定された動作に基づいて、プレイヤーのWorkspaceからBasePartsの領域を削除することができます。プロセスは、複製の焦点から最も遠い領域から始まり、必要に応じてより近くに移動します。Workspace.StreamingMinRadiusの範囲内にある領域は決してストリーミングアウトしません。

BasePartの子孫を持たないModel（例えば、非BasePartインスタンスの「コンテナ」としてのみ使用されるもの）は、BasePartの子孫である場合を除き、ストリーミングアウトすることは免除されます。

アセンブリ

物理アセンブリは、関連するConstraintsおよびAttachmentsを含む完全な単位としてストリーミングインされ、クライアントでの物理更新を一貫性のあるものに保ちます。唯一の例外は、アセンブリが固定されている場合であり、その場合はストリーミング半径内のBasePartsのみが、関連するConstraintsおよびAttachmentsとともにストリーミングされます。

アセンブリは、すべてのBasePartsがストリーミングアウトの対象になるまでストリーミングアウトされません。

ストリーミングプロパティ

次のプロパティは、インスタンスストリーミングがゲームに適用される方法を制御します。これらのプロパティはすべてスクリプトでは設定できず、スタジオ内のWorkspaceオブジェクトで設定する必要があります。

複製の焦点

デフォルトでは、ストリーミングはローカルプレイヤーのキャラクターのPrimaryPartの周囲で行われますが、Player.ReplicationFocusを介して異なる複製の焦点を指定できます。

Player:AddReplicationFocus()およびPlayer:RemoveReplicationFocus()を使用して、ゲームの複数の領域で動的にストリーミングを有効にするために、追加の複製焦点を追加または削除することもできます。

クライアント側の物理シミュレーションは、サーバー権限が実装されている際の予測および再シミュレーションを含め、ストリーミングされた領域内でのみ発生します。キャラクターから遠く離れている場合でもシミュレーションを続けたいインスタンスがある場合は、それらのインスタンスの近くに追加の複製焦点を作成してください。

モデルストリーミング制御

モデルごとのストリーミング関連の問題を避け、WaitForChild()の使用を最小限に抑えるために、Modelsおよびその子孫がどのようにストリーミングされるかを、ModelStreamingModeプロパティを介してカスタマイズできます。

非アトミック

デフォルトでは、モデルはNonatomicであり、Workspace.ModelStreamingBehaviorがLegacy（デフォルト）またはImprovedに設定されているかどうかに基づいてストリーミングイン/アウトされます。

レガシー

Workspace.ModelStreamingBehaviorがLegacy（デフォルト）に設定されている場合、Modelコンテナおよびその非BasePart子孫（たとえばScriptsなど）は、プレイヤーが参加するとクライアントに複製されます。その後、モデルのBasePart子孫がストリーミングインされる資格が生じます。

改善された

Workspace.ModelStreamingBehaviorがImprovedに設定されている場合、モデルのストリーミング動作は、モデルがBasePart子孫を持つか持たないかによって異なります：

• BasePart子孫を持つモデルは、1つの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を繰り返し押して利用可能なパネルをサイクリングします。4番目のパネルがストリーミングデバッグビューで、実行時の有用な情報が表示されます：

   • アクティブなストリーミング設定
   • 現在読み込まれている（ストリーミングインされた）領域
   • ストリーミングの動作と状態

有効になると、3Dビューポートに色付きのハイライト領域が表示されます：