事件序列器 | 文件 - Roblox 創作者中心

事件序列器是一個強大的框架，使您能夠在結構化的行動和觸發器序列上構建即時的跨伺服器事件和過場動畫。更具體地說，這個模組幫助您：

通過音效、動畫和過渡的時間表配置，在結構化的框架上構建事件或過場動畫。
在多個伺服器之間轉換多個場景，將複雜的動畫和視覺效果同步到時間線。
在事件中尋找並預覽體驗，以進行測試和開發用途。

此框架在 Roblox 事件中經過實戰考驗，例如 Twenty One Pilots 和 24kGoldn 演唱會，以及許多高人氣的體驗。

要在可編輯的地方中查看事件序列器的運作，可以檢查 Roblox Studio 中的演唱會範本。這個範本是開發者創建事件/演唱會和熟悉各種相關功能和組件的全面起點。

模組使用

安裝

要在體驗中使用事件序列器框架：

從 Studio 的視窗菜單或首頁標籤工具列中，打開工具箱並選擇創作者商店標籤。
確保選擇了模型排序，然後點擊查看所有按鈕以顯示類別。
找到並點擊包磚塊。
找到事件序列器模組並點擊，或將其拖放到 3D 視圖中。
在探索者窗口中，將整個事件序列器模型移動到 ServerScriptService 中。運行體驗時，模組將開始運行。

框架模式

替換模式

預設的框架模式是替換模式，在該模式中，您通過將 3D 物件、地形、燈光屬性、環境效果和用戶介面物件放入場景的環境資料夾中來設計獨特的場景。當場景加載時，這些物件和屬性會分配到 Workspace、Terrain 和 Lighting 中，替換現有的物件/屬性以形成一個克隆的空間。

此模式最適用於由多個連續場景組成的全新事件體驗，例如從預演場地到主要演唱會再到演出後派對。

行內模式

另一種框架模式是行內模式，在該模式中，您同樣設計獨特的場景，並為其流程/事件編寫腳本邏輯，但該框架將不會銷毀現有的 3D 物件、地形、燈光屬性、環境效果和用戶介面物件，以便在加載時從場景的環境資料夾克隆資產/屬性。

此模式最適合於現有體驗，因為它保留了您地方的設計和佈局，讓您可以在其中編排事件，如過場動畫。

要啟用行內模式：

在您放置於 ServerScriptService 中的事件序列器模型內部，展開並選擇 ReplicatedStorage 資料夾內的 Inline 值。
在屬性窗口中，切換開啟其值勾選框。

創建場景

場景本質上是整體事件或過場動畫的一部分，並包裹在一系列資料夾中。每個場景包含定義其流程/事件的腳本邏輯，並且一個場景可以存儲其自己的 3D 物件、地形、燈光屬性、環境效果和用戶介面物件。

要快速入手，您可以在模組的主資料夾中找到一個空白場景：

擴展事件序列器資料夾，找到 BlankScene 資料夾。
將整個 BlankScene 資料夾移動或複製到 ReplicatedStorage 中。

在開發事件時，您也可以將場景放置在探索者階層中的其他位置，並使用其屬性的標籤區域標記為 SequencerScene（BlankScene 已被標記為此）。不過，您需要將所有準備好的事件場景移動到 ReplicatedStorage 中，以便它們能在整體事件流程中工作。

時間長度

每個場景應有一個時間長度，以秒為單位，定義其持續時間 - 就像電影或演唱會有一個設置的持續時間一樣。時間長度定義為場景資料夾中的數字屬性，名為 TimeLength，您可以在 Studio 中直接設置它，也可以通過 Instance:SetAttribute() 程式化設置。

環境

場景的環境資料夾包含用戶所見所聞的一切，包括 3D 物件、地形、燈光屬性和環境效果，以及用戶介面物件。當場景加載時，這些物件和屬性將分配到 Workspace、Terrain 和 Lighting 中，替換現有的物件/屬性以形成一個克隆的空間。

