Table of Contents

EasyAR Sense Unity Plugin 릴리스 노트

EasyAR Sense Unity Plugin 4000 릴리스를 발표하게 되어 기쁘게 생각합니다. 이번 버전은 EasyAR이 완성된 API와 최신 기기 지원을 갖추었음을 의미하며, 향후 버전 업데이트도 이전보다 더 자주 이루어질 예정입니다.

새로운 기능과 개선 사항을 경험하려면 EasyAR Sense Unity Plugin 4000을 다운로드하세요.

이전 버전

버전 4001.0.0

릴리스 날짜: 2026-03-10

  • 🐛 네이티브에서 Unity로의 pose 변환에서 발생하던 수치 문제를 수정했습니다. 이 문제는 특정 기기에서 Mega 사용 시 짧은 시간 동안 pose 튐 현상이 발생하여 콘텐츠가 빠르게 깜빡이거나 흔들리는 원인이 되었습니다. 이 수정은 다른 유사한 잠재적 문제도 해결할 수 있습니다.
  • 🔧 MegaTrackerFrameFilter 인터페이스 일부를 EasyAR Sense 인터페이스 변경에 맞게 조정했습니다.
  • ⬆️ EasyAR Sense를 4.8.0으로 업데이트했습니다.

버전 4000.0.1

릴리스 날짜: 2025-11-14

  • 🐛 수정: minify 빌드가 활성화된 Android 빌드에서 정적 메서드(loadLibraries, setupActivity) 누락으로 인해 발생할 수 있는 런타임 AndroidJavaException 예외를 해결했습니다. 이 오류는 EasyAR 실행 실패를 유발했습니다.

버전 4000.0.0

릴리스 날짜: 2025-10-20

이 버전부터 EasyAR Sense Unity Plugin은 Unity가 요구하는 패키지 버전 관리(Semantic Versioning 사용)를 따릅니다. 따라서 버전 번호는 EasyAR Sense와 다를 수 있으며, 릴리스 빈도도 달라질 수 있습니다. 이 플러그인 버전은 EasyAR Sense 4.7.0 정식 버전을 포함합니다.

