Unity 프로젝트에서 Azure Spatial Anchors 구성

  • 아티클

이 가이드에서는 Unity 프로젝트에서 Azure Spatial Anchors SDK를 시작하는 방법을 보여줍니다.

프로젝트 요구 사항

새 Unity 프로젝트를 시작할 때 Unity XR 플러그 인 프레임워크와 레거시 기본 제공 XR 중에서 선택할 수 있습니다.

XR 플러그 인 프레임워크는 ASA SDK 버전 2.9.0 이상에서만 지원됩니다. XR 플러그 인 프레임워크를 대상 지정하려면 플랫폼에 따라 다음 패키지와 함께 Unity 2020.3(LTS) 및 AR Foundation 4.1.7을 사용합니다.

  • Mixed Reality OpenXR 플러그 인: 1.1.2
  • Windows XR 플러그 인: 4.5.0
  • ARCore XR 플러그 인: 4.1.7
  • ARKit XR 플러그 인: 4.1.7

프로젝트 구성

Unity 프로젝트에 Azure Spatial Anchors SDK를 포함하려면 먼저 Unity 패키지 관리자를 통해 필요한 패키지를 설치해야 합니다.

ASA 버전 선택

Unity 프로젝트에서 사용할 ASA SDK 버전을 확인하려면 아래에서 Unity 버전을 선택하세요.

Unity 2020에 대한 지원이 ASA SDK 2.9.0에 추가되었습니다. Unity 2020 개발용 최신 ASA SDK를 사용하는 것이 좋습니다.

Important

Mixed Reality OpenXR 플러그 인을 사용하는 경우 ASA SDK 2.10.0이 지원되는 최소 버전입니다. Windows XR 4.5.1 이상을 사용하는 경우 ASA SDK 2.11.0이 지원되는 최소 버전입니다.

ASA 패키지 다운로드

다음은 Unity용 Azure Spatial Anchors 패키지를 다운로드하는 단계입니다.

Unity에서 Azure Spatial Anchors를 사용하려면 지원할 계획인 각 플랫폼에 대한 코어 패키지(com.microsoft.azure.spatial-anchors-sdk.core) 및 플랫폼별 패키지를 모두 다운로드해야 합니다.

플랫폼 필수 패키지 이름
HoloLens com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>
Android com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.android@<version_number>
iOS com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>

참고 항목

Mixed Reality 기능 도구는 현재 Windows만 지원합니다.

다음 단계를 계속 진행합니다. 이후 단계에서 Mixed Reality 기능 도구를 사용합니다.

ASA 패키지 가져오기

이 단계를 수행하려면 Mixed Reality 기능 도구가 다운로드되어 사용할 수 있어야 합니다.

  1. Mixed Reality 기능 도구 설명서에 따라 도구를 설정하고 사용 방법을 알아보세요.
  2. 설치
    1. Azure Spatial Anchors SDK 코어
    2. <사용 중인 플랫폼>에 대한 Azure Spatial Anchors SDK
    3. OpenXR을 사용하는 경우 Mixed Reality OpenXR 플러그 인 - 플랫폼 지원 아래에 있음

추가 구성

HoloLens 또는 Android용으로 개발하는 경우 아래의 추가 설정 단계를 따릅니다.

Unity 프로젝트 XR 설정 구성

HoloLens에서 MixedReality 앱을 개발할 때 Unity에서 XR 구성을 설정해야 합니다. 자세한 내용은 XR 구성 설정 - Mixed Reality | Microsoft Docs 및 Unity 버전 및 XR 플러그 인 선택 - Mixed Reality | Microsoft Docs.

Azure Spatial Anchors SDK 버전 2.9.0 이하에서는 Windows XR 플러그 인(com.unity.xr.windowsmr)만 지원하므로 Azure Spatial Anchors Windows 패키지는 Windows XR 플러그 인에 대한 명시적 종속성을 갖습니다.

Azure Spatial Anchors SDK 버전 2.10.0 이상은 Mixed Reality OpenXR 플러그 인(com.microsoft.mixedreality.openxr) 및 Windows XR 플러그 인 com.unity.xr.windowsmr을 모두 지원합니다. 선택에 따라 프로젝트에 com.microsoft.mixedreality.openxr 패키지 또는 com.unity.xr.windowsmr 패키지를 포함해야 합니다.

Unity 프로젝트 기능 구성

Unity 프로젝트에서 다음 기능을 사용하도록 설정해야 합니다.

  • SpatialPerception
  • InternetClient
  • PrivateNetworkClientServer

Warning

PrivateNetworkClientServer 기능을 사용하도록 설정하지 않으면 디바이스가 프라이빗으로 구성된 네트워크를 사용할 때 앵커를 쿼리하지 못할 수 있습니다.