VIVEN SDK
빠른 시작하기
Unity 하나로 월드와 오브젝트를 저작하는 첫 걸음. 5분이면 첫 VIVEN 월드를 실행할 수 있습니다.
SDK 다운로드
VIVEN SDK 는 Unity Package Manager 의 git URL 방식으로 설치합니다. 별도 다운로드 없이 바로 추가할 수 있고, 업데이트도 Package Manager 에서 관리됩니다.
Unity 프로젝트 설정
Unity Hub 에서 새 Universal 3D (URP) 프로젝트를 생성합니다. 버전은 Unity 6000.0.68f1 LTS 기준, Android / iOS / macOS(Mono) / Web / Windows(IL2CPP) 빌드 모듈을 모두 포함해야 합니다.
VIVEN 패키지 임포트
Unity Editor 에서 Window → Package Manager → + → Install package from git URL... 를 선택해 복사한 URL 을 붙여넣습니다. 필수 의존성 Addressables 2.3.16 · OpenXR Plugin 1.14.0+ 도 같이 설치되어 있어야 합니다.
첫 스크립트 작성
GameObject 에 Viven Lua Behaviour 컴포넌트를 추가하고, VIVEN Script 만들기 버튼으로 Lua 스크립트를 생성합니다. VIVEN 클라이언트는 il2cpp 빌드이기 때문에 런타임 로직은 반드시 Viven Script (Lua) 로 작성해야 합니다.
-- 월드에 입장할 때 한 번 실행됩니다 function start() print("Welcome to VIVEN World!") end -- 오브젝트를 잡았을 때 Grabbable Event 로 반응 function onGrab(interactor) self.transform:Translate(Vector(0, 1, 0)) end
월드 빌드 & 업로드
Unity Editor 우측 상단의 Test on VIVEN 으로 즉시 실행. 공개 배포는 VIVEN SDK → Build & Upload 에서 진행하며, 자동 검수를 거쳐 다른 크리에이터와 월드를 공유합니다.
빌드 준비 완료
Test on VIVEN 버튼을 눌러 실행하거나, Build & Upload 로 공개하세요