유니티에서 XREAL SDK를 사용하여 안드로이드 XR 앱 개발 시작하기

유니티에서 XREAL SDK를 사용하여 안드로이드 XR 앱 개발 시작하기

XREAL Glasses와 XREAL SDK를 사용하여 유니티에서 XR 콘텐츠를 개발하기(SDK 설치와 환경설정)

Getting Started with XREAL SDK
https://docs.xreal.com/Getting%20Started%20with%20XREAL%20SDK

 

하드웨어 요구사항
XREAL Glasses
지원되는 안드로이드폰 또는 빔 프로(Beam Pro)
Samsung S24 또는 후속 플래그십 모델

 

유니티 에디터 버전
Unity 2021.3.X LTS, Unity 2022.3.X LTS, Unity 6000.0.X LTS

 

Android SDK 12.0 (API Level 31)  이상

Android Debug Bridge (adb), Wireless ADB는 필수요구사항은 아니지만 권장됨

패키지(Package)
XR Plugin Management
XREAL SDK for Unity
-Interaction Basics 샘플(Sample)
-AR Features 샘플(선택)
XR Interaction Toolkit
-Starter Assets 샘플(Sample)
- Hands Interaction Demo(선택)
AR Foundation(선택)
XR Hands(선택)

유니티에서 XREAL SDK 개발환경 세팅

1)유니티 새로운 프로젝트에서 대상 플랫폼을 안드로이드로 설정

 

XR Interaction Toolkit(XRI) 

2)패키지 관리자에서  XR Interaction Toolkit(XRI) 패키지를 설치하고 추가적으로 Starter Assets 샘플 에셋을 가져오기합니다(Import) 
상호작용에서 컨트롤러가 아닌 손 제스처(hand gestures)를 사용할것이라면 Hands Interaction Demo  샘플 에셋을 추가 가져오기합니다.

 

3)AR 기능(평면인식, 이미지트래킹, 공간앵커, 깊이 메시생성 등)이 필요한 경우에는 AR Foundation 패키지를 추가 설치합니다(선택)

 

4)아래 XREAL 웹페이지에서 XREAL SDK를 다운로드합니다.

https://developer.xreal.com/download

XREAL Developer

 

 

 

5)패키지관리자의 install package from tarball에서 다운로드한 SDK 파일을 가져오기 및 설치합니다.

 

 

6)XREAL SDK 샘플(Sample) 에셋을 가져오기합니다.

XR 프로젝트를 설정할때 먼저 Interaction Basics 샘플로부터 시작하여 AR Features 고급 기능을 추가하는 순서로 진행 
Interaction Basics
XR 어플리케이션의 기반을 마련하고 핸드 제스처(또는 컨트롤러)를 사용한 기본적인 상호작용 및 렌더링에 필요한 도구를 제공하는 필수 구성요소. XR Interaction Toolkit 호환
AR Features(선택)
평면감지, 이미지 트래킹, 공간 앵커등 AR 기능을 사용할 경우 필요(AR Features 샘플은 AR Foundation 패키지 의존)

7)프로젝트 설정의 XR Plugin Management 메뉴에서 안드로이드 탭을 선택하고 XREAL XR 플러그인을 활성화합니다.

8)XR Plugin Management 하위 project validation 메뉴에서  XREAL 프로젝트 환경 설정을 위한 몇가지 수정 및 업데이트 해야할 항목을 표시합니다. Fix를 클릭하면 수정 및 적용합니다.

 

XREAL 프로젝트 설정(Project Settings)

9)프로젝트 설정의 Player 메뉴로 이동합니다. Resolution and Presentation 에서 Default Orientation 을 Portrait로 변경합니다.

 

10)Other Settings에서 Auto Graphics API를 비활성화하고 그래픽 API에 OpenGLES3를 설정합니다.

 

11)Package Name에 앱의 고유 패키지 이름을 설정하고 안드로이드 최소 API 수준 및 타겟 API 수준을 아래와 같이 설정합니다.
Android 10.0(API level 29) 이상, Automatic (highest installed)

 

12)Write Permission에사 External (SDCard)를 선택합니다. 안드로이드 장치의 외부 저장소(공용 공간)에 데이터를 쓰기 및 저장할 수 있는 권한을 활성화하는것을 의미합니다.
(앱 전용 공간이 아닌 기기의 사진 DCIM, 다운로드Download 폴더 등 )

 

13)Qulity 메뉴에서 Vsync Count를 Dont Sync로 설정합니다.

XREAL 플러그인 설정

14)프로젝트 설정의 XR Plugin Management에서 XREA 메뉴에서 XREAL 플러그인 설정을 진행합니다.

Stereo Rendering Mode
Single Pass Instanced - 왼쪽 눈과 오른쪽 눈의 뷰를 한 번의 패스로 렌더링하여 오버헤드를 줄이고 성능을 향상
Multi-pass - 왼쪽 눈과 오른쪽 눈의 뷰가 각각 별도의 패스로 렌더링. 더 높은 성능을 요구하며 특정 효과나 호환성을 위해 필요

 

Initial Tracking Type
MODE_6DOF (Six Degrees of Freedom) - 3D 공간에서 위치와 회전을 모두 추적
MODE_3DOF (Three Degrees of Freedom) - 회전 운동만 추적하므로 사용자는 주변을 둘러볼 수는 있지만 공간 내에서 이동할 수는 없음
MODE_0DOF - 추적하지않음
MODE_0DOF-STAB - 추적기능은없지만 센서를 활용하여 드리프트 감소 안정적인 시야 유지.

Initial Input Source
Hands - 손 추적기능을 사용
Controller - 안드로이드 스마트폰 또는 빔프로(BeamPro)를 컨트롤러로 사용
None - 입력소스 사용하지않음
Controller And Hands - Hands와 Controller모두 사용

Virtual Controller

외부장치(안드로이드 스마트폰 또는 빔프로)를 가상컨트롤러로 사용할때 컨트롤러의 화면 버튼 레이아웃 및 기능을 정의하는데 사용

Support Multi Resume
듀얼 스크린 독립 디스플레이 모드 활성화
(앱이 백그라운드에서 실행 중일 때도 AR 뷰는 안경에서 활성화된 상태로 유지)

Enable Auto Logcat
앱이 실행될때마다 현재 로그캣 출력을 저장
(Android/data/<package_name>/cache/auto_log/logcat_yyyy-MMdd-HHmmss.log)
개발에서 디버깅을 위해 옵션 활성화 

Support Devices
XREAL_DEVICE_CATEGORY_REALITY - 6DoF 트래킹 기능을 갖춘 Glasses(XREAL Air 2 Ultra)
XREAL_DEVICE_CATEGORY_VISION - DoF 트래킹 기능을 갖춘 Glasses(XREAL Air 2 및 XREAL One 시리즈)

License Assets - 라이선스를 구성하면 SDK의 고급 기능을 사용가능

 

15)XREAL 플러그인의 Sample에서 상호작용 기초(Interaction Basics) 및 AR Features(AR 기능)에 대한 샘플 씬과 프리팹 구성을 확인할수있습니다.