AR 핀 개요

AR 핀을 사용하면 언리얼 엔진 내에 가상 콘텐츠를 어태치할 수 있도록 AR에서 고정된 현실 위치를 표시할 수 있습니다.

Choose your operating system:

Windows

macOS

Linux

AR 핀 은 언리얼 엔진 내의 가상 콘텐츠와 어태치할 수 있는 증강현실(AR)의 고정된 현실 위치입니다. AR 핀 API는 모든 플랫폼에서 동일하지만 각 플랫폼에는 AR 핀 데이터에 대한 고유한 구현이 있습니다. 기본 플랫폼에서 현실 위치 또는 현실 지오메트리 추적을 지원하는 경우 이 기능은 AR 핀 위치의 안정성을 향상시켜 해당되는 현실 위치 또는 지오메트리에 고정됩니다.

AR 환경에서 핀 추가 및 제거의 예시

AR 핀 데이터 저장하기

가상 콘텐츠가 특정 위치 또는 지오메트리에 고정되는 것 외에도 일부 플랫폼에서는 위치 데이터의 로컬 또는 클라우드 저장을 지원합니다. 위치 데이터를 저장할 수 있다는 것은 가상 콘텐츠가 앱 세션과 일부 구현 및 멀티 유저 경험 사이에서 일관적으로 나타날 수 있다는 것을 의미합니다.

다음 표에서는 어떤 AR 플랫폼에서 AR 핀 데이터의 로컬 또는 Microsoft Azure 클라우드 서비스를 사용한 저장을 지원하는지 설명합니다.

플랫폼

AR 핀 플랫폼 구현

AR 핀 퍼시스턴스 플랫폼 구현

AR 핀 로컬 스토리지 함수 지원 여부

Azure Spatial Anchors 지원 여부

ARCore

Anchor

Cloud Anchor

아니요

ARKit

ARAnchor

ARGeoAnchor

아니요

HoloLens

Spatial Anchor

Azure Spatial Anchors

예, 다음 플러그 중 하나 사용:

  • Windows Mixed Reality

  • Microsoft OpenXR

예, 다음 플러그인 중 하나 사용:

  • Azure Spatial Anchors for WMR

  • Microsoft OpenXR

Magic Leap

PersistentCoordinateFrame (PCF)

PersistentCoordinateFrame (PCF)

예, Magic Leap ARPin 함수 사용.

아니요

로컬로 AR 핀 저장하기

AR 디바이스에서 로컬로 데이터를 저장하면 콘텐츠가 앱 세션에서 일관되게 유지될 수 있습니다. 프로젝트에 AR 핀 기능을 추가하는 방법에 관한 자세한 정보는 AR 핀 퀵스타트를 참조하세요.

클라우드에 AR 핀 저장하기

Azure Spatial Anchors, Cloud Anchors with ARCore 및 Geo Anchors with ARKit을 사용하여 클라우드에 AR 핀을 저장할 수 있습니다.

Azure Spatial Anchors

클라우드에 데이터를 저장하는 것은 가상 콘텐츠와 현실 위치를 여러 디바이스 및 플랫폼 간에 언제든 공유할 수 있음을 의미합니다. Azure Spatial Anchors는 Microsoft Azure를 사용하여 AR 핀 데이터를 저장 및 검색하기 위한 클라우드 구현으로, 언리얼 엔진에 포함된 플러그인입니다. Azure Spatial Anchors는 여러 AR 플랫폼에서 지원됩니다.

  • Windows Mixed Reality (HoloLens)

  • ARCore를 지원하는 Android 디바이스

  • ARKit를 지원하는 iOS 디바이스

Azure Spatial Anchors를 사용하려면 Azure 계정이 필요합니다.

프로젝트에서 Azure Spatial Anchors를 사용하려면 Azure Spatial Anchors 플러그인과 플랫폼에 해당되는 Azure Spatial Anchors 플러그인을 활성화합니다.

이미지를 클릭하면 확대됩니다.

프로젝트에서 Azure Spatial Anchors를 사용하는 방법에 대한 자세한 내용은 Microsoft의 Unreal의 Azure Spatial Anchors 문서를 참조하세요.

Cloud Anchors with ARCore

ARCore 지원 디바이스에서 Azure Spatial Anchors를 사용할 수 있는 것 외에도 Google의 클라우드 내 AR 핀에 대한 플랫폼 구현인 Cloud AnchorsUGoogleARCoreServicesFunctionLibrary를 통해 언리얼 엔진에 표시됩니다.

API를 사용하려면 다음을 따릅니다.

  1. UGoogleARCoreServicesFunctionLibrary::CreateAndHostCloudARPin() 을 호출하여 기존 AR 핀에서 클라우드 AR 핀을 생성합니다.

  2. 클라우드 AR 핀이 생성될 때 UCloudARPin::GetCloudID() 를 호출하여 핀에 대해 고유한 UUID인 클라우드 ID에 액세스합니다.

  3. 언제든 UGoogleARCoreServicesFunctionLibrary::CreateAndResolveCloudARPin() 을 사용하여 이전에 생성된 클라우드 AR 핀을 리졸브할 수 있습니다. 리졸브에 성공한 경우 클라우드 AR 핀은 핀의 World Transform을 제공하고, 현실에서 핀이 생성된 위치를 보여줍니다.

Geo Anchors with ARKit

ARKit 지원 디바이스에서 Azure Spatial Anchors를 사용할 수 있는 것 외에도 Apple의 클라우드 내 AR 핀에 대한 플랫폼 구현인 ARGeoAnchor는 언리얼 엔진에서 UARTrackedGeometry의 서브클래스로 노출됩니다.

API를 사용하려면 다음을 따릅니다.

  1. UARGeoTrackingSupport::GetGeoTrackingSupport()를 쿼리합니다.

  2. 사용 가능한 경우 반환된 오브젝트의 함수를 호출합니다. 예를 들어 새 지오 앵커를 생성하려면 UARGeoTrackingSupport::AddGeoAnchorAtLocation() 함수를 사용합니다.