USDZ + Unreal Engine — Import 3D Scenes for AR + Cinematic Renders
USDZ (the iOS AR format) and Unreal Engine often appear in the same search query but they're solving different problems. Two paths covered below — short version: most teams want the GLB-to-Unreal route, USDZ is for the AR Quick Look pipeline.
# TL;DR
- AR Quick Look (iOS Safari, tap-to-AR on a webpage): export USDZ from Yugma. Open on iPhone. Done.
- Unreal cinematic / game: export GLB from Yugma → import into Unreal via glTFRuntime (runtime) or Datasmith (editor-time).
- Native USD in Unreal: Unreal supports
.usd/.usda/.usdcvia the USD Importer plugin; USDZ requires unzip first.
# Path 1 — USDZ for AR Quick Look
This is the simpler case. You want a tap-to-AR experience for iPhone users on a marketing page.
Steps
- Compose your scene in Yugma.
- Export → USDZ. Yugma's Pro tier exports USDZ directly.
- Host the
.usdzfile (your CDN, your Shopify, your hosting). - On the page, link with
. - Open on iPhone Safari → tap the link → AR Quick Look opens.
USDZ gotchas
- Triangle count under 200k: AR runtimes throttle hard above this.
- Texture sizes capped at 2K: 4K chokes Quick Look.
- PBR materials only: custom shaders don't translate.
- Centered model, real-world scale: origin at floor, dimensions in meters.
- No transparent materials at full opacity: glass at 0% opacity disappears.
# Path 2 — Unreal Engine import (cinematic + game)
For Unreal projects (whether film pre-vis, real-time visualization, or game), you'd typically use GLB or USD. Yugma exports both.
Option A — glTFRuntime for runtime loads
Install glTFRuntime plugin (free on Unreal Marketplace). Supports loading GLB at runtime — useful for user-uploaded scenes or dynamic content.
// Sample C++ usage
UglTFRuntimeAsset* Asset = UglTFRuntimeFunctionLibrary::glTFLoadAssetFromFilename(
TEXT("/Game/Yugma/scene.glb"), false, ConfigStruct);
Option B — Datasmith for editor-time
Datasmith is Unreal's pro pipeline for importing 3D content. For Yugma scenes:
- Export GLB.
- In Unreal: Datasmith → Import → choose the GLB.
- Datasmith preserves materials, lighting, and hierarchy.
Option C — Direct GLB import (Unreal 5.x)
Unreal 5.x has native GLB import. File → Import → select .glb. Lighting needs a recompute (Build Lighting → Production).
Option D — USD Importer plugin
Enable USD Importer in Unreal's Plugins. Supports .usd, .usda, .usdc files. For USDZ, unzip first (USDZ is a zipped USD).
# Common Unreal gotchas
Pink materials
Same cause as Unity: shader can't be found. Fix: select material → Material → assign default Surface (Lit, opaque).
Materials look "plastic"
GLB roughness sometimes imports as 0 (mirror). Fix: select material → adjust Roughness to 0.5-0.7 for non-metal, or 0.15-0.3 for metal.
Missing lights
GLB sometimes carries lights that don't map cleanly to Unreal's light system. Easiest: place Unreal lights yourself rather than rely on imported ones.
Animation doesn't play
If your GLB has skeletal animation:
- Import via Datasmith or Skeletal Mesh import.
- Verify the Skeleton Asset was created.
- Use Animation Blueprint to play the imported clip.
Lightmap coordinate issue
If you bake lighting in Unreal, your GLB needs proper UV channel 1 (lightmap UVs). Yugma's GLB export uses one UV channel; for Unreal lightmaps, generate channel 1 in Unreal: select mesh → Static Mesh Editor → "Generate Lightmap UVs" with source UV set to 0.
# A real workflow: Yugma → Unreal cinematic pre-vis
- Compose pre-vis scene in Yugma (90 seconds).
- Export GLB.
- Datasmith into Unreal (5 minutes).
- Place Cine Cameras for shots.
- Add post-process volume for cinematic look.
- Sequencer for camera animation.
- Render.
Yugma is upstream of Unreal, not a replacement. The blockout phase becomes 90 seconds instead of 2 days.
# When to use which format
| Goal | Format |
|---|---|
| iOS AR Quick Look | USDZ |
| Android Scene Viewer | GLB |
| Unreal game asset | GLB or FBX |
| Unreal cinematic | GLB via Datasmith |
| Unreal Nanite (high-poly) | GLB or FBX import + Nanite enable |
| Web embed | GLB |
Read the AI 3D export pipeline pillar → Read the AR/VR export checklist →