Перейти к основному содержимому

Введение

AR Clip VPS определяет, где находится устройство, по тому, что видит его камера. Здесь описано, как это работает, и по шагам разобран первый проект.

VPS — это система визуального позиционирования. Она удерживает AR-контент на своём месте в реальном мире без всяких маркеров. Она работает на телефонах, в браузере и на AR-очках и не зависит ни от точности GPS, ни от установки нативного приложения.

Как это работает​

У VPS две части:

  1. Построение карты. Вы снимаете реальное место, и AR Clip превращает съёмку в карту.
  2. Локализация. Устройство сравнивает изображение с камеры с этой картой и получает своё точное положение.

Построение карты​

Карта — это копия реального места, готовая для VPS. Снять её можно несколькими способами:

  • AR Clip Mapper — наше приложение для телефона. Оно записывает видео, которое нужно VPS.
  • Сканеры и камеры — LiDAR, камеры 360° и RGB-D-сенсоры (с глубиной).
  • REST API — загрузите изображения или облака точек, которые у вас уже есть.

AR Clip строит по съёмке карту. Когда обработка закончится, карта будет работать со всеми SDK.

Передавайте ID локации

У каждой карты есть ID локации. Передайте в SDK один или несколько ID локаций (locationIds), чтобы он знал, с какими картами сравнивать изображение с камеры. В REST API сама карта обозначается своим mapId.

Локализация​

Локализация находит положение и ориентацию устройства на карте — его позу (pose). VPS сравнивает кадры с камеры с картой и возвращает позу. Её точность зависит от качества карты и от условий на месте, например от освещения.

Для локализации можно использовать:

  • SDK для iOS, Android, Unity и веба;
  • проекты из AR Clip Studio — в браузере;
  • REST API — для серверной части или своих клиентов.

Первый проект​

  1. Создайте аккаунт на arclip.design. В бесплатный тариф входят SDK, REST API и инструменты для построения карт. apiKey вы получите при регистрации.
  2. Снимите карту. Используйте AR Clip Mapper или загрузите свои данные. Когда обработка закончится, карта появится в разделе Карты в консоли.
  3. Подключите SDK. Установите SDK для своей платформы и передайте ему apiKey и ID локаций своих карт. После успешной локализации начнут приходить обновления pose.
  4. Соберите AR-проект. Добавьте якоря, маршруты и контент в Unity, AR Clip Studio, Three.js или своём рендерере.

Токен разработчика​

<your-developer-token>

Токен есть в настройках аккаунта. Он нужен для запросов к REST API, например для автоматического управления картами.

Храните токен в секрете

Обращайтесь с ним как с паролем. Не вставляйте его в клиентский код, на скриншоты и в публичные репозитории. Если токен утёк, отзовите его в аккаунте и создайте новый.

Дальше: AR Clip Mapper — снимите свою первую карту.