@video-lab/player-core 4.0.1 → 4.1.1

package/dist/index.cjs

@@ -120,6 +120,27 @@ function detectEnv(input) {
 		requiresHls: isIOS || isWeChat || isUC || isQuark || !input.hasMediaSource
 	};
 }
+/** flv.js `isSupported()` 用的同一句基线:连它都报不支持,hls.js / flv.js 都不会开始播放 */
+const MSE_BASELINE_TYPE = "video/mp4; codecs=\"avc1.42E01E,mp4a.40.2\"";
+/**
+* 标准 MSE 是否**可用**,而不只是存在(ADR-135)。
+*
+* 小米浏览器(MiuiBrowser 20.28)暴露了 `MediaSource`,但 `isTypeSupported` 对所有
+* H.264/AAC 组合都回 false —— 实际 `addSourceBuffer` 能成功,是它报错了能力。
+* hls.js 信了前者,对声明了 CODECS 的主清单报 `manifestIncompatibleCodecsError`(不可重试)。
+* 按基线判为不可用后,SourceRouter 走原生 HLS,而该浏览器原生 HLS 播放、拖动都正常。
+*
+* 没有 `isTypeSupported` 的实现仍按「存在即可用」,只收紧「明确报不支持」这一种情况。
+*/
+function hasUsableMediaSource(mediaSource) {
+	if (typeof mediaSource === "undefined") return false;
+	if (typeof mediaSource.isTypeSupported !== "function") return true;
+	try {
+		return mediaSource.isTypeSupported(MSE_BASELINE_TYPE);
+	} catch {
+		return false;
+	}
+}
 /**
 * 从当前浏览器读环境。SSR 场景(没有 window / navigator)返回一个保守的默认值:
 * 当作没有 MSE,于是强制走 HLS —— 宁可保守也不要在服务端渲染时误判成能播 FLV。
@@ -132,7 +153,7 @@ function detectEnvFromGlobals() {
 	});
 	return detectEnv({
 		userAgent: navigator.userAgent,
-		hasMediaSource: typeof window.MediaSource !== "undefined",
+		hasMediaSource: hasUsableMediaSource(window.MediaSource),
 		hasManagedMediaSource: typeof window.ManagedMediaSource !== "undefined"
 	});
 }
@@ -4199,6 +4220,9 @@ function buildXgplayerConfig(options, routed, normalized, emit, env, playableSta
 	const lowLatencyMode = normalized.hls?.lowLatencyMode === true;
 	return {
 		el: options.el,
+		...options.fullscreenTarget ? { fullscreenTarget: options.fullscreenTarget } : {},
+		width: "100%",
+		height: "100%",
 		url: routed.chosen.url,
 		isLive: live,
 		ignores: [

package/dist/index.d.cts

@@ -78,6 +78,12 @@ declare function detectEnvFromGlobals(): Env;
 interface CreatePlayerOptions {
   /** 挂载容器 */
   el: HTMLElement;
+  /**
+   * 原生全屏目标(ADR-133)。装配层传入同时包含播放器与 SDK 覆盖层的外层容器,
+   * 覆盖层才会进入 `document.fullscreenElement` 子树、在全屏期间可见。
+   * 不传时沿用 xgplayer 默认(播放器根元素)。内部装配参数,不属于 `PlayerConfig`。
+   */
+  fullscreenTarget?: HTMLElement;
   /** 宿主网页全屏布局；不经可序列化配置传递。 */
   pageFullscreen?: PageFullscreenAdapter;
   /** iframe 内部使用：等待宿主协商后开放入口。 */

package/dist/index.d.mts

@@ -78,6 +78,12 @@ declare function detectEnvFromGlobals(): Env;
 interface CreatePlayerOptions {
   /** 挂载容器 */
   el: HTMLElement;
+  /**
+   * 原生全屏目标(ADR-133)。装配层传入同时包含播放器与 SDK 覆盖层的外层容器,
+   * 覆盖层才会进入 `document.fullscreenElement` 子树、在全屏期间可见。
+   * 不传时沿用 xgplayer 默认(播放器根元素)。内部装配参数,不属于 `PlayerConfig`。
+   */
+  fullscreenTarget?: HTMLElement;
   /** 宿主网页全屏布局；不经可序列化配置传递。 */
   pageFullscreen?: PageFullscreenAdapter;
   /** iframe 内部使用：等待宿主协商后开放入口。 */

package/dist/index.mjs

@@ -94,6 +94,27 @@ function detectEnv(input) {
 		requiresHls: isIOS || isWeChat || isUC || isQuark || !input.hasMediaSource
 	};
 }
+/** flv.js `isSupported()` 用的同一句基线:连它都报不支持,hls.js / flv.js 都不会开始播放 */
+const MSE_BASELINE_TYPE = "video/mp4; codecs=\"avc1.42E01E,mp4a.40.2\"";
+/**
+* 标准 MSE 是否**可用**,而不只是存在(ADR-135)。
+*
+* 小米浏览器(MiuiBrowser 20.28)暴露了 `MediaSource`,但 `isTypeSupported` 对所有
+* H.264/AAC 组合都回 false —— 实际 `addSourceBuffer` 能成功,是它报错了能力。
+* hls.js 信了前者,对声明了 CODECS 的主清单报 `manifestIncompatibleCodecsError`(不可重试)。
+* 按基线判为不可用后,SourceRouter 走原生 HLS,而该浏览器原生 HLS 播放、拖动都正常。
+*
+* 没有 `isTypeSupported` 的实现仍按「存在即可用」,只收紧「明确报不支持」这一种情况。
+*/
+function hasUsableMediaSource(mediaSource) {
+	if (typeof mediaSource === "undefined") return false;
+	if (typeof mediaSource.isTypeSupported !== "function") return true;
+	try {
+		return mediaSource.isTypeSupported(MSE_BASELINE_TYPE);
+	} catch {
+		return false;
+	}
+}
 /**
 * 从当前浏览器读环境。SSR 场景(没有 window / navigator)返回一个保守的默认值:
 * 当作没有 MSE,于是强制走 HLS —— 宁可保守也不要在服务端渲染时误判成能播 FLV。
@@ -106,7 +127,7 @@ function detectEnvFromGlobals() {
 	});
 	return detectEnv({
 		userAgent: navigator.userAgent,
-		hasMediaSource: typeof window.MediaSource !== "undefined",
+		hasMediaSource: hasUsableMediaSource(window.MediaSource),
 		hasManagedMediaSource: typeof window.ManagedMediaSource !== "undefined"
 	});
 }
@@ -4173,6 +4194,9 @@ function buildXgplayerConfig(options, routed, normalized, emit, env, playableSta
 	const lowLatencyMode = normalized.hls?.lowLatencyMode === true;
 	return {
 		el: options.el,
+		...options.fullscreenTarget ? { fullscreenTarget: options.fullscreenTarget } : {},
+		width: "100%",
+		height: "100%",
 		url: routed.chosen.url,
 		isLive: live,
 		ignores: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@video-lab/player-core",
-  "version": "4.0.1",
+  "version": "4.1.1",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -31,9 +31,9 @@
   "sideEffects": false,
   "dependencies": {
     "xgplayer": "3.0.26",
-    "hls.js": "1.6.16",
+    "hls.js": "1.6.19",
     "xgplayer-flv.js": "3.0.26",
-    "@video-lab/protocol": "4.0.1"
+    "@video-lab/protocol": "4.1.1"
   },
   "devDependencies": {
     "jsdom": "^24.0.0",