Skip to main content
Version: 1.9.0

VLSDK 패키지 설치

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

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

  1. Unity 상단 메뉴의 Window > Package Manager를 클릭하여 Package Manager 창을 활성화 합니다.
  2. Package Manager 창의 좌상단 + 버튼을 누른 뒤 Add package from git URL을 클릭한 뒤 다음 주소를 입력합니다. 
    https://github.com/NaverCloudPlatform/ARCeyeVLSDK.git?path=Assets/VLSDK
tip

VLSDK의 업데이트가 필요한 경우 Package Manager에서 Packages: In Project를 선택한 뒤 VLSDK를 선택합니다. 그 후 우측 상단의 Update 버튼을 눌러 업데이트를 진행합니다.

tip

특정 버전의 VLSDK를 사용하고 싶은 경우 git URL의 마지막 버전 부분에 #v{version}을 추가하여 원하는 버전으로 변경할 수 있습니다.

ex. https://github.com/NaverCloudPlatform/ARCeyeVLSDK.git?path=Assets/VLSDK#v1.8.0

Custom Package를 이용한 설치​

  1. ARCeyeVLSDK Github에서 VLSDK 패키지를 다운로드 받습니다.
  2. Unity 상단 메뉴의 Assets > Import Packages > Custom Package… 를 클릭한 후 vl-sdk-unity-x.x.x.unitypackage를 찾아 프로젝트에 추가합니다.
    • 이 과정을 통해 다음 패키지들이 자동으로 설치됩니다. 
      com.unity.modules.xr@1.0.0
      com.unity.xr.arcore@5.1.5
      com.unity.xr.arfoundation@5.1.5
      com.unity.xr.arkit@5.1.5
      com.unity.xr.management@4.4.0
      com.unity.nuget.newtonsoft-json@3.2.1
    • 설치가 완료되면 다음 define symbols들이 자동으로 설정됩니다. 
      VLSDK_ARFOUNDATION
      VLSDK_NEWTONSOFT_JSON
      caution

      Define symbols에 VLSDK_ARFOUNDATION와 VLSDK_NEWTONSOFT_JSON가 추가되지 않으면 VLSDK를 사용할 수 없습니다. VLSDK가 추가되었지만 사용할 수 없는 상태라면 Define symbols를 확인해주세요.

AR 기능을 위한 프로젝트 설정​

  1. Edit > Project Settings > XR Plug-in Management에서 다음 사항들을 설정합니다.
    • Android settings > Plug-in Provider에서 ARCore 체크
    • iOS settings > Plug-in Provider에서 ARKit 체크
  2. (Android) Edit > Project Settings > Player > Android Settings > Other Settings에서 다음 사항들을 수정합니다.
    • Rendering > Graphics APIs에서 OpenGLES3만 활성화
    • Identification > Minimum API Level을 API Level 24 이상으로 설정
    • Configuration > Scripting Backend를 IL2CPP로 설정
    • Configuration > Target Architectures 중 ARM64만 체크