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

CAD / BIM / синтетические ассеты

Превращайте архитектурные или синтетические ассеты в карты AR Clip VPS для стройки, навигации внутри помещений или сценариев цифрового двойника.

Подготовка геометрии​

  1. Импортируйте модель CAD/BIM в Blender, Unity или похожий инструмент.
  2. Схлопните инстансы и удалите скрытую или ненужную геометрию.
  3. Сократите число полигонов, сохранив ключевые детали (ориентир — ≤5 миллионов треугольников).
  4. Сгенерируйте UV и запеките лёгкие текстуры, если планируете предпросмотр модели.

Планирование якорей​

[
  { "name": "lobby", "position": [0.0, 0.0, 0.0] },
  { "name": "elevator_north", "position": [12.4, 0.0, 28.9] }
]
  • Координаты задаются в метрах относительно начала координат модели.
  • Используйте устойчивые идентификаторы (lobby, loading_dock), чтобы код SDK мог брать их напрямую.

Загрузка через Python REST API​

# upload_cad.py
from pathlib import Path
import json
import os
import requests

API_BASE = "https://api.arclip.app/vps/api/v3"
TOKEN = os.environ["ARCLIP_TOKEN"]
MODEL = Path("exports/mall.glb")
ANCHORS = Path("exports/anchors.json")

headers = {"Authorization": f"Bearer {TOKEN}"}

payload = {
    "name": "Mall Digital Twin",
    "dataType": "mesh",
    "sourceFormat": "glb",
    "anchors": json.loads(ANCHORS.read_text()),
    "publish": False
}

init = requests.post(f"{API_BASE}/maps/import", json=payload, headers=headers)
init.raise_for_status()
info = init.json()
map_id, upload_url = info["mapId"], info["uploadUrl"]

with MODEL.open("rb") as src:
    put = requests.put(upload_url, data=src, headers={"Content-Type": "model/gltf-binary"})
    put.raise_for_status()

finalize = requests.post(f"{API_BASE}/maps/{map_id}/finalize", json={}, headers=headers)
finalize.raise_for_status()
print(f"CAD map {map_id} queued → {finalize.json()['status']}")
  • Якоря можно вложить в первоначальный запрос; как вариант — вызвать POST /maps/{id}/anchors после.
  • Добавьте coordinate, если модель геопривязана ({"lat": ..., "lon": ..., "alt": ...}).

Проверка​

  • Посмотрите карту в arclip.design и при необходимости поправьте смещения якорей.
  • Проверьте локализацию с Unity SDK; выравнивайте виртуальные объекты по тем же идентификаторам якорей.
  • Когда CAD-модель меняется, повторите импорт. mapId останется прежним, если вызывать POST /maps/{id}/update, а не создавать новую карту.