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

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

마이그레이션 단계

버전 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 지원이 다시 구현되었습니다.

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 지원이 독립 package로 분리되었습니다.

AR Foundation을 사용할 필요가 없다면 장면의 AR Session 아래 AR Foundation 노드와 코드에서 ARFoundationFrameSource 사용을 삭제할 수 있습니다.

관련 변경:

AR Foundation 지원이 독립 package로 분리되었습니다.

Nreal을 사용할 필요가 없다면 장면의 AR Session 아래 Nreal 노드와 코드에서 NrealFrameSource 사용을 삭제할 수 있습니다. Nreal을 사용할 때 더 이상 가상 package를 만들 필요가 없습니다.

관련 변경:

Nreal 지원이 독립 package로 분리되었습니다.

스크립트의 API 문서와 버전 4.6 샘플을 참고하여 API 변경과 사용 방법을 이해하고 적절히 조정하는 것을 권장합니다.

관련 변경:

일부 다른 스크립트 API도 변경되었습니다.

일부 public 메서드는 XML 주석에서 internal로 표시되어 있습니다. 이러한 API 사용은 피해야 합니다. 이들은 버전 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에서 삭제되었습니다.

스크립트의 API 문서와 버전 4.4 샘플을 참고하여 API 변경과 사용 방법을 이해하고 적절히 조정하는 것을 권장합니다.