此資料夾不適用於行內模式，因為該模式期望您使用現有資產和地方的全局屬性設置，而不是加載場景特定的資產/屬性。

環境資料夾包含以下容器：

容器	描述
客戶端	包含所有在任何用戶（客戶端）加入事件時加載的資產，例如用戶介面物件或動畫裝置。
玩家生成點	包含用戶加入時的生成位置。此資料夾中的任何物件的行為類似於 SpawnLocation。
伺服器	包含在伺服器上第一次創建場景時加載的所有資產。建議大多數視覺資產放在這裡。
地形	包含場景地形。
燈光	包含全局燈光屬性作為屬性，以及像氣氛效果和後處理效果的修飾器。

事件

場景的事件資料夾僅僅是一個存放 RemoteEvents 的佔位符，用來在客戶端和伺服器模組之間進行通信。將任何內容放在此資料夾中並不是必需的。

客戶端

此腳本在客戶端執行架構邏輯。

伺服器

此腳本在伺服器執行架構邏輯。

場景架構

場景的架構定義在場景的時間線中什麼時候發生什麼。您應該在其客戶端和伺服器模組中定義場景的架構，並包括生命週期掛鈎來管理何時進行配置。

生命週期掛鈎

架構生命週期掛鈎讓您管理場景操作何時發生。正在生產中的場景通常會以最簡單的流程運行：

OnSetup → OnRun → OnEndScene

OnRun 可以在尋找時中斷：

OnSetup → OnRun… 尋找 → OnRun… 尋找 → OnRun → OnEndScene

所有三個掛鈎在場景重播時也可以重複：

OnSetup → OnRun → OnEndScene… 重播 → OnSetup → OnRun → OnEndScene

配置

架構配置定義場景的核心操作，例如在 00:32 播放音頻、排隊一個與該音頻同步的動畫、調度場景事件像煙火表演等。每個配置支持某些回調函數，其中第一個參數（self）是配置實例。

您可以在客戶端和伺服器模組架構中使用配置，但建議您像在典型體驗中一樣在客戶端執行音頻和動畫的操作。

尋找場景

事件序列器的一個獨特功能是能夠像尋找影片一樣在場景之中「尋找」。在替換模式中，您也可以在場景之間切換，以在將其投入生產之前預覽整個多場景事件。

場景尋找對所有人都不可用，因為僅僅享受事件的用戶不應該控制其時間流。相反，您必須根據事件的 PlaceId 以及特定的 UserIds 和/或群組及其內部角色授予尋找權限。

在 ServerScriptService 中創建一個新的 Script。

將以下代碼粘貼到新腳本中。

腳本 - 設定尋找權限
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

EventSequencer.setSeekingPermissions({
	placeIDs = {},
	userIDs = {},
	groups = {
		{GroupID = , MinimumRankID = },
	}
})

將以下表格填寫在 setSeekingPermissions 呼叫中，如下所示：

placeIDs	逗號分隔的 PlaceId 值列表，以支持尋找。
userIDs	逗號分隔的 UserIds 列表，表示可以在支持的地方中尋找的人。
groups	逗號分隔的表格列表，每個表格包含一個群組 ID 和該群組成員的最低等級，該成員可以在支持的地方中尋找。

場景管理器插件

場景管理器插件是一個有用的工具，用於加載和卸載場景、燈光和地形。除非您使用行內模式，否則強烈建議您使用此插件，而不是手動放置/編輯場景物件和屬性。

此插件不適用於行內模式，因為該模式期望您使用現有資產和地方的全局屬性設置，而不是從場景的環境資料夾中加載場景特定的資產/屬性。

要安裝插件：

從 Studio 的視窗菜單或首頁標籤工具列中，打開工具箱。
在創作者商店標籤選中後，從下拉菜單中選擇插件。
在搜索框中輸入場景管理器並按 Enter 以查找插件。
點擊插件的圖示以查看其詳細信息，然後點擊安裝按鈕。
成功安裝插件後，它將出現在 Studio 的插件標籤中。

