TeleportOptions

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

이 클래스는 개발자가 순간 이동 호출에 대한 인수를 제공할 수 있도록 하는 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

  • 예약된 서버가 할당되어야 하고 플레이어가 이 할당으로 순간이동해야 하는지를 나타내는 플래그입니다.

메서드

  • GetTeleportData():Variant

    인스턴스에 저장된 순간이동 데이터를 로 반환합니다.

  • SetTeleportData(teleportData : Variant):()

    대상 플레이스전달할 데이터에 대한 설정 함수.

속성

ReservedServerAccessCode

병렬 읽기

이 속성은 사용자(들)가 순간이동해야 하는 예약된 서버의 예약된 서버 액세스 코드를 나타냅니다.

서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.

ServerInstanceId

병렬 읽기

이 속성은 사용자(들)가 순간이동해야 하는 서버 인스턴스의 DataModel.JobId를 나타냅니다.

서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.

ShouldReserveServer

병렬 읽기

이 속성은 순간이동 호출이 새로운 예약된 서버를 만들어야 하는지 여부를 나타냅니다.참으로 설정되면 예약된 서버가 생성되고 플레이어(들)가 새 서버로 순간이동됩니다.

거짓으로 설정하면 플레이어(들)가 제공된 경우 TeleportOptions.ServerInstanceId 지정된 공용 서버로 순간이동됩니다.TeleportOptions.ServerInstanceId 가 비어 있거나 일치하는 서버가 없을 때, 플레이어(들)를 순간이동하기 위해 새로운 공용 서버가 생성됩니다.

서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.

메서드

GetTeleportData

Variant

이 함수는 전송 데이터를 반환하여 TeleportOptions 인스턴스에 저장된 전송 데이터를 TeleportOptions:SetTeleportData()에 의해 반환합니다.

플레이어가 순간이동한 후에는 Player:GetJoinData()TeleportService:GetLocalPlayerTeleportData() 함수를 사용하여 순간이동 데이터를 검색할 수 있습니다.

서버 간에 플레이어를 순간이동하는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.


반환

Variant

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 then
local placeId = teleportData.placeId
local jobId = teleportData.JobId
end

순간이동 함수에 설정된 teleportData 가 없으면 이 GetLocalPlayerTeleportData()는 nil로 반환됩니다.

순간이동과 함께 사용자 데이터를 보내고 받는 방법에 대한 자세한 정보는 장소 간 순간이동을 참조하십시오.

매개 변수

teleportData: Variant

대상 플레이스전달할 데이터.

기본값: ""

반환

()

이벤트