Creating and uploading annotations using the Unity editor
이 글은 Unity 에디터의 Mega Studio를 사용하여 주석을 생성하고 업로드하는 방법을 설명합니다.
시작하기 전에
Unity에서 Mega Studio 사용하기 가능한 상태
모델 준비: 예제 프로젝트에서 사용된 모델(통통한 팬더)을 사용하거나, xr-frame 공식 데모에서 사용된 작은 로봇 모델을 사용하거나, XRFame에서 로드 가능한 GLTF 형식 및 지원 확장을 참고하여 xr-frame 요구사항에 맞는 모델 파일을 준비합니다.
모델 파일을 Unity로 가져옵니다.
팁
Mega 플러그인에는 이미 com.unity.cloud.gltfast 종속성이 추가되어 있으므로, 모델 파일을 Unity Assets로 직접 드래그할 수 있습니다.
주석이 필요한 이유
EasyAR Mega Annotation(EMA)은 플랫폼 간(좌표계 정의가 다른) 공간 위치 동기화에 사용될 수 있습니다.
Unity 환경에서 주석의 로컬 좌표계: X 양의 방향은 뒤쪽, Y 양의 방향은 위쪽, Z 양의 방향은 오른쪽입니다.
xr-frame 환경에서 주석의 로컬 좌표계: X 양의 방향은 뒤쪽, Y 양의 방향은 위쪽, Z 양의 방향은 왼쪽입니다.
위 방향 차이는 Unity와 xr-frame이 사용하는 좌표계 정의(왼손/오른손 좌표계)의 차이에서 비롯됩니다.
EMA를 사용하여 공간 위치를 동기화하면 다음과 같은 뚜렷한 이점이 있습니다:
- 개발 프로세스 간소화: 플랫폼 간 좌표 변환을 자동으로 처리하여 수동 계산으로 인한 번거로운 로직과 오류 가능성을 피합니다.
- 디버깅 효율성 향상: MegaToolbox에서 직접 로드할 수 있어 실기 테스트 및 데이터 검증을 신속하게 수행할 수 있습니다.
작업 단계
Create annotation tool
우니티의 Hierarchy 패널에서 오른쪽 클릭 후 EasyAR Mega > Tool > **Annotation Tool(Edit Mode)**를 차례로 선택하십시오.
생성이 완료되면 장면에 EasyAR.Mega.Annotation 및 MegaBlocks 노드가 생성됩니다.
EasyAR.Mega.Annotation 노드를 선택하면 Inspector 패널에 사용자명/이메일 및 비밀번호 입력란이 나타납니다.
Log in account
EasyAR 계정과 비밀번호를 입력한 후 로그인합니다. 성공하면 Inspector 패널에 Studio 도구가 나타납니다.
Select Mega cloud positioning library
Mega Cloud Service 오른쪽의 아이콘을 클릭하십시오.
사용할 라이브러리를 선택하십시오.
위치 라이브러리 및 Mega Blocks 정보가 성공적으로 로드되면 Studio 도구 패널은 아래와 같습니다.
Load block dense model
Block 이름 오른쪽의 로드를 클릭하면 해당 Block의 조밀한 모델을 동적으로 로드할 수 있습니다.
모델 로드가 완료되면 Scene 탭에 나타납니다. 왼쪽 하단에 아래 그림과 같은 아이콘이 나타나면 현재 시야 내 모델이 아직 로드되지 않았음을 의미합니다. 아이콘이 사라질 때까지 잠시 기다리면 로드가 완료된 것입니다.
Create annotation
장면에서 Ctrl(Windows)/Command(Mac) 키를 누른 상태로 주석을 달 위치에 마우스 왼쪽 버튼을 클릭하십시오.
Use model
가져온 모델을 장면 노드로 드래그하여 주석의 하위 노드로 만듭니다.
모델의 Inspector 패널에서 Position과 Rotation을 모두 0으로 변경하고, Scale은 필요에 따라 조정하십시오.
참고
EMA는 모든 좌표 변환 로직을 담당합니다. 모델의 Position과 Rotation을 0으로 설정하는 것은 모델의 기하학적 중심이 주석 지점과 완전히 일치하도록 하기 위함입니다. 모든 이동 및 회전 조정은 부모 노드(주석 노드)를 통해 수행해야 합니다.
[선택 사항] 정밀하게 모델 위치 조정
모델 위치와 방향을 정밀하게 조정해야 하는 경우 Unity 에디터를 사용하여 3D 콘텐츠를 실제 환경에 정확히 정렬하는 방법을 참조하십시오.
Create new annotation data package
Inspector 패널의 주석 데이터 패키지 오른쪽 아이콘을 클릭하십시오.
상자에 주석 데이터 이름을 입력하고 오른쪽의 체크 표시를 클릭하십시오.
생성이 성공하면 아래와 같이 표시되며, 이후 하단의 확인을 클릭하십시오.
업로드 아이콘을 클릭하여 업로드하십시오.
업로드 성공 시 알림이 표시됩니다.
Record annotation ID
xr-frame에서 해당 주석 데이터를 로드하려면 주석 데이터의 이름 또는 ID를 기록해야 합니다.
업로드가 성공하면 클라우드 위치 라이브러리에서도 해당 정보를 확인할 수 있습니다.
여기에서 업로드된 주석 데이터 이름과 ID를 확인할 수도 있습니다.