加載和卸載場景

正如創建場景中概述的，場景的環境資料夾包含用戶所見所聞的一切，包括 3D 物件。插件幫助您迅速將場景的資產加載到工作區中的有組織資料夾中，或者從中卸載。

場景必須被標記為 SequencerScene 以便插件能夠識別（BlankScene 已經標記為這樣）。如果您創建了一個場景但它在插件中未顯示，請確保它已被標記，然後保存並重新打開該地方。

插件操作	描述
加載客戶端	如果場景的客戶端內容已卸載，則將其環境/客戶端資料夾移入工作區/場景客戶端資料夾中。
加載伺服器	如果場景的伺服器內容已卸載，則將其環境/伺服器資料夾移入工作區/場景伺服器資料夾中。
卸載客戶端	如果場景的客戶端內容已加載，則將其客戶端資料夾從工作區/場景客戶端移回 [場景]/環境資料夾中。
卸載伺服器	如果場景的伺服器內容已加載，則將其伺服器資料夾從工作區/場景伺服器移回 [場景]/環境資料夾中。
卸載所有場景	將每個已加載場景的客戶端和伺服器資料夾移回其環境資料夾中。

保存和加載燈光

頂級的 Lighting 服務儲存一個地點的所有燈光屬性和視覺效果。由於它是頂級服務，您無法手動將其移到特定場景的環境/伺服器或環境/客戶端資料夾中。相反，您可以利用插件將其屬性和子物件複製到場景的環境/燈光資料夾中。

通過頂級的 Lighting 服務配置場景的燈光屬性、後處理效果、氣氛效果和天空盒。
在場景管理器插件窗口中，點擊對應場景的保存燈光。
選擇並展開該場景的環境/燈光配置，您將看到相同的燈光屬性作為該資料夾的屬性，以及頂級的 Lighting 服務的克隆子物件。

克隆實例
保存的屬性

一旦燈光屬性和子物件為場景保存，您可以通過點擊插件窗口中的加載燈光將它們迅速加載回頂級的 Lighting 服務中。

如果您希望類似 Atmosphere 的環境燈光效果在多場景事件的場景之間持續存在，請將其放在頂級的 Lighting 服務中，並將其 boolean 屬性 SceneFrameworkIgnore 設置為 true。

該框架還將 UseCurrentLighting 屬性應用於頂級的 Lighting 服務，預設為 false。如果設置為 true，該服務的燈光會在播放測試期間覆蓋所有場景特定的燈光 - 但是，在已發布事件中，場景燈光始終具有優先權。實際生活的類比是，這讓您可以在演唱會完全開燈的情況下進行舞台佈置，而在表演開始時「關掉燈光」。

保存和加載地形

由於 Terrain 是 Workspace 的頂級類，您無法手動將生成或雕刻的地形移到特定場景的環境/伺服器或環境/客戶端資料夾中。相反，您可以利用插件將其複製到場景的環境/地形資料夾中。

通過頂級地形服務配置場景的地形。
在場景管理器插件窗口中，點擊對應場景的保存地形。
選擇並展開該場景的環境/地形資料夾，您將看到一個 TerrainRegion 物件，該物件表示保存的地形。

一旦地形為場景保存，您可以通過點擊插件窗口中的加載地形將其迅速加載回頂級的 Terrain 服務中。

如果一個場景完全沒有地形，您仍然應該點擊保存地形。這將為該場景保存一個「空的」地形區域，並有效地清除在其之前顯示的任何場景的所有地形。

API 參考

架構生命週期掛鈎

OnSetup

OnSetup 生命週期掛鈎旨在初始化資產和變數，這些資產和變數將在 OnRun 或 OnEndScene 中引用，設置連接，這些連接預期在場景持續期間內持續存在等。此掛鈎接收 timePositionObject 參數，讓您在設置期間讀取當前時間。

