Update viewer_ar_ios.js

viewer_ar_ios.js

@@ -1,7 +1,7 @@
 /* viewer_ar_ios.js — AR PlayCanvas + GLB/USDZ via config.json
    - Lit config.json (data-config) => { "glb_url": "...", "usdz_url": "..." }
-   - iOS : AR Quick Look (USDZ) avec #allowsContentScaling=0 (pas de zoom) + bouton "Lancer l’AR"
-   - Android/Desktop : WebXR AR (plans horizontaux uniquement) + bouton "Lancer l’AR" (pas de tap écran) + curseur de rotation (yaw) + blob shadow
+   - iOS : AR Quick Look (USDZ) avec #allowsContentScaling=0 (pas de zoom) + bouton "Lancer l’AR" (centré)
+   - Android/Desktop : WebXR AR (plans horizontaux uniquement) + bouton "Lancer l’AR" (centré, pas de tap écran) + curseur de rotation (yaw) + ombre blob
    - Éclairage PBR par défaut (sans WebXR light estimation)
    - Monté dans un conteneur choisi (data-mount="#ar-mount") pour Squarespace
 */
@@ -11,6 +11,7 @@
   // Utilitaires généraux
   // ==========================
 
+  // Récupère de façon robuste le <script> courant (compatible pages CMS)
   function getCurrentScript() {
     return document.currentScript || (function () {
       var scripts = document.getElementsByTagName('script');
@@ -18,6 +19,7 @@
     })();
   }
 
+  // URL du fichier config.json passée via data-config sur le <script>
   function findConfigUrl() {
     var el = getCurrentScript();
     if (!el) return null;
@@ -25,16 +27,19 @@
     return url || null;
   }
 
+  // Détection iOS (pour Quick Look)
   function isIOS() {
     return /iPad|iPhone|iPod/.test(navigator.userAgent) && !window.MSStream;
   }
 
+  // Petit helper timeout pour sécuriser des chargements
   function timeout(ms) {
     return new Promise(function (_res, rej) {
       setTimeout(function () { rej(new Error("timeout")); }, ms);
     });
   }
 
