ckplayer-plus 1.0.2 → 1.0.5

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)，请勿混淆。
 
@@ -74,30 +74,37 @@ React：
 |------|------|------|
 | `autoPlug` | `true` | 按地址自动选插件；通常保持默认即可 |
 | `plug` | 自动 | 仅在要强制指定或 `autoPlug: false` 时填写：`hls.js` / `flv.js` / `mpegts.js` |
+| `preferBuiltinPlug` | `true` | 优先加载本包内置脚本，避免复用页面上其它全局 `Hls` |
+| `cdnFallback` | `true` | `getPath` 失败时回退 jsDelivr；内网无外网请设 `false` 并配 `pluginPath` |
 | `pluginPath` | 自动 | 插件脚本根路径。默认：`window.ckplayerBasePath` → 本包 `dist/` → jsDelivr CDN |
+| `seek` | `0` | 续播秒数（number 或数字字符串）；会同步 `maxSeeTime`，兼容 `timeScheduleAdjust: 5` |
 | `loaded` | — | **只支持函数**；字符串形式已禁用（防 XSS） |
 
 ### 进阶（按需）
 
 | 配置 | 说明 |
 |------|------|
+| `timeScheduleAdjust` | `5` 时只能在已看进度内拖动；续播请同时传数字 `seek` |
 | `crossOrigin` | 跨域视频 / 截图等场景 |
 | `cookie` | 进度记忆；组件默认使用实例唯一名，避免多实例冲突 |
 | `language` | 语言包名，如 `en`、`zh.hk`（需能加载到 `language/*.js`） |
-| `seek` / `loop` / `controls` 等 | 与官方 ckplayer 一致，见[手册](https://www.ckplayer.com/manual/) |
+| `loop` / `controls` 等 | 与官方 ckplayer 一致，见[手册](https://www.ckplayer.com/manual/) |
 | `window.ckplayerBasePath` | 全局指定插件根目录（以 `/` 结尾），优先于 CDN |
 | `window.ckplayerPlusCdn` | 自定义 CDN 根地址（覆盖默认 jsDelivr） |
 
 ### 插件加载优先级
 
-1. 页面上已有全局 `Hls` / `flvjs` / `mpegts` → 直接用，不再请求脚本  
-2. `pluginPath` 或 `window.ckplayerBasePath`  
+1. `preferBuiltinPlug: false` 且页面已有全局 `Hls` / `flvjs` / `mpegts` → 直接复用  
+2. 否则加载本包脚本：`pluginPath` 或可信的 `window.ckplayerBasePath`（仅 dist / npm 包路径会自动设置；Vite/Webpack chunk 目录会忽略）  
 3. 传统 `<script src=".../ckplayer.min.js">` 同级目录推导  
-4. 回退：`https://cdn.jsdelivr.net/npm/ckplayer-plus@x.y.z/dist/`（发布到 npm 后可用）
+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`。
+> 内网离线：把 `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>
@@ -165,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.2/dist/';
+	var ckplayerPlusDefaultCdn='https://cdn.jsdelivr.net/npm/ckplayer-plus@1.0.5/dist/';
 	function ckplayerEmbed(videoObj){
 		/*
 		 * rightMenu
@@ -371,6 +371,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 +394,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 +404,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.2')>-1){
+			if(!allowCdn || !cdn || cdn.indexOf('1.0.5')>-1){
 				// 避免占位版本或显式关闭 CDN 时请求坏地址；交给相对路径或业务 pluginPath
 				return folder+'/'+file;
 			}
@@ -6693,7 +6706,7 @@
 		 * @file：js文件地址
 		 * @callback：加载完成后执行的函数
 		*/
-		loadJs=function(file, callback) {
+		loadJs=function(file, callback, isRetry) {
 			var fn =function() {};
 			if(!isUndefined(callback)){
 				fn=callback;
@@ -6725,19 +6738,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.5')===-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 +7053,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 : '';