TeleportOptions

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Diese Klasse ist ein optioneller Parameter für die TeleportService:TeleportAsync()-Funktion, die es den Entwicklern ermöglicht, Argumente für den Teleportanruf bereitzustellen.

Bestimmte Argumente in dieser Klasse sind nicht miteinander kompatibel und verursachen einen Fehler, wenn sie an TeleportService:TeleportAsync() übergeben werden:

  • ReservedServerzugriffscode + ServerInstanceId
  • ShouldReserveServer + ServerInstanceId
  • ShouldReserveServer + ReservedServerzugriffscode

Für weitere Informationen darüber, wie Spieler zwischen Servern teleportiert werden, siehe Teleportieren zwischen Orten.

Zusammenfassung

Eigenschaften

Methoden

Eigenschaften

ReservedServerAccessCode

Parallel lesen

Dieses Eigenschaft zeigt den reservierten Serverzugriffscode für den reservierten Server an, zu dem die Benutzer teleportiert werden sollten.

Für weitere Informationen darüber, wie Spieler zwischen Servern teleportiert werden, siehe Teleportieren zwischen Orten.

ServerInstanceId

Parallel lesen

Diese Eigenschaft zeigt die DataModel.JobId des Ser버instanz an, zu der der Benutzer teleportiert werden sollte.

Für weitere Informationen darüber, wie Spieler zwischen Servern teleportiert werden, siehe Teleportieren zwischen Orten.

ShouldReserveServer

Parallel lesen

Diese Eigenschaft zeigt an, ob der Teleportanruf einen neuen reservierten Server erstellen soll.Wenn auf wahr gesetzt, wird ein reservierter Server erstellt und die Spieler:in(innen) werden auf den neuen Server teleportiert.

Wenn auf false gesetzt, werden der Spieler:in(e) auf den öffentlichen Server mit dem angegebenen TeleportOptions.ServerInstanceId teleportiert, wenn es bereitgestellt wird.Wenn TeleportOptions.ServerInstanceId leer ist oder kein passender Server gefunden wird, wird ein neuer öffentlicher Server erstellt, um den Spieler:in(n) zu teleportieren.

Für weitere Informationen darüber, wie Spieler zwischen Servern teleportiert werden, siehe Teleportieren zwischen Orten.

Methoden

GetTeleportData

Variant

Diese Funktion gibt die Teleportdaten zurück, die in der TeleportOptions Instanz gespeichert sind, durch TeleportOptions:SetTeleportData() .

Sobald ein Spieler teleportiert wurde, können Teleportdaten mit den Funktionen Player:GetJoinData() und TeleportService:GetLocalPlayerTeleportData() abgerufen werden.

Für weitere Informationen darüber, wie Spieler zwischen Servern teleportiert werden, siehe Teleportieren zwischen Orten.


Rückgaben

Variant

SetTeleportData

()

Dies ist eine Setter-Funktion für Daten, die an den Ortübergeben werden sollen.Am Ortkann diese Daten mit Player:GetJoinData() oder TeleportService:GetLocalPlayerTeleportData() abgerufen werden.

Zum Beispiel würde das folgende Snippet die DataModel.PlaceId und DataModel.JobId in einem Wörterbuch senden, das die Teleportdaten in einer TeleportOptions Instanz verwendet, indem es TeleportOptions:SetTeleportData() verwendet:


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

Diese Daten könnten dann bei der Ankunft mit der Funktion GetLocalPlayerTeleportData() wie folgt abgerufen werden:


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

Wenn in der Teleportationsfunktion keine teleportData festgelegt wurde, wird diese GetLocalPlayerTeleportData() nil zurückgeben.

Für weitere Informationen darüber, wie Benutzerdaten zusammen mit Teleports gesendet und empfangen werden, siehe Teleportieren zwischen Orten.

Parameter

teleportData: Variant

Daten, die an den Ortübermittelt werden.

Standardwert: ""

Rückgaben

()

Ereignisse