TeleportOptions

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

此類別是可選參數到 TeleportService:TeleportAsync() 函數，允許開發人員為傳送呼叫提供參數。

此類中的某些參數不相容，並且在傳給 TeleportService:TeleportAsync() 時會發生錯誤：

  • 保留的伺服器存取代碼 + 伺服器實例ID
  • 應保留伺服器 + 伺服器InstanceId
  • 應保留伺服器 + 保留伺服器存取碼

有關如何在服務器之間傳送玩家的更多信息，請參閱傳送到地方之間。

概要

屬性

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

方法

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

屬性

ReservedServerAccessCode

string
平行讀取

此屬性指示使用者應該傳送到的保留伺服器的保留伺服器存取代碼。

有關如何在服務器之間傳送玩家的更多信息，請參閱傳送到地方之間。

ServerInstanceId

string
平行讀取

此屬性指示使用者應該傳送到服務器實例的 DataModel.JobId。

有關如何在服務器之間傳送玩家的更多信息，請參閱傳送到地方之間。

ShouldReserveServer

boolean
平行讀取

此屬性表示傳送呼叫是否應創建新的保留服務器。當設為真實時，將創建一個保留伺服器，並將玩家(s)傳送到新伺服器。

如果設為 false，玩家(s)將被傳送到指定的公共伺服器，如果提供了 TeleportOptions.ServerInstanceId 。當 TeleportOptions.ServerInstanceId 是空白或未找到匹配的伺服器時，會創建一個新的公共伺服器來將玩家傳送到。

有關如何在服務器之間傳送玩家的更多信息，請參閱傳送到地方之間。

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

方法

GetTeleportData

Variant

此功能返回存儲在 TeleportOptions 實例中的傳送資料，由 TeleportOptions:SetTeleportData() 來執行。

一旦玩家已經傳送，傳送資料可以使用 Player:GetJoinData() 和 TeleportService:GetLocalPlayerTeleportData() 函數來恢復。

有關如何在服務器之間傳送玩家的更多信息，請參閱傳送到地方之間。


返回

Variant

SetTeleportData

()

這是傳送數據到目的空間的設置器功能。在目的空間，這些資料可以使用 Player:GetJoinData() 或 TeleportService:GetLocalPlayerTeleportData() 來恢復。

例如，下面的代碼片段將會將 和 傳送到字典中，使用 傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送傳送

-- 服務器

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 then

    local placeId = teleportData.placeId

    local jobId = teleportData.JobId

end

如果在傳送功能中沒有設置 teleportData，這個 GetLocalPlayerTeleportData() 將返回 nil。

有關如何在傳送和接收用戶數據以及傳送中傳送之間的信息，請參閱在地點之間傳送。

參數

teleportData: Variant

將傳送到目的空間的資料。

預設值：""

返回

()
檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

活動

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目