Table of Contents

실제 공간과 정확히 정렬된 3D 콘텐츠 만들기

이 문서는 가상 물체를 현실 공간의 특정 위치에 정확히 배치하여 AR 경험에서 실제 공간과 정확하게 정렬하는 방법을 소개합니다.

시작하기 전에

참고

다음 내용 및 도구는 EasyAR Mega를 사용하여 Unity 애플리케이션을 개발하는 과정에만 적용됩니다.

소프트웨어를 개발 중인 경우 Unity 에디터를 사용하여 주석 생성 및 업로드(소프트웨어 개발) 를 참조하세요.

Unity 애플리케이션을 개발하지 않지만 Mega 지도 작성 결과를 확인하려는 경우 Mega 사용 가이드의 3D 실제 장면 그리드 미리보기 를 참조하세요.

Unity 애플리케이션을 개발하지 않지만 위치 추적 효과를 시뮬레이션 실행하여 확인해야 하는 경우 Mega 사용 가이드의 시뮬레이션 실행 효과 미리보기 를 참조하세요.

이 문서의 내용을 위해 프로젝트에 다음 Unity 패키지가 이미 가져와져 있어야 합니다.

  • com.easyar.sense
  • com.easyar.mega

Block 실제 장면 데이터

Mega 개발에서 3D 콘텐츠 배치를 보조하기 위해 다양한 실제 장면 데이터를 사용할 수 있습니다.

  • Block 그리드 모델

    alt text

  • 파노라마 이미지(공간 모델 가리기 포함)

    alt text

    참고

    일부 데이터는 파노라마 이미지를 지원하지 않습니다.

  • LCC 3D 가우시안 스플래시

    alt text

    참고

    LCC 3D 가우시안 스플래시 데이터는 해당 도메인 기기로 수집하고 맵 생성을 완료한 사용 시나리오에서만 사용할 수 있습니다.

에디터 도구 활성화

먼저 에디터에서 Mega 추적 대상 추가를 한 다음 추적 대상을 선택하고 Create Editor Tool 버튼을 클릭하세요.

팁

애플리케이션이 에디터 내에서가 아니라 스크립트에서 추적 대상을 생성해야 하는 경우, 에디터 내에서 배치를 완료한 후 추적 대상 및/또는 그 하위 오브젝트를 기록하고 실행 시 스크립트를 통해 추적 대상을 구성하고 하위 오브젝트를 추적 대상에 연결할 수 있습니다.

서비스 정보를 확인하고 서비스에 연결하세요.

중요

연결하기 전에 API Key의 권한을 확인해야 합니다.

  • 서비스의 Type이 Block인 경우, 사용하는 API Key가 Mega Block 서비스와 SpatialMap 서비스에 대한 액세스 권한이 있어야 합니다.
  • 서비스의 Type이 Landmark인 경우, API Key가 Mega Landmark 서비스에 대한 액세스 권한이 있어야 합니다.

alt text

권한이 부족하면 서비스 연결 검증 실패 오류 메시지가 표시됩니다.

alt text

target 데이터 소스가 올바르게 구성되어 있다면, 서비스에 정상적으로 연결한 후 데이터 업데이트 시간 및 block 에디터 데이터 제어 인터페이스를 볼 수 있습니다.

팁

target 데이터 소스를 비워 두고 서비스에 정상적으로 연결하면 서비스의 block 데이터 목록이 표시됩니다. 사용할 block을 선택한 후에도 block 에디터 데이터 제어 인터페이스에 접근할 수 있으며, target 데이터 소스가 자동으로 채워집니다.

에디터 도구의 데이터는 EasyAR.Mega.EditorTool 노드 아래에 저장됩니다. 이 노드를 삭제하면 에디터 도구의 데이터가 삭제됩니다.

주의

EasyAR.Mega.EditorTool 노드의 내용을 직접 수정하면 안 됩니다. 특히 이 노드의 Transform을 수정하면 에디터 도구가 정상적으로 작동하지 않거나 추적 시 내용 표시 위치가 잘못될 수 있습니다.

Block 모델 로드

Block 데이터 아래의 첫 번째 선택 상자를 클릭하면 block 편집기 데이터의 로드 프로세스가 시작되며, 로드 후 Scene 창에서 현재 block의 메시를 볼 수 있습니다.

팁
  • Block 메시는 block 추적 대상 공간과 정렬되어 있으므로 모델 위에 3D 콘텐츠를 직접 배치할 수 있습니다.
  • Block 메시는 카메라 위치에 따라 LOD가 전환되며, 사용 시 LOD 전환 실패를 방지하기 위해 인터넷 연결을 유지해야 합니다.
  • Block 메시는 도구 노드 아래에 저장되며, 편집기 모드에서만 존재하며 최종 애플리케이션에 패키징되지 않습니다.

3D 콘텐츠를 block 노드 아래에 마운트하기

block 모델을 로드한 후 3D 콘텐츠를 시나리오의 Block 노드 아래에 마운트하여 하위 노드로 만듭니다.

alt text