建議您不要在 OnSetup 中調用 wait() 或 task.wait()，因為這會延遲 OnRun 的開始，同時場景的計時器繼續計數。

客戶端架構
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

local Schema = EventSequencer.createSchema()

local clientEnvironment
local serverEnvironment
local dummy

Schema.OnSetup = function(timePositionObject)
	print("OnSetup (客戶端)")

	-- 訪問場景環境；不適用於行內模式
	clientEnvironment = EventSequencer.getCurrentSceneEnvironment()
	serverEnvironment = EventSequencer.getCurrentServerEnvironmentFromClient()
	-- 等待資產
	dummy = clientEnvironment:WaitForChild("Dummy")

	print("當前時間為:", timePositionObject.Value)
end

伺服器架構
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

local Schema = EventSequencer.createSchema()

local serverEnvironment
local partColorConnection
local changePartColorEvent = script.Parent.Events.ChangePartColor

Schema.OnSetup = function(timePositionObject)
	print("OnSetup (伺服器)")

	-- 訪問場景環境；不適用於行內模式
	serverEnvironment = EventSequencer.getCurrentSceneEnvironment()
	partColorConnection = changePartColorEvent.OnServerEvent:Connect(function(player, changedPart, newColor)
		serverEnvironment.changedPart.Color = newColor
	end)

	print("當前時間為:", timePositionObject.Value)
end

OnRun

OnRun 是架構中的主要操作生命週期掛鈎。它應包含場景的所有計時配置，如播放音頻或動畫，再到調度事件，例如煙火顯示等。

建議您不要在 OnRun 中調用 wait() 或 task.wait()，因為這會延遲場景的編排，同時場景的計時器繼續計數。

客戶端架構
Schema.OnRun = function()
	print("OnRun (客戶端)")

	local MainAudio = Schema:audio({
		StartTime = 1,
		SoundId = "rbxassetid://1838673350",
		OnStart = function(self)
			print("音頻播放中")
		end,
		OnEnd = function(self)
			print("音頻已結束")
		end
	})
end

OnEndScene

OnEndScene 生命週期掛鈎對清理場景中任何未完成的工作非常有用，例如斷開在 OnSetup 或 OnRun 中創建的連接，這些連接在場景持續期間保持存在。

伺服器架構
Schema.OnEndScene = function()
	print("OnEndScene (伺服器)")

	if partColorConnection then
		partColorConnection:Disconnect()
		partColorConnection = nil
	end
end

在像演出後會場這樣可能被認為是「無限」的情況下，省略 OnEndScene 生命週期事件，並將 TimeLength 值設置為足夠長，以容納所有的架構配置。此外，請不要告知任何事情到架構，因為那些將在場景達到其時間長度時被清理。

架構配置

audio

在工作區中創建 Sound 物件，並在特定時間播放。然後在場景結束後或 Sound 物件播放結束後刪除該音頻。

配置鍵	描述
StartTime	在場景持續時間中相對於音頻播放的時間，單位為秒。
SoundId	要播放的音頻資產 ID。
OnStart	當音頻開始播放時觸發的自定義函數。
OnEnd	當音頻播放結束時觸發的自定義函數。
Volume	Sound 物件的音量；默認值為 0.5。

客戶端架構
Schema.OnRun = function()
	print("OnRun (客戶端)")

	local MainAudio = Schema:audio({
		StartTime = 1,
		SoundId = "rbxassetid://1838673350",
		OnStart = function(self)
			print("音頻播放中")
		end,
		OnEnd = function(self)
			print("音頻已結束")
		end
	})
end

您可以訪問 [audio].CurrentSoundIntensityRatio 作為音頻配置的音量強度比，供您在間隔中使用。這像是一首歌曲的偽脈衝/節拍，根據其過去的音量來判斷。

animate

創建在特定時間播放的 Animation。

