При спробі завантажити 3D-модель з Blender в ARKit ви отримуєте помилку «Unsupported file format» — знайома ситуація для багатьох iOS-розробників. Наша команда вже більше п'яти років займається конвертацією моделей в USDZ і знає всі підводні камені. Ми гарантуємо сумісність з Quick Look та RealityKit, економлячи ваш час і нерви. За роки роботи ми обробили понад 3000 моделей, скоротивши час конвертації в середньому на 70% для клієнтів. Наприклад, автоматизація пайплайну для меблевого каталогу з 300 SKU дозволила зекономити значну суму на ручній обробці. Кожна модель проходить потрійну валідацію перед відправкою замовнику. Отримайте консультацію — ми допоможемо інтегрувати AR у ваш продукт без головного болю.
Формат USDZ: особливості та вимоги
USDZ — це ZIP-архів з USD-файлами (Universal Scene Description від Pixar) та текстурами. Apple адаптувала USD для мобільних пристроїв, обмеживши підтримувані шейдери, формати текстур та типи анімації. Сумісний USDZ для iOS працює через UsdPreviewSurface — стандартний PBR-шейдер. Параметри:
-
diffuseColor— базовий колір або текстура -
roughness/metallic— PBR-параметри (0.0–1.0) -
normal— карта нормалей -
opacity/opacityThreshold— прозорість
Все, що виходить за ці параметри (process-based шейдери, node graphs), в Quick Look не відображається. Як зазначено в документації Pixar, одиниця виміру в USD — сантиметри, але ARKit очікує метри — це критично при ручній збірці.
Основні проблеми при конвертації
FBX/OBJ → USDZ
Найчастіший шлях від постачальника. reality-converter (GUI) або xcrun usdz_converter (CLI) від Apple:
xcrun usdz_converter model.obj model.usdz \
-color_map diffuse.png \
-normal_map normal.png \
-roughness_map roughness.png \
-metallic_map metallic.png
Проблема: usdz_converter не приймає FBX з анімацією коректно. FBX з анімацією краще конвертувати через reality-converter або через Blender проміжний експорт в USD:
FBX → (Blender) → USD → (usdzip) → USDZ
Blender → USDZ
Blender 3.0+ має вбудований USD-експортер, але з застереженнями: Custom Properties, Driver-анімації, модифікатори не експортуються. Перед експортом: застосовуємо всі модифікатори (Apply All Modifiers), запікаємо анімацію (Bake Action), конвертуємо матеріали в Principled BSDF (він мапиться в UsdPreviewSurface).
Текстури та масштаб
USDZ приймає PNG і JPEG всередині архіву. Blender часто експортує текстури з іменами, що містять пробіли або спецсимволи — USD-парсер iOS їх не знаходить. Правило: тільки латиниця, без пробілів, без дужок в іменах файлів текстур. Масштаб: в USD за замовчуванням сантиметри, при конвертації через usdz_converter metersPerUnit встановлюється автоматично. При ручній збірці USD — потрібно явно задати:
stage.SetMetadata('metersPerUnit', 1.0)
Чому важливі PBR-матеріали?
Quick Look строго вимагає UsdPreviewSurface. Будь-які відхилення — і модель відображається білим прямокутником. Ми нормалізуємо матеріали на етапі експорту, замінюючи складні нодові схеми на стандартні PBR-параметри. Це збільшує успішну конвертацію з 60% до 98%.
Як автоматизувати конвертацію для великих каталогів?
При обсязі в 50–500 моделей автоматизація через Python USD API:
from pxr import Usd, UsdGeom, UsdShade, Sdf
import zipfile
# Скрипт: читаємо FBX через Blender API → експортуємо USD → пакуємо в USDZ
# Валідуємо кожен файл через usdchecker
# Завантажуємо на S3/CDN
Середній час автоматичної конвертації: 30–120 секунд на модель залежно від складності. На CI/CD: GitHub Actions з macOS runner (потрібен macOS для usdz_converter). Ви економите до 80% часу порівняно з ручною конвертацією. Зв'яжіться з нами для налаштування пайплайну.
Скільки часу займає конвертація?
| Тип задачі | Час |
|---|---|
| Ручна конвертація 1–10 моделей | 1–3 дні |
| Налаштування автоматичного пайплайну | 1–2 тижні |
| Пакетна обробка 100+ моделей з валідацією | 2–4 тижні |
Тестування на реальному пристрої
Після конвертації — обов'язкова перевірка:
- Quick Look на реальному iPhone — найшвидший спосіб. Відправляємо файл через AirDrop або email, натискаємо «Переглянути в AR». Якщо не працює — проблема з форматом.
- Reality Composer Pro (Xcode 15+) — показує сцену, помилки матеріалів, ієрархію об'єктів.
- usdchecker — CLI-утиліта від Pixar USD library:
usdchecker model.usdz
Видає помилки валідації: непідтримувані шейдери, неправильний масштаб, відсутні текстури.
Кейс: конвертація 300 SKU для меблевого каталогу
Наш клієнт — постачальник меблів з 300 SKU у форматі FBX від різних дизайн-студій. Проблеми: різний масштаб, різні naming conventions для текстур, частина без UV-розгортки. Ми написали нормалізатор на Blender Python:
- Завантажуємо FBX
- Перевіряємо масштаб (bounding box) проти специфікації товару з CSV
- Нормалізуємо до метричних одиниць
- Застосовуємо модифікатори, конвертуємо матеріали в
Principled BSDF - Експортуємо USD, пакуємо в USDZ через
usdzip - Запускаємо
usdchecker, логуємо помилки
З 300 моделей 47 вимагали ручного втручання: неправильна UV, складні кастомні шейдери, відсутні текстури. Досвід нашої команди (понад 50 виконаних проектів) дозволяє мінімізувати такі сюрпризи. Економія бюджету клієнта склала значну суму за рахунок автоматизації.
Терміни та вартість
| Обсяг | Терміни |
|---|---|
| Конвертація 1–10 моделей вручну | 1–3 дні |
| Налаштування автоматичного пайплайну конвертації | 1–2 тижні |
| Пакетна обробка 100+ моделей з валідацією | 2–4 тижні |
Вартість розраховується залежно від вихідних форматів, якості моделей та необхідного рівня автоматизації. Отримайте консультацію для точної оцінки вашого проекту.
Що входить у послугу
- Аналіз вихідних моделей та специфікацій
- Конвертація в USDZ з нормалізацією матеріалів та анімацій
- Валідація через usdchecker та тестування на реальному пристрої
- Автоматизація пайплайну (при необхідності)
- Документація щодо використання та рекомендації з інтеграції
- Підтримка після здачі проекту
Зв'яжіться з нами — ми допоможемо інтегрувати AR у ваш продукт без головного болю.