5. Android 및 iOS용 Azure Spatial Anchors5. Azure Spatial Anchors for Android and iOS

이 자습서에서는 AR Foundation, ARCore XR 플러그 인 및 ARKit XR 플러그 인을 사용하여 Android 및 iOS 디바이스에 프로젝트를 빌드하는 방법을 알아봅니다.In this tutorial, you will learn how to build your project to Android and iOS devices using AR Foundation, ARCore XR Plugin, and ARKit XR Plugin.

목표Objectives

  • Unity AR Foundation 및 ARCore XR 플러그 인을 사용하여 Android 디바이스에 프로젝트를 빌드하는 방법에 대해 알아봅니다.Learn how to build your project to your Android device using Unity's AR Foundation and ARCore XR Plugin
  • Unity AR Foundation 및 ARKit XR 플러그 인을 사용하여 iOS 디바이스에 프로젝트를 빌드하는 방법에 대해 알아봅니다.Learn how to build your project to your iOS device using Unity's AR Foundation and ARKit XR Plugin

기본 제공 Unity 패키지 설치Installing inbuilt Unity packages

이 섹션에서는 다음과 같은 기본 제공 패키지를 업그레이드하고 설치합니다.In this section, you will upgrade and install the following inbuilt packages:

  • AR Foundation 3.1.3AR Foundation 3.1.3
  • XR Legacy Input Helpers 2.1.4XR Legacy Input Helpers 2.1.4
  • Android 지원을 위한 ARCore XR 플러그 인 3.1.3ARCore XR Plugin 3.1.3 for Android support
  • iOS 지원을 위한 ARKit XR 플러그 인 3.1.3ARKit XR plugin 3.1.3 for iOS support

주의

모든 버전이 MRTK와 호환되는 것은 아니며 특정 버전만 함께 작동하므로 위에 나열된 정확한 버전을 설치해야 합니다.Not all version are compatible with MRTK and only certain version works together, so make sure you install the exact versions listed above.

Unity 메뉴에서 > 패키지 관리자 를 차례로 선택하여 [패키지 관리자] 창을 연 다음, AR Foundation > 3.1.3 을 선택하고 3.1.3으로 업데이트 단추를 클릭하여 패키지를 업데이트합니다.In the Unity menu, select Window > Package Manager to open the Package Manager window, then select AR Foundation > 3.1.3 and click the Update to 3.1.3 button to update the package:

AR Foundation이 선택된 Unity Package Manager

필요에 따라 동일한 프로세스를 수행하여 나머지 패키지를 가져옵니다.Follow the same process to import the remaining packages as needed.

참고

Android용으로 이 프로젝트를 개발하는 경우 ARKit XR 플러그 인 패키지를 설치할 필요가 없습니다.If you are developing this project for Android, there is no need to install the ARKit XR Plugin package. 마찬가지로 iOS용으로 이 프로젝트를 개발하는 경우 ARCore XR 플러그 인을 설치할 필요가 없습니다.Similarly, if you are developing this project for iOS, you do not need to install the ARCore XR Plugin.

AR Foundation Camera에 대한 MRTK 구성Configure MRTK for AR Foundation Camera

이 섹션에서는 모바일 디바이스에 배포하기 위해 MRTK를 구성하는 방법을 알아봅니다.In this section, you will learn how to configure MRTK for deploying to a mobile device.

Hierarchy(계층 구조) 창에서 MixedRealityToolkit 개체를 선택합니다.In the Hierarchy window, select the MixedRealityToolkit object. 그런 다음, Inspector(인스펙터) 창에서 Camera 탭을 선택하고 카메라 프로필을 복제한 다음, 적절한 이름(예: AzureSpatialAnchors_ARCameraProfile)을 지정합니다.Then in the Inspector window, select the Camera tab, clone the camera profile, and give it a suitable name, for example, AzureSpatialAnchors_ARCameraProfile:

새로 만든 ARCameraProfile이 선택된 Unity

MRTK 프로필을 복제하는 방법은 Mixed Reality Toolkit 프로필 구성 지침을 참조하세요.For a reminder on how to clone MRTK profiles, you can refer to the Configuring the Mixed Reality Toolkit profiles instructions.

Inspector(인스펙터) 창에서 Camera 탭을 선택한 상태로 Camera Setting Providers(카메라 설정 공급자)를 펼쳐서 + Add Camera Setting Provider(카메라 설정 공급자 추가) 단추를 클릭한 다음, 새로 추가한 New data provider 1(새 데이터 공급자 1)을 펼칩니다.With the Camera tab still selected in the Inspector window, expand the Camera Setting Providers and click the + Add Camera Setting Provider button, then expand the newly added New data provider 1:

