본문으로 건너뛰기
버전: Next

ARSDK 패키지 설치

ARSDK는 다음 두 가지 방법을 통해 설치할 수 있습니다. 개발 환경에 따라 선호하는 방법으로 설치를 진행할 수 있습니다.

UPM(Package Manager)을 이용한 설치 (권장)

  1. Unity 상단 메뉴의 Window > Package Manager를 클릭하여 Package Manager 창을 활성화 합니다.
  2. 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를 이용한 설치

  1. ARCeyeARSDK Github에서 ARSDK 패키지를 다운로드 받습니다.
  2. 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로 추가 됩니다.

스크린샷 2023-10-06 오후 4.57.00.jpg