ARSDK 패키지 설치
ARSDK는 다음 두 가지 방법을 통해 설치할 수 있습니다. 개발 환경에 따라 선호하는 방법으로 설치를 진행할 수 있습니다.
UPM(Package Manager)을 이용한 설치 (권장)
- Unity 상단 메뉴의 Window > Package Manager를 클릭하여 Package Manager 창을 활성화 합니다.
- Package Manager 창의 좌상단 + 버튼을 누른 뒤 Add package from git URL을 클릭한 뒤 다음 주소를 입력합니다.
https://github.com/NaverCloudPlatform/ARCeyeARSDK.git?path=Assets/ARSDK
팁
ARSDK의 업데이트가 필요한 경우 Package Manager에서 Packages: In Project를 선택한 뒤 ARSDK를 선택합니다. 그 후 우측 상단의 Update 버튼을 눌러 업데이트를 진행합니다.
팁
특정 버전의 ARSDK를 사용하고 싶은 경우 git URL의 마지막 버전 부분에 #v{version}
을 추가하여 원하는 버전으로 변경할 수 있습니다.
ex. https://github.com/NaverCloudPlatform/ARCeyeVLSDK.git?path=Assets/ARSDK#v1.6.0
Custom Package를 이용한 설치
- ARCeyeARSDK Github에서 ARSDK 패키지를 다운로드 받습니다.
- Unity 상단 메뉴의 Assets > Import Packages > Custom Package… 를 클릭한 후 ar-sdk-unity-x.x.x.unitypackage를 찾아 프로젝트에 추가합니다.
- 이 과정을 통해 다음 패키지들이 자동으로 설치됩니다.
com.unity.nuget.newtonsoft-json@3.2.1
com.unity.cloud.gltfast@6.1.0
com.unity.cloud.draco@5.1.8 - 설치가 완료되면 다음 define symbols들이 자동으로 설정됩니다.
ARSDK_GLTFAST
주의Define symbols에 ARSDK_GLTFAST가 추가되지 않으면 ARSDK를 사용할 수 없습니다. ARSDK가 추가되었지만 사용할 수 없는 상태라면 Define symbols를 확인해주세요.
- 이 과정을 통해 다음 패키지들이 자동으로 설치됩니다.
패키지 추가 후 실행되는 작업
레이어 추가
패키지가 추가되면 Layer가 추가 됩니다. 추가 되는 레이어는 다음과 같습니다.
- Map
- MapPOI
- MapArrow
Always included shader 추가
패키지가 추가되면 ARPG > Core > Shaders의 모든 쉐이더들이 Always included shader로 추가 됩니다.