wallpaper-engine-dsh 2.1.1 → 2.1.2

package/README.md

@@ -73,6 +73,7 @@ Media serving is defensive by design: tokens are unguessable 72-bit values, stab
 - Scene and application wallpapers are not listed: they are Wallpaper Engine's private `.pkg` scene packages, and their live animation can only be rendered by Wallpaper Engine itself on the desktop.
 - Web wallpapers run isolated from the page's storage, so ones that persist state across loads won't keep it.
 - Web wallpapers with sound may stay silent until you interact with the page — browsers gate audio in sandboxed documents on a user gesture, and wallpapers that rely on Wallpaper Engine's system-audio feed (visualizers) have no signal to draw from.
+- Video codecs are bounded by what the browser can decode. H.264/AVC, VP8/VP9, and AV1 play natively; workshop videos compressed with H.265/HEVC cannot be software-decoded on most machines — previously a solid black screen, now detected as "playing but zero decoded frames" and automatically demoted to the preview still with a status note. Transcoding to H.264 mp4 or VP9 webm restores full playback.
 - The glass effect reads DSH design tokens; if a future shell redesign renames them, frosting degrades to plain transparency.
 
 ## Development

package/README.zh.md

@@ -73,6 +73,7 @@ bundle 分为两半:
 - 场景与应用壁纸不出现在列表中:它们是 Wallpaper Engine 私有的 `.pkg` 场景包,动态渲染只能由桌面端的 Wallpaper Engine 完成。
 - 网页壁纸与页面存储隔离,需要跨加载保存状态的壁纸无法保留状态。
 - 带声音的网页壁纸可能在你与页面交互前保持静默——浏览器对沙箱文档的音频有自动播放限制;依赖 Wallpaper Engine 系统音频输入的壁纸(如音频可视化)在浏览器中没有信号可画。
+- 视频编码受浏览器解码能力约束。浏览器可以直接播放 H.264/AVC、VP8/VP9 与 AV1;创意工坊中用 H.265/HEVC 压缩的视频在多数机器上无法软解——之前表现为只有一片黑色,现在检测到「声称在播放但解不出任何帧」时会自动降级为预览图并在状态行说明。手工转码为 H.264 的 mp4 或 VP9 的 webm 即可完整播放。
 - 玻璃效果读 DSH 设计令牌;若未来外壳重构重命名令牌,磨砂会退化为普通半透明。
 
 ## 开发

package/lib/client.js

@@ -729,32 +729,64 @@ window.__ModuleLoader__.load({
 		  });
 		}
 
+		function handleMediaFailure(sel) {
+		  const id = sel.id;
+		  const count = (mediaFailures.get(id) || 0) + 1;
+		  mediaFailures.set(id, count);
+		  const w = selection.inventory.wallpapers.find((x) => x.id === id);
+		  if (count === 1) {
+		    // Maybe just a dead token: refetch fresh URLs and remount. Throttled
+		    // PER WALLPAPER - a global window would strand a video whose first
+		    // error lands soon after an unrelated recovery (no remount, no second
+		    // error, blank layer until a manual refresh).
+		    const now = Date.now();
+		    if (now - (lastRecoveryAt.get(id) || 0) < 10000) return;
+		    lastRecoveryAt.set(id, now);
+		    forceRemount = true;
+		    loadInventory(true);
+		  } else if (w && w.preview && !demotedToPreview.has(id)) {
+		    // The media itself is unusable here - fall back to the still preview.
+		    demotedToPreview.add(id);
+		    applySelection(id);
+		  } else {
+		    // Unrenderable here with no preview to fall back on (or the entry has
+		    // vanished from the inventory entirely): clear the selection rather
+		    // than leave a dead element on the layer.
+		    applySelection("");
+		  }
+		}
+
 		function attachMediaError(media, sel) {
-		  media.addEventListener("error", () => {
-		    const id = sel.id;
-		    const count = (mediaFailures.get(id) || 0) + 1;
-		    mediaFailures.set(id, count);
-		    const w = selection.inventory.wallpapers.find((x) => x.id === id);
-		    if (count === 1) {
-		      // Maybe just a dead token: refetch fresh URLs and remount. Throttled
-		      // PER WALLPAPER — a global window would strand a video whose first
-		      // error lands soon after an unrelated recovery (no remount, no second
-		      // error, blank layer until a manual refresh).
-		      const now = Date.now();
-		      if (now - (lastRecoveryAt.get(id) || 0) < 10000) return;
-		      lastRecoveryAt.set(id, now);
-		      forceRemount = true;
-		      loadInventory(true);
-		    } else if (w && w.preview && !demotedToPreview.has(id)) {
-		      // The media itself is unusable here — fall back to the still preview.
-		      demotedToPreview.add(id);
-		      applySelection(id);
-		    } else {
-		      // Unrenderable here with no preview to fall back on (or the entry has
-		      // vanished from the inventory entirely): clear the selection rather
-		      // than leave a dead element on the layer.
-		      applySelection("");
-		    }
+		  media.addEventListener("error", () => handleMediaFailure(sel));
+		  if (sel.type === "video") attachZeroFrameDetector(media, sel);
+		}
+
+		// Zero-decoded-frames detector: Chromium can report a video as PLAYING
+		// without ever decoding a frame - no error event, currentTime advancing,
+		// picture permanently black. Typical with HEVC/H.265 content when the
+		// machine has no usable hardware decode. getVideoPlaybackQuality exposes
+		// the truth (totalVideoFrames stays 0); a genuinely dark wallpaper is
+		// unaffected because its frames DO decode. Wired into the same recovery
+		// ladder as a media error: first hit retries with fresh tokens, second
+		// hit demotes to the preview still (or clears without one).
+		function attachZeroFrameDetector(media, sel) {
+		  media.addEventListener("playing", () => {
+		    // One probe ~2s into claimed playback: enough for even a slow
+		    // hardware pipeline to produce its first frames.
+		    schedule(() => {
+		      // Stale guard: crossfade may have swapped the element out already,
+		      // and the probe must never run while the user paused playback.
+		      const layer = document.getElementById(LAYER_ID);
+		      if (!layer || layer.querySelector("video") !== media) return;
+		      if (media.paused || !(media.currentTime > 0)) return;
+		      const q = typeof media.getVideoPlaybackQuality === "function"
+		        ? media.getVideoPlaybackQuality() : null;
+		      const frames = q ? q.totalVideoFrames
+		        : (typeof media.webkitDecodedFrameCount === "number"
+		          ? media.webkitDecodedFrameCount : null);
+		      if (frames === null) return; // no probe available -> cannot detect
+		      if (frames === 0) handleMediaFailure(sel);
+		    }, 2000);
 		  });
 		}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wallpaper-engine-dsh",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "Wallpaper Engine library as the DSH web GUI background — video/web/still wallpapers, rotation lists, search, resource monitor, bilingual UI.",
   "type": "module",
   "main": "lib/index.js",