Skip to content

Experimental WebXR integration

Model Lab does not currently provide a built-in AR session API. The headless architecture allows advanced applications to place a ModelPivotGroup inside a WebXR scene managed by another library, such as a React Three Fiber XR integration.

Conceptual structure

tsx
<XR store={xrStore}>
  <ModelPivotGroup
    pivot={preset.viewer.pivot.point}
    scale={[0.25, 0.25, 0.25]}
  >
    <primitive object={gltf.scene} />
  </ModelPivotGroup>
</XR>

Important differences from the standard viewer

  • AR placement, hit testing, session lifecycle, permissions, and device support are owned by the XR integration.
  • Camera sequences authored for a desktop perspective camera may not be appropriate in immersive AR because the user's head controls the camera.
  • Model, pivot, material, and embedded animation settings remain reusable.
  • Use HTTPS and test on physical devices.

Treat this as an extension point, not a built-in Model Lab guarantee.

Released under the MIT License.