配置鍵	描述
StartTime	在場景持續時間中相對於動畫播放的時間，單位為秒。
EndTime	選擇性時間，表示在場景持續時間中結束動畫的時間，單位為秒。
Rig	要在其上播放動畫的動畫裝置。
AnimationId	要播放的動畫資產 ID。
Speed	動畫的播放速度；默認值為 1。
FadeInTime	動畫淡入的時間，單位為秒；默認值為 0.2（秒）。
FadeOutTime	動畫淡出的時間，單位為秒；默認值為 0.2（秒）。
OnStart	當動畫開始播放時觸發的自定義函數。
OnEnd	當動畫播放結束時觸發的自定義函數。
Looped	是否循環播放動畫；默認值為 false。
SyncToAudio	定義是否將動畫與音頻配置同步的表。接受以下鍵： Audio - 對應一個音頻配置的引用。 StartAtAudioTime - 在音頻持續時間中播放動畫的時間。 EndAtAudioTime - 在音頻持續時間中可選的時間，表示結束動畫的時間。

客戶端架構
Schema.OnRun = function()
	print("OnRun (客戶端)")

	local MainAudio = Schema:audio({
		StartTime = 1,
		SoundId = "rbxassetid://1838673350",
	})

	local DanceAnimation = Schema:animate({
		AnimationId = "rbxassetid://3695333486",
		Rig = Dummy,
		Speed = 1,
		FadeInTime = 0.1,
		FadeOutTime = 0.3,
		SyncToAudio = {
			Audio = MainAudio,
			StartAtAudioTime = 5,
		},
		OnStart = function(self)
			print("動畫播放中")
		end,
		OnEnd = function(self)
			print("動畫已停止")
		end
	})
end

tween

創建一個可配置的 Tween，該Tween在尋找和動態加入時會得以保留，意味著您可以在不同的時間點鏈接過渡，一切都應按預期播放和同步。

配置鍵	描述
StartTimes	相對於場景持續時間的開始時間表，單位為秒。
Tween	定義要過渡的物件和屬性的表。接受以下鍵： Object - 要進行過渡的物件。 Info - TweenInfo 實例，用於過渡，定義其持續時間、Enum.EasingStyle、Enum.EasingDirection 等。 Properties - 物件屬性及其目標值的對象。
OnStart	當過渡開始播放時觸發的自定義函數。
OnHeartbeat	每次在 Heartbeat 上都觸發的自定義函數；接受過渡 alpha 作為第二個參數。
OnEnd	當過渡播放完成時觸發的自定義函數。
SyncToAudio	定義是否將過渡與音頻配置同步的表。接受以下鍵： Audio - 對應一個音頻配置的引用。 StartAtAudioTimes - 開始時間表，定義何時在音頻的持續時間內播放過渡。

客戶端架構
Schema.OnRun = function()
	print("OnRun (客戶端)")

	local MainAudio = Schema:audio({
		StartTime = 1,
		SoundId = "rbxassetid://1838673350",
	})

	local LightFadeOut = Schema:tween({
		StartTimes = {29.884},
		Tween = {
			Object = game:GetService("Lighting"),
			Info = TweenInfo.new(2, Enum.EasingStyle.Sine, Enum.EasingDirection.Out),
			Properties = {
				Brightness = 0,
			}
		},
		SyncToAudio = {
			Audio = MainAudio,
			StartAtAudioTimes = {5, 7.2, 9.4, 11.6},
		},
		OnStart = function(self)
			print("過渡播放中")
		end,
		OnHeartbeat = function(self, alpha)
			print("過渡 alpha", alpha)
		end,
		OnEnd = function(self)
			print("過渡完成")
		end,
	})
end

interval

在指定的時間和頻率上執行自定義回調函數，單位為秒。對於重複事件，如閃爍的燈光、閃爍音頻的強度等非常有用。最低可能的頻率是 0 秒，但技術上最小頻率始終被限制為 Heartbeat。

