TeleportService | 설명서 - Roblox 크리에이터 허브

엔진 클래스

TeleportService

만들 수 없음

서비스

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

요약

속성

CustomizedTeleportUI:boolean

사용되지 않음

메서드

GetArrivingTeleportGui():Instance

GetLocalPlayerTeleportData():Variant

GetPlayerPlaceInstanceAsync(userId: User):Tuple

GetTeleportSetting(setting: string):Variant

PromptExperienceDetailsAsync(player: Player,universeId: number):Enum.PromptExperienceDetailsResult

ReserveServer(placeId: number):Tuple

사용되지 않음

ReserveServerAsync(placeId: number):Tuple

SetTeleportGui(gui: Instance):()

SetTeleportSetting(setting: string,value: Variant):()

Teleport(placeId: number,player: Instance,teleportData: Variant,customLoadingScreen: Instance):()

TeleportAsync(placeId: number,players: Instances,teleportOptions: Instance):Instance

TeleportPartyAsync(placeId: number,players: Instances,teleportData: Variant,customLoadingScreen: Instance):string

TeleportToPlaceInstance(placeId: number,instanceId: string,player: Instance,spawnName: string,teleportData: Variant,customLoadingScreen: Instance):()

TeleportToPrivateServer(placeId: number,reservedServerAccessCode: string,players: Instances,spawnName: string,teleportData: Variant,customLoadingScreen: Instance):()

TeleportToSpawnByName(placeId: number,spawnName: string,player: Instance,teleportData: Variant,customLoadingScreen: Instance):()

이벤트

LocalPlayerArrivedFromTeleport(loadingGui: Instance,dataTable: Variant):RBXScriptSignal

TeleportInitFailed(player: Instance,teleportResult: Enum.TeleportResult,errorMessage: string,placeId: number,teleportOptions: Instance):RBXScriptSignal

상속된 멤버

API 참조

속성

CustomizedTeleportUI

사용되지 않음

메서드

GetArrivingTeleportGui

기능: UI, Teleport

TeleportService:GetArrivingTeleportGui():Instance

반환

Instance

코드 샘플

텔레포트 로딩 GUI 처리

local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")
local ReplicatedFirst = game:GetService("ReplicatedFirst")

local customLoadingScreen = TeleportService:GetArrivingTeleportGui()
if customLoadingScreen then
	local playerGui = Players.LocalPlayer:WaitForChild("PlayerGui")
	ReplicatedFirst:RemoveDefaultLoadingScreen()
	customLoadingScreen.Parent = playerGui
	task.wait(5)
	customLoadingScreen:Destroy()
end

GetLocalPlayerTeleportData

기능: Teleport

TeleportService:GetLocalPlayerTeleportData():Variant

반환

Variant

코드 샘플

로컬 플레이어 텔레포트 데이터 가져오기

local TeleportService = game:GetService("TeleportService")

local teleportData = TeleportService:GetLocalPlayerTeleportData()

print("로컬 플레이어가 이 데이터로 도착했습니다:", teleportData)

GetPlayerPlaceInstanceAsync

생성

기능: Teleport

TeleportService:GetPlayerPlaceInstanceAsync(userId:User):Tuple

매개 변수

userId:User

반환

Tuple

코드 샘플

다른 플레이어 따라가기

local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")

Players.PlayerAdded:Connect(function(player)
	local followId = player.FollowUserId

	if followId and followId ~= 0 then
		-- 이 플레이어는 다른 사람을 팔로우하고 있습니까? 그렇다면, 그들이 어디에 있는지 찾아보세요.
		local success, currentInstance, error, placeId, jobIdOrErr = pcall(function()
			return TeleportService:GetPlayerPlaceInstanceAsync(followId)
		end)
			-- followId는 당신이 장소와 직업 ID를 검색하고자 하는 플레이어의 사용자 ID입니다.
		if success then
			-- 성공 시 jobId에 따라 플레이어를 텔레포트합니다.
			TeleportService:TeleportToPlaceInstance(placeId, jobIdOrErr, player)
		else
			-- 반환된 오류에 따라 경고를 게시합니다.
			warn(jobIdOrErr)
		end
	else
		warn(("플레이어 %d는 다른 플레이어를 팔로우하고 있지 않습니다!"):format(player.UserId))
	end
end)

GetTeleportSetting

기능: Teleport

TeleportService:GetTeleportSetting(setting:string):Variant

매개 변수

setting:string

반환

Variant

PromptExperienceDetailsAsync

생성

기능: Teleport

TeleportService:PromptExperienceDetailsAsync(

player:Player, universeId:number

):Enum.PromptExperienceDetailsResult

매개 변수

player:Player

universeId:number

반환

Enum.PromptExperienceDetailsResult

코드 샘플

플레이어에게 경험 세부정보 표시

local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

