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

Введение

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

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

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

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

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

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

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

В более расширенном варианте, который заложен в плане подготовки промпта, страница может также учитывать глубокую ссылку (deeplink), срок действия сессии и резервный сценарий на случай ограничений 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 через резервный прокси-сценарий. Также в плане указано, что прямой CORS-вызов разрешён не для всех доменов-источников, поэтому при переносе решения на произвольный домен это нужно учитывать заранее.

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

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

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

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