EasyAR Sense Unity Plugin 4000.0.0은 다음과 같은 주요 변경 사항을 도입했습니다:

  1. Unity 및 AR Foundation 호환성 변경
    이 버전부터 EasyAR Sense Unity Plugin은 Unity 2021.3 이상 버전만 지원하며, Unity 6 지원도 완료되었습니다. 또한 AR Foundation 지원이 플러그인 패키지 내부로 통합되었으며, 이 버전은 AR Foundation 5 이상만 지원합니다. 사용법이 크게 단순화되었습니다. AR Foundation 컴포넌트가 씬에 추가된 경우, 런타임에 AR Foundation 사용 여부와 관계없이 씬 구성과 스크립트 코드를 변경할 필요가 없습니다.

  2. 최신 헤드셋 지원 확대, 다중 OST/VST 헤드셋 지원 추가
    업계 여러 기업과의 다년간 협력을 통해 EasyAR의 헤드셋 지원이 표준화되었습니다. 이제 EasyAR Sense Unity Plugin 확장 기능을 통해 서드파티 헤드셋 기기 지원을 구현할 수 있습니다(헤드셋 제조업체의 일부 데이터 인터페이스 제공이 필요할 수 있음). 이 버전은 Apple Vision Pro 및 XREAL Air2 Ultra 지원을 기본 내장하고 있으며, EasyAR Sense Unity Plugin 확장 패키지를 통해 Pico 4 Ultra Enterprise 및 Rokid AR Studio를 지원합니다.
    또한 EasyAR 파트너사(예: Xrany)를 통해 다른 기기 지원 확장 패키지를 획득할 수 있습니다.

  3. Unity 컴포넌트 인터페이스 개선, ARSession 워크플로우 최적화
    이 버전은 Unity 컴포넌트를 통해 EasyAR Sense 기능을 완전히 캡슐화한 첫 번째 버전입니다. ARSession이 대폭 최적화 및 재작성되어 이제 기기 또는 기능 지원 여부를 쉽게 확인하고, 런타임에 ARSession 전환 또는 다양한 AR 기능을 위해 ARSession을 시작/중지할 수 있습니다. 또한 런타임에 ARSessionFactory를 사용하여 ARSession 및 관련 컴포넌트를 생성할 수 있습니다. 이 버전은 관성 내비게이션 및 3DoF 카메라 기능도 추가되었으며, 이 기능들은 주로 EasyAR Mega를 위해 설계되었지만 독립적으로 사용할 수도 있습니다.

  4. 다중 개발 및 진단 도구 추가
    이 버전은 완전히 새로운 EIF 녹화 및 재생 기능을 제공합니다. 과거 버전에서도 EIF 녹화/재생이 가능했지만, 이제까지 EIF 사용이 이렇게 간편한 적은 없었습니다. Unity 에디터에서 세션 유효성 검사 도구(Session Validation Tool)를 사용하여 eif 파일을 직접 재생하고 장면을 구동할 수 있습니다. 이미지 트래킹, 공간 매핑 또는 EasyAR Mega 등 모든 기능을 PC에서 기기 실행 효과를 재현할 수 있습니다. 또한 런타임 진단 패널(EasyAR Diagnostics Panel)을 통해 앱 내에서 eif 녹화 기능을 쉽게 활성화하거나, ARSession 및 컴포넌트의 주요 상태 정보 표시를 언제든지 토글할 수 있습니다. 샘플 프로젝트도 전체적으로 재작성되어, 샘플 실행 시 ARSession 상태와 eif 녹화 버튼을 바로 확인할 수 있도록 개선되었습니다.

  5. EasyAR Mega 도구 공개
    이 버전은 Mega Studio 2.12를 통합하여 배포합니다. 향후 플러그인 업데이트는 더욱 빈번해질 예정이며, Unity 측 Mega 도구는 점차 플러그인 내부로 통합되어 정기 업데이트와 함께 배포될 것입니다. 이전 프리릴리스 버전의 업데이트 외에도, 이 버전은 기본적으로 관성 내비게이션 지원을 활성화하여 EasyAR Mega의 기기 지원 범위를 대폭 확장했습니다. 또한 최신 버전의 EasyAR Mega Landmark 서비스를 지원합니다. EasyAR Mega 사용은 EasyAR 웹사이트 페이지를 통해 신청할 수 있습니다.

자세한 업데이트 내용은 다음과 같습니다:

Unity 및 AR Foundation 호환성 변경사항:

  • 🔧 Unity: Unity 2021.3 이상 버전 지원 (Unity 2022.x/Unity 6.x 포함)
    • 🔥 Unity 2019/Unity 2020 지원 중단
    • 🔥 Unity 2019용 gradle 버전 감지 기능 제거
    • 🔥 Unity 2019용 옵션 DisableARCoreAREngine 제거
  • ✨ Unity 6: Unity 6 완전 지원
    • ✨ URP 17+ 및 Render Graph 지원
    • 🐛 수정됨: Unity 6에서 ClassLoader 동작 변경으로 인한 ARCore 실패 문제
    • 🐛 수정됨: Render Scale이 1이 아닐 때 카메라 렌더링 실패 문제
    • 🐛 Unity 6 자체 BUG: iOS/Mac 기기에서 카메라 텍스처를 가져올 필요가 있는 경우 시각적 오류 및 아티팩트가 관찰될 수 있음. 이 문제를 부분적으로 완화하는 조치를 추가했으나 완전히 제거할 수 없음. Unity에 보고됨 - Unity Issue UUM-87787 참조. Unity 6.2 이상에서는 Universal Render Pipeline Asset의 Render Scale을 0.96-1.05 범위 밖의 값으로 설정하여 이 문제를 회피할 수 있음.
    • 🐛 Unity 6 자체 BUG: Windows DX11에서 렌더링이 올바르지 않음. Unity 6.0-6.1에서 완화 조치를 추가함. 테스트 결과 Unity 6.2에서 수정됨.
  • ✨ AR Foundation: AR Foundation 5 이상 버전 지원, 사용이 크게 간소화됨
    • ✨ AR Foundation 지원이 플러그인 패키지 내부로 통합됨. 별도 패키지 임포트 불필요 (특별한 경우 구성 옵션으로 비활성화 가능)
    • ✨ Unity.XR.CoreUtils.XROrigin을 ARSession의 원점으로 재사용 지원, XROrigin의 카메라 재사용 지원
    • ✨ Unity XR Auto Switch 구성 옵션 추가. 기본적으로 Unity XR (AR Foundation 포함) 객체 전환 처리
    • ✨ EasyAR 메뉴로 생성된 ARSession은 자동으로 AR Foundation 지원을 포함하고 기본적으로 활성화됨
    • ✨ 대부분의 샘플에 AR Foundation 지원 추가됨 (AR Foundation 자체는 수동 임포트 및 올바른 구성 필요)
    • 🔧 ARCore 및 ARKit을 개별적으로 제어 가능. EasyAR 내장 ARCore/ARKit과 AR Foundation의 ARCore/ARKit 간 우선순위 제어 가능
    • 🔥 AR Foundation 4 지원 중단
    • 🔥 ARSessionOrigin 지원 중단, XROrigin만 지원
    • 🔥 AR Foundation의 ARCore 설치 절차를 대행하는 기능 제거
  • ✨ Input System Package 완전 호환

