ckplayer-plus 1.1.11 → 1.1.12

package/README.md

@@ -75,8 +75,8 @@ React：
 | `autoPlug` | `true` | 按地址自动选插件；通常保持默认即可 |
 | `plug` | 自动 | 仅在要强制指定或 `autoPlug: false` 时填写：`hls.js` / `flv.js` / `mpegts.js` |
 | `preferBuiltinPlug` | `true` | 优先加载本包内置脚本，避免复用页面上其它全局 `Hls` |
-| `cdnFallback` | `true` | `getPath` 失败时回退 jsDelivr；内网无外网请设 `false` 并配 `pluginPath` |
-| `pluginPath` | 自动 | 插件脚本根路径。默认：`window.ckplayerBasePath` → 可信 script/`dist` → jsDelivr CDN。**Vue/React + Vite 一般不用配**，勿设成 `/src/` |
+| `cdnFallback` | `true` | `getPath` 失败时回退 jsDelivr；内网无外网请设 `false` 并配 `pluginPath`（或确保能访问 `/node_modules/ckplayer-plus/dist/`） |
+| `pluginPath` | 自动 | 插件脚本根路径。默认：`window.ckplayerBasePath` → 可信 script/`dist` → jsDelivr CDN → `/node_modules/ckplayer-plus/dist/`。**勿设成 `/src/`**；也勿依赖当前页相对路径 |
 | `seek` | `0` | 续播秒数。HLS 对齐分片起点缓冲后再定位；**只 seek 不自动 play**，避免 Network 出现 canceled `.ts` |
 | `loaded` | — | **只支持函数**；字符串形式已禁用（防 XSS） |
 
@@ -98,9 +98,10 @@ React：
 2. 否则加载本包脚本：`pluginPath` 或可信的 `window.ckplayerBasePath`（仅 dist / npm 包路径会自动设置；`/src`、`assets`、`.vite/deps`、chunk 目录会忽略）  
 3. 传统 `<script src=".../ckplayer.min.js">` 同级目录推导（**不会**再用页面最后一个无关 script，避免 Vite 指到 `/src/main.js`）  
 4. `cdnFallback !== false` 时回退：`https://cdn.jsdelivr.net/npm/ckplayer-plus@x.y.z/dist/`；若本地路径 404 会再自动重试一次 CDN  
+5. 仍无可靠根时：站点根相对 `/node_modules/ckplayer-plus/dist/`（Vite 开发态常用；**不是**当前路由目录下的相对路径）
 
-> **Vue 2.7 / Vue 3 / React（Vite/Webpack）**：直接 `import { CkPlayer } from 'ckplayer-plus/vue'`（或 `/react`）即可，hls/flv 会走 CDN 或你配置的 `pluginPath`。不要把 `pluginPath` 设成业务的 `/src/`。  
-> 内网离线：把 `node_modules/ckplayer-plus/dist/` 里的 `hls.js/` 等目录拷到可访问静态路径（也可用 `public/ckplayer-plus/`），并设置 `pluginPath` 或 `window.ckplayerBasePath`，建议同时 `cdnFallback: false`。  
+> **Vue 2.7 / Vue 3 / React（Vite/Webpack）**：直接 `import { CkPlayer } from 'ckplayer-plus/vue'`（或 `/react`）即可。默认会走 jsDelivr CDN；内网请把 `dist/hls.js` 等拷到静态目录并设 `pluginPath`，同时 `cdnFallback: false`。  
+> **不要**指望 `hls.js/hls.min.js` 这种相对路径——在 `/student/course` 一类 SPA 路由下会错误请求 `/student/hls.js/...`。  
 > 本地调试本仓库 demo：先 `npm run build`，再用静态服务打开 `examples/demo.html`（`dist/` 被 gitignore，不重建会跑到旧逻辑）。  
 > 样式请使用 `import 'ckplayer-plus/style.css'`，保证 `./images/` 图标能被打包工具解析。
 

package/dist/ckplayer.js

@@ -141,7 +141,9 @@
 		cdnFallback:true// getPath 失败时是否回退到 jsDelivr（内网可设 false，并配置 pluginPath）
 	};
 	// 打包时替换为真实版本；用于 bundler 下 getPath 失效时的 CDN 回退
