Быстрый старт - AR с 8thwall

В этом руководстве рассматривается, как использовать wonderland-ar-tracking вместе с 8thwall.

Вы можете использовать любые из поддерживаемых возможностей отслеживания 8thwall:

  • Отслеживание SLAM
  • Отслеживание изображений (плоских и цилиндрических)
  • Отслеживание лиц
  • VPS (мировое отслеживание с предварительно отсканированной сеткой для сокрытия)

Установка шаблонов проектов 

Скачайте репозиторий wonderland-ar-tracking, либо как ZIP (<> Code > Скачать ZIP), либо клонируйте с помощью git.

Извлеките папку и скопируйте папку “SLAM-camera” из examples в вашу папку templates. Папка templates будет расположена по следующим адресам, в зависимости от вашей операционной системы:

  • Windows: %APPDATA%/WonderlandEngine (%APPDATA% можно ввести в адресной строке Проводника Windows, и она решается в C:\Users\<Имя пользователя>\AppData\Roaming)
  • MacOS: ~/Library/Application Support/WonderlandEngine (~ - это ваш домашний каталог)
  • Linux: ~/.WonderlandEngine/

Создание проекта 

Если вы правильно настроили шаблон, вы увидите следующее при создании нового проекта в Wonderland Editor:

Быстрый старт - AR с 8thwall

С выбранным новым шаблоном вы можете создать проект.

Тестирование 

Для локального тестирования проекта 8thwall требует настроить локальные сертификаты, так как они блокируют предоставление без HTTPS.

Настройка SSL сертификатов 

Чтобы сгенерировать собственные SSL сертификаты для localhost, откройте Views > Preferences > Server и нажмите Generate Certificates. Предпочитаемые значения будут установлены автоматически.

Наконец, перезапустите сервер: Остановите сервер, нажав на “localhost:8080” в верхней части окна редактора, потом “Stop Server”. Затем нажмите на “not running”, затем “Start Server”, чтобы снова запустить сервер.

Просмотр на смартфоне 

Для Android:

  1. Убедитесь, что у вас на устройстве включена “Отладка по USB”.
  2. Подключите устройство через USB.
  3. Выберите “Local Device”, чтобы вызвать на устройстве диалог “Разрешить отладку USB”.
  4. После утверждения вы можете выбрать устройство в выпадающем списке.
  5. Отметьте флажок “SSL”.
  6. Нажмите зеленую стрелку, чтобы запустить браузер с этой страницей на вашем смартфоне.

Для iOS:

  1. Подключите ваше устройство iOS и Mac к одной и той же Wi-Fi сети.
  2. На вашем Mac найдите имя вашего Mac: перейдите в Системные настройки > Общий доступ, чтобы найти имя вашего Mac.
  3. (по желанию) Установите сгенерированные выше SSL сертификаты на ваше устройство iOS: Или отправьте сертификат себе по электронной почте и установите его через почтовое приложение, или используйте Apple Configurator.
  4. (по желанию) Доверяйте установленному сертификату на вашем устройстве iOS, перейдя в Настройки > Основные > Об этом устройстве > Параметры доверия сертификатов.
  5. Откройте Safari на вашем устройстве iOS: Введите URL http://YourMacName.local:8080 или https://YourMacName.local:8081 при использовании SSL.

Публикация 

Для публикации вашего проекта на основе 8thwall необходимо заменить 8thwall API Token в src/index.js.

Создание проекта 8thwall 

  1. Создайте аккаунт на 8thwall.com. На вашей Dashboard 8th Wall нажмите “Start a new project”.
  2. Выберите “Self-Hosted”.
  3. Установите имя проекта и “Тип лицензии”, который соответствует вашим нуждам.
  4. Нажмите “Create”.
  5. Добавьте домены, на которых вы размещаете, в “Setup Domains”.
  6. Перейдите в “Settings” (значок шестеренки слева)
  7. Скопируйте ключ приложения из раздела “My App Key”.

Вставьте ключ приложения в файл src/index.js: Замените значение window.API_TOKEN_XR8 = '<here>';.