텔레포트 연동

SubPlace 텔레포트 시 PlayWave 인증을 유지하는 방법

​

배경

로비(Lobby) Place에서 SubPlace로 텔레포트하는 구조의 Experience에서는 TeleportService를 통한 이동 시 PlayWave 인증이 끊어집니다. 텔레포트 연동을 적용하면 TeleportOptions를 통해 세션 데이터를 전달하여 SubPlace에서도 인증을 유지할 수 있습니다.

텔레포트 연동을 적용하지 않으면 SubPlace 이동 후 과금이 적용되지 않아 수익 손실이 발생할 수 있습니다.

​

사전 준비

1. 최신 플러그인 설치

   Toolbox에서 최신 버전의 PlayWave 플러그인을 설치합니다.

   Install SDK 클릭 시 기존 콜백 함수 스크립트(PlayWaveSetup, PlayWaveClient)가 초기화됩니다. 반드시 기존 코드를 백업한 후 진행하세요.

2. 각 Place에 SDK 설치

   텔레포트 대상이 되는 모든 SubPlace에도 PlayWave SDK를 설치해야 합니다. 각 Place에서 플러그인의 Install SDK를 실행하세요.

​

텔레포트 코드 수정

기존 텔레포트 로직에서 TeleportOptions를 생성한 뒤, PlayWaveServer.prepareForTeleport를 호출하여 세션 데이터를 주입합니다.

-- ServerScriptService/TeleportHandler (Script Example)
local Players = game:GetService("Players")
local TeleportService = game:GetService("TeleportService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SUB_PLACE_ID = 130143450994652

local PlayWaveServer = require(
    game:GetService("ServerScriptService")
        :WaitForChild("PlayWaveSetup")
        :WaitForChild("PlayWaveServer")
)

local teleportEvent = Instance.new("RemoteEvent")
teleportEvent.Name = "RequestTeleport"
teleportEvent.Parent = ReplicatedStorage

teleportEvent.OnServerEvent:Connect(function(player)
    local teleportOptions = Instance.new("TeleportOptions")
    PlayWaveServer.prepareForTeleport(player, teleportOptions)
    TeleportService:TeleportAsync(SUB_PLACE_ID, {player}, teleportOptions)
end)

​

핵심 포인트

항목	설명
prepareForTeleport	PlayWave 세션 데이터를 TeleportOptions에 주입합니다
SubPlace SDK 설치	각 SubPlace에서 세션 데이터를 수신하려면 SDK가 필요합니다
기존 콜백 유지	SDK 재설치 후 onPcCafe 콜백을 다시 작성해야 합니다

​

적용 체크리스트

​

다음 단계

빠른 시작

플러그인 설치부터 기본 연동까지 전체 과정을 확인합니다.

세션 라이프사이클

세션, 하트비트, 종료가 어떻게 동작하는지 이해합니다.