Table of Contents

Использование AllSamplesLauncher для быстрого ознакомления с примерами EasyAR

AllSamplesLauncher — это интегрированный загрузчик примеров, который поможет вам быстро ознакомиться с функциями EasyAR SDK. С помощью этого загрузчика вы можете переключаться и запускать все официальные примеры сцен в одном проекте Unity одним щелчком, без необходимости ручной настройки нескольких независимых проектов.

Подготовка

Прежде чем начать, убедитесь, что вы выполнили следующие подготовительные шаги:

  1. Установлены Unity Hub и редактор Unity
  2. Создан новый проект Unity
  3. Импортирован плагин EasyAR Sense Unity Plugin и все Samples

Пожалуйста, обратитесь к инструкциям в Быстрый старт и выполните шаги по порядку.

Подробные шаги

  1. Откройте все сцены в папке Samples.
    All Sample Scenes
  2. В меню выберите File > Build Settings или Build Profiles > Scene List.
  3. Перетащите все сцены в Scene List.
  4. Убедитесь, что AllSamplesLauncher находится первой в списке всех сцен. Если это не так, перетащите его в окне.
    Scene List Order
  5. В меню выберите File > Build And Run для сборки и запуска.
Примечание

При сборке и запуске на мобильном устройстве, не добавляйте сцены для шлемов дополненной реальности:

  • Combination_BasedOn_AppleVisionPro
  • Combination_BasedOn_Xreal
    Donot Load Headset

Проблемы при сборке

В процессе компиляции и сборки вы можете столкнуться с некоторыми ошибками. Распространенные проблемы:

Сообщение об ошибке Причина Решение
FileNotFoundException:EasyAR Settings Asset Не заполнен лицензионный ключ В меню выберите EasyAR > Sense > Configuration, в разделе EasyAR Sense License введите ваш License Key
Missing Prefab Asset: 'XR Interaction Setup' Отсутствуют файлы, связанные со шлемом Удалите сцены, связанные со шлемами, из списка сцен для сборки. Если вы уверены, что вам нужен шлем, выполните шаги из Использование примеров для шлемов

Использование загрузчика

После запуска вы увидите простой интерфейс загрузчика.

Lanucher Homepage

Нажмите кнопку Samples внизу по центру, чтобы перейти к списку примеров всех функций.

Lanucher Samplepage

Слева находятся категории функций, справа — список примеров сцен для каждой функции. Нажимая на разные примеры сцен, вы можете опробовать все различные функции, предоставляемые EasyAR.

Кроме того, в нижней части интерфейса представлены демонстрационные видео функций EasyAR Sense и EasyAR Mega, которые помогут вам лучше понять, какие возможности и эффекты может предложить EasyAR.

Обязательно к прочтению перед запуском примеров

Перед запуском определенных примеров вы должны выполнить следующие ключевые настройки, иначе примеры не будут работать корректно:

  1. Установите ваш API Key

    • Некоторым примерам (особенно связанным с облачным распознаванием, облачным позиционированием Mega и т.д.) требуется действующий API Key.
    • В меню выберите EasyAR > Sense > Configuration, найдите соответствующие поля, которые необходимо заполнить для примера.
    • Введите App ID, API Key, API Secret, полученные вами в Центре разработчиков EasyAR.
      Key Configuration
    • Важно: Если у вас еще нет API Key, примеры локальных функций (таких как отслеживание изображений) могут по-прежнему работать, но облачные функции завершатся ошибкой. Обязательно перейдите в Центр разработчиков EasyAR, чтобы создать приложение и получить ключи.

  2. Настройте поддержку XR/платформы:

    • Если вы запускаете примеры, связанные со шлемами, следуйте инструкциям в Использование примеров для шлемов.
    • Убедитесь, что ваше устройство (например, телефон или шлем) правильно подключено и находится в режиме разработчика.

Глубокое изучение примеров

Загрузчик примеров — лучшая отправная точка для вашего обучения. Мы настоятельно рекомендуем:

  • Сначала запустите, затем изучите: Быстро опробуйте эффект каждого примера через загрузчик, чтобы получить наглядное представление о возможностях EasyAR.
  • Откройте исходные файлы сцен: Каждый пример представляет собой независимый файл сцены Unity, расположенный в каталоге Assets/Samples/EasyAR Sense Unity Plugin/[версия]/__All Samples__/[название функции]/[название примера]/Scenes.
  • Изучите и прочтите скрипты: В сценах примеров вы можете открыть прилагаемые скрипты *.cs, чтобы увидеть, как мы вызываем API EasyAR для реализации конкретных функций. Это лучший способ изучить методы использования API.

С помощью загрузчика примеров вы можете быстро получить представление о функциях EasyAR SDK. Приятного изучения!