-	var ckplayerPlusDefaultCdn='https://cdn.jsdelivr.net/npm/ckplayer-plus@1.1.11/dist/';
+	var ckplayerPlusDefaultCdn='https://cdn.jsdelivr.net/npm/ckplayer-plus@1.1.12/dist/';
+	// 构建脚本会把下一行改为 true；勿用版本号字符串做 CDN 可用性判断（默认 CDN URL 本身含版本）
+	var ckplayerPlusCdnReady=true; // BUILD_CDN_READY
 	function ckplayerEmbed(videoObj){
 		/*
 		 * rightMenu
@@ -414,9 +416,11 @@
 		/*
 		 * resolveAssetPath
 		 * 功能：解析插件/语言包路径
-		 * 优先级：pluginPath > window.ckplayerBasePath > script 推导 > 本包 CDN
+		 * 优先级：pluginPath > window.ckplayerBasePath > script 推导 > 本包 CDN > /node_modules/.../dist/
+		 * 禁止返回「hls.js/xxx」这类文档相对路径（会在 SPA 子路由下变成 /student/hls.js/... 404）
 		*/
 		resolveAssetPath=function (folder,file){
+			var asset=folder+'/'+file;
 			var base='';
 			if(vars && vars['pluginPath']){
 				base=vars['pluginPath'];
@@ -431,7 +435,7 @@
 				if(base.slice(-1)!=='/'){
 					base+='/';
 				}
-				return base+folder+'/'+file;
+				return base+asset;
 			}
 			var scriptBase=getPath();
 			var fromScript=scriptBase ? (getPath(folder)+file) : '';
@@ -440,14 +444,22 @@
 			}
 			var allowCdn=!vars || vars['cdnFallback']!==false;
 			var cdn=(typeof window!=='undefined' && window.ckplayerPlusCdn) ? window.ckplayerPlusCdn : ckplayerPlusDefaultCdn;
-			if(!allowCdn || !cdn || cdn.indexOf('1.1.11')>-1){
-				// 避免占位版本或显式关闭 CDN 时请求坏地址；交给相对路径或业务 pluginPath
-				return folder+'/'+file;
+			// 仅用构建注入的就绪标记；禁止 indexOf(版本号)/indexOf(占位符)（会与 CDN URL 自撞）
+			if(allowCdn && ckplayerPlusCdnReady && cdn){
+				if(cdn.slice(-1)!=='/'){
+					cdn+='/';
+				}
+				return cdn+asset;
+			}
+			// Vite/Webpack 开发态：站点根相对路径，不受 /student/course 等 SPA 路由影响
+			var npmDist=guessNpmDistBase();
+			if(npmDist){
+				return npmDist+asset;
 			}
-			if(cdn.slice(-1)!=='/'){
-				cdn+='/';
+			if(typeof console!=='undefined' && console.warn){
+				console.warn('[ckplayer-plus] cannot resolve plugin path for '+asset+'. Set pluginPath / window.ckplayerBasePath, or keep cdnFallback:true.');
 			}
-			return cdn+folder+'/'+file;
+			return '';
 		},
 		/*
 		 * guessPlug
@@ -7459,6 +7471,12 @@
 			if(!isUndefined(callback)){
 				fn=callback;
 			}
+			if(!file){
+				if(typeof console!=='undefined' && console.warn){
+					console.warn('[ckplayer-plus] loadJs skipped: empty plugin path');
+				}
+				return;
+			}
 			if(checkJs(file)){
 				fn();
 				return;
@@ -7502,11 +7520,11 @@
 				removeListener(script, 'load', w3c);
 				removeListener(script, 'error', w3cError);
 				removeScript();
-				// bundler 下错误 base 路径 404 时，回退 jsDelivr 再试一次（兼容相对路径 hls.js/xxx）
+				// 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.1.11')===-1 && m){
+					if(cdn && ckplayerPlusCdnReady && m){
 						if(cdn.slice(-1)!=='/'){
 							cdn+='/';
 						}
@@ -7801,6 +7819,14 @@
 		}
 		
 	}
+	/*
+	 * guessNpmDistBase
+	 * 功能：Vite/Webpack 开发态下用站点根相对路径访问 npm 包内 dist（含 hls.js/）
+	 * 必须以 / 开头，绝不能用文档相对路径（否则 /student/course 会解析成 /student/hls.js/...）
+	*/
+	function guessNpmDistBase() {
+		return '/node_modules/ckplayer-plus/dist/';
+	}
 	/*
 	 * isUnreliablePluginBase
 	 * 功能：识别不会托管 hls.js/flv.js 的目录，避免 Vite/Webpack 下请求 /src/hls.js 等 404