此类是 TeleportService:TeleportAsync() 函数的可选参数,允许开发人员为传送调用提供参数。
此类中的某些参数不兼容,并且在传递到 TeleportService:TeleportAsync() 时会导致错误:
- 保留的服务器访问代码 + ServerInstanceId
- 应该保留服务器 + ServerInstanceId
- 应该保留服务器 + 保留服务器访问代码
了解有关玩家在服务器之间如何传送的更多信息,请参阅在不同地点之间传送。
概要
属性
指示传送到的保留服务器的保留服务器访问代码。
服务器实例的DataModel.JobId。
一个指示是否要指定保留服务器的地点,以及玩家将被传送到该地点的所有者。
方法
将传送数据存储在 TeleportOptions 实例中的 TeleportOptions:SetTeleportData() 返回。
为数据传递到目的地场景点设置函数。
属性
ShouldReserveServer
此属性表示是否创建新的保留服务器。设置为“真”,将创建一个保留服务器,玩家将被传送到新服务器。
如果设置为“错误”,玩家将被传送到公共服务器,并且提供指定的 TeleportOptions.ServerInstanceId 如果指定为空白或未找到匹配的服务器,将创建一个新的公共服务器,将玩家传送到。
了解有关玩家在服务器之间如何传送的更多信息,请参阅在不同地点之间传送。
方法
GetTeleportData
此函数将传送数据存储在 TeleportOptions 实例中,通过 TeleportOptions:SetTeleportData() 返回。
一旦玩家传送,可以使用 Player:GetJoinData() 和 TeleportService:GetLocalPlayerTeleportData() 函数来恢复传送数据。
了解有关玩家在服务器之间如何传送的更多信息,请参阅在不同地点之间传送。
返回
SetTeleportData
此是将数据传递到目的地场景方的设置器函数。在目的地场景方,此数据可以使用 Player:GetJoinData() 或 TeleportService:GetLocalPlayerTeleportData() 来检索。
例如,以下代码将 DataModel.PlaceId 和 DataModel.JobId 发送到一个典型中,使用 TeleportOptions 实例使用 2>Class.TeleportOptions:SetTeleportData()2> 传送数据:
-- 服务器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。
有关有关如何发送和接收用户数据以及传送的更多信息,请参阅在地点之间传送。
参数
数据将被传递到目的场景。