TeleportOptions
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Questa classe è un parametro opzionale per la funzione TeleportService:TeleportAsync() che consente agli sviluppatori di fornire argomenti per la chiamata di teletrasporto.
Alcuni argomenti di questa classe non sono compatibili tra loro e causano un errore quando vengono passati a TeleportService:TeleportAsync() :
- ReservedServerAccessCode + ServerInstanceId
- ShouldReserveServer + ServerInstanceId
- ShouldReserveServer + ReservedServerAccessCode
Per ulteriori informazioni su come teletrasportare i giocatori tra i server, vedi Teletrasporto tra luoghi.
Sommario
Proprietà
Il codice di accesso al server riservato che indica il server riservato a cui il teletrasporto dovrebbe essere diretto.
Il DataModel.JobId dell'istanza del server a cui teletrasportarsi.
Una bandiera per indicare se un server riservato dovrebbe essere assegnato e i giocatori dovrebbero quindi essere teletrasportati a questo assegnamento.
Metodi
Restituisce i dati di teletrasporto memorizzati nell'istanza TeleportOptions da TeleportOptions:SetTeleportData() .
Funzione impostatrice per i dati da trasmettere al Postodi destinazione.
Proprietà
ReservedServerAccessCode
Questa proprietà indica il codice di accesso al server riservato per il server riservato a cui l'utente(i) dovrebbe essere teletrasportato.
Per ulteriori informazioni su come teletrasportare i giocatori tra i server, vedi Teletrasporto tra luoghi.
ServerInstanceId
Questa proprietà indica il DataModel.JobId dell'istanza del server a cui l'utente(i) dovrebbe essere teletrasportato.
Per ulteriori informazioni su come teletrasportare i giocatori tra i server, vedi Teletrasporto tra luoghi.
ShouldReserveServer
Questa proprietà indica se la chiamata di teletrasporto debba creare un nuovo Serverriservato.Quando è impostato su vero, verrà creato un server riservato e i Giocatore(i) verranno teletrasportati sul nuovo Server.
Se impostato su false, il (i) Giocatore(i) verrà teletrasportato sul server pubblico con il TeleportOptions.ServerInstanceId se fornito.Quando TeleportOptions.ServerInstanceId è vuoto o non viene trovato alcun server corrispondente, verrà creato un nuovo server pubblico per teletrasportare il Giocatore(i).
Per ulteriori informazioni su come teletrasportare i giocatori tra i server, vedi Teletrasporto tra luoghi.
Metodi
GetTeleportData
Questa funzione restituisce i dati di teletrasporto memorizzati nell'istanza TeleportOptions da TeleportOptions:SetTeleportData() .
Una volta che un giocatore è stato teletrasportato, i dati di teletrasporto possono essere recuperati utilizzando le funzioni Player:GetJoinData() e TeleportService:GetLocalPlayerTeleportData().
Per ulteriori informazioni su come teletrasportare i giocatori tra i server, vedi Teletrasporto tra luoghi.
Restituzioni
SetTeleportData
Questa è una funzione impostatrice per i dati da trasmettere al Postodi destinazione.Al Postodi destinazione, questi dati possono essere recuperati utilizzando Player:GetJoinData() o TeleportService:GetLocalPlayerTeleportData() .
Ad esempio, il seguente snippet invierebbe il DataModel.PlaceId e il DataModel.JobId in un dizionario che passa i dati di teletrasporto in un'istanza TeleportOptions utilizzando TeleportOptions:SetTeleportData() :
-- Serverlocal teleportOptions = Instance.new("TeleportOptions")local teleportData = {placeId = game.PlaceId,jobId = game.JobId}teleportOptions:SetTeleportData(teleportData)TeleportService:TeleportAsync(game.PlaceId, {player}, teleportOptions)
Tali dati potrebbero quindi essere recuperati all'arrivo utilizzando la funzione GetLocalPlayerTeleportData() come segue:
-- Clientelocal TeleportService = game:GetService("TeleportService")local teleportData = TeleportService:GetLocalPlayerTeleportData()if teleportData thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
Se non è stato impostato alcun teleportData nella funzione di teletrasporto, questo GetLocalPlayerTeleportData() restituirà nil .
Per ulteriori informazioni su come inviare e ricevere dati utente insieme ai teletrasporti, vedi, vedi Teletrasporto tra luoghi.
Parametri
Dati da trasmettere al Postodi destinazione.