配置鍵	描述
StartTime	在場景持續時間中的間隔持續時間開始的時間，單位為秒。
EndTime	在場景持續時間中的間隔持續時間結束的時間，單位為秒。
Frequency	OnInterval 函數應該觸發的頻率，單位為秒，第一次執行在 StartTime 時。
OnStart	當這系列間隔開始時觸發的自定義函數。
OnInterval	在指定的持續時間內（StartTime 到 EndTime）的每個間隔內觸發的自定義函數。
OnEnd	當這系列間隔結束時觸發的自定義函數。
SyncToAudio	定義是否將間隔持續時間與音頻配置同步的表。接受以下鍵： Audio - 對應一個音頻配置的引用。 StartAtAudioTime - 在音頻持續時間中開始間隔持續時間的時間。 EndAtAudioTime - 可選時間，表示在音頻持續時間中結束間隔持續時間的時間。

客戶端架構
Schema.OnRun = function()
	print("OnRun (客戶端)")

	local MainAudio = Schema:audio({
		StartTime = 1,
		SoundId = "rbxassetid://1838673350",
	})

	local ClientTimerUpdate = Schema:interval({
		Frequency = 1,
		SyncToAudio = {
			StartAtAudioTime = 2.5,
			EndAtAudioTime = 10,
			Audio = MainAudio
		},
		OnInterval = function(self)
			print(MainAudio.Sound.TimePosition, MainAudio.CurrentSoundIntensityRatio)
		end,
	})
end

schedule

類似於 interval，但您可以為同一事件定義多個特定開始時間，例如在一個場景中安排兩次煙火表演。

配置鍵	描述
StartTimes	相對於場景持續時間的開始時間表，單位為秒。
OnStart	在 StartTimes 表中每個指定的時間觸發的自定義函數。
Skippable	定義已安排的事件是否可以被捷徑用戶跳過，或者在某個時間之前的捷徑時。如果設置為 false，所有在捷徑/加入時間之前安排的事件開始時間將在該捷徑/加入時間發生。如果設置為 true，則只有在捷徑/加入之後安排的事件開始時間將發生。預設值為 false。
SyncToAudio	定義是否將日程與音頻配置同步的表。接受以下鍵： Audio - 對應一個音頻配置的引用。 StartAtAudioTimes - 開始時間表，定義何時觸發 OnStart 函數，以相對於音頻的持續時間。

客戶端架構
Schema.OnRun = function()
	print("OnRun (客戶端)")

	Schema:schedule({
		StartTimes = {5, 27.25},
		OnStart = function(self)
			-- 初始化臨時心跳連接
			local tempConnection = RunService.Heartbeat:Connect(function()

			end)
			-- 通知框架關於連接
			Schema:inform(tempConnection)
		end
	})
end

inform

通知框架任何在 OnRun 生命週期掛鈎中創建的模組、用戶介面物件、連接等，確保當尋找時會被正確清理。用例包括：

通知框架如 RunService.Heartbeat 這樣的臨時連接，以便在尋找至場景的早期時斷開此連接。

伺服器架構
Schema.OnRun = function()
	print("OnRun (伺服器)")

	Schema:schedule({
		StartTimes = {5},
		OnStart = function(self)
			-- 初始化臨時心跳連接
			local tempConnection = RunService.Heartbeat:Connect(function()

			end)
			-- 通知框架關於連接
			Schema:inform(tempConnection)
		end
	})
end

在 ModuleScript 中調用自定義「清理」函數，在 OnRun 生命週期掛鈎中初始化連接或其他引用。

伺服器架構
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")

local customModule = require(ReplicatedStorage:WaitForChild("CustomModule"))

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

local Schema = EventSequencer.createSchema()

Schema.OnRun = function()
	print("OnRun (伺服器)")

	Schema:schedule({
		StartTimes = {5},
		OnStart = function(self)
			-- 調用自定義模組中的 "init" 函數
			customModule.init()
			-- 在場景清理時調用自定義模組中的 "clean" 函數
			Schema:inform(customModule, customModule.clean)
		end,
	})
end

ModuleScript - CustomModule
local RunService = game:GetService("RunService")

local CustomModule = {}

