Как за несколько минут сделать свою AR-страницу для GIP VISION

Введение

В GIP VISION уже работает сценарий «Быстрый старт»: пользователь загружает файл модели, получает 6-значный Pin-код и открывает AR-сессию в мобильном приложении. На странице «Быстрый старт» сейчас поддерживаются файлы .ifc, .glb и .usdz, а после обработки пользователь получает код для открытия модели в приложении.

Для тех, кому нужен такой же сценарий под свой объект, внутреннюю демонстрацию или пилотный запуск, подготовлен готовый TXT-промпт. Его можно вставить в любую нейросеть и получить одностраничный index.html без сборки и фреймворков: со страницей загрузки модели, отправкой файла на API, получением one-time code и инструкцией для открытия модели в GIP VISION.

Сам базовый сценарий промпта зафиксирован так: страница должна отправить IFC-файл на endpoint POST /api/gip-vision/v1/session/by_plane/, получить в ответ onetime_code и показать пользователю, что этот код нужно ввести в iOS-приложении GIP VISION.

Такой подход подходит, когда нужно быстро собрать собственную точку входа в дополненную реальность без отдельной разработки веб-сервиса. По сути, вы получаете простую внешнюю страницу, через которую можно загрузить модель, сгенерировать код и сразу открыть проект в AR.

GIP VISION — приложение для работы со строительными проектами в дополненной реальности и на площадке. Оно позволяет размещать IFC-модели в реальном пространстве с точным масштабом и привязкой, сравнивать проект с фактом прямо на объекте, открывать модели по 6-значному Pin-коду и работать в offline-режиме. Отдельно в приложении доступен LiDAR SLAM-сканер для 3D-сканирования помещений и объектов. Программа для ЭВМ GIP VISION зарегистрирована в Роспатенте под № 2025618907.

Что именно вы получите

• минимальную HTML-страницу для загрузки модели
• отправку файла в AR-сессию GIP VISION
• получение one-time code от сервера
• вывод кода на экране
• инструкцию для пользователя, что код нужно ввести в приложении GIP VISION на iPhone

В более расширенном варианте, который заложен в плане подготовки промпта, страница может также учитывать deeplink, срок действия сессии и fallback-сценарий на случай ограничений CORS. В рабочем плане отдельно зафиксировано, что целевая страница должна возвращаться как один файл index.html, а для интерфейса нужно предусмотреть выбор файла, создание кода, вывод результата и кнопку открытия GIP VISION.

Как использовать

• Откройте приложенный TXT-файл с промптом.
• Вставьте его в любую нейросеть, которая умеет генерировать HTML-код.
• Получите готовый index.html.
• Разместите страницу у себя на сайте, тестовом домене или во внутреннем контуре.
• Загрузите модель.
• Получите код и введите его в приложении GIP VISION.

На публичной странице «Быстрый старт» GIP VISION этот сценарий уже реализован: пользователь загружает модель и получает Pin-код для приложения.

Сам промпт для генерации HTML-страницы

Нужно создать минимальную страницу html, которая состоит из заголовка GIP VISION,  file input (только ifc), и вывода ответа сервера.\nСтраница должна отправлять файл на указанный endpoint\n\nasync function createSessionByPlane() {\n  const fileInput = document.querySelector(\"#model-file-input\");\n  const modelFile = fileInput?.files?.[0];\n  if (!modelFile) {\n    throw new Error(\"Выберите IFC-файл в input#model-file-input\");\n  }\n\n  const formData = new FormData();\n  formData.append(\"model_file\", modelFile);\n\n  const response = await fetch(\"https://api-cpsk-superapp.gip.su/api/gip-vision/v1/session/by_plane/\", {\n    method: \"POST\",\n    body: formData,\n  });\n\n  const data = await response.json();\n  if (!response.ok) {\n    throw new Error(JSON.stringify(data));\n  }\n\n  console.log(response.status);\n  console.log(data);\n}\n\ncreateSessionByPlane().catch(console.error);\n\n\nСервер возвращает ответ {\n  \"onetime_code\": \"123456\"\n}\n\nНужно после получения ответа вывести пользователю onetime_code и сообщить, что этот код нужно ввести в ios-приложение GIP VISION.

Что важно учесть

В расширенном плане подготовки промпта отдельно зафиксированы дополнительные требования: поддержка нескольких форматов входных файлов, вывод one-time code, expires_at, deeplink, сценарий автооткрытия приложения и обработка ограничений CORS через proxy fallback. Также в плане указано, что прямой CORS-вызов разрешён не для всех origin, поэтому при переносе решения на произвольный домен это нужно учитывать заранее.

Где посмотреть рабочий пример

Готовый публичный пример уже доступен на странице «Быстрый старт» GIP VISION: там можно загрузить IFC, GLB или USDZ, получить 6-значный код и открыть модель в приложении. На странице указано ограничение до 100 MB для загружаемых файлов.

Файлы для создания страницы

Нажмите на нужную кнопку и скачайте материалы для быстрого запуска: план подготовки промпта, сам TXT-промпт и тестовую IFC-модель.