최신 헤드셋 지원을 통한 진화, 다양한 OST/VST 헤드셋 지원 추가:

  • 🚀 헤드 마운트 디스플레이(HMD) 인터페이스 안정화, 제3자 접근 지원
    • ✨ 제3자 기기 접근 지원 (헤드셋 제조사별 특정 데이터 인터페이스 필요)
    • ✨ XROrigin 및 XR Interaction Toolkit 지원
    • ✨ 모든 헤드셋 예제 단순화 및 통일, 코드 제로, 기능 전환 지원
    • ✨ 어안 렌즈(fisheye) 카메라 입력 지원
    • ✨ 사용자 정의 카메라 입력 3DOF 데이터 지원
    • ✨ 메뉴 기능 추가: Extensions, 모든 확장 메뉴 항목 통합
    • 🐛 특정 헤드셋에서 DenseSpatialMap 실행 시 발생하던 렌더링 오류 수정
    • 🔥 ActionOne 및 BT350 등 구형 안경 샘플 제거
  • ✨ Apple Vision Pro 내장 지원
    • ✨ Metal, RealityKit 및 Hybrid 모드 지원
    • ✨ visionOS >= 2.0 지원, visionOS 26 지원
  • ✨ XREAL Air2 Ultra 내장 지원 (XREAL SDK >= 3.1 필요)
    • ✨ 별도의 지원 패키지 임포트 불필요
    • ⚡ XREAL에서의 실행 성능 최적화
    • 🔥 XREAL Light 지원 중단
  • ✨ EasyAR Sense Unity Plugin 확장 배포를 통한 Pico, Rokid 등 기타 기기 지원
    • ✨ 제3자 기기 접근 참조 템플릿 제공 com.easyar.sense.ext.hmdtemplate
    • ✨ Pico 4 Ultra Enterprise 지원 (PICO Unity Integration SDK >= 3.1 필요)
    • ✨ Rokid AR Studio 지원 (Rokid Unity OpenXR Plugin >= 3.0.3 필요)
    • ✨ 이 확장들은 향후 여러 버전의 EasyAR Sense Unity Plugin을 지원할 예정
  • ✨ EasyAR XR License 지원
    • 🔧 헤드셋에서 EasyAR 사용 시 EasyAR XR License 필요 및 최초 인터넷 연결 보장 (체험판은 매번 연결 필요)

