ckplayer-plus 1.1.1 → 1.1.3

package/README.md

@@ -63,7 +63,7 @@ React：
 | `container` | 核心 API 必须；组件不用 | — | 播放器挂载节点。Vue/React 组件内部自动创建，**不要传** |
 | `video` | 必须 | — | 视频地址或清晰度数组 |
 | `poster` | 可选 | `''` | 封面图 |
-| `autoplay` | 可选 | `false` | 自动播放（移动端常需静音） |
+| `autoplay` | 可选 | `false` | 自动播放。**课程/断点续播请保持 `false`**：有 `seek` 时组件会强制关闭自动播，只定位进度，需用户点击播放 |
 | `volume` | 可选 | `0.8` | 音量 0–1 |
 | `live` | 可选 | `false` | 直播相关 |
 | `width` / `height` | 组件可选 | `100%` / `400px` | 仅 Vue/React 组件样式 |
@@ -77,7 +77,7 @@ React：
 | `preferBuiltinPlug` | `true` | 优先加载本包内置脚本，避免复用页面上其它全局 `Hls` |
 | `cdnFallback` | `true` | `getPath` 失败时回退 jsDelivr；内网无外网请设 `false` 并配 `pluginPath` |
 | `pluginPath` | 自动 | 插件脚本根路径。默认：`window.ckplayerBasePath` → 本包 `dist/` → jsDelivr CDN |
-| `seek` | `0` | 续播秒数（number 或数字字符串）；会同步 `maxSeeTime`。HLS 优先用 `startPosition`，并等待缓冲后再跳，降低非关键帧解码失败 |
+| `seek` | `0` | 续播秒数。HLS 对齐分片起点缓冲后再定位；**只 seek 不自动 play**，避免 Network 出现 canceled `.ts` |
 | `loaded` | — | **只支持函数**；字符串形式已禁用（防 XSS） |
 
 ### 进阶（按需）