주의
  • 3D 물체는 EasyAR.Mega.EditorTool 노드 아래에 배치할 수 없습니다. 이 노드는 에디터 도구 전용이며 일부 경우 자동으로 삭제되거나 재구성됩니다.
중요
  • 3D 물체는 실행 시 가상 콘텐츠의 렌더링 위치가 올바르게 되도록 block 노드 아래에 배치해야 합니다.

3D 콘텐츠 정확히 배치하기

다음 단계를 완료하여 가상 콘텐츠를 현실 공간에 정확하게 배치할 수 있습니다.

Block 그리드 모델에 따라 배치

장면에서 block mesh를 기준으로 3D 콘텐츠의 위치와 회전을 조정하여 원하는 위치와 방향으로 맞춥니다.

팁
  • 에디터가 play 모드로 들어가면 block mesh는 여전히 사용 가능하지만 카메라 위치에 따라 LOD가 전환되지 않습니다.
  • block mesh는 도구 노드 아래에 저장되며 에디터 모드에서만 존재하며 최종 애플리케이션에 패키징되지 않습니다.

[선택 사항] 파노라마 이미지에 따라 배치

Panorama Preview Marker 체크박스를 클릭하면 파노라마 마커가 표시됩니다.

참고
  • 일부 데이터는 파노라마를 지원하지 않습니다.

파노라마 마커 중 하나를 클릭하면 해당 위치에서 파노라마 모드로 콘텐츠를 배치할 수 있습니다. 서로 다른 파노라마 마커를 클릭하여 파노라마를 전환하면 3D 콘텐츠의 위치가 다양한 시점에서 정확한지 확인할 수 있습니다.

alt text

팁
  • 파노라마 마커를 사용하여 콘텐츠를 배치할 때, mesh 기반 공간 모델 오클루전은 여전히 유효합니다.
  • 에디터가 플레이 모드에 진입한 후에도 이 기능은 사용 가능하지만, mesh 기반 공간 모델 오클루전의 정확도는 LOD 전환 비활성화의 영향을 받습니다.
  • 파노라마 마커 및 파노라마 데이터는 도구 노드 아래에 저장되며, 에디터 모드에서만 존재하며 최종 애플리케이션에 패키징되지 않습니다.

[선택 사항] LCC 3D 가우시안 스플래시 배치에 따라

참고

이 단락의 내용은 해당 도메인 기기를 사용하여 데이터를 수집하고 지도 작성이 완료된 사용 시나리오에 적용됩니다. 다른 기기를 사용한 지도 작성 결과에는 LCC 3DGS 데이터가 포함되지 않습니다.

만약 여러분이 LCC 3D 가우시안 스플래시(해당 도메인 LCC) 기능을 사용했다면, 3DGS를 참고하여 모델 위치를 조정할 수 있습니다. LCC 데이터 사용 방법은 LCC 데이터 로드 및 Mesh와 정렬을 참조하세요.

실제 장면 데이터 결함이 콘텐츠 배치에 미치는 영향

로드된 Block 모델이 수평이 되지 않으면 어떻게 해야 할까요?

Hierarchy 패널에서 조정할 block 노드를 선택하고, Inspector 패널에서 Rotation 을 수정하여 Unity 에디터에서 모델의 방향이 올바르게 보이도록 합니다.

block 노드의 월드 좌표계에서의 Transform 은 block 의 로컬 좌표계에 영향을 주지 않으며 따라서 block 의 자식 노드인 3D 콘텐츠의 렌더링 결과에도 영향을 주지 않습니다. 이 Transform 은 최종 표시 결과와 관련이 없습니다.

주의

block 노드 아래의 EasyAR.Mega.EditorTool 의 Transform 을 수정하면 에디터 도구가 정상적으로 작동하지 않거나 추적 시 콘텐츠 표시 위치가 잘못될 수 있습니다.

로드된 Block 모델에 파손되거나 결손된 부분이 있으면 어떻게 해야 하나요?

3D 재구성 과정에서 수집 각도가 불완전하게 커버되는 영향으로 생성된 밀집 모델에 파손되거나 결손된 부분이 나타날 수 있습니다.

파손 및 결손

불완전한 모델을 처리할 때, 파손/결손 부분의 3D 콘텐츠 정렬 정확도 요구 사항이 높지 않은 경우 전경 마커를 클릭하여 전경 사진을 참조해 3D 콘텐츠를 배치할 수 있습니다. 그 후 근처의 다른 전경 마커 위치를 클릭하여 효과를 확인할 수 있습니다.

전경 사진을 통한 배치

파손/결손 부분의 3D 콘텐츠 정렬 정확도 요구 사항이 매우 높은 경우 보충 업데이트 또는 무손실 전체 업데이트를 통해 지도를 보충하거나 업데이트해야 합니다. 일반적으로 이러한 영역은 이미지 수집 과정에서 커버되지 않았음을 의미하며, 이러한 영역 내에서 Mega 위치 추적 효과가 영향을 받을 수 있으므로 편집기에서만 3D 콘텐츠를 정렬하는 것은 충분하지 않습니다.

후속 단계

관련 주제