이 클래스는 개발자가 순간이동 호출에 대한 인수를 제공하는 Class.TeleportService:TeleportAsync() 함수에 옵션 매개 변수입니다.
이 클래스의 특정 인수는 서로 호환되지 않으며 TeleportService:TeleportAsync() :
- ReservedServerAccessCode + ServerInstanceId
- ShouldReserveServer + ServerInstanceId
- ShouldReserveServer + reservedServerAccessCode
플레이어를 서버 간에 순간이동하는 방법에 대한 자세한 내용은 장소 간 순간이동을 참조하십시오.
요약
속성
순간이동할 예정 서버를 가리키는 예약된 서버 액세스 코드입니다.
서버 인스턴스로 순간이동할 서버 클래스 모델.
예약된 서버가 할당되어야 하고 플레이어가 이 할당으로 순간이동해야 하는지 여부를 나타내는 플래그입니다.
메서드
Class.TeleportOptions 인스턴스에 저장된 순간 이동 데이터를 TeleportOptions:SetTeleportData() 으로 반환합니다.
대상 플레이스데이터를 전송하는 설정 기능 집합.
속성
ReservedServerAccessCode
이 속성은 사용자(들)가 순간이동할 예약 서버에 대한 예약 서버 액세스 코드를 나타냅니다.This property indicates the reserved server access code for the reserved server that the user(s) should be teleported to.
플레이어를 서버 간에 순간이동하는 방법에 대한 자세한 내용은 장소 간 순간이동을 참조하십시오.
ServerInstanceId
이 속성은 사용자(들)가 순간이동할 서버 인스턴스의 DataModel.JobId를 나타냅니다.
플레이어를 서버 간에 순간이동하는 방법에 대한 자세한 내용은 장소 간 순간이동을 참조하십시오.
ShouldReserveServer
이 속성은 순간이동 호출이 새로운 예약된 서버를 생성해야 하는지 여부를 나타냅니다. 이 속성을 "예"로 설정하면 예약된 서버가 생성되고 플레이어가 새로운 서버로 순간이동됩니다.
설정을 거절하면 플레이어(s)는 지정된 TeleportOptions.ServerInstanceId 가 있는 공개 서버로 순간이동됩니다. 공개 서버가 비어 있거나 일치하는 서버가 없으면 새로운 공개 서버가 생성되어 플레이어(s)를 순간이동합니다.
플레이어를 서버 간에 순간이동하는 방법에 대한 자세한 내용은 장소 간 순간이동을 참조하십시오.
메서드
GetTeleportData
이 함수는 TeleportOptions 인스턴스에 저장된 순간 이동 데이터를 TeleportOptions:SetTeleportData() 으로 반환합니다.
플레이어가 순간이동하면 Player:GetJoinData() 및 TeleportService:GetLocalPlayerTeleportData() 함수를 사용하여 순간이동 데이터를 검색할 수 있습니다.
플레이어를 서버 간에 순간이동하는 방법에 대한 자세한 내용은 장소 간 순간이동을 참조하십시오.
반환
SetTeleportData
이 함수는 데이터를 목적지 플레이스패스하는 데 사용됩니다. 목적지 플레이스이 데이터는 Player:GetJoinData() 또는 TeleportService:GetLocalPlayerTeleportData()를 사용하여 검색할 수 있습니다.
예를 들어, 다음 스냅 코드는 DataModel.PlaceId 및 DataModel.JobId를 사전에 통과하는 디클러버 인스턴스에서 순위를 매기는 데 사용됩니다. TeleportOptions 인스턴스에서 순위를 매기는 데 사용됩니다. 2>Class.TeleportOptions:SetTeleportData()</
-- 서버local teleportOptions = Instance.new("TeleportOptions")local teleportData = {placeId = game.PlaceId,jobId = game.JobId}teleportOptions:SetTeleportData(teleportData)TeleportService:TeleportAsync(game.PlaceId, {player}, teleportOptions)
이 데이터는 다음과 같이 GetLocalPlayerTeleportData() 함수를 사용하여 도착 시 검색할 수 있습니다.
-- 클라이언트local TeleportService = game:GetService("TeleportService")local teleportData = TeleportService:GetLocalPlayerTeleportData()if teleportData thenlocal placeId = teleportData.placeIdlocal jobId = teleportData.JobIdend
텔레포트 함수에 teleportData 가 설정되지 않으면 이 메서드는 nil 을 반환합니다.
사용자 데이터를 텔레포트와 함께 보내고 받는 방법에 대한 자세한 내용은 자리 간 텔레포트를 참조하십시오.
매개 변수
대상 플레이스전달할 데이터.