此類是 TeleportService:TeleportAsync() 函數的可選參數,讓開發人員可以為傳送呼叫提供參數。
此類中的某些參數不相容,並且在傳送至 TeleportService:TeleportAsync() 時發生錯誤:
- 保留的伺服器通道代碼+伺服器實例ID
- 應該保留伺服器 + 伺服器實例ID
- 應該保留伺服器+保留伺服器AccessCode
了解有關如何在服務器間傳送玩家的更多資訊,請參閱 在不同地點之間傳送。
概要
屬性
指定傳送到的保留服務器的保留服務器存取代碼。
服務器實例的 DataModel.JobId。
一個指示是否應該할配保留伺服器的旗幟和是否應該將玩家傳送到這個할配的地方。
方法
將傳送資料返回 TeleportOptions 實例,由 TeleportOptions:SetTeleportData() 來存取。
設定資料傳送至目的地地空間的功能。
屬性
ShouldReserveServer
此屬性表示要創建新的保留伺服器嗎。設置為"真"時,將會創建一個保留伺服器,並且玩家將會被傳送到新的伺服器。
如果設為 false,玩家將被傳送到公共伺服器,並且提供指定的 TeleportOptions.ServerInstanceId 如果提供。當 TeleportOptions.ServerInstanceId 為空或未找到相應伺服器時,將建立新的公共伺服器來傳送玩家。
了解有關如何在服務器間傳送玩家的更多資訊,請參閱 在不同地點之間傳送。
方法
GetTeleportData
此函數將傳送資料存放在 TeleportOptions 實例的 TeleportOptions:SetTeleportData() 中返回。
一旦玩家傳送,傳送資料可以使用 Player:GetJoinData() 和 TeleportService:GetLocalPlayerTeleportData() 功能來取回。
了解有關如何在服務器間傳送玩家的更多資訊,請參閱 在不同地點之間傳送。
返回
SetTeleportData
這是一個將資料傳送到目的地地空間的設定器功能。在目的地地空間,這個資料可以使用 Player:GetJoinData() 或 TeleportService:GetLocalPlayerTeleportData() 來取回。
舉例來說,以下代碼將 DataModel.PlaceId 和 DataModel.JobId 發送到一個典型,並使用 TeleportOptions 中的 2>Class.DataModel.JobId2> 發送傳輸資料:
-- 伺服器local teleportOptions = Instance.new("TeleportOptions")local teleportData = {placeId = game.PlaceId,jobId = game.JobId}teleportOptions:SetTeleportData(teleportData)TeleportService:TeleportAsync(game.PlaceId, {player}, teleportOptions)
此資料可以在到達時使用 GetLocalPlayerTeleportData() 功能取回,如下所示:
-- 客戶local TeleportService = game:GetService("TeleportService")local teleportData = TeleportService:GetLocalPlayerTeleportData()if teleportData thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
如果沒有 teleportData 在傳送功能中設置,此 GetLocalPlayerTeleportData() 將返回 nil。
有關發送和接收用戶資料以及傳送至其他地方的方法,請參閱「傳送間隔」。
參數
資料要傳送到目的空間。