Demo gallery · CC0 assets from the Trysac Low-Poly Sampler

The <xr-asset-viewer> component

One custom element: poster first, three.js only when the visitor opens the viewer, and only the buttons the device supports.

Five-line integration

<script type="module" src="/js/xr-asset-viewer.js"></script>
<xr-asset-viewer src="/assets/sie-well.glb" poster="/assets/sie-well.avif"
  usdz="/assets/sie-well.usdz" real-size="1.92 2.5 1.522" vr
  alt="Round stone well with a small gable roof">
</xr-asset-viewer>

npm: @trysac/xr-asset-viewer (publication pending).

Attributes

srcModel GLB (required).
posterImage shown before three.js loads and without WebGL.
usdzUSDZ for Quick Look on iOS; without it there is no AR button on iPhone.
altModel description for screen readers.
real-size"x y z" in metres; shows the real size, scaled.
min-scale / max-scaleAR scale limits (0.25× and 4× by default).
ar-labelAR button text (e.g. "View in your space").
vrOffers VR when the browser supports it.

Events

xr-readyThe 3D viewer loaded the model.
xr-session-start / xr-session-enddetail.mode: "ar" or "vr".
xr-placedThe model was placed in AR; detail.position in metres.
xr-photoAR canvas photo; detail.blob (PNG, never the camera feed).
xr-errorLoad or session failure; detail.message.