TeleportOptions

사용되지 않는 항목 표시

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

이 클래스는 개발자가 순간이동 호출에 대한 인수를 제공하는 Class.TeleportService:TeleportAsync() 함수에 옵션 매개 변수입니다.

이 클래스의 특정 인수는 서로 호환되지 않으며 TeleportService:TeleportAsync() :

  • ReservedServerAccessCode + ServerInstanceId
  • ShouldReserveServer + ServerInstanceId
  • ShouldReserveServer + reservedServerAccessCode

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

요약

속성

  • 순간이동할 예정 서버를 가리키는 예약된 서버 액세스 코드입니다.

  • 서버 인스턴스로 순간이동할 서버 클래스 모델.

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

메서드

속성

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

Variant

이 함수는 TeleportOptions 인스턴스에 저장된 순간 이동 데이터를 TeleportOptions:SetTeleportData() 으로 반환합니다.

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

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


반환

Variant

SetTeleportData

void

이 함수는 데이터를 목적지 플레이스패스하는 데 사용됩니다. 목적지 플레이스이 데이터는 Player:GetJoinData() 또는 TeleportService:GetLocalPlayerTeleportData()를 사용하여 검색할 수 있습니다.

예를 들어, 다음 스냅 코드는 DataModel.PlaceIdDataModel.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 then
local placeId = teleportData.placeId
local jobId = teleportData.JobId
end

텔레포트 함수에 teleportData 가 설정되지 않으면 이 메서드는 nil 을 반환합니다.

사용자 데이터를 텔레포트와 함께 보내고 받는 방법에 대한 자세한 내용은 자리 간 텔레포트를 참조하십시오.

매개 변수

teleportData: Variant

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


반환

void

이벤트