local success, result = pcall(function()
	TeleportService:PromptExperienceDetailsAsync(player, 8357232245)
end)
if not success then
	warn("경험 세부정보 요청 중 오류: " .. tostring(result))
end

if result == Enum.PromptExperienceDetailsResult.PromptClosed then
	print("플레이어가 경험 세부정보 프롬프트를 닫았습니다")
elseif result == Enum.PromptExperienceDetailsResult.TeleportAttempted then
	print("플레이어가 경험으로 텔레포트를 선택했습니다")
end

ReserveServer

사용되지 않음

ReserveServerAsync

생성

기능: Teleport

TeleportService:ReserveServerAsync(placeId:number):Tuple

매개 변수

placeId:number

반환

Tuple

코드 샘플

텔레포트 서비스: 예약된 서버로 이동

local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")

local code = TeleportService:ReserveServerAsync(game.PlaceId)

local players = Players:GetPlayers()

TeleportService:TeleportToPrivateServer(game.PlaceId, code, players)
-- 이 함수에 추가 인수를 추가할 수 있습니다: spawnName, teleportData 및 customLoadingScreen

TeleportService: 채팅을 통해 예약된 서버로 텔레포트

local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

local dataStore = DataStoreService:GetGlobalDataStore()

-- 저장된 코드를 가져옵니다
local code = dataStore:GetAsync("ReservedServer")
if typeof(code) ~= "string" then -- 저장된 것이 없습니다, 하나 생성합니다
	code = TeleportService:ReserveServerAsync(game.PlaceId)
	dataStore:SetAsync("ReservedServer", code)
end

local function joined(player)
	player.Chatted:Connect(function(message)
		if message == "reserved" then
			TeleportService:TeleportToPrivateServer(game.PlaceId, code, { player })
		end
	end)
end

Players.PlayerAdded:Connect(joined)

SetTeleportGui

기능: UI, Teleport

TeleportService:SetTeleportGui(gui:Instance):()

매개 변수

gui:Instance

반환

()

코드 샘플

로컬 플레이어 텔레포트

local TeleportService = game:GetService("TeleportService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")

local playerGui = Players.LocalPlayer:WaitForChild("PlayerGui")

local PLACE_ID = 0 -- 여기를 교체하세요
local loadingGui = ReplicatedStorage:FindFirstChild("LoadingGui")

-- 이 장소의 로딩 GUI를 부모로 설정합니다
loadingGui.Parent = playerGui

-- 목적지 장소의 로딩 GUI를 설정합니다
TeleportService:SetTeleportGui(loadingGui)

TeleportService:Teleport(PLACE_ID)

SetTeleportSetting

기능: Teleport

TeleportService:SetTeleportSetting(

setting:string, value:Variant

):()

매개 변수

setting:string

value:Variant

반환

()

Teleport

기능: UI, Teleport

TeleportService:Teleport(

placeId:number, player:Instance, teleportData:Variant, customLoadingScreen:Instance

):()

매개 변수

placeId:number

player:Instance

기본값: "nil"

teleportData:Variant

customLoadingScreen:Instance

기본값: "nil"

반환

()

코드 샘플

로컬 플레이어 텔레포트

local TeleportService = game:GetService("TeleportService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")

local playerGui = Players.LocalPlayer:WaitForChild("PlayerGui")

local PLACE_ID = 0 -- 여기를 교체하세요
local loadingGui = ReplicatedStorage:FindFirstChild("LoadingGui")

-- 이 장소의 로딩 GUI를 부모로 설정합니다
loadingGui.Parent = playerGui

-- 목적지 장소의 로딩 GUI를 설정합니다
TeleportService:SetTeleportGui(loadingGui)

TeleportService:Teleport(PLACE_ID)

서버에서 텔레포트하기

local Players = game:GetService("Players")
local TeleportService = game:GetService("TeleportService")

local PLACE_ID = 0 -- 여기 교체
local USER_ID = 1 -- 플레이어의 UserId로 교체

local player = Players:GetPlayerByUserId(USER_ID)

TeleportService:Teleport(PLACE_ID, player)

TeleportAsync

생성

기능: UI, Teleport

TeleportService:TeleportAsync(

placeId:number, players:Instances, teleportOptions:Instance

):Instance

매개 변수

placeId:number

players:Instances

teleportOptions:Instance

기본값: "nil"

반환

Instance

TeleportPartyAsync

생성

기능: UI, Teleport

TeleportService:TeleportPartyAsync(

placeId:number, players:Instances, teleportData:Variant, customLoadingScreen:Instance

):string

매개 변수

placeId:number

players:Instances

teleportData:Variant

customLoadingScreen:Instance

기본값: "nil"

반환

string

코드 샘플

서버의 모든 플레이어 텔레포트

local Players = game:GetService("Players")
local TeleportService = game:GetService("TeleportService")