Unity 컴포넌트 인터페이스 개선, ARSession 워크플로우 대폭 최적화:

  • 🚀 Unity 컴포넌트 레이어 캡슐화 개선
    • ✨ 장면 컴포넌트 개선, 모든 EasyAR Sense 기능 제공
    • 🔥 컴포넌트를 통해 캡슐화된 모든 EasyAR Sense 레이어 인터페이스 제거
    • 🔥 모든 내부 인터페이스 제거
  • ✨ ARSession: 재작성 및 워크플로우 대폭 최적화
    • ✨ 언제든지 세션 시작 및 중지 지원
    • ✨ 세션 자동 시작 제어 지원
    • ✨ 화면이 검게 변하지 않고 세션 기능 및 입력 소스 전환 지원
    • ✨ 장치 지원 판단 단순화, 일관된 인터페이스로 제공
    • ✨ 시작 시 MotionTracker, ARCore, AR Engine의 장치 지원 목록 업데이트
    • ✨ 장치 목록 업데이트 후 세션 자동 재시작 지원
    • ✨ 상세 세션 손상 정보 획득 지원
    • ✨ 세션 내부 상태 자체 진단 추가
    • 🔥 ARComponentPicker 제거, 해당 기능은 다른 세션 워크플로우로 대체
    • 🔥 다중 ARSession 동시 실행 금지
  • ✨ ARSessionFactory: 런타임에 ARSession 및 관련 컴포넌트 생성 기능 제공
    • ✨ ARSessionFactory를 통해 에디터 메뉴와 동일한 세션을 런타임에 생성 지원
    • ✨ 프레임 소스 정렬 기능 추가 (메뉴 항목 포함)
  • ✨ FrameSource: 관성 내비게이션 및 3DoF 지원 추가
    • ✨ 관성 내비게이션 지원을 위한 InertialCameraDeviceFrameSource 추가
    • ✨ 3DoF 카메라 지원을 위한 ThreeDofCameraDeviceFrameSource 추가
    • ✨ 메뉴 기능 추가: Frame Source by Transform Type, 모든 내장 프레임 소스 목록 제공
    • ⚡ 인스펙터 옵션 최적화
  • ✨ 기타 인터페이스 조정 및 기능 업데이트
    • ✨ Texture2D를 사용하여 ImageTarget 생성 기능 추가
    • ✨ 이미지 유형 데이터(카메라 이미지 또는 타겟 이미지 등) 렌더링을 위한 ImageMaterial 추가
    • ✨ GameObject의 active를 제어하고 관련 로직을 통합하는 ActiveController 추가
    • ✨ 데스크톱에서 화면 회전 시뮬레이션 기능 추가
    • ✨ XROriginChildController 추가, 세션 원점 아래 오브젝트의 동작 제어
    • 🔥 WorldRootController 제거
    • 🔧 스파스 공간 맵 인터페이스를 Builder와 Tracker 두 개의 기능 컴포넌트로 분할
    • 🔧 EasyARController 조정, 애플리케이션/시스템 수준 정적 기능 제공
    • 🔧 타겟 컴포넌트 인터페이스 통일
    • 🔧 서비스 데이터 접근 인터페이스 통일

