@netless/slide 1.4.59-alpha.4 → 1.4.60-alpha.0

package/README.md

@@ -4,6 +4,10 @@
 
 ## changelog
 
+### 1.4.60-alpha.0 (2026-09-20)
+* 修复部分移动浏览器中 HTML5 音频播放请求卡住后，用户点击恢复仍无法重新发起播放的问题
+* 避免将媒体加载或缓冲过程误判为自动播放权限错误，并忽略旧播放请求的迟到事件
+
 ### 1.4.59-alpha.4 (2026-09-17)
 * 增强 PPT 媒体自动播放恢复：为 Howler/HTML5 音频与视频增加播放确认 watchdog，覆盖浏览器静默失败未触发 `playerror` 的场景
 * 修正 Howler `playerror` 在内部状态已变为 playing 但 DOM 仍 paused 时被误过滤的问题

package/lib/PlayerContextReleaseWait.d.ts

@@ -0,0 +1,10 @@
+export declare type ContextReleasePlatform = {
+    isIOS(): boolean;
+    isAndroid(): boolean;
+};
+/**
+ * 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 declare function waitForPlayerContextRelease(platform: ContextReleasePlatform): Promise<void>;

package/lib/Slide.d.ts

@@ -446,6 +446,7 @@ export declare class Slide extends Slide_base {
     static __stageCountLimit: number;
     static setStageCountLimit(limit: number): void;
     private iosResetCache;
+    private iosResetPending;
     private iosNewPlayer?;
     private version?;
     private __slideState;
@@ -467,13 +468,13 @@ export declare class Slide extends Slide_base {
     private anchor;
     private tracker;
     private player?;
+    private playerGeneration;
+    private playerGenerations;
+    private playerSwapRenderTimeoutMs;
     private pptMediaPermissionCallbacks;
     private pptMediaPermissionNotified;
     private pptMediaPermissionRenotifyPending;
     private pendingPptMediaState?;
-    private playerGeneration;
-    private playerGenerations;
-    private playerSwapRenderTimeoutMs;
     private renderingIndex;
     private frameWidth;
     private frameHeight;
@@ -514,8 +515,7 @@ export declare class Slide extends Slide_base {
     private handleSyncQueueCompactRenderComplete;
     private handleSyncQueueCatchUpStateChange;
     private updatePlayerInteractive;
-    private flipDebugState;
-    private logSlideFlip;
+    private hideResetSnapshot;
     private observeRenderTask;
     private recoverHandler;
     private reportError;