Galería de demostración · assets CC0 del Trysac Low-Poly Sampler

El componente <xr-asset-viewer>

Un solo elemento: primero el póster, three.js solo cuando el visitante abre el visor y únicamente los botones que el dispositivo admite.

Integración en cinco líneas

<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="Pozo de piedra redondo con techo a dos aguas">
</xr-asset-viewer>

npm: @trysac/xr-asset-viewer (publicación pendiente).

Atributos

srcGLB del modelo (obligatorio).
posterImagen que se muestra antes de cargar three.js y sin WebGL.
usdzUSDZ para Quick Look en iOS; sin él no hay botón de RA en iPhone.
altDescripción del modelo para lectores de pantalla.
real-size"x y z" en metros; muestra el tamaño real escalado.
min-scale / max-scaleTopes de escala en RA (0,25× y 4× por defecto).
ar-labelTexto del botón de RA (p. ej. «Ver en tu espacio»).
vrOfrece RV cuando el navegador la admite.

Eventos

xr-readyEl visor 3D cargó el modelo.
xr-session-start / xr-session-enddetail.mode: "ar" o "vr".
xr-placedEl modelo se colocó en RA; detail.position en metros.
xr-photoFoto del lienzo en RA; detail.blob (PNG, sin la cámara).
xr-errorFallo al cargar o al abrir una sesión; detail.message.