@netless/slide 1.4.59 → 1.4.60

package/README.md

@@ -4,6 +4,29 @@
 
 ## changelog
 
+### 1.4.60 (2026-09-21)
+* 新增 `onPptMediaPermissionRequest(callback)` 与 `playPptMedia()`，支持在浏览器阻止自动播放时通知业务方并由真实用户点击恢复当前媒体
+* 增加 HTML5 音频和视频播放确认，覆盖浏览器静默暂停或未触发 `playerror` 的情况
+* 修复部分移动浏览器播放前 `duration`、`seekable` 为 0 导致 Howler 提前结束且不触发权限回调的问题
+* 修复视频启动时浏览器底层暂停独立音轨，以及用户点击恢复遇到 Howler pending play 无法重新播放的问题
+
+### 1.4.60-alpha.0 (2026-09-20)
+* 修复部分移动浏览器中 HTML5 音频播放请求卡住后，用户点击恢复仍无法重新发起播放的问题
+* 避免将媒体加载或缓冲过程误判为自动播放权限错误，并忽略旧播放请求的迟到事件
+
+### 1.4.59 (2026-09-18)
+* 优化移动端切页时的 Player 与 WebGL context 生命周期，减少重复创建和资源残留
+* 完善 Player 原地重置、候选 Player 交换和失败回退，避免快速切页后出现白屏或旧画面
+* 加强纹理缓存隔离、取消任务清理和 context 释放超时保护，降低页面切换对 RTC 与其他 WebGL 内容的影响
+
+### 1.4.59-alpha.4 (2026-09-17)
+* 增强 PPT 媒体自动播放恢复：为 Howler/HTML5 音频与视频增加播放确认 watchdog，覆盖浏览器静默失败未触发 `playerror` 的场景
+* 修正 Howler `playerror` 在内部状态已变为 playing 但 DOM 仍 paused 时被误过滤的问题
+
+### 1.4.59-alpha.0 (2026-09-11)
+* 新增 `onPptMediaPermissionRequest(callback)` 接口，用于通知当前 PPT 音视频需要用户交互后才能播放
+* 新增 `playPptMedia()` 接口，用于在用户点击事件中恢复当前仍处于播放状态、且本地被浏览器拦截的 PPT 音视频
+
 ### 1.4.58 (2026-09-07)
 * 修复低版本 WebView 中纯色图形显示为黑块的问题
 * 修复切页或销毁 Stage 后无限循环动画回调仍访问已释放 Pixi 对象导致的异常

package/lib/PlayerContextReleaseWait.js

@@ -0,0 +1,41 @@
+/**
+ * Wait for the browser to finish releasing a destroyed WebGL context before
+ * creating a replacement player. Uses rAF when available, but always settles
+ * within a bounded timeout so hidden/background WebViews cannot hang release.
+ */
+export function waitForPlayerContextRelease(platform) {
+    var isMobile = platform.isIOS() || platform.isAndroid();
+    var minFrames = isMobile ? 4 : 2;
+    var settleMs = isMobile ? 100 : 16;
+    var maxWaitMs = isMobile ? 500 : 200;
+    return new Promise(function (resolve) {
+        var settled = false;
+        var complete = function () {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            setTimeout(resolve, settleMs);
+        };
+        var timeoutId = setTimeout(complete, maxWaitMs);
+        var frameCount = 0;
+        var nextFrame = function () {
+            if (settled) {
+                return;
+            }
+            frameCount += 1;
+            if (frameCount >= minFrames) {
+                clearTimeout(timeoutId);
+                complete();
+                return;
+            }
+            if (typeof window.requestAnimationFrame === "function") {
+                window.requestAnimationFrame(nextFrame);
+            }
+            else {
+                setTimeout(nextFrame, 0);
+            }
+        };
+        nextFrame();
+    });
+}

package/lib/Slide.d.ts

@@ -471,6 +471,10 @@ export declare class Slide extends Slide_base {
     private playerGeneration;
     private playerGenerations;
     private playerSwapRenderTimeoutMs;
+    private pptMediaPermissionCallbacks;
+    private pptMediaPermissionNotified;
+    private pptMediaPermissionRenotifyPending;
+    private pendingPptMediaState?;
     private renderingIndex;
     private frameWidth;
     private frameHeight;
@@ -522,6 +526,14 @@ export declare class Slide extends Slide_base {
     static handleLogDownload: () => Promise<void>;
     private urlInterrupter;
     private initPlayer;
+    private getPptMediaState;
+    private getPlayingMediaIds;
+    private hasPptMediaPermissionRequest;
+    private notifyPptMediaPermissionRequest;
+    private handlePptMediaPermissionRequest;
+    private handlePptMediaPermissionResolved;
+    onPptMediaPermissionRequest(callback: () => void): () => void;
+    playPptMedia(): void;
     private userInputHandle;
     private _handleViewClick;
     private handleViewTouchStart;