XR 헤드셋이나 안경에서 EasyAR 샘플 사용하기
EasyAR은 모든 헤드셋에 대해 통일된 샘플을 제공하며, 샘플에는 코드가 없고 모두 씬 내 설정으로 구현됩니다. 기능 자체의 사용은 Android/iOS 휴대폰에서의 샘플 구현을 참고할 수 있습니다.
헤드셋 샘플 이름은 Combination_BasedOn_* 형식입니다(예: Pico 샘플은 Combination_BasedOn_Pico). 이 샘플은 하나의 씬에서 대부분의 EasyAR 기능을 시연하며, 각 기능은 동적으로 켜고 끌 수 있으며 개별적으로 또는 동시에 사용할 수 있습니다.
사전 준비
- 사용 중인 헤드셋이나 안경이 EasyAR 지원 목록에 있는지 확인하세요
- EasyAR Unity 플러그인 패키지를 다운로드하여 임포트하세요
- EasyAR Unity XR 디바이스 확장 패키지를 다운로드하여 임포트하세요
- XR 헤드셋이나 안경에 적합한 EasyAR 라이선스를 획득하세요. 헤드셋/안경에서 사용 가능한 라이선스 유형은 다음과 같습니다
- EasyAR Sense 4.x XR License 평가판(EasyAR 웹사이트에서 직접 신청)
- EasyAR Sense 4.x XR License 정식판(유료, 영업 담당자에게 문의)
- EasyAR Sense 4.x XR License 기업판(기업용 SDK 사용)
주의
헤드셋과 안경에서는 XR License만 사용 가능하며, 일반 라이선스로는 EasyAR 기능을 사용할 수 없습니다.
공식 샘플 임포트
내장 지원 디바이스의 샘플은 EasyAR Unity 플러그인 패키지 내에 위치하며, 필요한 샘플을 개별적으로 임포트합니다.
확장 지원 디바이스의 샘플은 해당 헤드셋 확장과 함께 배포됩니다. Unity를 사용해 샘플을 프로젝트에 임포트할 수 있습니다(예: Pico).
샘플 빌드 및 실행
헤드셋별로 프로젝트 설정과 샘플 사용법을 완료하세요.
해당 헤드셋 제조사의 공식 문서와 지침을 엄격히 준수하여 설정하세요. EasyAR 문서에서는 이 내용을 다루지 않습니다.
EasyAR 문서의 플랫폼별 지침에 따라 설정하세요.
Android: Android 프로젝트 설정 참고
visionOS: visionOS 프로젝트 설정 참고
XREAL은 Android 플랫폼 설정 외에 추가로 XREAL 프로젝트 설정이 필요합니다
샘플 빌드 Unity에서 샘플을 빌드하여 디바이스에 배포하고 실행하세요. 자세한 방법은 Unity에서 샘플 실행하기를 참고하세요.
사용법 설명
샘플에는 여러 버튼이 내장되어 있으며 각 기능은 다음과 같습니다.
- 버튼1
HUD: UI 표시 모드 전환. 초기 상태에서는 UI가 현실 세계에 고정되며, HUD를 켜면 UI가 항상 시야 앞에 표시됩니다. - 버튼2
Record: EIF 녹화 전환. 켠 후에는 반드시 꺼야 정상적인 EIF 파일이 녹화되며, 그렇지 않으면 생성된 파일을 사용할 수 없습니다. - 버튼3
Image: 이미지 추적 전환. - 버튼4
Image Fusion: 이미지 추적 + 모션 퓨전 모드 전환. - 버튼5
Dense: 밀집 공간 매핑 전환. - 버튼6
Sparse: 희소 공간 매핑 전환. - 버튼7
Mega: Mega 전환.
기능 상세 설명
기본 기능 스위치
모든 기능은 시작 시 기본적으로 꺼져 있습니다. 이는 에디터에서 해당 스크립트를 비활성화하여 구현되며, 버튼 조작은 해당 스크립트의 활성화/비활성화를 제어합니다. 실행할 샘플에 따라 기본 활성화할 기능을 설정할 수 있습니다.
좌표계 원점 참조
샘플에서는 모션 추적 좌표계 원점에 고정 판다 모델을 배치하여 모션 추적 상태를 확인합니다. 이 모델은 문제 분리에 도움이 됩니다(예: Mega 실행 시 빠른 드리프트가 디바이스 모션 추적(디바이스 자체 결함)으로 인한 경우, 이 모델도 함께 드리프트됩니다). 필요에 따라 이 판다 모델을 조정하거나 제거할 수 있습니다.
내장 이미지 추적용 타겟 이미지 사용
샘플에는 평면 이미지 추적에 사용할 이미지의 크기가 미리 설정되어 있습니다. A4 용지에 namecard.jpg를 인쇄하여 사용해야 하며, 이미지 비율이 늘어나거나 잘리지 않도록 하고 최대한 용지에 꽉 차게 인쇄해야 합니다(아래 그림).
인쇄된 명함 패턴의 실제 길이를 측정한 후, 측정 결과에 따라 Unity 씬의
Image TargetScale을 실제 물리적 크기와 일치하도록 설정합니다(단위: 미터).
EasyAR 모션 퓨전이 켜진 상태에서는 고정 위치(이동 불가)의 이미지만 추적할 수 있습니다. 모션 퓨전이 꺼진 상태에서는 이미지가 시야를 벗어나면 추적이 불가능합니다.안경 시야각이 카메라 이미지 크기를 제대로 반영하지 못할 경우, 인식이 안 되면 안경 카메라를 이미지에 더 가까이 대어 보세요. 실제 사용 시에는 5미터x5미터 크기와 같은 더 큰 이미지를 추적하는 것이 좋습니다.
참고
헤드셋에서는 EasyAR 모션 퓨전 기능의 켜짐/꺼짐 여부와 관계없이 image target의 Scale 매개변수를 반드시 실제 물리적 크기로 설정해야 합니다. 그렇지 않으면 표시 위치가 잘못됩니다.
Mega 설정
EasyAR Mega를 사용하는 경우 Mega Unity 빠른 시작을 참고하세요.