추가된 여러 개발 및 진단 도구:

  • 🚀 편집 시 진단 도구 추가: Session Validation Tool
    • ✨ 어느 시나리오에서든 eif 재생 간소화
    • ✨ eif 재생 흐름 제어 지원
    • ✨ 세션 흐름 제어 지원
  • 🚀 런타임 진단 패널 추가: EasyAR Diagnostics Panel
    • ✨ Developer Mode 스위치 추가, 기본적으로 화면 8회 탭으로 Diagnostics Panel 켜기/끄기 가능, 온라인 앱에서 eif 녹화 및 문제 피드백 간소화
    • ✨ 커스텀 Developer Mode 스위치 지원, 사용자 정의 상호작용으로 Diagnostics Panel 제어
    • ✨ eif 녹화 제어 지원
    • ✨ 세션 정보 표시 제어 지원
    • ✨ eed 녹화 제어 지원
  • ✨ 완전히 새로운 EIF 녹화 및 재생 기능 추가
    • ✨ FrameRecorder가 자동으로 ARSession에 조립되어 수동 선택 불필요
    • ✨ FrameRecorder가 기본적으로 자동 파일명 생성하여 스크립트 없이 사용 지원
    • ✨ 새로운 형식으로 녹화된 데이터를 사용하는 FramePlayer는 재생 건너뛰기 및 속도 조절 지원, 파일 크기 감소
    • 🔧 컴퓨터에서 eif를 사용하여 장면 및 AR 기능 구동 지원 (신규 기능 아님)
  • ✨ DiagnosticsController 추가, 진단 기능 통합 및 최적화
    • ✨ 정보 등급별 표시 및 제어 추가, 기본적으로 모든 오류 및 경고 메시지가 UI 통해 표시됨
    • ✨ ARSession 및 그 구성 요소의 핵심 상태 정보 표시 기능 추가, 기본적으로 UI 통해 표시되며 매 프레임 업데이트됨
    • 🔧 진단 기능을 사용하여 문제 피드백 정보 획득 간소화
    • 🔥 GUIPopup 삭제
  • 🔧 예외 상태 동작 및 오류 메시지 표시 최적화
    • 🔧 사용 가능한 frame source 없음 시 오류 메시지 최적화
    • 🔧 URP 환경에서 AR Foundation 또는 헤드셋 렌더링 카메라 대신 EasyAR 사용 시, RendererFeature가 올바르게 구성되지 않으면 오류 발생 및 ARSession 실행 중단
    • 🔧 Origin의 기본 Active 제어 전략 수정, 트래킹 손실 시 콘텐츠가 사라지지 않고 화면에 고정됨
    • 🔧 커스텀 카메라 또는 헤드셋에서 평가판 제품 사용 시, 제한 시간 도달 시 효과 오판 방지를 위해 모든 콘텐츠 숨김
  • 🔧 구성 페이지 내용 및 옵션 최적화
    • ✨ EasyAR Sense 라이브러리 변종 선택 지원
    • 🔒 애플리케이션 권한 부분에서 카메라 권한 외 나머지 권한은 변경 불가, EasyAR Sense 라이브러리 변종 및 Mega 활성화 여부에 따라 결정됨
    • 🔧 기능 및 서버 구성이 EasyAR 기능별로 그룹화됨
    • 🔧 타사 AR SDK 구성 통합 관리
    • 🔧 Unity용 Workaround 구성 통합 관리

EasyAR Mega 도구 전체 공개:

  • 🚀 전체 공개, 동기화 업데이트
    • ✨ 통합 릴리스 Mega Studio 2.12
    • 🔧 Unity 측 Mega 도구는 점진적으로 플러그인 내부로 병합되며, 향후에도 최신 버전의 통합 패키지만 제공될 예정이지만, EasyAR Sense Unity Plugin의 정기 업데이트와 병합되어 릴리스됩니다.
    • 🔧 EasyAR Mega는 여전히 EasyAR 웹사이트 페이지를 통해 신청하고 승인을 받아야 사용 가능합니다.
  • ✨ 새로운 지원 EasyAR Mega Landmark
  • ✨ 새로운 지원 5DOF 관성 내비게이션 및 기본 활성화, EasyAR Mega의 장치 지원 범위를 더욱 크게 확장
  • ✨ 새로운 지원 API Token을 통한 Mega 서비스 접근
  • 🔧 Mega 효과 및 개발 경험 최적화 (과거 업데이트된 4.7.x 버전 내 포함)
    • ✨ 지원 3DOF 순수 회전 모드 및 0DOF 모드 (기본 비활성화)
    • ✨ 에디터 진단을 위한 EditorCameraDeviceFrameSource 추가, 불완전한 샘플 복사로 인한 휴대폰에서의 오작동 방지
    • ✨ Mega 사용 시 구버전 eif 데이터 녹화 시, FrameRecorder가 자동으로 .eif.json 파일 생성
    • 🔧 원격 디버깅의 퇴화 옵션 대신 LocationInputMode 사용
    • 🔧 트래킹 없는 모드를 독립 컴포넌트로 분리, 일반적으로 더 이상 사용하거나 주의할 필요 없음
    • 🔧 BlockRootSource 옵션 추가, 기본 구성에서 BlockRoot 설정을 잊어버리면 오류 발생
    • 🔧 다중 block에 위치할 때의 기본 동작 조정, 다중 block이 기본적으로 사용되지 않도록 보장
    • 🔧 일부 인터페이스 명칭 조정
    • 🔧 세션에 Mega가 포함되어 있으나 사용할 수 없을 때 더 명확한 예외 발생
    • 🔧 Mega가 지원하는 MotionTracker의 최소 QualityLevel을 Limited로 조정
    • 🐛 CloudLocalizerStatus.WakingUp 상태가 올바르게 이스케이프되지 않아 발생하던 런타임 오류 수정
    • 🔧 일부 최적화 및 수정 사항은 EasyAR Sense의 업데이트 로그 참조