@@ -125,7 +125,7 @@ export default {
 </script>
 ```
 
-断点续播：`seek` 用 `:seek` 或 `options.seek` 在创建时传入；**不要**在 `@ready` 里再 `player.seek(16)`，否则会重复加载 HLS、取消 `.ts` 分片导致卡住。
+断点续播：`seek` 用 `:seek` 或 `options.seek` 在创建时传入；**不要**在 `@ready` 里再 `player.seek(16)`，否则会重复加载 HLS、取消 `.ts` 分片导致卡住。有 `seek` 时不会自动播放，定位完成后点中央播放按钮即可。切集/切换清晰度同样不强制自动播。
 
 SSR（Nuxt 等）请用 `<ClientOnly>`，仅在浏览器初始化。
 

package/dist/ckplayer.js

@@ -141,7 +141,7 @@
 		cdnFallback:true// getPath 失败时是否回退到 jsDelivr（内网可设 false，并配置 pluginPath）
 	};
 	// 打包时替换为真实版本；用于 bundler 下 getPath 失效时的 CDN 回退
-	var ckplayerPlusDefaultCdn='https://cdn.jsdelivr.net/npm/ckplayer-plus@1.1.1/dist/';
+	var ckplayerPlusDefaultCdn='https://cdn.jsdelivr.net/npm/ckplayer-plus@1.1.3/dist/';
 	function ckplayerEmbed(videoObj){
 		/*
 		 * rightMenu
@@ -446,7 +446,7 @@
 			}
 			var allowCdn=!vars || vars['cdnFallback']!==false;
 			var cdn=(typeof window!=='undefined' && window.ckplayerPlusCdn) ? window.ckplayerPlusCdn : ckplayerPlusDefaultCdn;
-			if(!allowCdn || !cdn || cdn.indexOf('1.1.1')>-1){
+			if(!allowCdn || !cdn || cdn.indexOf('1.1.3')>-1){
 				// 避免占位版本或显式关闭 CDN 时请求坏地址；交给相对路径或业务 pluginPath
 				return folder+'/'+file;
 			}
@@ -594,7 +594,13 @@
 				// 不使用原生 autoplay 属性：浏览器会在 seek 前开始 play，随后
 				// currentTime / pause 等初始化动作会打断其 Promise，导致永久 loading。
 				video.attr('preload','auto');
-				autoplayPending=true;
+				// 带断点续播时不自动播：只定位进度，等用户点击（避免 .ts canceled）
+				if(parseResumeSeekFromVars()>0){
+					autoplayPending=false;
+				}
+				else{
+					autoplayPending=true;
+				}
 			}
 			else{
 				video.attr('preload','metadata');
@@ -763,6 +769,10 @@
 			if(!seekTime){
 				applyResumeSeekState(parseResumeSeekFromVars());
 			}
+			// 有续播目标：取消自动播放，定位后展示中央播放按钮
+			if(seekTime>0){
+				autoplayPending=false;
+			}
 		},
 		/*
 		 * hlsSeekTo
@@ -990,10 +1000,8 @@
 					if(!resumeAt){
 						resumeAt=parseResumeSeekFromVars();
 					}
-					// 部分旧 HLS 的分片不从关键帧开始。直接以续播点 startPosition / startLoad(target)
-					// 起播会触发 Chrome PIPELINE_ERROR_DECODE。策略：
-					// 1) 从目标前约一个分片开始加载，让前序关键帧进入缓冲
-					// 2) 等 hlsCanSafelySeekTo 后再写 currentTime
+					// HLS 续播：不要用精确秒数做 startPosition（易在分片中部起播导致解码失败/永久 loading）。
+					// 对齐目标分片起点加载，等分片从起点缓冲到目标后再一次 currentTime，并强制 play。
 					if(resumeAt && resumeAt>0 && (isUndefined(vars['live']) || !vars['live'])){
 						maxSeeTime=Math.max(maxSeeTime,resumeAt);
 						if(firstSeekTime<0){
@@ -1002,16 +1010,28 @@
 						seekTime=resumeAt;
 						hlsResumeTarget=resumeAt;
 						hlsResumeWarmup=true;
-						hlsConf.startPosition=hlsPriorLoadTime(resumeAt);
 					}
 					hls = new Hls(hlsConf);
 					hls.loadSource(url);
 					hls.attachMedia(video);
 					hls.on(Hls.Events.MANIFEST_PARSED, function(){
 						if(hlsResumeWarmup && seekTime>0){
+							var loadAt=hlsPriorLoadTime(seekTime);
 							try{
-								hls.startLoad(hlsPriorLoadTime(seekTime));
+								hls.startLoad(loadAt);
 							}catch(event){}
+							// 超时兜底：仍未定位则对齐分片起点起播，避免一直转圈
+							setTimeout(function(){
+								if(!hlsResumeWarmup || !seekTime){return;}
+								var target=seekTime;
+								if(hlsCanSafelySeekTo(target)){
+									finishResumeSeek(target);
+									return;
+								}
+								var snap=hlsPriorLoadTime(target);
+								hlsResumeWarmup=false;
+								finishResumeSeek(snap);
+							},5000);
 							return;
 						}
 						if(!hlsStartPositionUsed){
@@ -1020,10 +1040,8 @@
 					});
 					hls.on(Hls.Events.FRAG_BUFFERED, function(event, data){
 						if(hlsResumeWarmup && seekTime>0){
-							// 必须等「目标 + 前序分片」都在同一连续缓冲里，再定位
 							if(hlsCanSafelySeekTo(seekTime)){
-								hlsResumeWarmup=false;
-								applySeekToMedia(seekTime);
+								finishResumeSeek(seekTime);
 							}
 							return;
 						}
@@ -1033,7 +1051,6 @@
 						var fragStart=data.frag.start;
 						var fragEnd=fragStart+data.frag.duration;
 						if(hlsResumeTarget>=fragStart-0.5 && hlsResumeTarget<=fragEnd+0.5){
-							// 续播分片已进入缓冲，解除 waiting
 							if(!waited){
 								waited=true;
 								if(C['buffer']){
@@ -1833,38 +1850,114 @@
 			}catch(event){}
 			return false;
 		},
+		/*
+		 * hlsFragAround
+		 * 功能：查找覆盖指定时间的 HLS 分片（用于对齐关键帧起点）
+		*/
+		hlsFragAround=function(t){
+			if(!hls || isNaN(t) || t<0){
+				return null;
+			}
+			try{
+				var level=-1;
+				if(typeof hls.currentLevel==='number' && hls.currentLevel>=0){
+					level=hls.currentLevel;
+				}
+				else if(typeof hls.firstLevel==='number' && hls.firstLevel>=0){
+					level=hls.firstLevel;
+				}
+				else{
+					level=0;
+				}
+				var details=hls.levels && hls.levels[level] && hls.levels[level].details;
+				var frags=details && details.fragments;
+				if(!frags || !frags.length){
+					return null;
+				}
+				for(var i=0;i<frags.length;i++){
+					var f=frags[i];
+					if(!f){continue;}
+					var start=f.start||0;
+					var end=start+(f.duration||0);
+					if(t>=start-0.05 && t<end+0.05){
+						return f;
+					}
+				}
+				// 超出末片时回退最后一片
+				return frags[frags.length-1];
+			}catch(event){}
+			return null;
+		},
 		/*
 		 * hlsPriorLoadTime
-		 * 功能：续播加载起点——至少回退约一个分片，保证目标分片前仍有关键帧可参考
+		 * 功能：续播加载起点——优先对齐目标分片起点（该流分片开头通常有 IDR）
 		*/
 		hlsPriorLoadTime=function(t){
 			if(isNaN(t) || t<=0){
 				return 0;
 			}
+			var frag=hlsFragAround(t);
+			if(frag && !isUndefined(frag.start)){
+				return Math.max(0,frag.start);
+			}
 			return Math.max(0,t-12);
 		},
 		/*
 		 * hlsCanSafelySeekTo
-		 * 功能：目标已缓冲，且同一连续缓冲区间覆盖目标前约一个分片
-		 * 部分旧 TS 分片首帧不是关键帧；若只缓冲目标分片就 seek，Chrome 会报 PIPELINE_ERROR_DECODE
+		 * 功能：目标分片已从分片起点连续缓冲到目标点，才允许 currentTime
+		 * 避免分片未完整进入 MSE 时中途 seek 触发 PIPELINE_ERROR_DECODE / 永久 loading
 		*/
 		hlsCanSafelySeekTo=function(t){
 			if(!video || isUndefined(video.buffered) || isNaN(t) || t<0){
 				return false;
 			}
+			if(!timeInBuffered(t)){
+				return false;
+			}
+			var fragStart=hlsPriorLoadTime(t);
+			// 同一连续区间需覆盖分片起点→目标
 			try{
 				var buf=video.buffered;
-				var needFrom=hlsPriorLoadTime(t);
 				for(var i=0;i<buf.length;i++){
 					var start=buf.start(i);
 					var end=buf.end(i);
-					if(t<=end+0.15 && needFrom>=start-0.35){
+					if(fragStart>=start-0.35 && t<=end+0.15){
 						return true;
 					}
 				}
 			}catch(event){}
 			return false;
 		},
+		/*
+		 * finishResumeSeek
+		 * 功能：完成续播定位。只 seek、不自动 play（由用户点击中央按钮/播放键）
+		 * 避免 seek 后立刻 play 打断 HLS 分片请求（Network 出现 canceled .ts）并导致永久转圈
+		*/
+		finishResumeSeek=function(t){
+			hlsResumeWarmup=false;
+			// 续播场景取消挂起的自动播放，统一改为点击播放
+			autoplayPending=false;
+			applySeekToMedia(t);
+			setTimeout(function(){
+				if(!video){return;}
+				try{
+					video.pause();
+				}catch(event){}
+				paused=true;
+				if(C['buffer']){
+					C['buffer'].hide();
+				}
+				waited=true;
+				if(!vars['controls'] && C['centerPlay']){
+					C['centerPlay'].show();
+				}
+				if(C['bar'] && C['bar']['playAndPause']){
+					C['bar']['playAndPause']['pause'].hide();
+					C['bar']['playAndPause']['play'].show();
+					C['bar']['playAndPause']['refresh'].hide();
+				}
+			},120);
+		},
 		/*
 		 * clearSeekRetry
 		 * 功能：清理续播等待计时器
@@ -1933,17 +2026,14 @@
 					firstSeekTime=t;
 				}
 			}
-			// HLS 首分片尚未完成预热时不能直接 startLoad(target)，否则某些
-			// 非关键帧分片会让浏览器解码器永久报错。
+			// HLS 首分片尚未完成预热时不能直接 startLoad(target)
 			if(hlsResumeWarmup){
 				if(hlsCanSafelySeekTo(t)){
-					hlsResumeWarmup=false;
-					applySeekToMedia(t);
+					finishResumeSeek(t);
 				}
 				return;
 			}
-			// HLS：用 hls.startLoad 从目标分片加载（去重，避免取消进行中的 .ts）
-			// 若目标附近尚无前序缓冲，改为预热模式从更早处分片加载
+			// HLS：用 hls.startLoad 从目标分片起点加载（去重，避免取消进行中的 .ts）
 			if(hls && typeof hls.startLoad==='function'){
 				if(!hlsCanSafelySeekTo(t) && t>1){
 					hlsResumeWarmup=true;
@@ -1998,8 +2088,11 @@
 			if(isNaN(resumeAt) || resumeAt<0){
 				resumeAt=0;
 			}
-			// 每次失败再往前多退一个分片，避免反复落到同一坏点
-			var loadFrom=Math.max(0,resumeAt-(12*decodeRecoverCount));
+			// 优先对齐分片起点（有 IDR）；多次失败再往前一片
+			var loadFrom=hlsPriorLoadTime(resumeAt);
+			if(decodeRecoverCount>=2){
+				loadFrom=Math.max(0,loadFrom-10);
+			}
 			seekApplyLock=false;
 			clearSeekRetry();
 			try{
@@ -2008,7 +2101,9 @@
 				}
 			}catch(event){}
 			if(resumeAt>0 && hls && typeof hls.startLoad==='function'){
-				seekTime=resumeAt;
+				// 第 3 次直接落到分片起点起播，保证能出画面
+				var target=(decodeRecoverCount>=3)?loadFrom:resumeAt;
+				seekTime=target;
 				hlsResumeTarget=resumeAt;
 				hlsResumeWarmup=true;
 				hlsLoadAt=-1;
@@ -2017,31 +2112,20 @@
 					hls.startLoad(loadFrom);
 				}catch(event){}
 				setTimeout(function(){
-					if(hlsCanSafelySeekTo(resumeAt)){
-						hlsResumeWarmup=false;
-						applySeekToMedia(resumeAt);
-						if(video && video.paused && vars['autoplay']){
-							try{video.play();}catch(e2){}
-						}
+					if(hlsCanSafelySeekTo(target)){
+						finishResumeSeek(target);
+					}
+					else if(decodeRecoverCount>=2){
+						finishResumeSeek(loadFrom);
 					}
 					else{
 						applyPendingSeek(false);
 					}
-				},500);
+				},600);
 				return true;
 			}
 			try{
-				var soft=Math.max(0,resumeAt-1.5);
-				seekTime=resumeAt;
-				if(video){
-					video.currentTime=soft;
-				}
-				setTimeout(function(){
-					applyPendingSeek(true);
-					if(video && video.paused && vars['autoplay']){
-						try{video.play();}catch(e2){}
-					}
-				},400);
+				finishResumeSeek(Math.max(0,resumeAt-1.5));
 				return true;
 			}catch(event){}
 			return false;
@@ -2303,7 +2387,8 @@
 				eventTarget('seeked');
 			},
 			seeking:function(){
-				if(paused){
+				// 续播/初始化定位中禁止抢先 play：会取消进行中的 .ts 并导致永久 loading
+				if(paused && !seekApplyLock && !hlsResumeWarmup && !seekTime && !autoplayPending){
 					player.play();
 				}
 				var seekingTime=this.currentTime;
@@ -4763,7 +4848,10 @@
 						}
 					}
 					seekTime=player.time();
-					video.attr('autoplay','autoplay');
+					// 切换清晰度只保留进度，不强制 autoplay（避免分片 canceled + 未经点击就播放）
+					try{
+						video.removeAttr('autoplay');
+					}catch(event){}
 					changeVideo(ele.attr('data-video'));
 					message(language['switchTo']+ele.htm());
 					C['bar']['definition']['button'].htm(ele.htm());
@@ -7194,7 +7282,7 @@
 				if(!isRetry && (!vars || vars['cdnFallback']!==false)){
 					var cdn=(typeof window!=='undefined' && window.ckplayerPlusCdn) ? window.ckplayerPlusCdn : ckplayerPlusDefaultCdn;
 					var m=String(file).match(/\/(hls\.js|flv\.js|mpegts\.js|language)\/([^/?#]+)(?:[?#].*)?$/i);
-					if(cdn && cdn.indexOf('1.1.1')===-1 && m){
+					if(cdn && cdn.indexOf('1.1.3')===-1 && m){
 						if(cdn.slice(-1)!=='/'){
 							cdn+='/';
 						}