webwallgl 1.1.0 → 1.3.5

package/webwallgl.mjs

@@ -47,10 +47,24 @@ function clear(rt) {
   rt.raf = void 0;
   for (const p of rt.videoPairs ?? []) p.destroy();
   rt.videoPairs = void 0;
-  if (rt.sceneCleanup) rt.sceneCleanup();
+  if (rt.sceneCleanup) {
+    try {
+      rt.sceneCleanup();
+    } catch {
+    }
+  }
   rt.sceneCleanup = void 0;
   rt.sceneCtl = void 0;
   rt.pointerCtl = void 0;
+  rt.mediaCtl = void 0;
+  const ds = rt.wallpaperDisposers ?? [];
+  rt.wallpaperDisposers = [];
+  for (const d of ds) {
+    try {
+      d();
+    } catch {
+    }
+  }
   if (rt.renderer) {
     rt.renderer.dispose?.();
     rt.renderer = void 0;
@@ -92,10 +106,18 @@ function clear(rt) {
   rt.canvas = void 0;
   rt.ctx = void 0;
   rt.info = void 0;
+  clearSceneDebugGlobals();
   resetFrameMeter(rt);
 }
 function destroyRuntime(rt) {
-  clear(rt);
+  try {
+    clear(rt);
+  } catch {
+  }
+  if (rt.peekRaf !== void 0) {
+    cancelAnimationFrame(rt.peekRaf);
+    rt.peekRaf = void 0;
+  }
   for (const off of rt.disposers.splice(0)) {
     try {
       off();
@@ -151,6 +173,32 @@ function applyCoverAlignToDom(rt) {
   const obj = rt.video ?? rt.img;
   if (obj && obj.isConnected) obj.style.objectPosition = pos;
 }
+const SCENE_DEBUG_GLOBALS = [
+  "__scene",
+  "__sceneLayers",
+  "__textures",
+  "__objScripts",
+  "__textWidgets",
+  "__mediaHooks",
+  "__mediaControl",
+  "__mediaStats",
+  "__mediaSet",
+  "__system",
+  "__liveSystem",
+  "__audioStats",
+  "__audioMute",
+  "__particleStats",
+  "__particleToggle",
+  "__pointerStats",
+  "__compositeStats",
+  "__compositeEnable"
+];
+function clearSceneDebugGlobals() {
+  const w = window;
+  for (const k of SCENE_DEBUG_GLOBALS) {
+    if (k in w) delete w[k];
+  }
+}
 function syncCanvasSize(rt, canvas, cfg) {
   const dpr = effectiveDpr(rt, cfg);
   const w = Math.max(1, Math.round((canvas.clientWidth || window.innerWidth || 1) * dpr));
@@ -3539,6 +3587,11 @@ function rewriteXrayFragScale(fragGlsl) {
   const from = usesVarying ? /unprojectedUVs\s*\*=\s*v_PointerScale\s*\*/ : /unprojectedUVs\s*\*=\s*g_PointerScale\s*\*/;
   return out.replace(from, "unprojectedUVs *= " + XRAY_FRAG_UV_SCALE + " *");
 }
+const XRAY_SIZE_FALLBACK = 1;
+function constantFallback(uniformName, declaredDefault) {
+  if (uniformName === "g_PointerScale") return XRAY_SIZE_FALLBACK;
+  return declaredDefault;
+}
 function createRenderer(canvas, opts = {}) {
   const gl = canvas.getContext("webgl2", { premultipliedAlpha: false, antialias: false, alpha: false, preserveDrawingBuffer: true });
   if (!gl) throw new Error("当前浏览器不支持 WebGL2");
@@ -3895,7 +3948,8 @@ function createRenderer(canvas, opts = {}) {
     }
     for (const [matKey, entry] of Object.entries(matMeta || {})) {
       if (!constants || !(matKey in constants)) {
-        if (entry.default !== void 0) setConstant(uni, entry.uniform, entry.default);
+        const dflt = constantFallback(entry.uniform, entry.default);
+        if (dflt !== void 0) setConstant(uni, entry.uniform, dflt);
       }
     }
   }
@@ -5114,9 +5168,11 @@ const rndMod = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProper
   __proto__: null,
   ALIGN,
   XRAY_IDLE_SCREEN_UV,
+  XRAY_SIZE_FALLBACK,
   applyColorBlendCPU,
   collectGroupDescendantIds,
   colorBlendPlan,
+  constantFallback,
   createRenderer,
   effectFboSize,
   layerWantsPreserveBackdrop,
@@ -11340,19 +11396,84 @@ async function decodeGifFrames(src) {
   dec.close?.();
   return { width, height, frames };
 }
+function attachVideoSpectrum(rt, cfg, v) {
+  if (rt.audioBridge) return;
+  const AC = window.AudioContext || window.webkitAudioContext;
+  if (!AC) return;
+  let ctx;
+  let analyser;
+  try {
+    ctx = new AC();
+    const srcNode = ctx.createMediaElementSource(v);
+    analyser = ctx.createAnalyser();
+    analyser.fftSize = 256;
+    analyser.smoothingTimeConstant = 0.75;
+    srcNode.connect(analyser);
+    analyser.connect(ctx.destination);
+  } catch (e) {
+    reportDiag(rt, cfg, `media 频谱接管跳过: ${e?.message ?? e}`);
+    return;
+  }
+  const bins = new Uint8Array(analyser.frequencyBinCount);
+  const left = new Float32Array(64);
+  const right = new Float32Array(64);
+  const bridge = () => {
+    if (ctx.state !== "running") return null;
+    analyser.getByteFrequencyData(bins);
+    const n = Math.min(64, bins.length);
+    for (let i = 0; i < n; i++) {
+      const x = bins[i] / 255;
+      left[i] = x;
+      right[i] = x;
+    }
+    for (let i = n; i < 64; i++) {
+      left[i] = 0;
+      right[i] = 0;
+    }
+    return { left, right };
+  };
+  rt.audioBridge = bridge;
+  if (ctx.state === "suspended") {
+    const kick = () => {
+      void ctx.resume().catch(() => {
+      });
+      window.removeEventListener("pointerdown", kick);
+      window.removeEventListener("keydown", kick);
+    };
+    window.addEventListener("pointerdown", kick, { once: true });
+    window.addEventListener("keydown", kick, { once: true });
+    (rt.wallpaperDisposers ??= []).push(() => {
+      window.removeEventListener("pointerdown", kick);
+      window.removeEventListener("keydown", kick);
+    });
+  }
+  (rt.wallpaperDisposers ??= []).push(() => {
+    if (rt.audioBridge === bridge) rt.audioBridge = null;
+    void ctx.close().catch(() => {
+    });
+  });
+}
 function mountMedia(rt, cfg) {
   clear(rt);
-  if (!cfg.src) {
+  const failHard = (why) => {
+    reportDiag(rt, cfg, `media ${cfg.type} 失败: ${why}`);
+    rt.onError?.(new Error(`媒体壁纸（${cfg.type}）${why}`));
     rt.fallbackPage?.();
+  };
+  if (!cfg.src) {
+    failHard("缺少资源 URL（cfg.src 为空）");
     return;
   }
   const isVideo = cfg.type === "video";
   const isGif = cfg.type === "gif";
-  const c = document.createElement("canvas");
+  const embedded = cfg.canvas instanceof HTMLCanvasElement;
+  const c = embedded ? cfg.canvas : document.createElement("canvas");
   const dpr = effectiveDpr(rt, cfg);
-  c.width = Math.max(1, Math.round(innerWidth * dpr));
-  c.height = Math.max(1, Math.round(innerHeight * dpr));
-  c.style.cssText = "position:absolute;inset:0;width:100%;height:100%;";
+  const vw = c.clientWidth || window.innerWidth || 1;
+  const vh = c.clientHeight || window.innerHeight || 1;
+  c.width = Math.max(1, Math.round(vw * dpr));
+  c.height = Math.max(1, Math.round(vh * dpr));
+  if (!embedded) c.style.cssText = "position:absolute;inset:0;width:100%;height:100%;";
   const gl2 = c.getContext("webgl2", {
     premultipliedAlpha: false,
     antialias: false,
@@ -11360,13 +11481,32 @@ function mountMedia(rt, cfg) {
     preserveDrawingBuffer: true
   });
   if (!gl2) {
-    reportDiag(rt, cfg, `media ${cfg.type}: WEBGL2_UNAVAILABLE，回退 DOM 渲染`);
+    reportDiag(rt, cfg, `media ${cfg.type}: WEBGL2_UNAVAILABLE`);
+    if (embedded) {
+      rt.onError?.(new Error("WEBGL2_UNAVAILABLE"));
+      return;
+    }
     if (isVideo) mountVideoDom(rt, cfg);
     else mountGifDom(rt, cfg);
     return;
   }
-  rt.wrap?.appendChild(c);
+  if (!embedded) rt.wrap?.appendChild(c);
   rt.canvas = c;
+  if (rt.onSceneInfo) {
+    const hook = rt.onSceneInfo;
+    rt.onSceneInfo = void 0;
+    try {
+      hook({
+        width: vw,
+        height: vh,
+        layerCount: 0,
+        hasModels: false,
+        hasParticles: false,
+        hasText: false
+      });
+    } catch {
+    }
+  }
   let disposed = false;
   rt.sceneCleanup = () => {
     disposed = true;
@@ -11378,6 +11518,21 @@ function mountMedia(rt, cfg) {
   let pauseImpl;
   let resumeImpl;
   let videoWasPlaying = false;
+  rt.sceneAudio = {
+    setVolume(v) {
+      const vid = rt.video;
+      if (!vid) return;
+      const vol = Math.max(0, Math.min(1, Number(v) || 0));
+      vid.volume = vol;
+      vid.muted = vol <= 0;
+      if (vol > 0 && vid.paused && !rt.paused) {
+        void vid.play().catch((e) => {
+          reportDiag(rt, cfg, `media 取消静音后自动播放被拒绝: ${e?.message ?? e}`);
+        });
+      }
+    },
+    audios: []
+  };
   rt.sceneCtl = {
     pause() {
       pauseImpl?.();
@@ -11391,8 +11546,7 @@ function mountMedia(rt, cfg) {
   const fail = (why) => {
     if (disposed) return;
     disposed = true;
-    reportDiag(rt, cfg, `media ${cfg.type} 失败: ${why}`);
-    rt.fallbackPage?.();
+    failHard(why);
   };
   void (async () => {
     try {
@@ -11440,6 +11594,7 @@ function mountMedia(rt, cfg) {
         });
         if (!rt.paused) void v.play().catch(() => {
         });
+        attachVideoSpectrum(rt, cfg, v);
         reportDiag(rt, cfg, `media video ${mediaW}x${mediaH} → scene 渲染`);
       } else {
         let decoded = false;
@@ -11539,6 +11694,14 @@ function mountMedia(rt, cfg) {
             peek.x,
             peek.y
           ).then(() => {
+            if (rt.onFirstFrame) {
+              const first = rt.onFirstFrame;
+              rt.onFirstFrame = void 0;
+              try {
+                first();
+              } catch {
+              }
+            }
             if (disposed || rt.paused) return;
             rt.raf = requestAnimationFrame(renderLoop);
           }).catch((e) => fail(String(e.message || e).slice(0, 200)));
@@ -11621,6 +11784,48 @@ function mountGifDom(rt, cfg) {
   rt.img = img;
 }
 const PKG_PATHS = ["scene.pkg", "scenes/scene.pkg", "gifscene.pkg"];
+const EXT_TYPES = {
+  mp4: "video",
+  webm: "video",
+  mov: "video",
+  m4v: "video",
+  ogv: "video",
+  gif: "gif",
+  png: "image",
+  jpg: "image",
+  jpeg: "image",
+  webp: "image",
+  avif: "image",
+  bmp: "image"
+};
+function typeFromMime(mime) {
+  const m = mime.toLowerCase().split(";")[0].trim();
+  if (m === "image/gif") return "gif";
+  if (m.startsWith("video/")) return "video";
+  if (m.startsWith("image/")) return "image";
+  return null;
+}
+function sniffMediaType(url) {
+  if (typeof url !== "string" || !url) return null;
+  let path = url;
+  const hash = path.indexOf("#");
+  if (hash >= 0) path = path.slice(0, hash);
+  const q = path.indexOf("?");
+  if (q >= 0) path = path.slice(0, q);
+  const seg = path.split("/").pop() || "";
+  const dot = seg.lastIndexOf(".");
+  if (dot < 0) return null;
+  return EXT_TYPES[seg.slice(dot + 1).toLowerCase()] ?? null;
+}
+async function sniffMediaTypeByHead(url, init, signal) {
+  try {
+    const r = await fetch(url, { ...init, method: "HEAD", signal });
+    if (!r.ok) return null;
+    return typeFromMime(r.headers.get("content-type") || "");
+  } catch {
+    return null;
+  }
+}
 function httpSource(baseUrl, init) {
   const base = baseUrl.replace(/\/+$/, "");
   return {
@@ -11675,6 +11880,29 @@ function httpSource(baseUrl, init) {
         if (signal?.aborted) throw new Error("aborted");
       }
       return { url: `${base}/${file}` };
+    },
+    /**
+     * 媒体壁纸（video/gif/image）的资源地址：`{base}/{project.file}`。
+     *
+     * 与 webEntry 的区别是**没有默认文件名可兜底**：网页壁纸缺 file 时
+     * index.html 是行业惯例，媒体壁纸的文件名（scene.mp4 / xxx.gif）完全由作者定，
+     * 猜一个只会 404。拿不到 file 就返回 null，让 mount 报「无法解析媒体 URL」，
+     * 而不是发一个必然失败的请求、再把那个 404 当成根因写进错误里。
+     */
+    async mediaEntry(signal) {
+      let file = "";
+      try {
+        const r = await fetch(`${base}/project.json`, { ...init, signal });
+        if (r.ok) {
+          const project = await r.json();
+          if (project && typeof project.file === "string" && project.file.trim()) {
+            file = project.file.trim().replace(/^\/+/, "");
+          }
+        }
+      } catch {
+        if (signal?.aborted) throw new Error("aborted");
+      }
+      return file ? { url: `${base}/${file}` } : null;
     }
   };
 }
@@ -11694,6 +11922,43 @@ function bytesSource(pkg2, project, key) {
     project: async () => project ?? null
   };
 }
+function mediaSource(urlOrFile, options) {
+  const isBlob = typeof urlOrFile !== "string";
+  const named = urlOrFile;
+  let type = options?.type ?? (isBlob ? typeFromMime(urlOrFile.type || "") : null) ?? sniffMediaType(isBlob ? String(named.name ?? "") : urlOrFile);
+  let headTried = false;
+  let objectUrl = null;
+  const url = () => {
+    if (!isBlob) return urlOrFile;
+    if (!objectUrl) objectUrl = URL.createObjectURL(urlOrFile);
+    return objectUrl;
+  };
+  const key = options?.key ?? (isBlob ? typeof named.name === "string" ? `media:${named.name}:${named.size}:${named.lastModified ?? 0}` : void 0 : `media:${urlOrFile}`);
+  return {
+    key,
+    async scenePkg() {
+      throw new Error("mediaSource 是纯媒体来源，没有 scene.pkg（请改用 httpSource/fileSource/bytesSource）");
+    },
+    // type 为 null 时也如实返回：resolveMountConfig 会再按 mediaEntry 的 URL
+    // 嗅探一次（含 HEAD 兜底），仍认不出才落回 scene 并报错
+    async project() {
+      return type ? { type } : null;
+    },
+    async mediaEntry(signal) {
+      if (!type && !isBlob && !headTried) {
+        headTried = true;
+        type = await sniffMediaTypeByHead(urlOrFile, void 0, signal);
+      }
+      return { url: url(), type: type ?? void 0 };
+    },
+    dispose() {
+      if (objectUrl) {
+        URL.revokeObjectURL(objectUrl);
+        objectUrl = null;
+      }
+    }
+  };
+}
 const LOOP_PREROLL_SEC = 0.5;
 const LOOP_HOLD_SEC = 0.04;
 const LOOP_SWAP_EPS = 0.08;
@@ -12974,9 +13239,10 @@ function mountScene(rt, cfg) {
       const audioDriverRef = {
         current: null
       };
-      let mediaDriver = simMedia;
+      let liveMediaOverride = null;
+      const currentMediaDriver = () => liveMediaOverride ?? rt.mediaSource ?? simMedia;
       let windowDriver = simWindow;
-      const audioSim = { enabled: supportsAudioProcessing };
+      const audioSim = { enabled: supportsAudioProcessing && !rt.audioDisabled };
       const zero = (n) => new Float32Array(n);
       const SILENT_AUDIO = {
         left16: zero(16),
@@ -13075,7 +13341,7 @@ function mountScene(rt, cfg) {
       const shortcuts = system.createShortcutHandler((name) => {
         reportDiag(rt, cfg, `openUserShortcut: ${name}`);
       });
-      const mediaSim = { enabled: true, override: null };
+      const mediaSim = { enabled: !rt.mediaDisabled, override: null };
       const mediaHooks = [];
       let lastMediaSnap = null;
       liveHold.lastSnap = {
@@ -13084,7 +13350,7 @@ function mountScene(rt, cfg) {
           if (lastMediaSnap) lastMediaSnap.hasThumbnail = v;
         }
       };
-      const mediaSnapshot = () => mediaDriver.snapshot;
+      const mediaSnapshot = () => currentMediaDriver().snapshot;
       const registerMediaHook = (sb) => {
         if (!sb || !sb.hasMediaHook || mediaHooks.includes(sb)) return;
         mediaHooks.push(sb);
@@ -13129,36 +13395,30 @@ function mountScene(rt, cfg) {
         }
         lastMediaSnap = media.cloneMediaSnapshot(mediaSnapshot());
       };
+      const callDriver = (name) => {
+        const drv = currentMediaDriver();
+        const fn = drv?.[name];
+        if (typeof fn === "function") {
+          try {
+            fn.call(drv);
+          } catch (e) {
+            reportDiag(rt, cfg, `media ${name} 失败: ${e?.message}`);
+          }
+        }
+        dispatchMediaNow();
+        return mediaSnapshot();
+      };
       const mediaControl = {
         get snapshot() {
           return mediaSnapshot();
         },
-        skipNext: () => {
-          mediaDriver.skipNext();
-          dispatchMediaNow();
-          return mediaSnapshot();
-        },
-        skipPrevious: () => {
-          mediaDriver.skipPrevious();
-          dispatchMediaNow();
-          return mediaSnapshot();
-        },
-        play: () => {
-          mediaDriver.play();
-          dispatchMediaNow();
-          return mediaSnapshot();
-        },
-        pause: () => {
-          mediaDriver.pause();
-          dispatchMediaNow();
-          return mediaSnapshot();
-        },
-        playPause: () => {
-          mediaDriver.playPause();
-          dispatchMediaNow();
-          return mediaSnapshot();
-        }
+        skipNext: () => callDriver("skipNext"),
+        skipPrevious: () => callDriver("skipPrevious"),
+        play: () => callDriver("play"),
+        pause: () => callDriver("pause"),
+        playPause: () => callDriver("playPause")
       };
+      rt.mediaCtl = mediaControl;
       window.__mediaControl = mediaControl;
       window.__system = {
         media: mediaControl,
@@ -13279,6 +13539,18 @@ function mountScene(rt, cfg) {
         }
       }
       if (cfg.liveSystem) {
+        const liveSlot = {
+          handle: null,
+          dead: false
+        };
+        (rt.wallpaperDisposers ??= []).push(() => {
+          liveSlot.dead = true;
+          try {
+            liveSlot.handle?.dispose();
+          } catch {
+          }
+          liveSlot.handle = null;
+        });
         try {
           const uploadLiveArtwork = async (info) => {
             try {
@@ -13319,7 +13591,7 @@ function mountScene(rt, cfg) {
                   generated: true
                 });
               }
-              const snap = mediaDriver.snapshot;
+              const snap = currentMediaDriver().snapshot;
               if (palette) {
                 snap.primaryColor = media.mediaVec3(...palette.primary);
                 snap.secondaryColor = media.mediaVec3(...palette.secondary);
@@ -13344,39 +13616,48 @@ function mountScene(rt, cfg) {
               void uploadLiveArtwork(info);
             }
           });
-          mediaDriver = live.media;
-          windowDriver = live.windowTitle;
-          liveHold.mediaDriver = live.media;
-          if (live.status().audio === "mic") audioDriverRef.current = live.audio;
-          if (mediaDriver.snapshot.hasMedia) {
-            for (const { name, event } of media.diffMediaEvents(null, mediaDriver.snapshot)) {
-              for (const sb of mediaHooks) {
-                try {
-                  sb.callMedia(name, event);
-                } catch {
+          if (liveSlot.dead) {
+            try {
+              live.dispose();
+            } catch {
+            }
+            live = null;
+          } else {
+            liveSlot.handle = live;
+            liveMediaOverride = live.media;
+            windowDriver = live.windowTitle;
+            liveHold.mediaDriver = live.media;
+            if (live.status().audio === "mic") audioDriverRef.current = live.audio;
+            if (currentMediaDriver().snapshot.hasMedia) {
+              for (const { name, event } of media.diffMediaEvents(null, currentMediaDriver().snapshot)) {
+                for (const sb of mediaHooks) {
+                  try {
+                    sb.callMedia(name, event);
+                  } catch {
+                  }
                 }
               }
+              lastMediaSnap = media.cloneMediaSnapshot(currentMediaDriver().snapshot);
             }
-            lastMediaSnap = media.cloneMediaSnapshot(mediaDriver.snapshot);
+            const st = live.status();
+            reportDiag(
+              rt,
+              cfg,
+              `liveSystem: audio=${st.audio} media=${st.media} window=${st.window}` + (st.title ? ` title="${st.title}"` : "") + (st.hasArtwork ? " artwork=1" : "")
+            );
+            reportDiag(
+              rt,
+              cfg,
+              `audio: ${audioDriverRef.current ? "live mic" : "simulated"} stream, supportsaudioprocessing=${supportsAudioProcessing}`
+            );
+            window.__system = {
+              media: mediaControl,
+              windowTitle: windowDriver.snapshot,
+              shortcuts: shortcuts.last,
+              live: () => live.status()
+            };
+            window.__liveSystem = () => live.status();
           }
-          const st = live.status();
-          reportDiag(
-            rt,
-            cfg,
-            `liveSystem: audio=${st.audio} media=${st.media} window=${st.window}` + (st.title ? ` title="${st.title}"` : "") + (st.hasArtwork ? " artwork=1" : "")
-          );
-          reportDiag(
-            rt,
-            cfg,
-            `audio: ${audioDriverRef.current ? "live mic" : "simulated"} stream, supportsaudioprocessing=${supportsAudioProcessing}`
-          );
-          window.__system = {
-            media: mediaControl,
-            windowTitle: windowDriver.snapshot,
-            shortcuts: shortcuts.last,
-            live: () => live.status()
-          };
-          window.__liveSystem = () => live.status();
         } catch (e) {
           reportDiag(rt, cfg, `liveSystem: 启动失败，回退模拟源 (${e instanceof Error ? e.message : e})`);
           live = null;
@@ -14708,17 +14989,15 @@ function mountScene(rt, cfg) {
         if (now - lastRender >= interval) {
           lastRender = now;
           markFrame(rt, now);
-          if (rt.onFirstFrame) {
-            const first = rt.onFirstFrame;
-            rt.onFirstFrame = void 0;
-            first();
-          }
           syncCanvasSize(rt, c, rt.cfg);
           const t = (now - start - pauseAccum) / 1e3;
           inputView.update(pointerSrc.state);
           if (mediaSim.enabled) {
             if (live?.media) live.media.pump();
-            else simMedia.update(t);
+            else {
+              const drv = currentMediaDriver();
+              if (typeof drv?.update === "function") drv.update(t);
+            }
             const snap = mediaSnapshot();
             const evts = media.diffMediaEvents(lastMediaSnap, snap);
             if (evts.length) {
@@ -14824,6 +15103,14 @@ function mountScene(rt, cfg) {
           }
           const peek = rt.coverAlign;
           void renderer.render(scene, textures, c.width, c.height, t, normalizeFit(rt.cfg.fit), peek.x, peek.y).then(() => {
+            if (rt.onFirstFrame) {
+              const first = rt.onFirstFrame;
+              rt.onFirstFrame = void 0;
+              try {
+                first();
+              } catch {
+              }
+            }
             if (disposed || rt.paused) return;
             try {
               dispatchCursor();
@@ -15144,6 +15431,44 @@ function defaultAudioDriver() {
     }
   };
 }
+function bridgeAudioDriver(rt) {
+  const left = new Float32Array(64);
+  const right = new Float32Array(64);
+  return {
+    snapshot() {
+      const src = rt.audioBridge?.();
+      const sl = src?.left;
+      const sr = src?.right;
+      const n = sl && sr ? Math.min(64, sl.length, sr.length) : 0;
+      for (let i = 0; i < n; i++) {
+        left[i] = Math.max(0, Math.min(1, Number(sl[i]) || 0));
+        right[i] = Math.max(0, Math.min(1, Number(sr[i]) || 0));
+      }
+      for (let i = n; i < 64; i++) {
+        left[i] = 0;
+        right[i] = 0;
+      }
+      return { left, right };
+    }
+  };
+}
+function liveAudioDriver(handle) {
+  const left = new Float32Array(64);
+  const right = new Float32Array(64);
+  return {
+    tick() {
+      handle.audio.pump();
+    },
+    snapshot() {
+      const s = handle.audio.snapshot;
+      for (let i = 0; i < 64; i++) {
+        left[i] = Math.max(0, Math.min(1, Number(s.left64[i]) || 0));
+        right[i] = Math.max(0, Math.min(1, Number(s.right64[i]) || 0));
+      }
+      return { left, right };
+    }
+  };
+}
 function resolveContainer(rt, cfg) {
   if (rt.wrap) return rt.wrap;
   const el = cfg.canvas;
@@ -15458,8 +15783,10 @@ function pushMediaDiff(rt, prev, snap) {
   }
   return media.cloneMediaSnapshot(snap);
 }
-function startAudioPump(rt, driver, frameClock) {
+function startAudioPump(rt, driver, frameClock, liveHold = { driver: null }) {
   if (!driver) return;
+  const bridged = bridgeAudioDriver(rt);
+  const pick = () => rt.audioBridge ? bridged : liveHold.driver ?? driver;
   let raf = 0;
   let lastPush = 0;
   const tick = (now) => {
@@ -15471,8 +15798,9 @@ function startAudioPump(rt, driver, frameClock) {
     if (now - lastPush < interval * 0.85) return;
     lastPush = now;
     try {
-      driver.tick?.(now);
-      const snap = driver.snapshot();
+      const cur = pick();
+      cur.tick?.(now);
+      const snap = cur.snapshot();
       const arr = packWebAudioArrayInto(pumpBuffer, snap.left, snap.right);
       weShimCall(rt, (w) => w.__wePushAudio?.(arr));
       if (frameClock && now - frameClock.last > 200) markFrame(rt, now);
@@ -15491,6 +15819,7 @@ function startAudioPump(rt, driver, frameClock) {
 }
 function startMediaPump(rt, driver) {
   if (!driver) return;
+  const pick = () => rt.mediaSource ?? driver;
   let raf = 0;
   let lastMedia = null;
   let lastTick = 0;
@@ -15500,8 +15829,9 @@ function startMediaPump(rt, driver) {
     if (now - lastTick < 200) return;
     lastTick = now;
     try {
-      driver.update(now / 1e3);
-      lastMedia = pushMediaDiff(rt, lastMedia, driver.snapshot);
+      const cur = pick();
+      cur.update?.(now / 1e3);
+      lastMedia = pushMediaDiff(rt, lastMedia, cur.snapshot);
     } catch {
     }
   };
@@ -15596,18 +15926,65 @@ function mountWeb(rt, cfg) {
   }
   installWebCtl(rt);
   const cfgExt = cfg;
-  const audioDriver = cfgExt._webAudio === null ? null : cfgExt._webAudio ?? defaultAudioDriver();
-  const mediaDriver = cfgExt._webMedia === null ? null : cfgExt._webMedia ?? defaultMediaDriver();
+  const audioDriver = cfgExt._webAudio === null || rt.audioDisabled ? null : cfgExt._webAudio ?? defaultAudioDriver();
+  const mediaDriver = cfgExt._webMedia === null || rt.mediaDisabled ? null : cfgExt._webMedia ?? defaultMediaDriver();
   const finishBare = (why) => {
     reportDiag(rt, cfg, `网页壁纸 shim 注入失败（${why}），退回裸 iframe`);
     attachIframe(rt, cfg, container, entry, { injected: false });
     startAudioPump(rt, null);
     startMediaPump(rt, null);
+    let beat = 0;
+    const tick = (now) => {
+      if (!rt.iframe) return;
+      beat = requestAnimationFrame(tick);
+      if (rt.paused) return;
+      markFrame(rt, now);
+    };
+    beat = requestAnimationFrame(tick);
+    (rt.wallpaperDisposers ??= []).push(() => cancelAnimationFrame(beat));
   };
   const frameClock = { last: 0 };
+  const liveHold = { driver: null };
   const startPumps = () => {
-    startAudioPump(rt, audioDriver, frameClock);
+    startAudioPump(rt, audioDriver, frameClock, liveHold);
     startMediaPump(rt, mediaDriver);
+    if (cfg.liveSystem && audioDriver) {
+      const liveSlot = {
+        handle: null,
+        dead: false
+      };
+      (rt.wallpaperDisposers ??= []).push(() => {
+        liveSlot.dead = true;
+        liveHold.driver = null;
+        try {
+          liveSlot.handle?.dispose();
+        } catch {
+        }
+        liveSlot.handle = null;
+      });
+      void (async () => {
+        try {
+          const live = await startLiveSystem({ origin: location.origin });
+          if (liveSlot.dead) {
+            try {
+              live.dispose();
+            } catch {
+            }
+            return;
+          }
+          liveSlot.handle = live;
+          const st = live.status();
+          if (st.audio === "mic") {
+            liveHold.driver = liveAudioDriver(live);
+            reportDiag(rt, cfg, "liveSystem: 网页壁纸音频改用麦克风");
+          } else {
+            reportDiag(rt, cfg, `liveSystem: 麦克风不可用（${st.audio}），网页壁纸沿用模拟源`);
+          }
+        } catch (e) {
+          reportDiag(rt, cfg, `liveSystem: 启动失败，网页壁纸沿用模拟源 (${e?.message ?? e})`);
+        }
+      })();
+    }
   };
   void (async () => {
     const defaults = await fetchProjectWire(entry);
@@ -15674,6 +16051,99 @@ function mountWallpaper(rt, cfg) {
     rt.onUnhandledType?.(cfg);
   }
 }
+class Color {
+  x;
+  y;
+  z;
+  constructor(x, y, z) {
+    this.x = Number(x) || 0;
+    this.y = Number(y) || 0;
+    this.z = Number(z) || 0;
+  }
+  add(o) {
+    return new Color(this.x + o.x, this.y + o.y, this.z + o.z);
+  }
+  subtract(o) {
+    return new Color(this.x - o.x, this.y - o.y, this.z - o.z);
+  }
+  multiply(k) {
+    if (typeof k === "number") return new Color(this.x * k, this.y * k, this.z * k);
+    return new Color(this.x * k.x, this.y * k.y, this.z * k.z);
+  }
+  toString() {
+    return `${this.x} ${this.y} ${this.z}`;
+  }
+}
+function mediaColor(r, g, b) {
+  if (r instanceof Color) return r;
+  if (Array.isArray(r)) return new Color(r[0] ?? 0, r[1] ?? 0, r[2] ?? 0);
+  if (typeof r === "object" && r !== null) {
+    const o = r;
+    return new Color(o.x ?? 0, o.y ?? 0, o.z ?? 0);
+  }
+  return new Color(r, g ?? 0, b ?? 0);
+}
+const DEF_PRIMARY = [0.35, 0.38, 0.45];
+const DEF_SECONDARY = [0.12, 0.13, 0.17];
+const DEF_TERTIARY = [0.72, 0.76, 0.84];
+const DEF_TEXT = [0.95, 0.96, 0.98];
+function locateLyric(lyrics, position) {
+  if (!Array.isArray(lyrics) || lyrics.length === 0) return { line: "", index: -1 };
+  let idx = -1;
+  for (let i = 0; i < lyrics.length; i++) {
+    const at = Number(lyrics[i]?.[0]);
+    if (Number.isFinite(at) && at <= position) idx = i;
+    else break;
+  }
+  return { line: idx >= 0 ? String(lyrics[idx][1] ?? "") : "", index: idx };
+}
+function buildSnapshot(init) {
+  const position = Number(init.position) || 0;
+  const lyrics = Array.isArray(init.lyrics) ? init.lyrics : [];
+  const { line, index } = locateLyric(lyrics, position);
+  const state = init.state !== void 0 ? init.state : init.playing === false ? 2 : init.playing ? 1 : 0;
+  return {
+    hasMedia: init.hasMedia ?? (init.title != null || init.artist != null || !!init.playing),
+    state,
+    title: String(init.title ?? ""),
+    artist: String(init.artist ?? ""),
+    album: String(init.album ?? ""),
+    albumArtist: String(init.albumArtist ?? init.artist ?? ""),
+    position,
+    duration: Number(init.duration) || 0,
+    hasThumbnail: init.hasThumbnail ?? false,
+    primaryColor: mediaColor(init.primaryColor ?? DEF_PRIMARY),
+    secondaryColor: mediaColor(init.secondaryColor ?? DEF_SECONDARY),
+    tertiaryColor: mediaColor(init.tertiaryColor ?? DEF_TERTIARY),
+    textColor: mediaColor(init.textColor ?? DEF_TEXT),
+    highContrastColor: mediaColor(init.highContrastColor ?? init.textColor ?? DEF_TEXT),
+    trackIndex: Number(init.trackIndex) || 0,
+    lyrics,
+    lyricLine: line,
+    lyricIndex: index
+  };
+}
+function createMediaSource(init = {}, controls = {}) {
+  let cur = { ...init };
+  let snap = buildSnapshot(cur);
+  return {
+    get snapshot() {
+      return snap;
+    },
+    set(patch) {
+      cur = { ...cur, ...patch };
+      snap = buildSnapshot(cur);
+    },
+    // 宿主的快照由外部事件驱动，不需要按帧自行推进；留空实现满足接口即可
+    update() {
+    },
+    skipNext: controls.skipNext,
+    skipPrevious: controls.skipPrevious,
+    play: controls.play,
+    pause: controls.pause,
+    playPause: controls.playPause
+  };
+}
 function normalizeFitOption(fit) {
   if (fit === "fit") return "contain";
   if (fit === "fill") return "cover";
@@ -15683,6 +16153,13 @@ function isWebProject(project) {
   const t = project?.type;
   return typeof t === "string" && t.toLowerCase() === "web";
 }
+const MEDIA_TYPES = /* @__PURE__ */ new Set(["video", "gif", "image"]);
+function mediaProjectType(project) {
+  const t = project?.type;
+  if (typeof t !== "string") return null;
+  const lower = t.toLowerCase();
+  return MEDIA_TYPES.has(lower) ? lower : null;
+}
 function ensureSceneCanvas(el) {
   if (el instanceof HTMLCanvasElement) return el;
   const existing = el.querySelector(":scope > canvas[data-webwallgl]");
@@ -15725,6 +16202,47 @@ async function resolveMountConfig(el, o) {
     if (!url) throw new Error("网页壁纸：无法解析入口 URL（需要 Source.webEntry 或 httpSource）");
     return { ...base, type: "web", src: url, source: o.source };
   }
+  const mediaType = mediaProjectType(project);
+  if (mediaType) {
+    let url;
+    let entryType;
+    try {
+      const entry = await o.source.mediaEntry?.();
+      url = entry?.url;
+      entryType = entry?.type;
+    } catch {
+      url = void 0;
+    }
+    if (!url && o.source.key) {
+      const file = project && typeof project.file === "string" ? String(project.file).trim().replace(/^\/+/, "") : "";
+      if (file) url = `${o.source.key.replace(/\/+$/, "")}/${file}`;
+    }
+    if (!url) {
+      throw new Error(
+        `媒体壁纸（${mediaType}）：无法解析资源 URL（需要 Source.mediaEntry 或 project.file + httpSource）`
+      );
+    }
+    const canvas2 = ensureSceneCanvas(el);
+    const finalType = MEDIA_TYPES.has(String(entryType).toLowerCase()) ? String(entryType).toLowerCase() : mediaType;
+    return { ...base, type: finalType, src: url, canvas: canvas2, source: o.source };
+  }
+  const declaredType = typeof project?.type === "string" ? String(project.type).trim() : "";
+  if (!declaredType && typeof o.source.mediaEntry === "function") {
+    let url;
+    let entryType;
+    try {
+      const entry = await o.source.mediaEntry();
+      url = entry?.url;
+      entryType = entry?.type;
+    } catch {
+      url = void 0;
+    }
+    const sniffed = (MEDIA_TYPES.has(String(entryType).toLowerCase()) ? String(entryType).toLowerCase() : null) ?? (url ? sniffMediaType(url) : null);
+    if (url && sniffed) {
+      const canvas2 = ensureSceneCanvas(el);
+      return { ...base, type: sniffed, src: url, canvas: canvas2, source: o.source };
+    }
+  }
   const canvas = ensureSceneCanvas(el);
   return { ...base, type: "scene", canvas, source: o.source };
 }
@@ -15764,6 +16282,26 @@ function createScene(el, options) {
     rt.onSceneInfo = (info) => {
       rt.info = info;
     };
+    if ("audio" in o) applyAudio(o.audio ?? null);
+    if ("media" in o) {
+      rt.mediaSource = o.media ?? null;
+      rt.mediaDisabled = o.media === null;
+    }
+  };
+  const applyAudio = (src) => {
+    rt.audioDisabled = src === null;
+    if (!src) {
+      rt.audioBridge = null;
+      return;
+    }
+    rt.audioBridge = () => {
+      try {
+        const s = src.snapshot();
+        return s && s.left && s.right ? s : null;
+      } catch {
+        return null;
+      }
+    };
   };
   const armFirstFrame = () => {
     return new Promise((resolve) => {
@@ -15820,6 +16358,7 @@ function createScene(el, options) {
     setFit(fit) {
       rt.cfg.fit = fit;
       resetCoverAlign(rt);
+      rt.webRelayout?.();
     },
     setFps(fps) {
       rt.cfg.sceneFps = fps;
@@ -15843,11 +16382,81 @@ function createScene(el, options) {
     getProperties() {
       return { ...rt.liveUserProps ?? {} };
     },
+    // 宿主频谱源。只存引用，实际每帧拉取在 scene-mount 的渲染循环里。
+    // 与 __wp.setAudioBridge 同纪律：换场景不清空，装一次对之后所有场景生效
+    // （wireOptions 也只在选项里出现 audio 时才覆盖，见那里的说明）。
+    setAudio(src) {
+      currentOptions = { ...currentOptions, audio: src };
+      applyAudio(src);
+      rt.audioDisabled = false;
+    },
+    // 系统媒体源。与 setAudio 同纪律：只存引用、换场景不清空，
+    // scene 与 web 两条装配路径读同一个 rt.mediaSource。
+    // 注意语义与 MountOptions.media:null 不同：这里的 null 按文档是
+    // 「回落内置模拟源」，不是禁用（禁用只在挂载选项里表达）。
+    setMedia(src) {
+      currentOptions = { ...currentOptions, media: src };
+      rt.mediaSource = src ?? null;
+      rt.mediaDisabled = false;
+    },
+    // 媒体控制面。装配后由 mountScene 写入 rt.mediaCtl；未装配（或媒体/网页
+    // 壁纸尚无控制面）时给一个惰性替身，读快照得空、控制方法静默无效 ——
+    // 让调用方能无条件 `wp.media.playPause()` 而不必先判空。
+    get media() {
+      const ctl = rt.mediaCtl;
+      if (ctl) return ctl;
+      const empty = {
+        hasMedia: false,
+        state: 0,
+        title: "",
+        artist: "",
+        album: "",
+        albumArtist: "",
+        position: 0,
+        duration: 0,
+        hasThumbnail: false,
+        primaryColor: mediaColor(0, 0, 0),
+        secondaryColor: mediaColor(0, 0, 0),
+        tertiaryColor: mediaColor(0, 0, 0),
+        textColor: mediaColor(1, 1, 1),
+        highContrastColor: mediaColor(1, 1, 1),
+        trackIndex: 0,
+        lyrics: [],
+        lyricLine: "",
+        lyricIndex: -1
+      };
+      const noop = () => empty;
+      return {
+        get snapshot() {
+          return empty;
+        },
+        skipNext: noop,
+        skipPrevious: noop,
+        play: noop,
+        pause: noop,
+        playPause: noop
+      };
+    },
+    // 外部指针注入。pointerCtl 由 mountScene / mountWeb 各自装配时设置，
+    // 媒体壁纸不设 —— 那时这里静默无效，与整页渲染器的 __wp.pushPointer 一致。
+    pushPointer(u, v, buttons) {
+      rt.pointerCtl?.push({ u, v, buttons });
+    },
+    pointerLeave() {
+      rt.pointerCtl?.leave();
+    },
     async load(source) {
+      const prev = currentOptions.source;
+      if (prev && prev !== source) {
+        try {
+          prev.dispose?.();
+        } catch {
+        }
+      }
       currentOptions = { ...currentOptions, source };
       wireOptions(currentOptions);
       const cfg = await resolveMountConfig(boundEl, currentOptions);
-      if (cfg.type === "scene" && cfg.canvas instanceof HTMLCanvasElement) {
+      if (cfg.type !== "web" && cfg.canvas instanceof HTMLCanvasElement) {
         boundEl = cfg.canvas;
       }
       rt.cfg = cfg;
@@ -15874,6 +16483,10 @@ function createScene(el, options) {
     },
     destroy() {
       destroyRuntime(rt);
+      try {
+        currentOptions.source?.dispose?.();
+      } catch {
+      }
       rt.onDiagnostic = void 0;
       rt.onError = void 0;
       rt.onFirstFrame = void 0;
@@ -15901,11 +16514,11 @@ function createScene(el, options) {
     currentOptions = o;
     wireOptions(o);
     const cfg = await resolveMountConfig(el, o);
-    if (cfg.type === "scene" && cfg.canvas instanceof HTMLCanvasElement) {
+    if (cfg.type !== "web" && cfg.canvas instanceof HTMLCanvasElement) {
       boundEl = cfg.canvas;
     }
     rt.cfg = cfg;
-    rt.paused = o.autoplay === false;
+    rt.paused = false;
     rt.info = void 0;
     resetCoverAlign(rt);
     if (o.properties && Object.keys(o.properties).length) {
@@ -15919,6 +16532,7 @@ function createScene(el, options) {
     } finally {
       failure.off();
     }
+    if (o.autoplay === false) instance.pause();
     if ((o.volume ?? 0) > 0) instance.setVolume(o.volume);
     if (o.properties && Object.keys(o.properties).length) instance.setProperties(o.properties);
   };
@@ -15933,9 +16547,13 @@ async function mount(el, options) {
 }
 export {
   bytesSource,
+  createMediaSource,
   createScene,
   fileSource,
   httpSource,
-  mount
+  mediaColor,
+  mediaSource,
+  mount,
+  sniffMediaType
 };
 //# sourceMappingURL=webwallgl.mjs.map