webwallgl 1.1.0 → 1.3.5

package/webwallgl.global.js

@@ -51,10 +51,24 @@
     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;
@@ -96,10 +110,18 @@
     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();
@@ -155,6 +177,32 @@
     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));
@@ -3543,6 +3591,11 @@ void main() {
     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");
@@ -3899,7 +3952,8 @@ void main() {
       }
       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);
         }
       }
     }
@@ -5118,9 +5172,11 @@ void main() {
     __proto__: null,
     ALIGN,
     XRAY_IDLE_SCREEN_UV,
+    XRAY_SIZE_FALLBACK,
     applyColorBlendCPU,
     collectGroupDescendantIds,
     colorBlendPlan,
+    constantFallback,
     createRenderer,
     effectFboSize,
     layerWantsPreserveBackdrop,
@@ -11344,19 +11400,84 @@ void main() {
     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,
@@ -11364,13 +11485,32 @@ void main() {
       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;
@@ -11382,6 +11522,21 @@ void main() {
     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?.();
@@ -11395,8 +11550,7 @@ void main() {
     const fail = (why) => {
       if (disposed) return;
       disposed = true;
-      reportDiag(rt, cfg, `media ${cfg.type} 失败: ${why}`);
-      rt.fallbackPage?.();
+      failHard(why);
     };
     void (async () => {
       try {
@@ -11444,6 +11598,7 @@ void main() {
           });
           if (!rt.paused) void v.play().catch(() => {
           });
+          attachVideoSpectrum(rt, cfg, v);
           reportDiag(rt, cfg, `media video ${mediaW}x${mediaH} → scene 渲染`);
         } else {
           let decoded = false;
@@ -11543,6 +11698,14 @@ void main() {
               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)));
@@ -11625,6 +11788,48 @@ void main() {
     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 {
@@ -11679,6 +11884,29 @@ void main() {
           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;
       }
     };
   }
@@ -11698,6 +11926,43 @@ void main() {
       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;
@@ -12978,9 +13243,10 @@ vec3 DecompressNormal(vec4 tex) {
         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),
@@ -13079,7 +13345,7 @@ vec3 DecompressNormal(vec4 tex) {
         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 = {
@@ -13088,7 +13354,7 @@ vec3 DecompressNormal(vec4 tex) {
             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);
@@ -13133,36 +13399,30 @@ vec3 DecompressNormal(vec4 tex) {
           }
           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,
@@ -13283,6 +13543,18 @@ vec3 DecompressNormal(vec4 tex) {
           }
         }
         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 {
@@ -13323,7 +13595,7 @@ vec3 DecompressNormal(vec4 tex) {
                     generated: true
                   });
                 }
-                const snap = mediaDriver.snapshot;
+                const snap = currentMediaDriver().snapshot;
                 if (palette) {
                   snap.primaryColor = media.mediaVec3(...palette.primary);
                   snap.secondaryColor = media.mediaVec3(...palette.secondary);
@@ -13348,39 +13620,48 @@ vec3 DecompressNormal(vec4 tex) {
                 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;
@@ -14712,17 +14993,15 @@ vec3 DecompressNormal(vec4 tex) {
           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) {
@@ -14828,6 +15107,14 @@ vec3 DecompressNormal(vec4 tex) {
             }
             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();
@@ -15148,6 +15435,44 @@ ${escapeScriptClose(opts.seedScript)}
       }
     };
   }
+  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;
@@ -15462,8 +15787,10 @@ ${escapeScriptClose(opts.seedScript)}
     }
     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) => {
@@ -15475,8 +15802,9 @@ ${escapeScriptClose(opts.seedScript)}
       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);
@@ -15495,6 +15823,7 @@ ${escapeScriptClose(opts.seedScript)}
   }
   function startMediaPump(rt, driver) {
     if (!driver) return;
+    const pick = () => rt.mediaSource ?? driver;
     let raf = 0;
     let lastMedia = null;
     let lastTick = 0;
@@ -15504,8 +15833,9 @@ ${escapeScriptClose(opts.seedScript)}
       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 {
       }
     };
@@ -15600,18 +15930,65 @@ ${escapeScriptClose(opts.seedScript)}
     }
     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);
@@ -15678,6 +16055,99 @@ ${escapeScriptClose(opts.seedScript)}
       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";
@@ -15687,6 +16157,13 @@ ${escapeScriptClose(opts.seedScript)}
     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]");
@@ -15729,6 +16206,47 @@ ${escapeScriptClose(opts.seedScript)}
       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 };
   }
@@ -15768,6 +16286,26 @@ ${escapeScriptClose(opts.seedScript)}
       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) => {
@@ -15824,6 +16362,7 @@ ${escapeScriptClose(opts.seedScript)}
       setFit(fit) {
         rt.cfg.fit = fit;
         resetCoverAlign(rt);
+        rt.webRelayout?.();
       },
       setFps(fps) {
         rt.cfg.sceneFps = fps;
@@ -15847,11 +16386,81 @@ ${escapeScriptClose(opts.seedScript)}
       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;
@@ -15878,6 +16487,10 @@ ${escapeScriptClose(opts.seedScript)}
       },
       destroy() {
         destroyRuntime(rt);
+        try {
+          currentOptions.source?.dispose?.();
+        } catch {
+        }
         rt.onDiagnostic = void 0;
         rt.onError = void 0;
         rt.onFirstFrame = void 0;
@@ -15905,11 +16518,11 @@ ${escapeScriptClose(opts.seedScript)}
       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) {
@@ -15923,6 +16536,7 @@ ${escapeScriptClose(opts.seedScript)}
       } 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);
     };
@@ -15936,10 +16550,14 @@ ${escapeScriptClose(opts.seedScript)}
     return instance;
   }
   exports2.bytesSource = bytesSource;
+  exports2.createMediaSource = createMediaSource;
   exports2.createScene = createScene;
   exports2.fileSource = fileSource;
   exports2.httpSource = httpSource;
+  exports2.mediaColor = mediaColor;
+  exports2.mediaSource = mediaSource;
   exports2.mount = mount;
+  exports2.sniffMediaType = sniffMediaType;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
 });
 //# sourceMappingURL=webwallgl.global.js.map