ckplayer-plus 1.0.5 → 1.0.6

package/README.md

@@ -77,7 +77,7 @@ React：
 | `preferBuiltinPlug` | `true` | 优先加载本包内置脚本，避免复用页面上其它全局 `Hls` |
 | `cdnFallback` | `true` | `getPath` 失败时回退 jsDelivr；内网无外网请设 `false` 并配 `pluginPath` |
 | `pluginPath` | 自动 | 插件脚本根路径。默认：`window.ckplayerBasePath` → 本包 `dist/` → jsDelivr CDN |
-| `seek` | `0` | 续播秒数（number 或数字字符串）；会同步 `maxSeeTime`，兼容 `timeScheduleAdjust: 5` |
+| `seek` | `0` | 续播秒数（number 或数字字符串）；会同步 `maxSeeTime`。HLS 优先用 `startPosition`，并等待缓冲后再跳，降低非关键帧解码失败 |
 | `loaded` | — | **只支持函数**；字符串形式已禁用（防 XSS） |
 
 ### 进阶（按需）

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.0.5/dist/';
+	var ckplayerPlusDefaultCdn='https://cdn.jsdelivr.net/npm/ckplayer-plus@1.0.6/dist/';
 	function ckplayerEmbed(videoObj){
 		/*
 		 * rightMenu
@@ -171,6 +171,11 @@
 		var paused=true;//默认暂停状态
 		var loadTime=0;//已加载部分
 		var seekTime=0;//需要跳转的时间，初次播放以及切换清晰度后会用该变量记录需要seek的时间
+		var seekRetryTimer=null;//续播等待缓冲的重试计时器
+		var seekRetryCount=0;//续播重试次数
+		var seekApplyLock=false;//防止并发多次 currentTime 赋值
+		var decodeRecoverCount=0;//MEDIA_ERR_DECODE 恢复次数
+		var hlsStartPositionUsed=false;//是否已用 hls.js startPosition 处理续播
 		var oldTime=0,playTime=0,firstSeekTime=-1,maxSeeTime=0;//oldTime=记录上次播放时间，playTime=当前播放时间，firstSeekTime=记录第一次拖动的时间,maxSeeTime=看过的最大时间
 		var isChangeDef=true;//是否需要重置清晰度
 		var playType='';//播放类别，默认=''，是通过api接口播放，='button'则判定是通过点击按钮播放
@@ -409,7 +414,7 @@
 			}
 			var allowCdn=!vars || vars['cdnFallback']!==false;
 			var cdn=(typeof window!=='undefined' && window.ckplayerPlusCdn) ? window.ckplayerPlusCdn : ckplayerPlusDefaultCdn;
-			if(!allowCdn || !cdn || cdn.indexOf('1.0.5')>-1){
+			if(!allowCdn || !cdn || cdn.indexOf('1.0.6')>-1){
 				// 避免占位版本或显式关闭 CDN 时请求坏地址；交给相对路径或业务 pluginPath
 				return folder+'/'+file;
 			}
@@ -842,11 +847,25 @@
 		hlsPlayer=function (url){
 			var startHls=function(){
 				if (typeof Hls!=='undefined' && !isUndefined(Hls) && Hls.isSupported()) {
-					hls = new Hls();
+					var hlsConf={};
+					// 断点续播：优先用 startPosition，让 hls 从正确分片/关键帧起播，避免裸 currentTime 解码失败
+					if(seekTime && seekTime>0 && (isUndefined(vars['live']) || !vars['live'])){
+						hlsConf.startPosition=seekTime;
+						maxSeeTime=Math.max(maxSeeTime,seekTime);
+						if(firstSeekTime<0){
+							firstSeekTime=seekTime;
+						}
+						seekTime=0;
+						hlsStartPositionUsed=true;
+						clearSeekRetry();
+					}
+					hls = new Hls(hlsConf);
 					hls.loadSource(url);
 					hls.attachMedia(video);
 					hls.on(Hls.Events.MANIFEST_PARSED, function(){
-						applyPendingSeek();
+						if(!hlsStartPositionUsed){
+							applyPendingSeek();
+						}
 					});
 					hls.on(Hls.Events.ERROR, function(event, data){
 						var code=9;
@@ -865,6 +884,13 @@
 								}
 							}
 						}
+						// 媒体解码类错误先尝试恢复，避免续播直接黑屏
+						if(fatal && data.type===Hls.ErrorTypes.MEDIA_ERROR && hls && typeof hls.recoverMediaError==='function'){
+							try{
+								hls.recoverMediaError();
+								fatal=false;
+							}catch(errRecover){}
+						}
 						CT.error={code:code,message:message};
 						eventTarget('error',CT.error);//注册监听error
 						if(fatal){
@@ -1614,12 +1640,42 @@
 				}
 			}
 		},
+		/*
+		 * timeInBuffered
+		 * 功能：判断目标时间是否已在 buffered 区间内（续播前避免跳到未缓冲的非关键帧）
+		*/
+		timeInBuffered=function(t){
+			if(!video || isUndefined(video.buffered)){
+				return false;
+			}
+			try{
+				var buf=video.buffered;
+				for(var i=0;i<buf.length;i++){
+					if(t>=buf.start(i)-0.35 && t<=buf.end(i)+0.15){
+						return true;
+					}
+				}
+			}catch(event){}
+			return false;
+		},
+		/*
+		 * clearSeekRetry
+		 * 功能：清理续播等待计时器
+		*/
+		clearSeekRetry=function(){
+			if(seekRetryTimer){
+				clearTimeout(seekRetryTimer);
+				seekRetryTimer=null;
+			}
+			seekRetryCount=0;
+		},
 		/*
 		 * applyPendingSeek
-		 * 功能：在媒体就绪后应用挂起的 seekTime
+		 * 功能：在媒体就绪且目标时间可解码后再应用挂起的 seekTime
+		 * 避免断点续播过早 seek 触发 PIPELINE_ERROR_DECODE（非关键帧）
 		*/
-		applyPendingSeek=function(){
-			if(!seekTime || !video){
+		applyPendingSeek=function(force){
+			if(!seekTime || !video || seekApplyLock){
 				return;
 			}
 			if(!isUndefined(vars['live']) && ((valType(vars['live'])=='boolean' && vars['live']) || valType(vars['live'])=='number')){
@@ -1630,19 +1686,93 @@
 			if(dur && isFinite(dur) && dur>0 && t>=dur){
 				t=Math.max(0,dur-0.3);
 			}
-			// 续播水位同步（mode=5 依赖 maxSeeTime）
+			if(t<=0){
+				seekTime=0;
+				clearSeekRetry();
+				return;
+			}
+			var readyEnough=!isUndefined(video.readyState) && video.readyState>=2;
+			var bufferedOk=timeInBuffered(t);
+			// 未进入可播缓冲时先等待，并引导 hls 加载目标位置
+			if(!force && !bufferedOk && (!readyEnough || video.readyState<3)){
+				seekRetryCount++;
+				if(seekRetryCount<=50){
+					try{
+						if(hls && typeof hls.startLoad==='function'){
+							hls.startLoad(t);
+						}
+					}catch(event){}
+					if(seekRetryTimer){
+						clearTimeout(seekRetryTimer);
+					}
+					seekRetryTimer=setTimeout(function(){
+						applyPendingSeek(false);
+					},200);
+					return;
+				}
+			}
+			clearSeekRetry();
 			if(t>0){
 				maxSeeTime=Math.max(maxSeeTime,t);
 				if(firstSeekTime<0){
 					firstSeekTime=t;
 				}
 			}
+			seekApplyLock=true;
 			seekTime=0;
 			try{
 				video.currentTime=t;
 			}catch(event){
 				seekTime=t;
+				seekApplyLock=false;
+			}
+			// seeked / 短暂延时后解锁，允许后续切换清晰度再 seek
+			setTimeout(function(){
+				seekApplyLock=false;
+			},800);
+		},
+		/*
+		 * recoverDecodeError
+		 * 功能：断点续播触发的解码错误尝试恢复（Chrome PIPELINE_ERROR_DECODE）
+		*/
+		recoverDecodeError=function(){
+			if(decodeRecoverCount>=2){
+				return false;
+			}
+			decodeRecoverCount++;
+			var resumeAt=playTime>0?playTime:(vars['seek']?parseFloat(vars['seek']):0);
+			if(isNaN(resumeAt) || resumeAt<0){
+				resumeAt=0;
 			}
+			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;
+				}
+				setTimeout(function(){
+					applyPendingSeek(true);
+					if(video && video.paused && vars['autoplay']){
+						try{video.play();}catch(e2){}
+					}
+				},400);
+				return true;
+			}catch(event){}
+			return false;
 		},
 		/*
 		 * loadedMetaData
@@ -1834,6 +1964,12 @@
 							if(!isUndefined(errorInfo.message)){
 								msg=errorInfo.message;
 							}
+							// code=3 MEDIA_ERR_DECODE：续播非关键帧常见，先尝试恢复
+							if(code===3 && recoverDecodeError()){
+								CT.error={code:code,message:msg};
+								eventTarget('error',CT.error);
+								return;
+							}
 							CT.error={code:code,message:msg};
 							showError();
 						}
@@ -1887,6 +2023,8 @@
 				eventTarget('error',CT.error);//注册监听error
 			},
 			seeked:function(){
+				seekApplyLock=false;
+				decodeRecoverCount=0;
 				if(paused){
 					player.play();
 				}
@@ -2920,7 +3058,7 @@
 									break;
 							}
 							pSliderMouseDown=false;
-							// 媒体未就绪时先记录，待 canplay/时长就绪后再应用
+							// 媒体未就绪时只记录目标，禁止抢先 currentTime（会触发非关键帧解码失败）
 							var ready=video.readyState>=2 || (duration && isFinite(duration) && duration>0);
 							if(!ready){
 								seekTime=target;
@@ -2930,7 +3068,6 @@
 										firstSeekTime=target;
 									}
 								}
-								try{video.currentTime=target;}catch(event){}
 								return player;
 							}
 							if(duration && isFinite(duration) && duration>0 && target>duration){
@@ -2943,6 +3080,12 @@
 							if(vars['timeScheduleAdjust']==5 && target>maxSeeTime && seekTime && Math.abs(seekTime-target)<0.5){
 								maxSeeTime=Math.max(maxSeeTime,target);
 							}
+							// 目标尚未进入缓冲时改为挂起，由 applyPendingSeek 等待后再跳
+							if(target>0.5 && !timeInBuffered(target) && video.readyState<3){
+								seekTime=target;
+								applyPendingSeek(false);
+								return player;
+							}
 							try{
 								video.currentTime=target;
 								seekTime=0;
@@ -6758,7 +6901,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.0.5')===-1 && m){
+					if(cdn && cdn.indexOf('1.0.6')===-1 && m){
 						if(cdn.slice(-1)!=='/'){
 							cdn+='/';
 						}