ckplayer-plus 1.0.3 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # ckplayer-plus
 
-基于 [ckplayer](https://www.ckplayer.com) X3 的工程化封装：支持 **npm / ESM**，并提供 **Vue 2/3** 与 **React** 组件。
+基于 [ckplayer](https://www.ckplayer.com) X3 的工程化封装：支持 **npm / ESM**，并提供 **Vue 2.7+/3** 与 **React** 组件。
 
 > **免责声明**：本包为社区/工程化封装，**非 ckplayer 官方包**。播放内核来自 ckplayer（MIT）。完整能力与参数请同时参考 [官方手册](https://www.ckplayer.com/manual/)。npm 上的官方包名为 [`ckplayer`](https://www.npmjs.com/package/ckplayer)，请勿混淆。
 
@@ -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） |
 
 ### 进阶（按需）
@@ -95,14 +95,16 @@ React：
 ### 插件加载优先级
 
 1. `preferBuiltinPlug: false` 且页面已有全局 `Hls` / `flvjs` / `mpegts` → 直接复用  
-2. 否则加载本包脚本：`pluginPath` 或 `window.ckplayerBasePath`  
+2. 否则加载本包脚本：`pluginPath` 或可信的 `window.ckplayerBasePath`（仅 dist / npm 包路径会自动设置；Vite/Webpack chunk 目录会忽略）  
 3. 传统 `<script src=".../ckplayer.min.js">` 同级目录推导  
-4. `cdnFallback !== false` 时回退：`https://cdn.jsdelivr.net/npm/ckplayer-plus@x.y.z/dist/`  
+4. `cdnFallback !== false` 时回退：`https://cdn.jsdelivr.net/npm/ckplayer-plus@x.y.z/dist/`；若本地路径 404 会再自动重试一次 CDN  
 
 > 内网离线：把 `node_modules/ckplayer-plus/dist/` 里的 `hls.js/` 等目录放到可访问静态路径，并设置 `pluginPath` 或 `window.ckplayerBasePath`，建议同时 `cdnFallback: false`。  
 > 样式请使用 `import 'ckplayer-plus/style.css'`，保证 `./images/` 图标能被打包工具解析。
 
-## Vue 2 / Vue 3
+## Vue 2.7 / Vue 3
+
+支持 **Vue 2.7+** 与 **Vue 3**（需从 `vue` 解析 `h`，与 peerDependencies 一致）。
 
 ```vue
 <template>
@@ -170,9 +172,3 @@ npm publish --access public
 ## License
 
 MIT。内置的 hls.js / flv.js / mpegts.js 遵循各自许可证（多为 Apache-2.0）。
-
-## 相关链接
-
-- 官网：https://www.ckplayer.com  
-- 手册：https://www.ckplayer.com/manual/  
-- 官方 npm：https://www.npmjs.com/package/ckplayer  

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.3/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'则判定是通过点击按钮播放
@@ -371,6 +376,16 @@
 				return embed(obj);
 			}
 		},
+		/*
+		 * isUnreliablePluginBase
+		 * 功能：识别 bundler chunk 目录（不含 hls.js 等插件），避免短路 CDN 回退
+		*/
+		isUnreliablePluginBase=function(base){
+			if(!base || valType(base)!='string'){
+				return true;
+			}
+			return /\/(?:assets|\.vite\/deps|_next\/static|chunks?)\/?$/i.test(base);
+		},
 		/*
 		 * resolveAssetPath
 		 * 功能：解析插件/语言包路径
@@ -384,6 +399,9 @@
 			else if(typeof window!=='undefined' && window.ckplayerBasePath){
 				base=window.ckplayerBasePath;
 			}
+			if(base && isUnreliablePluginBase(base)){
+				base='';
+			}
 			if(base){
 				if(base.slice(-1)!=='/'){
 					base+='/';
@@ -391,12 +409,12 @@
 				return base+folder+'/'+file;
 			}
 			var fromScript=getPath(folder)+file;
-			if(fromScript && fromScript.indexOf(folder+'/')>-1 && fromScript.indexOf('undefined')===-1){
+			if(fromScript && fromScript.indexOf(folder+'/')>-1 && fromScript.indexOf('undefined')===-1 && !isUnreliablePluginBase(getPath())){
 				return fromScript;
 			}
 			var allowCdn=!vars || vars['cdnFallback']!==false;
 			var cdn=(typeof window!=='undefined' && window.ckplayerPlusCdn) ? window.ckplayerPlusCdn : ckplayerPlusDefaultCdn;
-			if(!allowCdn || !cdn || cdn.indexOf('1.0.3')>-1){
+			if(!allowCdn || !cdn || cdn.indexOf('1.0.6')>-1){
 				// 避免占位版本或显式关闭 CDN 时请求坏地址；交给相对路径或业务 pluginPath
 				return folder+'/'+file;
 			}
@@ -829,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;
@@ -852,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){
@@ -1601,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')){
@@ -1617,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
@@ -1821,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();
 						}
@@ -1874,6 +2023,8 @@
 				eventTarget('error',CT.error);//注册监听error
 			},
 			seeked:function(){
+				seekApplyLock=false;
+				decodeRecoverCount=0;
 				if(paused){
 					player.play();
 				}
@@ -2907,7 +3058,7 @@
 									break;
 							}
 							pSliderMouseDown=false;
-							// 媒体未就绪时先记录，待 canplay/时长就绪后再应用
+							// 媒体未就绪时只记录目标，禁止抢先 currentTime（会触发非关键帧解码失败）
 							var ready=video.readyState>=2 || (duration && isFinite(duration) && duration>0);
 							if(!ready){
 								seekTime=target;
@@ -2917,7 +3068,6 @@
 										firstSeekTime=target;
 									}
 								}
-								try{video.currentTime=target;}catch(event){}
 								return player;
 							}
 							if(duration && isFinite(duration) && duration>0 && target>duration){
@@ -2930,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;
@@ -6693,7 +6849,7 @@
 		 * @file：js文件地址
 		 * @callback：加载完成后执行的函数
 		*/
-		loadJs=function(file, callback) {
+		loadJs=function(file, callback, isRetry) {
 			var fn =function() {};
 			if(!isUndefined(callback)){
 				fn=callback;
@@ -6725,19 +6881,38 @@
 					} catch(event) {};
 				}, 10);
 			};
+			var removeScript = function() {
+				try {
+					if(script.parentNode){
+						script.parentNode.removeChild(script);
+					}
+				} catch(event) {}
+			};
 			var w3c = function() {
-				if(valType(fn) == 'function') {
-					fn();
-				}
 				removeListener(script, 'load', w3c);
 				removeListener(script, 'error', w3cError);
+				doReady();
 			};
 			var w3cError = function() {
-				if(valType(fn) == 'function') {
-					fn();
-				}
 				removeListener(script, 'load', w3c);
 				removeListener(script, 'error', w3cError);
+				removeScript();
+				// bundler 下错误 base 路径 404 时，回退 jsDelivr 再试一次
+				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.6')===-1 && m){
+						if(cdn.slice(-1)!=='/'){
+							cdn+='/';
+						}
+						var retryUrl=cdn+m[1]+'/'+m[2];
+						if(retryUrl!==file){
+							loadJs(retryUrl, callback, true);
+							return;
+						}
+					}
+				}
+				// 加载失败不再假装成功，避免在 Hls/flvjs 未定义时继续执行
 			};
 			try {
 				addListener(script, 'load', w3c);
@@ -7021,13 +7196,19 @@
 	function getPath(siz) {
 		if (typeof window !== 'undefined' && window.ckplayerBasePath) {
 			var base = window.ckplayerBasePath;
-			if (base.slice(-1) !== '/') {
-				base += '/';
+			// bundler chunk 目录不含插件文件，忽略并继续 script/CDN 推导
+			if (/\/(?:assets|\.vite\/deps|_next\/static|chunks?)\/?$/i.test(base)) {
+				base = '';
 			}
-			if (!isUndefined(siz)) {
-				return base + siz + '/';
+			if (base) {
+				if (base.slice(-1) !== '/') {
+					base += '/';
+				}
+				if (!isUndefined(siz)) {
+					return base + siz + '/';
+				}
+				return base;
 			}
-			return base;
 		}
 		var scriptList = document.scripts || [],
 			thisPath = scriptList.length ? scriptList[scriptList.length - 1].src : '';