TeleportOptions
*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
Der reservierte Serverzugriffscode, der den reservierten Server anzeigt, zu dem sich die Teleportation richten soll.
Das DataModel.JobId der Serverinstanz, zu der teleportiert werden soll.
Eine Flagge, um anzugeben, ob ein reservierter Server zugewiesen werden soll und die Spieler dann zu dieser Zuweisung teleportiert werden sollen.
Methoden
Gibt die Teleportdaten, die in der TeleportOptions Instanz gespeichert sind, durch TeleportOptions:SetTeleportData() zurück.
Setter-Funktion für Daten, die an den Ortübergeben werden sollen.
Eigenschaften
ReservedServerAccessCode
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
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
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
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
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:
-- Serverlocal 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:
-- Clientlocal TeleportService = game:GetService("TeleportService")local teleportData = TeleportService:GetLocalPlayerTeleportData()if teleportData thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
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
Daten, die an den Ortübermittelt werden.