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 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.

  • Lettura Parallela

    Il DataModel.JobId dell'istanza del server a cui teletrasportarsi.

  • Lettura Parallela

    Una bandiera per indicare se un server riservato dovrebbe essere assegnato e i giocatori dovrebbero quindi essere teletrasportati a questo assegnamento.

Metodi

Proprietà

ReservedServerAccessCode

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Variant

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

Variant

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() :


-- Server
local 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:


-- Cliente
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 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

teleportData: Variant

Dati da trasmettere al Postodi destinazione.

Valore predefinito: ""

Restituzioni

()

Eventi