CustomModule.init = function()
	-- 初始化心跳連接
	CustomModule.connection = RunService.Heartbeat:Connect(function()

	end)
end

CustomModule.clean = function()
	-- 斷開並清除心跳連接
	if CustomModule.connection then
		CustomModule.connection:Disconnect()
		CustomModule.connection = nil
	end
end

return CustomModule

雖然 inform 對於尋找支持至關重要，但您應該僅將其用於通知框架所有在 OnRun 生命週期掛鈎中創建/初始化的模組、UI 物件、連接等。如果您希望在整個場景中引用某物，請直接在 OnSetup 中初始化並在 OnEndScene 中清理。

函數

loadScene

loadScene(sceneName: string, startTime: number ?)

按 sceneName 程式化加載一個場景，並從其開始時間 startTime 開始播放。場景從服務器加載之前會有 5 秒的「寬限期」，因此如果您在 4:15:00 PM 時精確調用 loadScene("[SceneName]", 20)，框架將再等 5 秒外加請求的 20 秒，於是場景會在 4:15:25 PM 開始播放。

腳本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

-- 當當前場景結束時瞭解下個場景要加載
EventSequencer.onOrchestrationFinished:Connect(function(endedSceneName)
	if endedSceneName == "PreShow" then
		-- "PreShow" 結束；加載演唱會的第一個場景
		EventSequencer.loadScene("Track1")
	elseif endedSceneName == "Track1" then
		-- "Track1" 結束；加載演唱會的第二個場景
		EventSequencer.loadScene("Track2")
	else
		-- 循環返回到預演場景
		EventSequencer.loadScene("PreShow")
	end
end)

請勿在架構生命週期掛鈎內調用 loadScene，因為事件序列器預期場景轉換和整體的多場景事件序列是在各個單獨的場景外進行處理的。

createSchema

createSchema(): table

返回場景架構的實例，以創建場景的邏輯。

客戶端架構
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

local Schema = EventSequencer.createSchema()

Schema.OnSetup = function(timePositionObject)
	print("OnSetup (客戶端)")
end

seek

seek(time: number)

從當前加載的場景的開始位置尋找 time 值，以秒為單位。

腳本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

EventSequencer.seek(95.58)

請勿在架構生命週期掛鈎內調用 seek，因為事件序列器預期場景尋找和加載是在各個單獨的場景外進行處理的。

setSceneWarningTime

setSceneWarningTime(endSceneTimeWindow: number)

設置從所有場景結束開始發送警告的時間。您可以通過 onSceneEndingWarningForClient 或 onSceneEndingWarningForServer 在客戶端或伺服器端檢測到這些警告。

腳本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

-- 加載場景
EventSequencer.loadScene("BeautifulScene")

-- 將警告時間設置為場景結束前 5 秒
EventSequencer.setSceneWarningTime(5)

-- 檢測場景即將結束時
EventSequencer.onSceneEndingWarningForServer:Connect(function()
	warn("場景即將結束！")
end)

setSeekingPermissions

setSeekingPermissions(permissions: table)

基於事件的 PlaceId 以及特定的 UserIds 和/或群組和角色授予尋找許可。詳情請參見尋找和切換場景。

getCurrentSceneEnvironment

getCurrentSceneEnvironment(): Folder (YIELDS)

根據從客戶端架構腳本或伺服器架構腳本的調用，返回當前場景的客戶端或伺服器端環境資料夾。

請勿將此函數與行內模式一起使用，因為該模式期望您使用現有資產和全局屬性設置，而不是從場景的環境資料夾中加載場景特定的資產/屬性。如果資料夾不存在，該函數將無限地產生等待。

客戶端架構
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

local Schema = EventSequencer.createSchema()

local clientEnvironment
local serverEnvironment

Schema.OnSetup = function(timePositionObject)
	print("OnSetup (客戶端)")

	-- 訪問場景環境；不適用於行內模式
	clientEnvironment = EventSequencer.getCurrentSceneEnvironment()
	serverEnvironment = EventSequencer.getCurrentServerEnvironmentFromClient()

	print("當前時間為:", timePositionObject.Value)
