TeleportOptions

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Questa classe è un parametro opzionale alla funzione TeleportService:TeleportAsync() che consente ai sviluppatori di fornire argomenti per la chiamata di teletrasporto.

Alcuni argomenti in questa classe non sono compatibili tra loro e causano un errore quando vengono passati a TeleportService:TeleportAsync() :

  • ReservedServerAccessCode + ServerInstanceId
  • ShouldReserveServer + ServerInstanceId
  • ShouldReserveServer + Codice riservato

For more information on how to teleport players between servers, see Teleporting Between Places .

Sommario

Proprietà

  • Il codice di accesso al server riservato che indica il server riservato a cui il teletrasporto dovrebbe essere.

  • Lettura Parallela

    Il DataModel.JobId della istanza server a cui teletrasportarsi.

  • Lettura Parallela

    Una bandiera per indicare se un server riservato dovrebbe essere assegnato e i giocatori dovrebbero quindi essere teletrasportati in questa allocazione.

Metodi

Proprietà

ReservedServerAccessCode

Lettura Parallela

Questa proprietà indica il codice di accesso al server riservato per il server riservato che gli utenti dovrebbero essere teletrasportati.

For more information on how to teleport players between servers, see Teleporting Between Places .

ServerInstanceId

Lettura Parallela

Questa proprietà indica il DataModel.JobId della istanza server a cui gli utenti dovrebbero essere teletrasportati.

For more information on how to teleport players between servers, see Teleporting Between Places .

ShouldReserveServer

Lettura Parallela

Questa proprietà indica se la chiamata di teletrasporto dovrebbe creare un nuovo Serverriservato. Quando è impostato su true, verrà creato un nuovo server riservato e i Giocatoreverranno teletrasportati sul nuovo Server.

Se impostato su false, il Giocatore(i) sarà teletrasportato(i) al server pubblico con l'TeleportOptions.ServerInstanceId specificato se fornito. Quando TeleportOptions.ServerInstanceId è vuoto o non corrispondente, viene creato un nuovo server pubblico per teletrasportare i Giocatore.

For more information on how to teleport players between servers, see Teleporting Between Places .

Metodi

GetTeleportData

Variant

Questa funzione restituisce i dati di teletrasporto memorizzati nell'istanza TeleportOptions da TeleportOptions:SetTeleportData() .

Una volta che un giocatore si è teletrasportato, i dati di teletrasporto possono essere recuperati utilizzando le funzioni Player:GetJoinData() e TeleportService:GetLocalPlayerTeleportData().

For more information on how to teleport players between servers, see Teleporting Between Places .


Restituzioni

Variant

SetTeleportData

void

Questa è una funzione di impostazione per i dati che vengono passati al luogo di Posto. Nello luogo di Posto, questi dati possono essere recuperati utilizzando Player:GetJoinData() o TeleportService:GetLocalPlayerTeleportData() .

Ad esempio, il seguente snippet invia il DataModel.PlaceId e DataModel.JobId in un dizionario che passa i dati di teletrasporto in una TeleportOptions istanza usando 1> Class.TeleportOptions:SetTeleportData()1> :


-- Server
local teleportOptions = Instance.new("TeleportOptions")
local teleportData = {
placeId = game.PlaceId,
jobId = game.JobId
}
teleportOptions:SetTeleportData(teleportData)
TeleportService:TeleportAsync(game.PlaceId, {player}, teleportOptions)

Questa data potrebbe quindi essere recuperata all'arrivo utilizzando la funzione GetLocalPlayerTeleportData() come segue:


-- Client
local TeleportService = game:GetService("TeleportService")
local teleportData = TeleportService:GetLocalPlayerTeleportData()
if teleportData then
local placeId = teleportData.placeId
local jobId = teleportData.JobId
end

Se non è stato impostato teleportData nella funzione di teletrasporto, questo GetLocalPlayerTeleportData() restituirà nil .

For more information on how to send and receive user data along with teleports, see, see Teleporting Between Places .

Parametri

teleportData: Variant

Dati da inviare al Postodi destinazione.


Restituzioni

void

Eventi