샘플 재작성 및 최적화:

  • ✨ 모든 샘플 다시 작성
    • ✨ 다양한 Input System 구성과 호환
    • ✨ URP17+와 호환
    • ✨ AR Foundation 사용과 호환
    • 🔧 AR Foundation 미사용과 호환
    • 🔧 AR Foundation 지원이 없는 소량의 샘플 유지
    • ⚡ 스크립트 및 인터페이스 호출 최적화
    • 🚚 일부 샘플 이름 변경
    • 🔧 샘플 내 모델 및 비디오 등 리소스 교체
    • ⚡ streaming assets 사용 감소, 특정 기능을 보여주는 샘플에서만 사용 및 임포트
    • ✨ Texture2D를 사용하여 ImageTarget 생성
  • ✨ 새로운 기능 및 인터페이스 데모 추가
    • ✨ Workflow_ARSession 샘플 추가: session 기본 워크플로우 및 디바이스 지원 학습용
    • ✨ Workflow_FrameSource_ExternalImageStream 샘플 추가: 비디오를 커스텀 카메라로 사용 (헤드셋에는 사용 불가)
    • ✨ Combination_BasedOn_MotionTracking 샘플 추가: 모션 트래킹 사용 가능 시 다양한 기능 사용, 전환 및 AR Foundation 전환 학습용
    • ✨ Combination_BasedOn_AppleVisionPro 샘플 추가: Apple Vision Pro에서 다양한 기능 사용 및 전환 데모
    • ✨ Combination_BasedOn_Xreal 샘플 추가: XREAL 디바이스에서 다양한 기능 사용 및 전환 데모
    • ✨ 여러 Mega 샘플 추가 (과거 4.7.x 업데이트에 포함됨)
    • ✨ Workflow_FrameSource_CameraDevice에 카메라 해상도 전환 및 토치 모드 기능 추가
    • 🔥 별도의 AR Foundation 샘플 제거: 기능이 다른 샘플에 포함됨
    • 🔥 FrameRecording 샘플 제거: 기능이 다른 샘플에 포함됨
    • 🔥 MotionTracking_Fusion 샘플 제거: 기능이 Combination_BasedOn_MotionTracking에 포함됨
    • 🔥 SurfaceTracking_ImageTarget 샘플 제거: 기능 조합은 여전히 쉽게 구현 가능
    • 🔥 Camera_CustomCamera 샘플 제거: 필요 시 직접 구현 가능
    • 🔥 ActionOne 및 BT350 등 구형 안경 샘플 제거
  • ✨ eif 녹화 및 재생 사용 간소화
    • ✨ 모든 샘플에 eif 녹화 버튼 추가, 녹화된 eif 파일은 에디터 내에서 사용 가능
  • ✨ 런처 재작성, 샘플 설명 포함
    • 🐛 런처를 통해 샘플 씬 로드 시 어두워지는 문제 수정

EasyAR 및 서드파티 AR 기능 통합:

  • ⬆️ EasyAR Sense 4.7.0 정식 버전으로 업데이트
  • ⬆️ EasyAR AR Engine Interop 업데이트
  • ⬆️ ARCore SDK 1.46.0으로 업데이트
  • 🔧 AR Engine을 합리적으로 실행할 수 없는 일부 폰에서 AR Engine 비활성화
  • 🐛 Unity 6에서 ClassLoader 동작 변경으로 인한 ARCore 실패 문제 수정

관련 주제