end

伺服器架構
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

local Schema = EventSequencer.createSchema()

local serverEnvironment
local partColorConnection
local changePartColorEvent = script.Parent.Events.ChangePartColor

Schema.OnSetup = function(timePositionObject)
	print("OnSetup (伺服器)")

	serverEnvironment = EventSequencer.getCurrentSceneEnvironment()

	partColorConnection = changePartColorEvent.OnServerEvent:Connect(function(player, changedPart, newColor)
		serverEnvironment.changedPart.Color = newColor
	end)
end

getCurrentServerEnvironmentFromClient

getCurrentServerEnvironmentFromClient(): Folder (YIELDS)

返回當前場景的伺服器端環境資料夾。與 getCurrentSceneEnvironment 不同，您可以從客戶端架構腳本調用此方法。

客戶端架構
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

local Schema = EventSequencer.createSchema()

local clientEnvironment
local serverEnvironment

Schema.OnSetup = function(timePositionObject)
	print("OnSetup (客戶端)")

	-- 訪問場景環境；不適用於行內模式
	clientEnvironment = EventSequencer.getCurrentSceneEnvironment()
	serverEnvironment = EventSequencer.getCurrentServerEnvironmentFromClient()

	print("當前時間為:", timePositionObject.Value)
end

isLoadingScene

isLoadingScene(): boolean

從服務器調用，以了解場景是否正在加載。

請勿將此函數與行內模式一起使用，因為該模式期望您使用現有資產和全局屬性設置，而不是從場景的環境資料夾中加載場景特定的資產/屬性。

腳本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

print(EventSequencer.isLoadingScene())

while EventSequencer.isLoadingScene() do
	task.wait()
end
print("場景已加載")

事件

onSceneEndingWarningForClient

在場景即將結束之前在客戶端觸發。預設時間為 3 秒，但您可以通過 setSceneWarningTime 進行配置。該事件僅可以在 LocalScript 中連接。

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

-- 檢測場景即將結束（客戶端）
EventSequencer.onSceneEndingWarningForClient:Connect(function()
	warn("場景即將結束！")
end)

onSceneEndingWarningForServer

在場景即將結束之前在伺服器端觸發。預設時間為 3 秒，但您可以通過 setSceneWarningTime 進行配置。該事件僅可以在 Script 中連接。

腳本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

-- 檢測場景即將結束（伺服器）
EventSequencer.onSceneEndingWarningForServer:Connect(function()
	warn("場景即將結束！")
end)

onSceneLoadedForClient

場景開始時在客戶端觸發。該事件僅可以在 LocalScript 中連接。

請勿將此事件用於行內模式，因為該模式期望您使用現有資產和全局屬性設置，而不是從場景的環境資料夾中加載場景特定的資產/屬性。

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

-- 檢測場景開始（客戶端）
EventSequencer.onSceneLoadedForClient:Connect(function()
	warn("場景開始中！")
end)

onOrchestrationFinished

當場景達到其時間長度並有效終結時，在伺服器呼叫。此事件接收一個 endedSceneName 字串名稱作為參數，表示剛剛結束的場景，您可以基於這個事件有條件地加載其他場景。該事件只能在 Script 中連接。

腳本
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EventSequencer = require(ReplicatedStorage:WaitForChild("EventSequencer"))

-- 當前場景結束時瞭解下個場景要加載
EventSequencer.onOrchestrationFinished:Connect(function(endedSceneName)
	if endedSceneName == "PreShow" then
		-- "PreShow" 結束；加載演唱會的第一個場景
		EventSequencer.loadScene("Track1")
	elseif endedSceneName == "Track1" then
		-- "Track1" 結束；加載演唱會的第二個場景
		EventSequencer.loadScene("Track2")
	else
		-- 循環返回到預演場景
		EventSequencer.loadScene("PreShow")
	end
end)