새 데이터 공급자가 추가된 Unity ARCameraProfile

유형 드롭다운을 사용하여 유형을 Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings 로 변경합니다.Using the Type dropdown, change the type to Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:

데이터 공급자 유형 선택 경로가 있는 Unity ARCameraProfile

Hierarchy(계층 구조) 창에서 MixedRealityToolkit 개체를 선택한 상태로, Inspector(인스펙터) 창에서 Add Component(구성 요소 추가) 단추를 사용하여 다음 구성 요소를 추가합니다.With the MixedRealityToolkit object still selected in the Hierarchy window, use the Add Component button in the Inspector window to add the following components:

  • AR 앵커 관리자(스크립트)AR Anchor Manager (Script)
  • DisableDiagnosticsSystem(스크립트)DisableDiagnosticsSystem (Script)

AR Anchor Manager 및 DisableDiagnosticsSystem 구성 요소가 추가된 Unity MixedRealityToolkit 개체Unity MixedRealityToolkit object with AR Anchor Manager and DisableDiagnosticsSystem components added

참고

AR 참조 지점 관리자(스크립트) 구성 요소를 추가하면 AR 세션 원본(스크립트) 구성 요소가 AR 참조 지점 관리자(스크립트) 구성 요소에 필요하기 때문에 자동으로 추가됩니다.When you add the AR Reference Point Manager (Script) component, the AR Session Origin (Script) component is automatically added because it is required by the AR Reference Point Manager (Script) component.

Android 디바이스에 애플리케이션 빌드Building your application to your Android device

이 섹션에서는 프로젝트를 구성하고 빌드하여 Android 디바이스에 배포하는 방법을 알아봅니다.In this section, you will learn how to configure your project to build and deploy it to an Android device.

Unity 메뉴에서 파일 > 빌드 설정... 을 선택하여 빌드 설정 창을 연 다음, 플랫폼을 Android로 전환합니다.In the Unity menu, select File > Build Settings... to open the Build Settings window and then switch the platform to Android:

Android 플랫폼이 선택된 Unity Build Settings 창

빌드 플랫폼을 전환하는 방법은 빌드 플랫폼 전환 지침을 참조하세요.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

빌드 설정 창을 닫습니다.Close the Build Settings window.

Unity 메뉴에서 Mixed Reality Toolkit > 유틸리티 > Unity 프로젝트 구성 을 선택하여 MRTK Project Configurator 창을 열고 모든 옵션이 선택되어 있는지 확인한 다음, 적용 단추를 클릭하여 설정을 적용합니다.In the Unity menu, select Mixed Reality Toolkit > Utilities > Configure Unity Project to open the MRTK Project Configurator window, ensure all options are selected, then click the Apply button to apply the settings:

Unity MRTK Project Configurator 창 Android

Unity 메뉴에서 편집 > 프로젝트 설정... 을 차례로 선택하여 플레이어 설정 창을 연 다음, 플레이어 > 기타 설정 섹션을 찾아서 Vulkan 을 선택하고 "-" 기호를 클릭하여 제거합니다.In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Other Settings section, select Vulkan and remove it by clicking the "-" symbol:

Vulcan이 선택된 Unity Other Settings

플레이어 설정 창을 닫고 빌드 설정 창을 다시 엽니다.Close the Player Settings window and open the Build Settings window again.

빌드 설정 창에서 Add Open Scenes(열려 있는 장면 추가) 단추를 클릭하여 현재 장면을 Scenes In Build(빌드의 장면) 목록에 추가합니다.In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list. 그런 다음, USB 케이블을 사용하여 Android 디바이스를 컴퓨터에 연결하고 Run Device(디바이스 실행) 드롭다운 목록에서 선택합니다.Then, use a USB cable, connect your Android device to your computer and select it from the Run Device dropdown:

장면이 추가되고 Run Device가 선택된 Unity Build Settings 창

참고

Run Device(디바이스 실행) 드롭다운 목록에 디바이스가 보이지 않으면 드롭다운 목록 옆에 있는 새로 고침 단추를 눌러야 할 수도 있습니다.If your device does not appear in the Run Device dropdown, you might need to press the Refresh button next to the dropdown.

빌드 설정 창에서 빌드 및 실행 단추를 클릭하여 Build Android(Android 빌드) 창을 엽니다.In the Build Settings window, click the Build And Run button to open the Build Android window.

