시작하기 가이드

VIVEN SDK
빠른 시작하기

Unity 하나로 월드와 오브젝트를 저작하는 첫 걸음. 5분이면 첫 VIVEN 월드를 실행할 수 있습니다.

Current Step
1

SDK 다운로드

진행 중

VIVEN SDK 는 Unity Package Manager 의 git URL 방식으로 설치합니다. 별도 다운로드 없이 바로 추가할 수 있고, 업데이트도 Package Manager 에서 관리됩니다.

VIVEN SDK Core
v2.1.212025.12.03 • UPM
https://github.com/vivenapp/viven-sdk.git
2

Unity 프로젝트 설정

대기 중

Unity Hub 에서 새 Universal 3D (URP) 프로젝트를 생성합니다. 버전은 Unity 6000.0.68f1 LTS 기준, Android / iOS / macOS(Mono) / Web / Windows(IL2CPP) 빌드 모듈을 모두 포함해야 합니다.

Project Name
My-Viven-World
Template
3D (URP) Core
Version
6000.0.68f1
Create project
3

VIVEN 패키지 임포트

대기 중

Unity Editor 에서 Window → Package Manager + → Install package from git URL... 를 선택해 복사한 URL 을 붙여넣습니다. 필수 의존성 Addressables 2.3.16 · OpenXR Plugin 1.14.0+ 도 같이 설치되어 있어야 합니다.

Install package from git URL
VIVEN_SDK
Core
Prefabs
VivenLuaBehaviour.cs
Cancel
Install
4

첫 스크립트 작성

대기 중

GameObject 에 Viven Lua Behaviour 컴포넌트를 추가하고, VIVEN Script 만들기 버튼으로 Lua 스크립트를 생성합니다. VIVEN 클라이언트는 il2cpp 빌드이기 때문에 런타임 로직은 반드시 Viven Script (Lua) 로 작성해야 합니다.

MyScript.lua
-- 월드에 입장할 때 한 번 실행됩니다
function start()
  print("Welcome to VIVEN World!")
end

-- 오브젝트를 잡았을 때 Grabbable Event 로 반응
function onGrab(interactor)
  self.transform:Translate(Vector(0, 1, 0))
end
5

월드 빌드 & 업로드

대기 중

Unity Editor 우측 상단의 Test on VIVEN 으로 즉시 실행. 공개 배포는 VIVEN SDK → Build & Upload 에서 진행하며, 자동 검수를 거쳐 다른 크리에이터와 월드를 공유합니다.

빌드 준비 완료

Test on VIVEN 버튼을 눌러 실행하거나, Build & Upload 로 공개하세요