EasyAR Sense Unity 플러그인 4.2 및 이전 버전에서 Unity 애플리케이션 마이그레이션

4.3 버전부터 Unity 플러그인은 Unity Package Manager를 통해 배포 및 관리되며, 플러그인 패키지 구조가 크게 조정되었습니다. 따라서 4.2 또는 그 이전 버전에서 4.3 이상 버전으로 업그레이드할 때는 몇 가지 추가 단계가 필요합니다.

Migration steps

4.2 또는 이전 버전에서 업그레이드할 때는 다음이 필요합니다:

Assets/EasyAR, Assets/Plugins, Assets/Samples, Assets/StreamingAssets 폴더에 존재할 수 있는 이전 버전 플러그인의 모든 파일을 삭제합니다.
그런 다음 Unity의 Package Manager window를 통해 새 버전을 임포트합니다.
아래의 각 버전별 마이그레이션 가이드에 따라 씬과 코드를 업데이트합니다.

4000 이상 버전으로 마이그레이션

4000 이상 버전으로 마이그레이션하려면 아래 변경 사항을 적용해야 합니다.

씬 구조를 재생성하려면 AR session 생성 및 구성을 참조하세요.

관련 변경 사항:

prefab이 삭제됨.

VIOCameraDeviceUnion이 삭제됨.

AR Foundation 사용 시 EasyAR 프로젝트에서 AR Foundation 활성화를 참조하여 AR Foundation을 사용하세요.

관련 변경 사항:

AR Foundation 지원이 재구현됨.

XREAL X 및 XREAL Light 같은 기기에서는 EasyAR를 사용할 수 없으며, XREAL Air2 Ultra로 교체하는 것이 좋습니다.

관련 변경 사항:

Nreal/XREAL X 및 Nreal/XREAL Light 지원이 중단됨.

XREAL 지원이 EasyAR Sense에 내장되어 XREAL Air2 Ultra를 지원함.

추가 마이그레이션 작업은 4000으로 마이그레이션을 참조하세요.

4000 버전은 4.x에 비해 더 많은 변경 사항이 있습니다.

버전 4.6으로 마이그레이션

[!주의] 버전 4.6은 더 이상 유지보수되지 않습니다. 4000으로 업그레이드하거나 최신 버전으로 바로 이동하는 것이 좋습니다. EasyAR 웹사이트의 포괄적인 Unity 개발 문서는 모두 4000 이상 버전을 위해 준비되었습니다.

버전 4.6으로 마이그레이션하려면 아래 변경 사항을 적용해야 합니다.

새로운 씬 구조를 이해하려면 4.6 버전 샘플을 참조하고 관련 컴포넌트를 재생성하는 것이 좋습니다.

관련 변경 사항:

prefab이 삭제됨.

VIOCameraDeviceUnion이 삭제됨.

AR Foundation 지원이 별도의 패키지로 분리됨.

AR Foundation을 사용하지 않을 경우, 씬의 AR Session 아래에 있는 AR Foundation 노드와 코드 내 ARFoundationFrameSource 사용을 삭제할 수 있습니다.

관련 변경 사항:

AR Foundation 지원이 별도의 패키지로 분리됨.

Nreal을 사용하지 않을 경우, 씬의 AR Session 아래에 있는 Nreal 노드와 코드 내 NrealFrameSource 사용을 삭제할 수 있습니다. Nreal 사용 시 더 이상 가상 패키지를 생성할 필요가 없습니다.

관련 변경 사항:

Nreal 지원이 별도의 패키지로 분리됨.

인터페이스 변경 사항 및 사용법을 이해하고 적절히 조정하려면 스크립트의 인터페이스 문서와 4.6 버전 샘플을 참조하는 것이 좋습니다.

관련 변경 사항:

일부 다른 스크립트 인터페이스도 변경되었습니다.

일부 public 메서드의 XML 주석이 internal로 표시되어 있습니다. 이러한 인터페이스는 사용하지 말아야 하며, 4000 버전에서 삭제되었습니다.

버전 4.4으로 마이그레이션

[!주의] 버전 4.4는 더 이상 유지보수되지 않습니다. 4000으로 업그레이드하거나 최신 버전으로 바로 이동하는 것이 좋습니다. EasyAR 웹사이트의 포괄적인 Unity 개발 문서는 모두 4000 이상 버전을 위해 준비되었습니다.

버전 4.4로 마이그레이션하려면 아래 변경 사항에 주의해야 합니다.

플러그인 패키지 내 prefab에 대한 참조를 가능한 한 제거해야 합니다. 이러한 prefab을 계속 사용하면 경고 로그가 표시되며, 이 로그에는 새 플러그인에서의 대체 방법에 대한 간단한 안내가 포함되어 있습니다. 새로운 씬 구조를 이해하려면 4.4 버전 샘플을 참조하는 것이 좋습니다.

관련 변경 사항:

prefab은 더 이상 사용되지 않음(obsolete)으로 표시되었으며 4.6 버전에서 삭제됨.

VIOCameraDeviceUnion 사용을 삭제합니다. 이 컴포넌트를 계속 사용하면 경고 로그가 표시되며, 이 로그에는 새 플러그인에서의 대체 방법에 대한 간단한 안내가 포함되어 있습니다. 새로운 씬 구조를 이해하려면 4.4 버전 샘플을 참조하는 것이 좋습니다.

관련 변경 사항:

VIOCameraDeviceUnion은 더 이상 사용되지 않음(obsolete)으로 표시되었으며 4.6 버전에서 삭제됨.