빌드를 저장할 적당한 위치(예: D:\MixedRealityLearning\Builds)를 선택한 다음, apk에 적절한 이름(예: MRTKTutorials-AzureSpatialAnchors)을 지정하고 저장 단추를 클릭하여 빌드 프로세스를 시작합니다.Choose a suitable location to store your build, for example, D:\MixedRealityLearning\Builds, then give the apk a suitable name, for example, MRTKTutorials-AzureSpatialAnchors, and click the Save button to start the build process:

Save 프롬프트 창이 있는 Unity Build Settings 창 Android

참고

Android SDK, NDK 및 JDK 모듈과 관련된 Unity 콘솔 창에 오류가 발생하면 Unity Hub를 열고 Android 빌드 지원 모듈과 관련된 Android 빌드 지원 모듈을 설치해야 합니다.If you get any error in the Unity Console window related to Android SDK, NDK, or JDK modules, you need to open Unity Hub and install the associated Android Build Support modules.

빌드 프로세스가 완료되면 앱이 Android 디바이스에 자동으로 로드됩니다.When the build process is complete, your apps should automatically load on your Android device.

iOS 디바이스에 애플리케이션 빌드Building your application to your iOS device

이 섹션에서는 프로젝트를 구성하고 빌드하여 iOS 디바이스에 배포하는 방법을 알아봅니다.In this section, you will learn how to configure your project, to build and deploy it to your iOS device.

Unity 메뉴에서 파일 > 빌드 설정... 을 선택하여 빌드 설정 창을 열고 플랫폼을 iOS로 전환합니다.In the Unity menu, select File > Build Settings... to open the Build Settings window and switch platform to iOS:

iOS가 선택된 Unity Build Settings 창

빌드 플랫폼을 전환하는 방법은 빌드 플랫폼 전환 지침을 참조하세요.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

빌드 설정 창을 닫습니다.Close the Build Settings window.

Unity 메뉴에서 Mixed Reality Toolkit > 유틸리티 > Unity 프로젝트 구성 을 선택하여 MRTK Project Configurator 창을 열고 모든 옵션이 선택되어 있는지 확인한 다음, 적용 단추를 클릭하여 설정을 적용합니다.In the Unity menu, select Mixed Reality Toolkit > Utilities > Configure Unity Project to open the MRTK Project Configurator window, ensure all options are selected, then click the Apply button to apply the settings:

Unity MRTK Project Configurator 창 iOS

Unity 메뉴에서 편집 > 프로젝트 설정... 을 선택하여 플레이어 설정 창을 연 다음, 플레이어 > 기타 설정 섹션을 찾아서 Strip Engine Code(엔진 코드 스트립) 확인란 선택을 취소하여 사용하지 않도록 설정합니다.In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Other Settings section, uncheck the Strip Engine Code checkbox to disable it:

스트립 엔진 코드가 비활성화된 Unity Other Settings

플레이어 설정 창을 닫고 빌드 설정 창을 다시 엽니다.Close the Player Settings window and open the Build Settings window again.

빌드 설정 창에서 Add Open Scenes(열려 있는 장면 추가) 단추를 클릭하여 현재 장면을 Scenes In Build(빌드의 장면) 목록에 추가합니다.In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list:

장면이 추가된 Unity Build Settings 창

빌드 설정 창에서 빌드 단추를 클릭하여 Build iOS(iOS 빌드) 창을 엽니다.In the Build Settings window, click the Build button to open the Build iOS window.

Xcode 프로젝트를 저장할 적당한 위치(예: D:\MixedRealityLearning\Builds)를 선택하고, 새 폴더를 만들어서 적절한 이름(예: MRTKTutorials-AzureSpatialAnchors)을 지정한 다음, 폴더 선택 단추를 클릭하여 빌드 프로세스를 시작합니다.Choose a suitable location to store your Xcode project, for example, D:\MixedRealityLearning\Builds, create a new folder and give it a suitable name, for example, MRTKTutorials-AzureSpatialAnchors, and then click the Select Folder button to start the build process:

저장 프롬프트 창이 있는 Unity Build Settings 창 iOS

빌드 프로세스가 완료되면 Xcode 프로젝트 내보내기 지침에 따라 Xcode 프로젝트를 iOS 디바이스에 배포하는 방법을 알아봅니다.When the build process is complete, follow the Export the Xcode project instructions to learn to deploy your Xcode project to your iOS device.

축하합니다.Congratulations

이 자습서에서는 AR Foundation, ARCore XR 플러그 인 및 ARKit XR 플러그 인을 사용하여 Android 및 iOS 디바이스에 프로젝트를 빌드하는 방법을 알아보았습니다.In this tutorial, you learned how to build your project to Android and iOS devices using AR Foundation, ARCore XR Plugin, and ARKit XR Plugin.