TeleportOptions

顯示已棄用項目

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

此類是 TeleportService:TeleportAsync() 函數的可選參數,讓開發人員可以為傳送呼叫提供參數。

此類中的某些參數不相容,並且在傳送至 TeleportService:TeleportAsync() 時發生錯誤:

  • 保留的伺服器通道代碼+伺服器實例ID
  • 應該保留伺服器 + 伺服器實例ID
  • 應該保留伺服器+保留伺服器AccessCode

了解有關如何在服務器間傳送玩家的更多資訊,請參閱 在不同地點之間傳送

概要

屬性

方法

屬性

ReservedServerAccessCode

平行讀取

此屬性表示使用者應該傳送至的保留伺服器的保留伺服器使用權限代碼。

了解有關如何在服務器間傳送玩家的更多資訊,請參閱 在不同地點之間傳送

ServerInstanceId

平行讀取

此屬性表示用戶應該傳送至的服務器實例 DataModel.JobId

了解有關如何在服務器間傳送玩家的更多資訊,請參閱 在不同地點之間傳送

ShouldReserveServer

平行讀取

此屬性表示要創建新的保留伺服器嗎。設置為"真"時,將會創建一個保留伺服器,並且玩家將會被傳送到新的伺服器。

如果設為 false,玩家將被傳送到公共伺服器,並且提供指定的 TeleportOptions.ServerInstanceId 如果提供。當 TeleportOptions.ServerInstanceId 為空或未找到相應伺服器時,將建立新的公共伺服器來傳送玩家。

了解有關如何在服務器間傳送玩家的更多資訊,請參閱 在不同地點之間傳送

方法

GetTeleportData

Variant

此函數將傳送資料存放在 TeleportOptions 實例的 TeleportOptions:SetTeleportData() 中返回。

一旦玩家傳送,傳送資料可以使用 Player:GetJoinData()TeleportService:GetLocalPlayerTeleportData() 功能來取回。

了解有關如何在服務器間傳送玩家的更多資訊,請參閱 在不同地點之間傳送


返回

Variant

SetTeleportData

void

這是一個將資料傳送到目的地地空間的設定器功能。在目的地地空間,這個資料可以使用 Player:GetJoinData()TeleportService:GetLocalPlayerTeleportData() 來取回。

舉例來說,以下代碼將 DataModel.PlaceIdDataModel.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 then
local placeId = teleportData.placeId
local jobId = teleportData.JobId
end

如果沒有 teleportData 在傳送功能中設置,此 GetLocalPlayerTeleportData() 將返回 nil

有關發送和接收用戶資料以及傳送至其他地方的方法,請參閱「傳送間隔」。

參數

teleportData: Variant

資料要傳送到目的空間。


返回

void

活動