TeleportOptions
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
Klasa ta jest opcjonalnym parametrem funkcji TeleportService:TeleportAsync(), która pozwala programistom dostarczyć argumenty dla wezwania teleportacyjnego.
Niektóre argumenty w tej klasie nie są ze sobą kompatybilne i powodują błąd, gdy są przekazywane do TeleportService:TeleportAsync() :
- Zarezerwowany kod dostępu do serwera + ID serwera
- Powinien zarezerwować server + ServerInstanceId
- ShouldReserveServer + Rezerwowany kod dostępu do serwera
Aby uzyskać więcej informacji o tym, jak teleportować graczy między serwerami, zobacz Teleportowanie między miejscami.
Podsumowanie
Właściwości
Zarezerwowany kod dostępu do serwera, który wskazuje rezerwowany serwer, do którego ma nastąpić teleportacja.
The DataModel.JobId z instancji serwera do teleportacji
Flaga wskazująca, czy należy przydzielić rezerwowany serwer i czy gracze powinni zostać teleportowani do tej rezerwacji.
Metody
Zwraca dane teleportacyjne przechowywane w instancji TeleportOptions przez TeleportOptions:SetTeleportData() .
Funkcja ustawienia dla danych, które mają być przekazane do miejscedocelowego.
Właściwości
ReservedServerAccessCode
Ta właściwość wskazuje kod dostępu do rezerwowanego serwera dla rezerwowanego serwera, do którego użytkownicy powinni zostać przeteleportowani.
Aby uzyskać więcej informacji o tym, jak teleportować graczy między serwerami, zobacz Teleportowanie między miejscami.
ServerInstanceId
Właściwość ta wskazuje na DataModel.JobId instancję serwera, do której użytkownicy powinni zostać przeniesieni.
Aby uzyskać więcej informacji o tym, jak teleportować graczy między serwerami, zobacz Teleportowanie między miejscami.
ShouldReserveServer
Właściwość ta wskazuje, czy wezwanie teleportacyjne powinno utworzyć nowy zarezerwowany serwer.Gdy ustawiono na prawdę, zostanie utworzony rezerwowany serwer, a gracz(owie) zostaną przeniesieni na nowy serwer.
Jeśli ustawiono na fałsz, gracz(owie) zostaną przeteleportowani na publiczny serwer z określonym TeleportOptions.ServerInstanceId jeśli podano.Gdy TeleportOptions.ServerInstanceId jest pusty lub nie znaleziono odpowiedniego serwera, zostanie utworzony nowy publiczny serwer, aby przeteleportować gracza (ów).
Aby uzyskać więcej informacji o tym, jak teleportować graczy między serwerami, zobacz Teleportowanie między miejscami.
Metody
GetTeleportData
Funkcja ta zwraca dane teleportacyjne przechowywane w instancji TeleportOptions przez TeleportOptions:SetTeleportData().
Gdy gracz się teleportuje, dane o teleportacji można odzyskać za pomocą funkcji Player:GetJoinData() i TeleportService:GetLocalPlayerTeleportData().
Aby uzyskać więcej informacji o tym, jak teleportować graczy między serwerami, zobacz Teleportowanie między miejscami.
Zwroty
SetTeleportData
To jest funkcja ustawienia dla danych, które mają być przekazane do miejscedocelowego.Na miejscedocelowym dane te można odzyskać za pomocą Player:GetJoinData() lub TeleportService:GetLocalPlayerTeleportData().
Na przykład następujący kod wysłałby DataModel.PlaceId i DataModel.JobId w słowniku przekazującym dane teleportacyjne w instancji TeleportOptions za pomocą TeleportOptions:SetTeleportData() :
-- Serwerlocal teleportOptions = Instance.new("TeleportOptions")local teleportData = {placeId = game.PlaceId,jobId = game.JobId}teleportOptions:SetTeleportData(teleportData)TeleportService:TeleportAsync(game.PlaceId, {player}, teleportOptions)
Dane te można następnie odzyskać po przybyciu za pomocą funkcji GetLocalPlayerTeleportData() w następujący sposób:
-- Kliencilocal TeleportService = game:GetService("TeleportService")local teleportData = TeleportService:GetLocalPlayerTeleportData()if teleportData thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
Jeśli nie ustawiono teleportData w funkcji teleportacji, ta GetLocalPlayerTeleportData() zwróci nil .
Aby uzyskać więcej informacji o tym, jak wysyłać i odbierać dane użytkownika wraz z teleportami, zobacz Teleportowanie między miejscami.
Parametry
Dane, które mają być przekazane do miejscedocelowego.