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
src | GLB del modelo (obligatorio). |
|---|---|
poster | Imagen que se muestra antes de cargar three.js y sin WebGL. |
usdz | USDZ para Quick Look en iOS; sin él no hay botón de RA en iPhone. |
alt | Descripción del modelo para lectores de pantalla. |
real-size | "x y z" en metros; muestra el tamaño real escalado. |
min-scale / max-scale | Topes de escala en RA (0,25× y 4× por defecto). |
ar-label | Texto del botón de RA (p. ej. «Ver en tu espacio»). |
vr | Ofrece RV cuando el navegador la admite. |
Eventos
xr-ready | El visor 3D cargó el modelo. |
|---|---|
xr-session-start / xr-session-end | detail.mode: "ar" o "vr". |
xr-placed | El modelo se colocó en RA; detail.position en metros. |
xr-photo | Foto del lienzo en RA; detail.blob (PNG, sin la cámara). |
xr-error | Fallo al cargar o al abrir una sesión; detail.message. |