이 클래스는 개발자가 순간 이동 호출에 대한 인수를 제공할 수 있도록 하는 TeleportService:TeleportAsync() 함수의 선택적 매개변수입니다.
이 클래스의 일부 인수가 서로 호환되지 않아 TeleportService:TeleportAsync()로 전달되면 오류가 발생합니다.
- 예약된 서버 액세스 코드 + 서버 인스턴스 ID
- ShouldReserveServer + ServerInstanceId
- ReserveServer + ReservedServerAccessCode 예약해야 합니다
서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.
요약
속성
순간이동할 예약된 서버를 나타내는 예약된 서버 액세스 코드. The reserved server access code that indicates the reserved server that the teleport should be to.
순간이동할 서버 인스턴스의 DataModel.JobId
예약된 서버가 할당되어야 하고 플레이어가 이 할당으로 순간이동해야 하는지를 나타내는 플래그입니다.
메서드
인스턴스에 저장된 순간이동 데이터를 로 반환합니다.
대상 플레이스전달할 데이터에 대한 설정 함수.
속성
ReservedServerAccessCode
이 속성은 사용자(들)가 순간이동해야 하는 예약된 서버의 예약된 서버 액세스 코드를 나타냅니다.
서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.
ServerInstanceId
이 속성은 사용자(들)가 순간이동해야 하는 서버 인스턴스의 DataModel.JobId를 나타냅니다.
서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.
ShouldReserveServer
이 속성은 순간이동 호출이 새로운 예약된 서버를 만들어야 하는지 여부를 나타냅니다.참으로 설정되면 예약된 서버가 생성되고 플레이어(들)가 새 서버로 순간이동됩니다.
거짓으로 설정하면 플레이어(들)가 제공된 경우 TeleportOptions.ServerInstanceId 지정된 공용 서버로 순간이동됩니다.TeleportOptions.ServerInstanceId 가 비어 있거나 일치하는 서버가 없을 때, 플레이어(들)를 순간이동하기 위해 새로운 공용 서버가 생성됩니다.
서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.
메서드
GetTeleportData
이 함수는 전송 데이터를 반환하여 TeleportOptions 인스턴스에 저장된 전송 데이터를 TeleportOptions:SetTeleportData()에 의해 반환합니다.
플레이어가 순간이동한 후에는 Player:GetJoinData() 및 TeleportService:GetLocalPlayerTeleportData() 함수를 사용하여 순간이동 데이터를 검색할 수 있습니다.
서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.
반환
SetTeleportData
이는 대상 플레이스전달할 데이터의 설정 함수입니다.플레이스Player:GetJoinData() 또는 TeleportService:GetLocalPlayerTeleportData()를 사용하여 이 데이터를 검색할 수 있습니다.
예를 들어 다음 스니펫은 텔레포트 데이터를 전달하는 및 인스턴스에서 사용하는 을 사전에 보낼 것입니다:
-- 서버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 가 없으면 이 GetLocalPlayerTeleportData()는 nil로 반환됩니다.
순간이동과 함께 사용자 데이터를 보내고 받는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.
매개 변수
대상 플레이스전달할 데이터.