런타임 통합

런타임 통합의 공개 facade는 Game Instance Subsystem인 UPlanetXSubsystem입니다. World별 registry와 서비스는 내부 구현이며 gameplay 코드는 facade와 공개 Component를 사용합니다.

#Planet 등록

APlanetXPlanetActor에는 Planet, Proxy, Transition Morph, Atmosphere, Volumetric Cloud Component가 기본으로 포함됩니다. Planet Component에 Planet Asset을 지정하고 bAutoRegisterRuntime을 사용하거나 RegisterToPlanetXRuntime을 호출합니다.

같은 Planet ID를 가진 Actor가 여러 개면 Planet Binding ID를 저장하고 query에 전달하세요. 단일 인스턴스만 가정한 자동 resolve는 여러 Actor 환경에서 모호할 수 있습니다.

#참가 Actor

필요에 따라 다음 Component를 추가합니다.

• Coordinate: Planet/Section reference, 표준 pose, vector 변환, Spatial Entry policy
• Movement: planet gravity, input/force/impulse, surface snap과 alignment
• Viewpoint: transition 관찰 기준
• Travel Receiver: Level Handoff 도착 후 pending travel 재개
• Transition Endpoint: Section 진입/이탈 조건과 presentation

#Begin Play 순서

Planet Actor가 먼저 등록되고 참가 Actor가 runtime context를 resolve할 수 있어야 합니다. Streaming으로 순서가 늦어질 수 있으면 RefreshRuntimeRegistration, RefreshRuntimeContext 또는 Travel Receiver의 retry 정책을 사용합니다.

#Package 전 확인

Planet Asset Full Validate, current Proxy Bake, current Generated Visual/Material, Runtime Preview World와 Cook asset bundle을 확인합니다. Editor Preview가 보인다는 사실만으로 runtime payload가 Cook됐다고 판단하지 마세요.