TeleportOptions

Pokaż przestarzałe

*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

Metody

Właściwości

ReservedServerAccessCode

Odczyt równoległy

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

Odczyt równoległy

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

Odczyt równoległy

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

Variant

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

Variant

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


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


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

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

teleportData: Variant

Dane, które mają być przekazane do miejscedocelowego.

Wartość domyślna: ""

Zwroty

()

Zdarzenia