local PLACE_ID = 0 -- 교체
local playerList = Players:GetPlayers()

local success, result = pcall(function()
	return TeleportService:TeleportPartyAsync(PLACE_ID, playerList)
end)

if success then
	local jobId = result
	print("플레이어가 텔레포트되었습니다", jobId)
else
	warn(result)
end

TeleportToPlaceInstance

기능: UI, Teleport

TeleportService:TeleportToPlaceInstance(

placeId:number, instanceId:string, player:Instance, spawnName:string, teleportData:Variant, customLoadingScreen:Instance

):()

매개 변수

placeId:number

instanceId:string

player:Instance

기본값: "nil"

spawnName:string

teleportData:Variant

customLoadingScreen:Instance

기본값: "nil"

반환

()

코드 샘플

다른 플레이어 따라가기

local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")

Players.PlayerAdded:Connect(function(player)
	local followId = player.FollowUserId

	if followId and followId ~= 0 then
		-- 이 플레이어는 다른 사람을 팔로우하고 있습니까? 그렇다면, 그들이 어디에 있는지 찾아보세요.
		local success, currentInstance, error, placeId, jobIdOrErr = pcall(function()
			return TeleportService:GetPlayerPlaceInstanceAsync(followId)
		end)
			-- followId는 당신이 장소와 직업 ID를 검색하고자 하는 플레이어의 사용자 ID입니다.
		if success then
			-- 성공 시 jobId에 따라 플레이어를 텔레포트합니다.
			TeleportService:TeleportToPlaceInstance(placeId, jobIdOrErr, player)
		else
			-- 반환된 오류에 따라 경고를 게시합니다.
			warn(jobIdOrErr)
		end
	else
		warn(("플레이어 %d는 다른 플레이어를 팔로우하고 있지 않습니다!"):format(player.UserId))
	end
end)

TeleportToPrivateServer

기능: UI, Teleport

TeleportService:TeleportToPrivateServer(

placeId:number, reservedServerAccessCode:string, players:Instances, spawnName:string, teleportData:Variant, customLoadingScreen:Instance

):()

매개 변수

placeId:number

reservedServerAccessCode:string

players:Instances

spawnName:string

teleportData:Variant

customLoadingScreen:Instance

기본값: "nil"

반환

()

코드 샘플

TeleportService: 채팅을 통해 예약된 서버로 텔레포트

local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

local dataStore = DataStoreService:GetGlobalDataStore()

-- 저장된 코드를 가져옵니다
local code = dataStore:GetAsync("ReservedServer")
if typeof(code) ~= "string" then -- 저장된 것이 없습니다, 하나 생성합니다
	code = TeleportService:ReserveServerAsync(game.PlaceId)
	dataStore:SetAsync("ReservedServer", code)
end

local function joined(player)
	player.Chatted:Connect(function(message)
		if message == "reserved" then
			TeleportService:TeleportToPrivateServer(game.PlaceId, code, { player })
		end
	end)
end

Players.PlayerAdded:Connect(joined)

텔레포트 서비스: 예약된 서버로 이동

local TeleportService = game:GetService("TeleportService")
local Players = game:GetService("Players")

local code = TeleportService:ReserveServerAsync(game.PlaceId)

local players = Players:GetPlayers()

TeleportService:TeleportToPrivateServer(game.PlaceId, code, players)
-- 이 함수에 추가 인수를 추가할 수 있습니다: spawnName, teleportData 및 customLoadingScreen

TeleportToSpawnByName

기능: UI, Teleport

TeleportService:TeleportToSpawnByName(

placeId:number, spawnName:string, player:Instance, teleportData:Variant, customLoadingScreen:Instance

):()

매개 변수

placeId:number

spawnName:string

player:Instance

기본값: "nil"

teleportData:Variant

customLoadingScreen:Instance

기본값: "nil"

반환

()

코드 샘플

텔레포트서비스: 이름으로 스폰 위치로 텔레포트

local TeleportService = game:GetService("TeleportService")

-- 플레이어를 스폰 위치로 텔레포트합니다.
TeleportService:TeleportToSpawnByName(1818, "TeleportSpawn")

이벤트

LocalPlayerArrivedFromTeleport

기능: Teleport

TeleportService.LocalPlayerArrivedFromTeleport(

loadingGui:Instance, dataTable:Variant

):RBXScriptSignal

매개 변수

loadingGui:Instance

dataTable:Variant

TeleportInitFailed

기능: Teleport

TeleportService.TeleportInitFailed(

player:Instance, teleportResult:Enum.TeleportResult, errorMessage:string, placeId:number, teleportOptions:Instance

):RBXScriptSignal

매개 변수

player:Instance

teleportResult:Enum.TeleportResult

errorMessage:string

placeId:number

teleportOptions:Instance