ckplayer-plus 1.1.0 → 1.1.2

package/dist/ckplayer.js

@@ -93,7 +93,7 @@
 		backLive:false,//显示返回直播按钮
 		seek: 0,//默认需要跳转的秒数
 		next: null,//下一集按钮动作
-		loaded: '',//加载播放器后调用的函数
+		loaded: null,//加载播放器后调用的函数（仅支持 function）
 		plug: '',//使用插件
 		duration:0,//视频总时间
 		preview: null,//预览图片对象
@@ -141,7 +141,7 @@
 		cdnFallback:true// getPath 失败时是否回退到 jsDelivr（内网可设 false，并配置 pluginPath）
 	};
 	// 打包时替换为真实版本；用于 bundler 下 getPath 失效时的 CDN 回退
-	var ckplayerPlusDefaultCdn='https://cdn.jsdelivr.net/npm/ckplayer-plus@1.1.0/dist/';
+	var ckplayerPlusDefaultCdn='https://cdn.jsdelivr.net/npm/ckplayer-plus@1.1.2/dist/';
 	function ckplayerEmbed(videoObj){
 		/*
 		 * rightMenu
@@ -174,9 +174,11 @@
 		var seekRetryTimer=null;//续播等待缓冲的重试计时器
 		var seekRetryCount=0;//续播重试次数
 		var seekApplyLock=false;//防止并发多次 currentTime 赋值
+		var autoplayPending=false;//自动播放必须等初始化续播完成后才触发
 		var decodeRecoverCount=0;//MEDIA_ERR_DECODE 恢复次数
 		var hlsStartPositionUsed=false;//是否已用 hls.js startPosition 处理续播
 		var hlsResumeTarget=-1;//HLS 续播目标秒数（避免重复 startLoad 取消分片请求）
+		var hlsResumeWarmup=false;//HLS 续播先预热首个可解码分片，再定位目标时间
 		var hlsLoadAt=-1;//最近一次 hls.startLoad 目标
 		var hlsLoadTs=0;//最近一次 hls.startLoad 时间戳
 		var oldTime=0,playTime=0,firstSeekTime=-1,maxSeeTime=0;//oldTime=记录上次播放时间，playTime=当前播放时间，firstSeekTime=记录第一次拖动的时间,maxSeeTime=看过的最大时间
@@ -444,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.0')>-1){
+			if(!allowCdn || !cdn || cdn.indexOf('1.1.2')>-1){
 				// 避免占位版本或显式关闭 CDN 时请求坏地址；交给相对路径或业务 pluginPath
 				return folder+'/'+file;
 			}
@@ -589,8 +591,10 @@
 				player.volume(0);
 				player.muted();
 				recoveryVolume=true;
-				video.attr('autoplay','autoplay');
-				paused=false;
+				// 不使用原生 autoplay 属性：浏览器会在 seek 前开始 play，随后
+				// currentTime / pause 等初始化动作会打断其 Promise，导致永久 loading。
+				video.attr('preload','auto');
+				autoplayPending=true;
 			}
 			else{
 				video.attr('preload','metadata');
@@ -810,6 +814,7 @@
 			seekApplyLock=false;
 			hlsStartPositionUsed=false;
 			hlsResumeTarget=-1;
+			hlsResumeWarmup=false;
 			hlsLoadAt=-1;
 			hlsLoadTs=0;
 			decodeRecoverCount=0;
@@ -985,36 +990,57 @@
 					if(!resumeAt){
 						resumeAt=parseResumeSeekFromVars();
 					}
-					// 断点续播：startPosition 必须在 loadSource 前设置，从正确 TS 分片起播
+					// HLS 续播：不要用精确秒数做 startPosition（易在分片中部起播导致解码失败/永久 loading）。
+					// 对齐目标分片起点加载，等分片从起点缓冲到目标后再一次 currentTime，并强制 play。
 					if(resumeAt && resumeAt>0 && (isUndefined(vars['live']) || !vars['live'])){
-						hlsConf.startPosition=resumeAt;
 						maxSeeTime=Math.max(maxSeeTime,resumeAt);
 						if(firstSeekTime<0){
 							firstSeekTime=resumeAt;
 						}
+						seekTime=resumeAt;
 						hlsResumeTarget=resumeAt;
-						hlsLoadAt=resumeAt;
-						hlsLoadTs=Date.now();
-						seekTime=0;
-						hlsStartPositionUsed=true;
-						clearSeekRetry();
+						hlsResumeWarmup=true;
 					}
 					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(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){
 							applyPendingSeek();
 						}
 					});
 					hls.on(Hls.Events.FRAG_BUFFERED, function(event, data){
+						if(hlsResumeWarmup && seekTime>0){
+							if(hlsCanSafelySeekTo(seekTime)){
+								finishResumeSeek(seekTime);
+							}
+							return;
+						}
 						if(hlsResumeTarget<=0 || !data || !data.frag){
 							return;
 						}
 						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']){
@@ -1814,6 +1840,109 @@
 			}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
+		 * 功能：目标分片已从分片起点连续缓冲到目标点，才允许 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;
+				for(var i=0;i<buf.length;i++){
+					var start=buf.start(i);
+					var end=buf.end(i);
+					if(fragStart>=start-0.35 && t<=end+0.15){
+						return true;
+					}
+				}
+			}catch(event){}
+			return false;
+		},
+		/*
+		 * finishResumeSeek
+		 * 功能：完成续播定位并恢复播放（清除 loading 卡住）
+		*/
+		finishResumeSeek=function(t){
+			hlsResumeWarmup=false;
+			applySeekToMedia(t);
+			// seeked 可能因解码抖动延迟；主动再拉一次播放，避免永久转圈
+			setTimeout(function(){
+				if(!video){return;}
+				if(C['buffer']){
+					C['buffer'].hide();
+				}
+				waited=true;
+				if(vars['autoplay'] || autoplayPending){
+					try{
+						var p=video.play();
+						if(p && typeof p.then==='function'){
+							p.catch(function(){});
+						}
+					}catch(event){}
+					autoplayPending=false;
+				}
+			},120);
+		},
 		/*
 		 * clearSeekRetry
 		 * 功能：清理续播等待计时器
@@ -1825,6 +1954,35 @@
 			}
 			seekRetryCount=0;
 		},
+		/*
+		 * startPendingAutoplay
+		 * 功能：续播定位完成后统一发起一次播放，避免 play/pause 竞态
+		 */
+		startPendingAutoplay=function(){
+			if(!autoplayPending || !video || !vars['autoplay'] || seekTime || seekApplyLock || loadedmetadataNum<1){
+				return;
+			}
+			autoplayPending=false;
+			player.play();
+		},
+		/*
+		 * applySeekToMedia
+		 * 功能：仅对已建立解码管线的 media 元素写入 currentTime
+		 */
+		applySeekToMedia=function(t){
+			clearSeekRetry();
+			seekApplyLock=true;
+			seekTime=0;
+			try{
+				video.currentTime=t;
+			}catch(event){
+				seekTime=t;
+				seekApplyLock=false;
+			}
+			setTimeout(function(){
+				seekApplyLock=false;
+			},800);
+		},
 		/*
 		 * applyPendingSeek
 		 * 功能：在媒体就绪且目标时间可解码后再应用挂起的 seekTime
@@ -1853,15 +2011,41 @@
 					firstSeekTime=t;
 				}
 			}
-			// HLS：用 hls.startLoad 从目标分片加载（去重，避免取消进行中的 .ts）
-			if(hlsSeekTo(t, !!force)){
-				clearSeekRetry();
-				seekTime=0;
+			// HLS 首分片尚未完成预热时不能直接 startLoad(target)
+			if(hlsResumeWarmup){
+				if(hlsCanSafelySeekTo(t)){
+					finishResumeSeek(t);
+				}
 				return;
 			}
-			var readyEnough=!isUndefined(video.readyState) && video.readyState>=2;
-			var bufferedOk=timeInBuffered(t);
-			if(!force && !bufferedOk && (!readyEnough || video.readyState<3)){
+			// HLS：用 hls.startLoad 从目标分片起点加载（去重，避免取消进行中的 .ts）
+			if(hls && typeof hls.startLoad==='function'){
+				if(!hlsCanSafelySeekTo(t) && t>1){
+					hlsResumeWarmup=true;
+					hlsResumeTarget=t;
+					try{
+						hls.startLoad(hlsPriorLoadTime(t));
+					}catch(event){}
+					seekRetryCount++;
+					if(seekRetryCount<=50){
+						if(seekRetryTimer){
+							clearTimeout(seekRetryTimer);
+						}
+						seekRetryTimer=setTimeout(function(){
+							applyPendingSeek(false);
+						},200);
+					}
+					return;
+				}
+				if(hlsSeekTo(t, !!force)){
+					clearSeekRetry();
+					seekTime=0;
+					return;
+				}
+			}
+			// 对普通 MP4，metadata 后设置 currentTime 会由浏览器自动请求目标 Range。
+			// 等待目标已缓冲会形成循环等待：目标分片只有 seek 后才会下载。
+			if(!force && (!isUndefined(video.readyState) && video.readyState<1)){
 				seekRetryCount++;
 				if(seekRetryCount<=50){
 					if(seekRetryTimer){
@@ -1873,58 +2057,60 @@
 					return;
 				}
 			}
-			clearSeekRetry();
-			seekApplyLock=true;
-			seekTime=0;
-			try{
-				video.currentTime=t;
-			}catch(event){
-				seekTime=t;
-				seekApplyLock=false;
-			}
-			setTimeout(function(){
-				seekApplyLock=false;
-			},800);
+			applySeekToMedia(t);
 		},
 		/*
 		 * recoverDecodeError
 		 * 功能：断点续播触发的解码错误尝试恢复（Chrome PIPELINE_ERROR_DECODE）
+		 * 典型场景：目标 TS 分片首帧不是关键帧，必须回退加载前序分片再建解码管线
 		*/
 		recoverDecodeError=function(){
-			if(decodeRecoverCount>=2){
+			if(decodeRecoverCount>=3){
 				return false;
 			}
 			decodeRecoverCount++;
-			var resumeAt=playTime>0?playTime:(vars['seek']?parseFloat(vars['seek']):0);
+			var resumeAt=hlsResumeTarget>0?hlsResumeTarget:(playTime>0?playTime:(vars['seek']?parseFloat(vars['seek']):0));
 			if(isNaN(resumeAt) || resumeAt<0){
 				resumeAt=0;
 			}
+			// 优先对齐分片起点（有 IDR）；多次失败再往前一片
+			var loadFrom=hlsPriorLoadTime(resumeAt);
+			if(decodeRecoverCount>=2){
+				loadFrom=Math.max(0,loadFrom-10);
+			}
+			seekApplyLock=false;
+			clearSeekRetry();
 			try{
 				if(hls && typeof hls.recoverMediaError==='function'){
 					hls.recoverMediaError();
-					if(resumeAt>0){
-						seekTime=resumeAt;
-						seekApplyLock=false;
-						setTimeout(function(){
-							applyPendingSeek(true);
-						},300);
-					}
-					return true;
 				}
 			}catch(event){}
-			try{
-				var soft=Math.max(0,resumeAt-1.5);
-				seekTime=resumeAt;
-				seekApplyLock=false;
-				if(video){
-					video.currentTime=soft;
-				}
+			if(resumeAt>0 && hls && typeof hls.startLoad==='function'){
+				// 第 3 次直接落到分片起点起播，保证能出画面
+				var target=(decodeRecoverCount>=3)?loadFrom:resumeAt;
+				seekTime=target;
+				hlsResumeTarget=resumeAt;
+				hlsResumeWarmup=true;
+				hlsLoadAt=-1;
+				hlsLoadTs=0;
+				try{
+					hls.startLoad(loadFrom);
+				}catch(event){}
 				setTimeout(function(){
-					applyPendingSeek(true);
-					if(video && video.paused && vars['autoplay']){
-						try{video.play();}catch(e2){}
+					if(hlsCanSafelySeekTo(target)){
+						finishResumeSeek(target);
+					}
+					else if(decodeRecoverCount>=2){
+						finishResumeSeek(loadFrom);
 					}
-				},400);
+					else{
+						applyPendingSeek(false);
+					}
+				},600);
+				return true;
+			}
+			try{
+				finishResumeSeek(Math.max(0,resumeAt-1.5));
 				return true;
 			}catch(event){}
 			return false;
@@ -1981,6 +2167,7 @@
 				C['loading'].hide();
 				eventTarget('canplay');
 				applyPendingSeek();
+				startPendingAutoplay();
 			},
 			loadedData:function(){
 				eventTarget('loadeddata');
@@ -2036,6 +2223,7 @@
 				}
 				pSliderMouseDown=false;
 				loadedmetadataNum++;
+				startPendingAutoplay();
 				if(!isUndefined(ad) && !isUndefined(ad['frontPlay']) && ad['frontPlay'] && loadedmetadataNum>1){//如果是贴片广告播放中，则进行播放和计算
 					player.play();
 					calculationAdFrontTime(duration);//计算贴片广告的时间
@@ -2119,10 +2307,8 @@
 							if(!isUndefined(errorInfo.message)){
 								msg=errorInfo.message;
 							}
-							// code=3 MEDIA_ERR_DECODE：续播非关键帧常见，先尝试恢复
+							// code=3 MEDIA_ERR_DECODE：续播非关键帧常见，先尝试恢复；恢复中不向业务抛致命 error
 							if(code===3 && recoverDecodeError()){
-								CT.error={code:code,message:msg};
-								eventTarget('error',CT.error);
 								return;
 							}
 							CT.error={code:code,message:msg};
@@ -2166,8 +2352,8 @@
 			},
 			stalled:function(){
 				eventTarget('stalled');//注册监听error
-				CT.error={code:13,message:'load:stalled'};
-				eventTarget('error',CT.error);//注册监听error
+				// HLS 在切片预热、切换清晰度时会短暂触发 stalled，属于可恢复缓冲。
+				// 不把它上报为致命 error，避免业务侧误判已失败而覆盖正常播放状态。
 			},
 			suspend:function(){
 				eventTarget('suspend');//注册监听error
@@ -2180,15 +2366,14 @@
 			seeked:function(){
 				seekApplyLock=false;
 				decodeRecoverCount=0;
-				if(paused){
-					player.play();
-				}
+				startPendingAutoplay();
 				pSliderMouseDown=false;
 				eventTarget('seek',{time:this.currentTime,state:'seeked'});
 				eventTarget('seeked');
 			},
 			seeking:function(){
-				if(paused){
+				// 续播预热/定位过程中不要抢先 play，否则会打断 play Promise 导致永久 loading
+				if(paused && !seekApplyLock && !hlsResumeWarmup && !seekTime){
 					player.play();
 				}
 				var seekingTime=this.currentTime;
@@ -3054,7 +3239,14 @@
 				}
 				else{
 					if(loadedmetadataNum>0 && video){
-						try{video.play();}catch(event){console.error(event)}
+						try{
+							var playPromise=video.play();
+							// play() 返回 Promise 时必须消费 rejection，避免 autoplay 策略或
+							// 页面卸载造成未捕获异常；播放状态仍由原生事件同步。
+							if(playPromise && typeof playPromise.catch==='function'){
+								playPromise.catch(function(){});
+							}
+						}catch(event){}
 					}
 				}
 				return player;
@@ -3242,6 +3434,17 @@
 								applyPendingSeek(false);
 								return player;
 							}
+							// HLS：无前序关键帧缓冲时禁止直接 startLoad(target)
+							if(hls && target>1 && !hlsCanSafelySeekTo(target)){
+								seekTime=target;
+								hlsResumeWarmup=true;
+								hlsResumeTarget=target;
+								try{
+									hls.startLoad(hlsPriorLoadTime(target));
+								}catch(event){}
+								applyPendingSeek(false);
+								return player;
+							}
 							if(hlsSeekTo(target, false)){
 								seekTime=0;
 								return player;
@@ -7061,7 +7264,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.0')===-1 && m){
+					if(cdn && cdn.indexOf('1.1.2')===-1 && m){
 						if(cdn.slice(-1)!=='/'){
 							cdn+='/';
 						}
@@ -7984,4 +8187,4 @@
 		}
 	}
 	return ckplayerEmbed;
-}));
+}));