Совместимость Unity
В этой статье описываются версии Unity и требования к конфигурации, с которыми совместим EasyAR Sense Unity Plugin.
Версии Unity
EasyAR Sense Unity Plugin поддерживает Unity 2021.3 и выше.
Поддержка пакета EasyAR Mega, необходимого для разработки Mega-функций, поддерживает Unity 2021.3.30 и выше.
Совет
Как правило, EasyAR не зависит от многих изменяющихся API Unity, поэтому если Unity выпустит новую версию, EasyAR Sense Unity Plugin обычно будет работать исправно.
EasyAR Sense Unity Plugin с версии 4.6.4 поддерживает URP 17+ Render Graph для Unity 6.
Разработка на платформе
| Операционная система | Версия операционной системы | Архитектура CPU | Дополнительная информация |
|---|---|---|---|
| Windows | 7 и выше (7/8.1/10/11) | x86, x86_64 | Версии Windows N/KN требуют установки Media Feature Pack для использования |
| macOS | 11.0 и выше | x86_64, arm64 |
Кроме того, должны быть соблюдены требования к системе разработки Unity соответствующей версии (https://docs.unity3d.com/Manual/system-requirements.html).
Издание на платформе
| Операционная система | Версия операционной системы | Архитектура CPU | Дополнительная информация |
|---|---|---|---|
| Windows | 7 и выше (7/8.1/10/11) | x86, x86_64 | Версии Windows N/KN требуют установки Media Feature Pack для использования. Функция записи экрана EasyAR не поддерживается. |
| macOS | 11.0 и выше | x86_64, arm64 | Функция записи экрана EasyAR не поддерживается. |
| Android | 5.0 и выше | armv7a, arm64-v8a | Поддержка arm64-v8a требует включения IL2CPP. Функция записи экрана EasyAR поддерживается только при Graphics API OpenGLES2 или OpenGLES3. |
| 鸿蒙 (мобильная версия) | 1.0 – 4.x имеет原生альную поддержку 5 и выше поддерживаются через Android Application Compatibility Layer 1 |
arm64-v8a | |
| iOS | 15.0 и выше | arm64 | Архитектура должна быть настроена на ARM64, настройка на Universal не поддерживается. Функция записи экрана EasyAR не поддерживается. |
| visionOS | 2.0 и выше | arm64 | Функция записи экрана EasyAR не поддерживается. |
Кроме того, должны быть соблюдены требования к платформе выпуска Unity соответствующей версии:
Дополнительная информация по платформе macOS
Apple silicon
EasyAR Sense Unity Plugin с версии 4.6.0 поддерживает原生альную работу на устройствах Apple silicon и может быть использован в Unity Editor без проблем.
Примечание
В силу ошибки в поддержке原生альных плагинов Unity в некоторых версиях Unity приложение, созданное для "Apple silicon" или "Intel 64-bit + Apple silicon", может не работать исправно. Если обнаружите, что приложение не работает на Mac и отображается ошибка, похожая на "Fail to load EasyAR library" или "DllNotFoundException: EasyAR assembly", рекомендуется использовать новую версию Unity или обратиться за помощью к Unity и сообществу Unity.
Дополнительная информация по платформе Android
Поддержка размеров страниц памяти 16 KB для Android
EasyAR Sense Unity Plugin с версии 4000 поддерживает устройства с размером страницы памяти 16 KB.
Совет
Это функция, введенная в Android 15. Дополнительные сведения о ней см. в документации Android по поддержке размеров страниц 16 KB.
Предупреждение Google Play о том, что libhuawei_arengine_jni.so может привести к сбою приложения на устройствах с 16 KB
В стандартной конфигурации EasyAR Sense Unity Plugin использует AR Engine SDK 3.7.0.3 (включая libhuawei_arengine_jni.so) на платформе Android для поддержки Huawei AR Engine. Так как эта библиотека была скомпилирована华为 с использованием ранней версии Android NDK, Google Play может выдать предупреждение, но это не имеет фактического значения.
Your app could crash on 16 KB devices
base/lib/arm64-v8a/libhuawei_arengine_jni.so
Информация о AR Engine SDK:
- Версия 3.7.0.3 была скомпилирована华为 с использованием ранней версии Android NDK, что и является причиной появления предупреждения от Google Play. Подробнее см. в документации Google по компиляции приложений с использованием Android NDK r27 и ниже.
- Версия 3.7.0.3 поддерживает загрузку на устройствах с размером страницы памяти 16 KB для Android, что и является причиной того, что Google Play не запрещает публикацию приложения.
- Версия 4.0.0.5 не поддерживает загрузку на устройствах с размером страницы памяти 16 KB для Android, это последняя версия AR Engine SDK, доступная в Android-экосистеме, поэтому EasyAR Sense Unity Plugin по-прежнему использует версию 3.7.0.3.
Использование AR Engine SDK 3.7.0.3 в EasyAR Sense Unity Plugin не влияет на публикацию приложения в Google Play и не вызывает фактических сбоев:
- Huawei-devices не являются устройствами Android с 16 KB.
- EasyAR Sense использует механизм белого списка для избежания запуска AR Engine SDK на не-Huawei-devices.
Как обработать это предупреждение:
- Если необходимо использовать функцию AR Engine на Huawei-devices, рекомендуется проигнорировать это предупреждение.
- Если не требуется поддерживать Huawei-devices или можно обойтись без функции AR Engine, можно отключить AR Engine SDK в Настройках EasyAR.
Примечание
На Huawei-devices даже при отключении AR Engine другие функции EasyAR будут работать исправно, но эффект отслеживания движения будет отличаться от AR Engine, и другие функции, использующие отслеживание движения также будут поражены.
Дополнительная информация по платформе鸿蒙
Совместимость системы鸿蒙 с Android
EasyAR Sense Unity Plugin полностью поддерживает鸿蒙 1.0 – 4.x.
原生鸿蒙/纯血鸿蒙/HarmonyOS NEXT
EasyAR Sense Unity Plugin вскоре будет поддерживать原生鸿蒙 5.0+, текущая версия не поддерживает原生鸿蒙/纯血鸿蒙 и может использоваться только через Android Application Compatibility Layer.
Совет
Unity International Edition не поддерживает原生鸿蒙, используйте Unity Engine.
WebGL
EasyAR Sense Unity Plugin не поддерживает WebGL Unity.
Совет
Функции, разработанные с использованием непосредственно интерфейсов EasyAR Cloud Service (например, CRS Service Interface), могут быть опубликованы на веб-платформу.
Graphics API
EasyAR Sense Unity Plugin напрямую использует рендеринговый конвейер Unity, и все графические API, доступные в Unity, могут быть поддерживаются.
Scriptable Render Pipeline
EasyAR Sense Unity Plugin поддерживает Universal Render Pipeline (URP) 7.0.0 или выше.
EasyAR Sense Unity Plugin не поддерживает High Definition Render Pipeline (HDRP).
Примечание
Объявление о поддержке Unity 6 URP 17+ render graph
EasyAR поддерживает Unity 6 URP 17+ render graph, но в Unity по-прежнему остаются некоторые нерешенные проблемы. В случае возникновения аномальных ситуаций можно попробовать использовать URP Compatibility Mode, предоставляемый Unity.
Некоторые проблемы уже были решены в последней версии Unity, рекомендуется использовать версии 6.2 и выше.
Известные проблемы в несовместимом режиме включают:
[Не решено] При получении текстуры камеры из EasyAR (как в примере ImageTracking_Coloring3D и ARSession Workflow (CameraDevice)) на iOS/Mac- устройствах могут быть замечены аномалии зрения и артефакты. Мы уже воспроизвели эту проблему в чистом пакете Unity и сообщили о ней Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Обновление проблемы можно отслеживать по Unity Issue UUM-87787 и журналу выпусков будущих версий Unity.
Для всех версий Unity 6 можно использовать частичное решение, включенное по умолчанию.
Для Unity 6.2 и выше можно избежать этой проблемы, установив значение Render Scale в Universal Render Pipeline Asset вне диапазона 0.96-1.05.
[Исправлено в Unity 6.2] На Windows DX11 изображение с камеры может привести к непредсказуемому рендерингу объектов в сцене. В версиях Unity 6.0 - 6.1 EasyAR предоставляет вариант избежания] и включает его по умолчанию.
-
Текущая версия не поддерживает原生鸿蒙/纯血鸿蒙 5.0.↩