+  // Charge config.json (chemins GLB/USDZ)
   async function loadConfigJson(url) {
     if (!url) return null;
     try {
@@ -57,6 +62,7 @@
     umd: ["https://cdn.jsdelivr.net/npm/playcanvas@" + PC_VERSION + "/build/playcanvas.min.js"]
   };
 
+  // Charge PlayCanvas de façon robuste (ESM puis fallback UMD)
   async function loadPlayCanvasRobust(opts) {
     opts = opts || {};
     var esmFirst = (typeof opts.esmFirst === "boolean") ? opts.esmFirst : true;
@@ -112,21 +118,29 @@
   // ==========================
   // Overlay / UI (styles intégrés)
   // ==========================
+  // NOTE: ids/classes explicites :
+  // - #ar-overlay-root : overlay global (DOM overlay XR + toasts)
+  // - #ar-start-button : bouton Android/Desktop
+  // - #ar-ios-quicklook-button : bouton iOS (rel="ar")
+  // - .ar-rotation-panel : panneau rotation
+  // - #ar-rotation-track/#ar-rotation-knob/#ar-rotation-range/#ar-rotation-value : slider yaw
+
   var css = [
+    /* Conteneur overlay global (DOM Overlay WebXR + messages) */
     "#ar-overlay-root{position:fixed;inset:0;z-index:10001;pointer-events:none}",
 
+    /* Toast (bas centre) utilisé pour la plupart des messages */
     ".pc-ar-msg{position:fixed;left:50%;transform:translateX(-50%);bottom:16px;z-index:10002;padding:10px 14px;background:rgba(0,0,0,.65);color:#fff;border-radius:12px;font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;font-size:14px;line-height:1.3;text-align:center;max-width:min(90vw,640px);box-shadow:0 6px 20px rgba(0,0,0,.25);backdrop-filter:blur(4px);pointer-events:none}",
     ".pc-ar-msg.pc-ar-msg--centerBig{top:50%;bottom:auto;transform:translate(-50%,-50%);font-size:20px;padding:16px 22px;max-width:min(90vw,760px)}",
 
-    /* ----- Bouton start commun (Android/Desktop) ----- */
-    "#ar-start-button{position:fixed;left:50%;top:50%transform:translateX(-50%, -50%);z-index:10003;pointer-events:auto;border:none;border-radius:12px;padding:18px 28px;background:#000;color:#fff;font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;font-size:20px;line-height:1;box-shadow:0 6px 20px rgba(0,0,0,.25);cursor:pointer}",
- 
+    /* ----- Bouton start Android/Desktop : centré et légèrement plus grand ----- */
+    "#ar-start-button{position:fixed;left:50%;top:50%;transform:translate(-50%,-50%);z-index:10003;pointer-events:auto;border:none;border-radius:16px;padding:16px 24px;font-size:18px;line-height:1;background:#000;color:#fff;box-shadow:0 10px 28px rgba(0,0,0,.28);cursor:pointer;min-width:200px;text-align:center}",
     "#ar-start-button[disabled]{opacity:.5;cursor:not-allowed}",
 
-    /* ----- Bouton iOS Quick Look (ancre rel=ar, stylée comme un bouton) ----- */
-    "#ar-ios-quicklook-button{position:fixed;left:50%;transform:translateX(-50%);bottom:72px;z-index:10003;display:inline-block;pointer-events:auto;background:#000;color:#fff;border-radius:12px;padding:14px 20px;font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;font-size:16px;line-height:1;text-decoration:none;box-shadow:0 6px 20px rgba(0,0,0,.25)}",
+    /* ----- Bouton iOS Quick Look (ancre rel=ar) : centré et légèrement plus grand ----- */
+    "#ar-ios-quicklook-button{position:fixed;left:50%;top:50%;transform:translate(-50%,-50%);z-index:10003;display:inline-block;pointer-events:auto;background:#000;color:#fff;border-radius:16px;padding:16px 24px;font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;font-size:18px;line-height:1;text-decoration:none;box-shadow:0 10px 28px rgba(0,0,0,.28);min-width:200px;text-align:center}",
 
-    /* ----- Panneau rotation ----- */
+    /* ----- Panneau de rotation ----- */
     ".ar-rotation-panel{position:absolute;right:12px;top:50%;transform:translateY(-50%);background:rgba(0,0,0,0.55);color:#fff;padding:12px 10px;border-radius:16px;width:56px;font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;pointer-events:auto;display:flex;flex-direction:column;align-items:center;gap:8px;box-shadow:0 6px 18px rgba(0,0,0,.25);backdrop-filter:blur(6px);touch-action:none}",
     ".ar-rotation-panel .label{font-size:12px;text-align:center;opacity:.95}",
     "#ar-rotation-track{position:relative;width:48px;height:200px;display:flex;align-items:center;justify-content:center;touch-action:none;overflow:visible;pointer-events:auto}",
@@ -139,7 +153,7 @@
   styleTag.textContent = css;
   document.head.appendChild(styleTag);
 
-  // Overlay root
+  // Crée/récupère le conteneur d’overlay global
   function ensureOverlayRoot() {
     var r = document.getElementById("ar-overlay-root");
     if (!r) {
@@ -151,7 +165,7 @@
   }
   var overlayRoot = ensureOverlayRoot();
 
-  // Messages
+  // Système de message (centre + agrandi si invite de départ)
   function message(txt) {
     var el = overlayRoot.querySelector(".pc-ar-msg");
     if (!el) {
@@ -159,13 +173,12 @@
       el.className = "pc-ar-msg";
       overlayRoot.appendChild(el);
     }
-    // On centre/agrandit si c’est l’invite de démarrage
     var isStartMsg = /Appuyez sur .Lancer l.?AR./i.test(txt);
     el.classList.toggle("pc-ar-msg--centerBig", isStartMsg);
     el.textContent = txt;
   }
 
-  // Quick Look URL
+  // Construit l’URL Quick Look empêchant le pinch-to-scale
   function buildQuickLookHref(usdzUrl) {
     try {
       var u = new URL(usdzUrl, window.location.href);
@@ -179,10 +192,11 @@
     }
   }
 
-  // iOS: bouton rel=ar “Lancer l’AR”
+  // Crée le bouton iOS Quick Look (ancre rel=ar) — centré
   function ensureQuickLookButton(USDZ_URL) {
     var btn = document.getElementById("ar-ios-quicklook-button");
     if (btn) return btn;
+
     var anchor = document.createElement("a");
     anchor.id = "ar-ios-quicklook-button";
     anchor.setAttribute("rel", "ar");
@@ -192,7 +206,7 @@
     return anchor;
   }
 
-  // Android/Desktop: bouton “Lancer l’AR”
+  // Android/Desktop : bouton “Lancer l’AR” — centré
   function ensureARStartButton(onClick) {
     var btn = document.getElementById("ar-start-button");
     if (!btn) {
@@ -218,14 +232,17 @@
     var mountSel = scriptEl && scriptEl.getAttribute('data-mount');
     var desiredHeight = (scriptEl && scriptEl.getAttribute('data-height')) || '70vh';
 
+    // Trouve (ou fabrique) le conteneur d’accueil du canvas
     var mountEl = null;
     if (mountSel) mountEl = document.querySelector(mountSel);
     if (!mountEl) {
+      // Fallback : placé en haut de <body> pour éviter d’être “sous le footer”
       mountEl = document.createElement('div');
       mountEl.id = 'ar-mount-fallback';
       document.body.insertBefore(mountEl, document.body.firstChild);
     }
 
+    // Style de base du conteneur
     var mountStyle = mountEl.style;
     if (!mountStyle.position) mountStyle.position = 'relative';
     mountStyle.width = mountStyle.width || '100%';
@@ -233,6 +250,7 @@
     mountStyle.touchAction = mountStyle.touchAction || 'manipulation';
     mountStyle.webkitTapHighlightColor = 'transparent';
 
+    // Crée/réutilise le canvas
     var canvas = mountEl.querySelector('#application-canvas');
     if (!canvas) {
       canvas = document.createElement('canvas');
@@ -240,6 +258,7 @@
       mountEl.appendChild(canvas);
     }
 
+    // Le canvas remplit le conteneur
     var cs = canvas.style;
     cs.position = 'absolute';
     cs.left = '0';
@@ -248,11 +267,15 @@
     cs.height = '100%';
     cs.display = 'block';
 
-    try { mountEl.scrollIntoView({ behavior: 'instant', block: 'start' }); } catch (_) {}
+    // Optionnel : faire défiler vers la zone AR
+    try {
+      mountEl.scrollIntoView({ behavior: 'instant', block: 'start' });
+    } catch (_) {}
 
     return canvas;
   }
 
+  // Panneau “Rotation” vertical (slider personnalisé)
   function ensureRotationPanel() {
     var p = overlayRoot.querySelector(".ar-rotation-panel");
     if (p) return p;
@@ -283,10 +306,11 @@
                    cfg.usdz_url :
                    null;
 
-    // iOS → Quick Look via bouton
+    // iOS → Quick Look (bouton centré)
     if (isIOS()) {
       if (USDZ_URL) {
         ensureQuickLookButton(USDZ_URL);
+        // Message centré + agrandi pour être bien visible
         message("Modèle chargé. Appuyez sur « Lancer l’AR ».");
       } else {
         message("iOS détecté, mais aucun 'usdz_url' dans config.json.");
@@ -294,7 +318,7 @@
       return;
     }
 
-    // Android/Desktop → PlayCanvas/WebXR (avec bouton de démarrage)
+    // Android/Desktop → PlayCanvas/WebXR (avec bouton centré)
     try {
       await loadPlayCanvasRobust({ esmFirst: true, loadTimeoutMs: 15000 });
     } catch (e) {
@@ -311,6 +335,7 @@
   function initARApp(GLB_URL) {
     var pc = window.pc;
 
+    // Canvas + panneau rotation
     var canvas = ensureCanvas();
     var rotationPanel = ensureRotationPanel();
     var rotTrack = rotationPanel.querySelector("#ar-rotation-track");
@@ -320,6 +345,7 @@
 
     window.focus();
 
+    // Application PlayCanvas
     var app = new pc.Application(canvas, {
       mouse: new pc.Mouse(canvas),
       touch: new pc.TouchDevice(canvas),
@@ -335,11 +361,13 @@
     app.on("destroy", function () { window.removeEventListener("resize", onResize); });
     app.start();
 
+    // Réglages de rendu PBR “safe”
     app.scene.gammaCorrection = pc.GAMMA_SRGB;
     app.scene.toneMapping     = pc.TONEMAP_ACES;
     app.scene.exposure        = 1;
     app.scene.ambientLight    = new pc.Color(1, 1, 1);
 
+    // Caméra + lumière
     var camera = new pc.Entity("Camera");
     camera.addComponent("camera", { clearColor: new pc.Color(0, 0, 0, 0), farClip: 10000 });
     app.root.addChild(camera);
@@ -349,6 +377,7 @@
     light.setLocalEulerAngles(45, 30, 0);
     app.root.addChild(light);
 
+    // Réticule (visualise la cible du hit-test)
     var reticleMat = new pc.StandardMaterial();
     reticleMat.diffuse = new pc.Color(0.2, 0.8, 1.0);
     reticleMat.opacity = 0.85;
@@ -361,11 +390,13 @@
     reticle.enabled = false;
     app.root.addChild(reticle);
 
+    // Conteneur du modèle chargé
     var modelRoot = new pc.Entity("ModelRoot");
     modelRoot.enabled = false;
     app.root.addChild(modelRoot);
     var modelLoaded = false, placedOnce = false;
 
+    // Ombre de contact (blob “peinte” sur un plan)
     var blob = null;
     var BLOB_SIZE = 0.4;
     var BLOB_OFFSET_Y = 0.005;
@@ -420,6 +451,7 @@
       return e;
     }
 
+    // Rotation via slider (0..360)
     var baseEulerX = 0, baseEulerZ = 0;
     var rotationYDeg = 0;
     function clamp360(d) { return Math.max(0, Math.min(360, d)); }
@@ -443,12 +475,14 @@
       if (rotLikePlane) blob.setRotation(rotLikePlane);
     }
 
+    // Chargement du modèle GLB (depuis config.json)
     app.assets.loadFromUrl(GLB_URL, "container", function (err, asset) {
       if (err) { console.error(err); message("Échec du chargement du modèle GLB."); return; }
       var instance = asset.resource.instantiateRenderEntity({ castShadows: true, receiveShadows: false });
       modelRoot.addChild(instance);
       modelRoot.setLocalScale(1, 1, 1);
 
+      // Ajustements simples matériaux (évite rendu trop sombre sans IBL)
       var renders = instance.findComponents('render');
       for (var ri = 0; ri < renders.length; ri++) {
         var r = renders[ri];
@@ -468,12 +502,13 @@
       baseEulerX = initE.x; baseEulerZ = initE.z;
 
       modelLoaded = true;
+      // >>> Message de démarrage
       message("Modèle chargé. Appuyez sur « Lancer l’AR ».");
     });
 
     if (!app.xr.supported) { message("WebXR n’est pas supporté sur cet appareil."); return; }
 
-    // ----- Slider (pointer capture) -----
+    // Gestion fiable du slider (capture des pointer events)
     var uiInteracting = false;
     var draggingTrack = false;
     var activePointerId = null;
@@ -484,7 +519,7 @@
       var y = (e.clientY != null) ? e.clientY : ((e.touches && e.touches[0] && e.touches[0].clientY) || 0);
       var ratio = (y - rect.top) / rect.height;
       var t = Math.max(0, Math.min(1, ratio));
-      return (1 - t) * 360;
+      return (1 - t) * 360; // 360 en haut, 0 en bas
     }
 
     function onPointerDownCapture(e) {
@@ -492,21 +527,29 @@
       uiInteracting = true;
       draggingTrack = true;
       activePointerId = (e.pointerId != null) ? e.pointerId : 1;
-      if (rotTrack.setPointerCapture) { try { rotTrack.setPointerCapture(activePointerId); } catch (er) {} }
+      if (rotTrack.setPointerCapture) {
+        try { rotTrack.setPointerCapture(activePointerId); } catch (er) {}
+      }
       applyRotationY(degFromPointer(e));
-      e.preventDefault(); e.stopPropagation();
+      e.preventDefault();
+      e.stopPropagation();
     }
     function onPointerMoveCapture(e) {
       if (!draggingTrack || ((e.pointerId != null ? e.pointerId : 1) !== activePointerId)) return;
       applyRotationY(degFromPointer(e));
-      e.preventDefault(); e.stopPropagation();
+      e.preventDefault();
+      e.stopPropagation();
     }
     function endDrag(e) {
       if (!draggingTrack || ((e.pointerId != null ? e.pointerId : 1) !== activePointerId)) return;
-      draggingTrack = false; uiInteracting = false;
-      if (rotTrack.releasePointerCapture) { try { rotTrack.releasePointerCapture(activePointerId); } catch (er) {} }
+      draggingTrack = false;
+      uiInteracting = false;
+      if (rotTrack.releasePointerCapture) {
+        try { rotTrack.releasePointerCapture(activePointerId); } catch (er) {}
+      }
       activePointerId = null;
-      e.preventDefault(); e.stopPropagation();
+      e.preventDefault();
+      e.stopPropagation();
     }
 
     document.addEventListener("pointerdown", onPointerDownCapture, { capture: true, passive: false });
@@ -514,7 +557,7 @@
     document.addEventListener("pointerup",   endDrag,               { capture: true, passive: false });
     document.addEventListener("pointercancel", endDrag,             { capture: true, passive: false });
 
-    // ----- Démarrage AR UNIQUEMENT via bouton -----
+    // Démarrage AR (UNIQUEMENT via bouton)
     function activateAR() {
       if (!app.xr.isAvailable(pc.XRTYPE_AR)) { message("AR immersive indisponible sur cet appareil."); return; }
       if (!app.xr.domOverlay) app.xr.domOverlay = {};
@@ -534,11 +577,10 @@
     // Crée le bouton et relie le clic au démarrage AR
     var startBtn = ensureARStartButton(activateAR);
 
-    // IMPORTANT : on supprime tout démarrage par clic/tap sur le canvas
-    // (AUCUN écouteur mousedown/touchend ne lance activateAR ici)
+    // IMPORTANT : aucun démarrage par clic/tap sur le canvas
     app.keyboard.on("keydown", function (evt) { if (evt.key === pc.KEY_ESCAPE && app.xr.active) app.xr.end(); });
 
-    // ----- Hit-test -----
+    // Hit-test : détecte uniquement des surfaces quasi-horizontales
     var TMP_IN = new pc.Vec3(0, 1, 0), TMP_OUT = new pc.Vec3();
     function isHorizontalUpFacing(rot, minDot) {
       minDot = (typeof minDot === "number") ? minDot : 0.75;
@@ -546,6 +588,7 @@
       return TMP_OUT.y >= minDot;
     }
 
+    // Hit Test global (alimentation du réticule + premier placement)
     app.xr.hitTest.on("available", function () {
       app.xr.hitTest.start({
         entityTypes: [pc.XRTRACKABLE_POINT, pc.XRTRACKABLE_PLANE],
@@ -562,6 +605,7 @@
               modelRoot.enabled = true;
               modelRoot.setPosition(pos);
 
+              // Ombre de contact au placement initial
               blob = createBlobShadowAt(pos, rot);
 
               var e = new pc.Vec3();
@@ -578,7 +622,7 @@
       });
     });
 
-    // Drag XR
+    // Déplacement XR continu (drag) — ignoré si UI active
     var isDragging = false;
     app.xr.input.on("add", function (inputSource) {
       inputSource.on("selectstart", function () {
@@ -605,7 +649,7 @@
       inputSource.on("selectend", function () { isDragging = false; });
     });
 
-    // Desktop rotation à la souris (clic droit ou Shift+clic gauche)
+    // Desktop : rotation à la souris (clic droit ou Shift+clic gauche)
     var rotateMode = false, lastMouseX = 0;
     var ROTATE_SENSITIVITY = 0.25;
     app.mouse.on("mousedown", function (e) {