@video-lab/vue 2.0.0 → 3.0.1

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("vue"),t=require("@video-lab/protocol"),n=require("@video-lab/player-ui"),r=require("@video-lab/player-core");function i(t,r){return(0,n.defineSentinelOverlays)(),(0,e.h)(t,r)}function a(e,t){return e[t]??t}function o(e,t,n){let r=`error.${t}`,i=a(e,r);return i===r?n:i}function s(i,a,o){let s=(0,e.shallowRef)(null),u=(0,e.shallowRef)(n.INITIAL_OVERLAY),d=(0,e.ref)(!1);function f(e){let r=(0,t.toErrorEvent)(e);u.value=(0,n.reduceOverlay)(u.value,r),l(r,o)}function p(e){let n=s.value;if(n){if(n.destroyed){f({playerError:(0,t.makePlayerError)(`E_PLAYER_DESTROYED`,t.PLAYER_DESTROYED_MESSAGE)});return}e(n)}}function m(){let e=i.value;if(e){u.value=n.INITIAL_OVERLAY;try{s.value=(0,r.createPlayer)({el:e,config:c(a),onEvent:e=>{u.value=(0,n.reduceOverlay)(u.value,e),l(e,o)}}),d.value=!0}catch(e){f(e)}}}function h(){s.value?.destroy(),s.value=null,d.value=!1}(0,e.onMounted)(m),(0,e.onBeforeUnmount)(h),(0,e.watch)(()=>JSON.stringify(a.source),()=>{u.value=(0,n.resetOverlayForNewSource)(u.value),p(e=>{e.load(a.source).catch(f)})}),(0,e.watch)(()=>a.muted,e=>{e!==void 0&&p(t=>t.setMuted(e))}),(0,e.watch)(()=>a.locale,e=>{e!==void 0&&p(t=>t.setLocale(e))},{deep:!0});function g(){h(),m()}function _(){u.value={...u.value,pauseImageVisible:!1,pauseImageDismissed:!0}}return{handle:s,overlay:u,isMounted:d,handleRetry:g,dismissPauseImage:_}}function c(e){let t={source:e.source};return e.preset!==void 0&&(t.preset=e.preset),e.autoplay!==void 0&&(t.autoplay=e.autoplay),e.muted!==void 0&&(t.muted=e.muted),e.loop!==void 0&&(t.loop=e.loop),e.playsinline!==void 0&&(t.playsinline=e.playsinline),e.playbackRate!==void 0&&(t.playbackRate=e.playbackRate),e.volume!==void 0&&(t.volume=e.volume),e.startTime!==void 0&&(t.startTime=e.startTime),e.preload!==void 0&&(t.preload=e.preload),e.controls!==void 0&&(t.controls=e.controls),e.interactive!==void 0&&(t.interactive=e.interactive),e.poster!==void 0&&(t.poster=e.poster),e.pauseImage!==void 0&&(t.pauseImage=e.pauseImage),e.locale!==void 0&&(t.locale=e.locale),e.danmaku!==void 0&&(t.danmaku=e.danmaku),e.debug!==void 0&&(t.debug=e.debug),t}function l(e,t){try{t(`playerEvent`,e)}catch{}switch(e.event){case`ready`:t(`ready`,e.payload);break;case`play`:t(`play`);break;case`pause`:t(`pause`);break;case`ended`:t(`ended`);break;case`timeupdate`:t(`timeUpdate`,e.payload);break;case`volumechange`:t(`volumeChange`,e.payload);break;case`seeking`:t(`seeking`,e.payload);break;case`seeked`:t(`seeked`,e.payload);break;case`waiting`:t(`waiting`);break;case`playing`:t(`playing`);break;case`qualitychange`:t(`qualityChange`,e.payload);break;case`subtitlechange`:t(`subtitleChange`,e.payload);break;case`error`:t(`error`,e.payload);break;case`autoplayblocked`:t(`autoplayBlocked`);break;case`reconnectstart`:t(`reconnectStart`,{attempt:e.payload.attempt,maxAttempts:e.payload.maxAttempts});break;case`reconnectsuccess`:t(`reconnectSuccess`);break;case`reconnectfailed`:t(`reconnectFailed`);break;case`compatwarning`:t(`compatWarning`,e.payload);break;case`stalled`:t(`stalled`,e.payload);break;case`playablechange`:t(`playableChange`,e.payload);break;case`bufferhealth`:t(`bufferHealth`,e.payload);break;case`contextchange`:t(`contextChange`,e.payload);break;case`sourceroute`:t(`sourceRoute`,e.payload);break;case`firstframe`:t(`firstFrame`,e.payload);break;case`framefreeze`:t(`frameFreeze`,e.payload);break;case`useraction`:t(`userAction`,e.payload);break;case`kernelhealth`:t(`kernelHealth`,e.payload);break;case`audiohealth`:t(`audioHealth`,e.payload);break;case`recovery`:break;default:break}}var u=(0,e.defineComponent)({__name:`VideoPlayer`,props:{source:{},autoplay:{type:Boolean,default:void 0},muted:{type:Boolean,default:void 0},loop:{type:Boolean,default:void 0},controls:{type:Boolean,default:void 0},interactive:{type:Boolean,default:void 0},playsinline:{type:Boolean,default:void 0},playbackRate:{},volume:{},startTime:{},preload:{},poster:{},pauseImage:{},preset:{},locale:{},danmaku:{},debug:{type:Boolean,default:void 0}},emits:`playerEvent.ready.play.pause.ended.timeUpdate.volumeChange.seeking.seeked.waiting.playing.qualityChange.subtitleChange.error.autoplayBlocked.reconnectStart.reconnectSuccess.reconnectFailed.compatWarning.stalled.playableChange.kernelHealth.audioHealth.bufferHealth.contextChange.sourceRoute.firstFrame.frameFreeze.userAction`.split(`.`),setup(n,{expose:r,emit:c}){let l=n,u=c,d=(0,e.shallowRef)(null),{handle:f,overlay:p,isMounted:m,handleRetry:h,dismissPauseImage:g}=s(d,l,u),_=(0,e.computed)(()=>(0,t.resolveLocaleMessages)(l.locale).messages),v=(0,e.computed)(()=>typeof l.poster==`string`?l.poster:l.poster?.url),y=(0,e.computed)(()=>typeof l.pauseImage==`string`?l.pauseImage:l.pauseImage?.url),b=()=>[v.value?i(`sentinel-poster`,{visible:p.value.posterVisible,poster:l.poster}):null,y.value?i(`sentinel-pause`,{visible:p.value.pauseImageVisible,pauseImage:l.pauseImage,"close-label":a(_.value,`close`),"onSentinel-close":g}):null,i(`sentinel-loading`,{visible:p.value.loadingVisible,text:a(_.value,`loading`)}),p.value.error?i(`sentinel-error`,{visible:!0,code:p.value.error.code,message:o(_.value,p.value.error.code,p.value.error.message),retryable:p.value.error.retryable,"retry-label":a(_.value,`retry`),"onSentinel-retry":h}):null];return r({play:()=>f.value?.play()??Promise.resolve(),pause:()=>f.value?.pause(),seek:e=>f.value?.seek(e),setMuted:e=>f.value?.setMuted(e),setVolume:e=>f.value?.setVolume(e),setPlaybackRate:e=>f.value?.setPlaybackRate(e),enterFullscreen:()=>f.value?.enterFullscreen()??Promise.resolve(),exitFullscreen:()=>f.value?.exitFullscreen()??Promise.resolve(),setQuality:e=>f.value?.setQuality(e),setSubtitle:e=>f.value?.setSubtitle(e),setLocale:e=>f.value?.setLocale(e),pushDanmaku:e=>f.value?.pushDanmaku(e),setDanmakuEnabled:e=>f.value?.setDanmakuEnabled(e),clearDanmaku:()=>f.value?.clearDanmaku(),reconnect:e=>f.value?.reconnect(e),destroy:()=>f.value?.destroy(),getCurrentTime:()=>f.value?.getCurrentTime()??0,getDuration:()=>f.value?.getDuration()??0,getPlaybackContext:()=>f.value?.getPlaybackContext()??null,getPlayerHandle:()=>f.value}),(t,n)=>((0,e.openBlock)(),(0,e.createElementBlock)(`div`,{class:`sentinel-video`,style:(0,e.normalizeStyle)({position:`relative`,width:`100%`,height:`100%`,pointerEvents:l.interactive===!1?`none`:void 0})},[(0,e.createElementVNode)(`div`,{ref_key:`containerRef`,ref:d,class:`sentinel-video__player`,style:{width:`100%`,height:`100%`}},null,512),(0,e.createVNode)(b),(0,e.unref)(m)?(0,e.createCommentVNode)(``,!0):(0,e.renderSlot)(t.$slots,`ssr-placeholder`,{key:0})],4))}});exports.VideoPlayer=u;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("vue"),t=require("@video-lab/protocol"),n=require("@video-lab/player-ui"),r=require("@video-lab/player-core");function i(t,r){return(0,n.defineSentinelOverlays)(),(0,e.h)(t,r)}function a(e,t){return e[t]??t}function o(e,t,n){let r=`error.${t}`,i=a(e,r);return i===r?n:i}function s(i,a,o){let s=(0,e.shallowRef)(null),u=(0,e.shallowRef)(n.INITIAL_OVERLAY),d=(0,e.ref)(!1);function f(e){let r=(0,t.toErrorEvent)(e);u.value=s.value?(0,n.reduceOverlay)(u.value,r):{...u.value,posterVisible:!1,loadingVisible:!1,error:r.payload,action:`replace-source`},l(r,o)}function p(e){let n=s.value;if(n){if(n.destroyed){f({playerError:(0,t.makePlayerError)(`E_PLAYER_DESTROYED`,t.PLAYER_DESTROYED_MESSAGE)});return}e(n)}}function m(){let e=i.value;if(e){u.value=n.INITIAL_OVERLAY;try{s.value=(0,r.createPlayer)({el:e,config:c(a),pageFullscreen:a.pageFullscreen,onEvent:e=>{u.value=(0,n.reduceOverlay)(u.value,e),l(e,o)},onDeliveredEvent:e=>{try{o(`deliveredPlayerEvent`,e)}catch{}}}),d.value=!0}catch(e){f(e)}}}function h(){s.value?.destroy(),s.value=null,d.value=!1}(0,e.onMounted)(m),(0,e.onBeforeUnmount)(h),(0,e.watch)(()=>JSON.stringify(a.source),()=>{u.value=(0,n.resetOverlayForNewSource)(u.value),p(e=>{e.load(a.source).catch(f)})}),(0,e.watch)(()=>a.muted,e=>{e!==void 0&&p(t=>t.setMuted(e))}),(0,e.watch)(()=>a.locale,e=>{e!==void 0&&p(t=>t.setLocale(e))},{deep:!0});function g(){let e=s.value;e&&(u.value.action===`play`?e.play():e.retry()).catch(()=>{})}function _(){u.value={...u.value,pauseImageVisible:!1,pauseImageDismissed:!0}}return{handle:s,overlay:u,isMounted:d,handleRetry:g,dismissPauseImage:_}}function c(e){let t={source:e.source};return e.preset!==void 0&&(t.preset=e.preset),e.autoplay!==void 0&&(t.autoplay=e.autoplay),e.muted!==void 0&&(t.muted=e.muted),e.loop!==void 0&&(t.loop=e.loop),e.playsinline!==void 0&&(t.playsinline=e.playsinline),e.playbackRate!==void 0&&(t.playbackRate=e.playbackRate),e.volume!==void 0&&(t.volume=e.volume),e.startTime!==void 0&&(t.startTime=e.startTime),e.preload!==void 0&&(t.preload=e.preload),e.controls!==void 0&&(t.controls=e.controls),e.showErrorOverlay!==void 0&&(t.showErrorOverlay=e.showErrorOverlay),e.showLoadingOverlay!==void 0&&(t.showLoadingOverlay=e.showLoadingOverlay),e.controlVisibility!==void 0&&(t.controlVisibility=e.controlVisibility),e.interactive!==void 0&&(t.interactive=e.interactive),e.poster!==void 0&&(t.poster=e.poster),e.pauseImage!==void 0&&(t.pauseImage=e.pauseImage),e.locale!==void 0&&(t.locale=e.locale),e.danmaku!==void 0&&(t.danmaku=e.danmaku),e.debug!==void 0&&(t.debug=e.debug),t}function l(e,t){try{t(`playerEvent`,e)}catch{}switch(e.event){case`ready`:t(`ready`,e.payload);break;case`play`:t(`play`);break;case`pause`:t(`pause`);break;case`ended`:t(`ended`);break;case`timeupdate`:t(`timeUpdate`,e.payload);break;case`volumechange`:t(`volumeChange`,e.payload);break;case`seeking`:t(`seeking`,e.payload);break;case`seeked`:t(`seeked`,e.payload);break;case`waiting`:t(`waiting`);break;case`playing`:t(`playing`);break;case`qualitychange`:t(`qualityChange`,e.payload);break;case`subtitlechange`:t(`subtitleChange`,e.payload);break;case`error`:t(`error`,e.payload);break;case`autoplayblocked`:t(`autoplayBlocked`);break;case`compatwarning`:t(`compatWarning`,e.payload);break;case`stalled`:t(`stalled`,e.payload);break;case`playablechange`:t(`playableChange`,e.payload);break;case`bufferhealth`:t(`bufferHealth`,e.payload);break;case`contextchange`:t(`contextChange`,e.payload);break;case`sourceroute`:t(`sourceRoute`,e.payload);break;case`firstframe`:t(`firstFrame`,e.payload);break;case`framefreeze`:t(`frameFreeze`,e.payload);break;case`pagefullscreenchange`:t(`pageFullscreenChange`,e.payload);break;case`useraction`:t(`userAction`,e.payload);break;case`kernelhealth`:t(`kernelHealth`,e.payload);break;case`audiohealth`:t(`audioHealth`,e.payload);break;case`recovery`:break;default:break}}var u=(0,e.defineComponent)({__name:`VideoPlayer`,props:{pageFullscreen:{},source:{},autoplay:{type:Boolean,default:void 0},muted:{type:Boolean,default:void 0},loop:{type:Boolean,default:void 0},controls:{type:Boolean,default:void 0},showErrorOverlay:{type:Boolean,default:void 0},showLoadingOverlay:{type:Boolean,default:void 0},controlVisibility:{},interactive:{type:Boolean,default:void 0},playsinline:{type:Boolean,default:void 0},playbackRate:{},volume:{},startTime:{},preload:{},poster:{},pauseImage:{},preset:{},locale:{},danmaku:{},debug:{type:Boolean,default:void 0}},emits:`playerEvent.deliveredPlayerEvent.ready.play.pause.ended.timeUpdate.volumeChange.seeking.seeked.waiting.playing.qualityChange.subtitleChange.error.autoplayBlocked.compatWarning.stalled.playableChange.kernelHealth.audioHealth.bufferHealth.contextChange.sourceRoute.firstFrame.frameFreeze.pageFullscreenChange.userAction`.split(`.`),setup(n,{expose:r,emit:c}){let l=n,u=c,d=l.showErrorOverlay!==!1,f=l.showLoadingOverlay!==!1,p=(0,e.shallowRef)(null),{handle:m,overlay:h,isMounted:g,handleRetry:_,dismissPauseImage:v}=s(p,l,u),y=(0,e.computed)(()=>(0,t.resolveLocaleMessages)(l.locale).messages),b=(0,e.computed)(()=>typeof l.poster==`string`?l.poster:l.poster?.url),x=(0,e.computed)(()=>typeof l.pauseImage==`string`?l.pauseImage:l.pauseImage?.url),S=()=>[b.value?i(`sentinel-poster`,{visible:h.value.posterVisible,poster:l.poster}):null,x.value?i(`sentinel-pause`,{visible:h.value.pauseImageVisible,pauseImage:l.pauseImage,"close-label":a(y.value,`close`),"onSentinel-close":v}):null,i(`sentinel-loading`,{visible:f&&h.value.loadingVisible,text:a(y.value,`loading`)}),d&&h.value.error?i(`sentinel-error`,{visible:!0,code:h.value.error.code,message:o(y.value,h.value.error.code,h.value.error.message),retryable:h.value.action===`retry`||h.value.action===`play`,"retry-label":a(y.value,h.value.action===`play`?`play`:`retry`),"onSentinel-retry":_}):null];return r({play:()=>m.value?.play()??Promise.resolve(),pause:()=>m.value?.pause(),seek:e=>m.value?.seek(e),setMuted:e=>m.value?.setMuted(e),setVolume:e=>m.value?.setVolume(e),setPlaybackRate:e=>m.value?.setPlaybackRate(e),setPageFullscreen:e=>m.value?.setPageFullscreen(e)??Promise.reject(Error(`播放器未就绪`)),enterFullscreen:()=>m.value?.enterFullscreen()??Promise.resolve(),exitFullscreen:()=>m.value?.exitFullscreen()??Promise.resolve(),setQuality:e=>m.value?.setQuality(e),setSubtitle:e=>m.value?.setSubtitle(e),setLocale:e=>m.value?.setLocale(e),pushDanmaku:e=>m.value?.pushDanmaku(e),setDanmakuEnabled:e=>m.value?.setDanmakuEnabled(e),clearDanmaku:()=>m.value?.clearDanmaku(),retry:()=>m.value?.retry()??Promise.resolve(),destroy:()=>m.value?.destroy(),getCurrentTime:()=>m.value?.getCurrentTime()??0,getDuration:()=>m.value?.getDuration()??0,getPlaybackContext:()=>m.value?.getPlaybackContext()??null,getPlayerHandle:()=>m.value}),(t,n)=>((0,e.openBlock)(),(0,e.createElementBlock)(`div`,{class:`sentinel-video`,style:(0,e.normalizeStyle)({position:`relative`,width:`100%`,height:`100%`,pointerEvents:l.interactive===!1?`none`:void 0})},[(0,e.createElementVNode)(`div`,{ref_key:`containerRef`,ref:p,class:`sentinel-video__player`,style:{width:`100%`,height:`100%`}},null,512),(0,e.createVNode)(S),(0,e.unref)(g)?(0,e.createCommentVNode)(``,!0):(0,e.renderSlot)(t.$slots,`ssr-placeholder`,{key:0})],4))}});exports.VideoPlayer=u;

package/dist/index.d.ts

@@ -8,6 +8,7 @@
  * 只做技术,不含团队品牌 UI(ADR-021)。**开门的决策见 ADR-052**
  *(取代 ADR-002「Vue 只做 iframe 不做 inline」—— 那条的唯一论据在 #120 之后已不成立)。
  */
+export type { PageFullscreenAdapter, PageFullscreenState } from '@video-lab/protocol';
 export type { DanmakuConfig, DanmakuItem, MediaSource, PlayerError, PlayerHandle, QualityLevel, SubtitleTrackInfo, VideoPlayerEmits, VideoPlayerExpose, VideoPlayerProps, } from './types';
 export { default as VideoPlayer } from './VideoPlayer.vue';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -19,7 +19,13 @@ function O(e, t, n) {
 	let r = p(null), i = p(b), a = d(!1);
 	function o(e) {
 		let t = y(e);
-		i.value = S(i.value, t), A(t, n);
+		i.value = r.value ? S(i.value, t) : {
+			...i.value,
+			posterVisible: !1,
+			loadingVisible: !1,
+			error: t.payload,
+			action: "replace-source"
+		}, A(t, n);
 	}
 	function s(e) {
 		let t = r.value;
@@ -39,8 +45,14 @@ function O(e, t, n) {
 				r.value = w({
 					el: s,
 					config: k(t),
+					pageFullscreen: t.pageFullscreen,
 					onEvent: (e) => {
 						i.value = S(i.value, e), A(e, n);
+					},
+					onDeliveredEvent: (e) => {
+						try {
+							n("deliveredPlayerEvent", e);
+						} catch {}
 					}
 				}), a.value = !0;
 			} catch (e) {
@@ -61,7 +73,8 @@ function O(e, t, n) {
 		e !== void 0 && s((t) => t.setLocale(e));
 	}, { deep: !0 });
 	function m() {
-		f(), u();
+		let e = r.value;
+		e && (i.value.action === "play" ? e.play() : e.retry()).catch(() => {});
 	}
 	function v() {
 		i.value = {
@@ -80,7 +93,7 @@ function O(e, t, n) {
 }
 function k(e) {
 	let t = { source: e.source };
-	return e.preset !== void 0 && (t.preset = e.preset), e.autoplay !== void 0 && (t.autoplay = e.autoplay), e.muted !== void 0 && (t.muted = e.muted), e.loop !== void 0 && (t.loop = e.loop), e.playsinline !== void 0 && (t.playsinline = e.playsinline), e.playbackRate !== void 0 && (t.playbackRate = e.playbackRate), e.volume !== void 0 && (t.volume = e.volume), e.startTime !== void 0 && (t.startTime = e.startTime), e.preload !== void 0 && (t.preload = e.preload), e.controls !== void 0 && (t.controls = e.controls), e.interactive !== void 0 && (t.interactive = e.interactive), e.poster !== void 0 && (t.poster = e.poster), e.pauseImage !== void 0 && (t.pauseImage = e.pauseImage), e.locale !== void 0 && (t.locale = e.locale), e.danmaku !== void 0 && (t.danmaku = e.danmaku), e.debug !== void 0 && (t.debug = e.debug), t;
+	return e.preset !== void 0 && (t.preset = e.preset), e.autoplay !== void 0 && (t.autoplay = e.autoplay), e.muted !== void 0 && (t.muted = e.muted), e.loop !== void 0 && (t.loop = e.loop), e.playsinline !== void 0 && (t.playsinline = e.playsinline), e.playbackRate !== void 0 && (t.playbackRate = e.playbackRate), e.volume !== void 0 && (t.volume = e.volume), e.startTime !== void 0 && (t.startTime = e.startTime), e.preload !== void 0 && (t.preload = e.preload), e.controls !== void 0 && (t.controls = e.controls), e.showErrorOverlay !== void 0 && (t.showErrorOverlay = e.showErrorOverlay), e.showLoadingOverlay !== void 0 && (t.showLoadingOverlay = e.showLoadingOverlay), e.controlVisibility !== void 0 && (t.controlVisibility = e.controlVisibility), e.interactive !== void 0 && (t.interactive = e.interactive), e.poster !== void 0 && (t.poster = e.poster), e.pauseImage !== void 0 && (t.pauseImage = e.pauseImage), e.locale !== void 0 && (t.locale = e.locale), e.danmaku !== void 0 && (t.danmaku = e.danmaku), e.debug !== void 0 && (t.debug = e.debug), t;
 }
 function A(e, t) {
 	try {
@@ -129,18 +142,6 @@ function A(e, t) {
 		case "autoplayblocked":
 			t("autoplayBlocked");
 			break;
-		case "reconnectstart":
-			t("reconnectStart", {
-				attempt: e.payload.attempt,
-				maxAttempts: e.payload.maxAttempts
-			});
-			break;
-		case "reconnectsuccess":
-			t("reconnectSuccess");
-			break;
-		case "reconnectfailed":
-			t("reconnectFailed");
-			break;
 		case "compatwarning":
 			t("compatWarning", e.payload);
 			break;
@@ -165,6 +166,9 @@ function A(e, t) {
 		case "framefreeze":
 			t("frameFreeze", e.payload);
 			break;
+		case "pagefullscreenchange":
+			t("pageFullscreenChange", e.payload);
+			break;
 		case "useraction":
 			t("userAction", e.payload);
 			break;
@@ -183,6 +187,7 @@ function A(e, t) {
 var j = /* @__PURE__ */ a({
 	__name: "VideoPlayer",
 	props: {
+		pageFullscreen: {},
 		source: {},
 		autoplay: {
 			type: Boolean,
@@ -200,6 +205,15 @@ var j = /* @__PURE__ */ a({
 			type: Boolean,
 			default: void 0
 		},
+		showErrorOverlay: {
+			type: Boolean,
+			default: void 0
+		},
+		showLoadingOverlay: {
+			type: Boolean,
+			default: void 0
+		},
+		controlVisibility: {},
 		interactive: {
 			type: Boolean,
 			default: void 0
@@ -222,53 +236,54 @@ var j = /* @__PURE__ */ a({
 			default: void 0
 		}
 	},
-	emits: /* @__PURE__ */ "playerEvent.ready.play.pause.ended.timeUpdate.volumeChange.seeking.seeked.waiting.playing.qualityChange.subtitleChange.error.autoplayBlocked.reconnectStart.reconnectSuccess.reconnectFailed.compatWarning.stalled.playableChange.kernelHealth.audioHealth.bufferHealth.contextChange.sourceRoute.firstFrame.frameFreeze.userAction".split("."),
+	emits: /* @__PURE__ */ "playerEvent.deliveredPlayerEvent.ready.play.pause.ended.timeUpdate.volumeChange.seeking.seeked.waiting.playing.qualityChange.subtitleChange.error.autoplayBlocked.compatWarning.stalled.playableChange.kernelHealth.audioHealth.bufferHealth.contextChange.sourceRoute.firstFrame.frameFreeze.pageFullscreenChange.userAction".split("."),
 	setup(a, { expose: o, emit: c }) {
-		let l = a, d = c, h = p(null), { handle: g, overlay: _, isMounted: y, handleRetry: b, dismissPauseImage: x } = O(h, l, d), S = e(() => v(l.locale).messages), C = e(() => typeof l.poster == "string" ? l.poster : l.poster?.url), w = e(() => typeof l.pauseImage == "string" ? l.pauseImage : l.pauseImage?.url), k = () => [
-			C.value ? T("sentinel-poster", {
-				visible: _.value.posterVisible,
+		let l = a, d = c, h = l.showErrorOverlay !== !1, g = l.showLoadingOverlay !== !1, _ = p(null), { handle: y, overlay: b, isMounted: x, handleRetry: S, dismissPauseImage: C } = O(_, l, d), w = e(() => v(l.locale).messages), k = e(() => typeof l.poster == "string" ? l.poster : l.poster?.url), A = e(() => typeof l.pauseImage == "string" ? l.pauseImage : l.pauseImage?.url), j = () => [
+			k.value ? T("sentinel-poster", {
+				visible: b.value.posterVisible,
 				poster: l.poster
 			}) : null,
-			w.value ? T("sentinel-pause", {
-				visible: _.value.pauseImageVisible,
+			A.value ? T("sentinel-pause", {
+				visible: b.value.pauseImageVisible,
 				pauseImage: l.pauseImage,
-				"close-label": E(S.value, "close"),
-				"onSentinel-close": x
+				"close-label": E(w.value, "close"),
+				"onSentinel-close": C
 			}) : null,
 			T("sentinel-loading", {
-				visible: _.value.loadingVisible,
-				text: E(S.value, "loading")
+				visible: g && b.value.loadingVisible,
+				text: E(w.value, "loading")
 			}),
-			_.value.error ? T("sentinel-error", {
+			h && b.value.error ? T("sentinel-error", {
 				visible: !0,
-				code: _.value.error.code,
-				message: D(S.value, _.value.error.code, _.value.error.message),
-				retryable: _.value.error.retryable,
-				"retry-label": E(S.value, "retry"),
-				"onSentinel-retry": b
+				code: b.value.error.code,
+				message: D(w.value, b.value.error.code, b.value.error.message),
+				retryable: b.value.action === "retry" || b.value.action === "play",
+				"retry-label": E(w.value, b.value.action === "play" ? "play" : "retry"),
+				"onSentinel-retry": S
 			}) : null
 		];
 		return o({
-			play: () => g.value?.play() ?? Promise.resolve(),
-			pause: () => g.value?.pause(),
-			seek: (e) => g.value?.seek(e),
-			setMuted: (e) => g.value?.setMuted(e),
-			setVolume: (e) => g.value?.setVolume(e),
-			setPlaybackRate: (e) => g.value?.setPlaybackRate(e),
-			enterFullscreen: () => g.value?.enterFullscreen() ?? Promise.resolve(),
-			exitFullscreen: () => g.value?.exitFullscreen() ?? Promise.resolve(),
-			setQuality: (e) => g.value?.setQuality(e),
-			setSubtitle: (e) => g.value?.setSubtitle(e),
-			setLocale: (e) => g.value?.setLocale(e),
-			pushDanmaku: (e) => g.value?.pushDanmaku(e),
-			setDanmakuEnabled: (e) => g.value?.setDanmakuEnabled(e),
-			clearDanmaku: () => g.value?.clearDanmaku(),
-			reconnect: (e) => g.value?.reconnect(e),
-			destroy: () => g.value?.destroy(),
-			getCurrentTime: () => g.value?.getCurrentTime() ?? 0,
-			getDuration: () => g.value?.getDuration() ?? 0,
-			getPlaybackContext: () => g.value?.getPlaybackContext() ?? null,
-			getPlayerHandle: () => g.value
+			play: () => y.value?.play() ?? Promise.resolve(),
+			pause: () => y.value?.pause(),
+			seek: (e) => y.value?.seek(e),
+			setMuted: (e) => y.value?.setMuted(e),
+			setVolume: (e) => y.value?.setVolume(e),
+			setPlaybackRate: (e) => y.value?.setPlaybackRate(e),
+			setPageFullscreen: (e) => y.value?.setPageFullscreen(e) ?? Promise.reject(/* @__PURE__ */ Error("播放器未就绪")),
+			enterFullscreen: () => y.value?.enterFullscreen() ?? Promise.resolve(),
+			exitFullscreen: () => y.value?.exitFullscreen() ?? Promise.resolve(),
+			setQuality: (e) => y.value?.setQuality(e),
+			setSubtitle: (e) => y.value?.setSubtitle(e),
+			setLocale: (e) => y.value?.setLocale(e),
+			pushDanmaku: (e) => y.value?.pushDanmaku(e),
+			setDanmakuEnabled: (e) => y.value?.setDanmakuEnabled(e),
+			clearDanmaku: () => y.value?.clearDanmaku(),
+			retry: () => y.value?.retry() ?? Promise.resolve(),
+			destroy: () => y.value?.destroy(),
+			getCurrentTime: () => y.value?.getCurrentTime() ?? 0,
+			getDuration: () => y.value?.getDuration() ?? 0,
+			getPlaybackContext: () => y.value?.getPlaybackContext() ?? null,
+			getPlayerHandle: () => y.value
 		}), (e, a) => (u(), n("div", {
 			class: "sentinel-video",
 			style: s({
@@ -280,15 +295,15 @@ var j = /* @__PURE__ */ a({
 		}, [
 			r("div", {
 				ref_key: "containerRef",
-				ref: h,
+				ref: _,
 				class: "sentinel-video__player",
 				style: {
 					width: "100%",
 					height: "100%"
 				}
 			}, null, 512),
-			i(k),
-			m(y) ? t("", !0) : f(e.$slots, "ssr-placeholder", { key: 0 })
+			i(j),
+			m(x) ? t("", !0) : f(e.$slots, "ssr-placeholder", { key: 0 })
 		], 4));
 	}
 });

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import { PlayerCoreHandle } from '@video-lab/player-core';
-import { AudioHealthPayload, BufferHealthPayload, DanmakuConfig, DanmakuItem, FirstFramePayload, FrameFreezePayload, KernelHealthPayload, LocaleConfig, MediaSource, PauseImageConfig, PlayableReason, PlaybackContext, PlaybackContextPayload, PlayerError, PlayerEvent, PosterConfig, PresetName, QualityLevel, SourceRouteEventPayload, SubtitleTrackInfo, UserActionPayload } from '@video-lab/protocol';
+import { AudioHealthPayload, BufferHealthPayload, ControlVisibilityConfig, DanmakuConfig, DanmakuItem, DeliveredPlayerEvent, FirstFramePayload, FrameFreezePayload, KernelHealthPayload, LocaleConfig, MediaSource, PageFullscreenAdapter, PageFullscreenState, PauseImageConfig, PlaybackContext, PlaybackContextPayload, PlayerError, PlayerEvent, PosterConfig, PresetName, QualityLevel, SourceRouteEventPayload, SubtitleTrackInfo, UserActionPayload } from '@video-lab/protocol';
 /**
  * 消费方拿到的底层句柄(逃生舱)。
  *
@@ -23,12 +23,20 @@ export type { DanmakuConfig, DanmakuItem, MediaSource, PlayerError, QualityLevel
  * 声明成 props 反而会把它们从 fallthrough 里摘出来,要自己再拼一遍。
  */
 export interface VideoPlayerProps {
+    /** 挂载期间保持稳定的宿主网页全屏布局适配器。 */
+    pageFullscreen?: PageFullscreenAdapter;
     /** 视频源。字符串按 URL 处理,对象可带 type / live / hls 等 */
     source: MediaSource | string;
     autoplay?: boolean;
     muted?: boolean;
     loop?: boolean;
     controls?: boolean;
+    /** 默认错误覆盖层，省略时开启。仅初始化读取；变更须重新挂载，不影响错误事件。 */
+    showErrorOverlay?: boolean;
+    /** 是否显示 SDK 运行时 Loading；构造期读取，默认 true。 */
+    showLoadingOverlay?: boolean;
+    /** 内置控件初始化显示策略；修改后须由宿主显式重建播放器。 */
+    controlVisibility?: ControlVisibilityConfig;
     /** false 时播放器不接收指针事件(点击穿透到下层,如首页预览卡片) */
     interactive?: boolean;
     playsinline?: boolean;
@@ -88,6 +96,7 @@ export interface VideoPlayerProps {
 export interface VideoPlayerEmits {
     /** 完整的契约事件流，供遥测适配器使用；不裁剪 payload。 */
     (e: 'playerEvent', payload: PlayerEvent): void;
+    (e: 'deliveredPlayerEvent', payload: DeliveredPlayerEvent): void;
     /**
      * metadata 就绪。`quality` 是可切档位清单(单码率源为空数组),团队层据此渲染清晰度菜单;
      * `subtitles` 是可切字幕轨清单(无字幕源为空/缺省,契约 1.0.0 起可选,ADR-027),团队层据此渲染字幕菜单。
@@ -137,12 +146,6 @@ export interface VideoPlayerEmits {
     }): void;
     (e: 'error', payload: PlayerError): void;
     (e: 'autoplayBlocked'): void;
-    (e: 'reconnectStart', payload: {
-        attempt: number;
-        maxAttempts: number;
-    }): void;
-    (e: 'reconnectSuccess'): void;
-    (e: 'reconnectFailed'): void;
     (e: 'compatWarning', payload: {
         code: string;
         message: string;
@@ -166,11 +169,9 @@ export interface VideoPlayerEmits {
      * `recoverable` 决定盖 loading(等)还是露重试入口(不等);`reason='degraded'`
      * 是唯一 `playable` 仍为 `true` 的值(掉帧严重但画面还在动,可以忽略)。
      */
-    (e: 'playableChange', payload: {
-        playable: boolean;
-        reason: PlayableReason;
-        recoverable: boolean;
-    }): void;
+    (e: 'playableChange', payload: Extract<PlayerEvent, {
+        event: 'playablechange';
+    }>['payload']): void;
     /**
      * 内核健康 —— **非致命内核诊断的聚合**(契约 4.1.0 / ADR-062 / issue #391)。
      *
@@ -213,6 +214,8 @@ export interface VideoPlayerEmits {
      * ⚠️ 它不是掉帧率,也不与 `stalled` 重复(后者是缓冲驱动的等待)。
      */
     (e: 'frameFreeze', payload: FrameFreezePayload): void;
+    /** 实际网页全屏状态变化。 */
+    (e: 'pageFullscreenChange', payload: PageFullscreenState): void;
     /**
      * 用户动作(ADR-075),经白名单过滤,只含**发生在 SDK 内部**的那些。
      *
@@ -238,6 +241,8 @@ export interface VideoPlayerExpose {
     setMuted(muted: boolean): void;
     setVolume(volume: number): void;
     setPlaybackRate(rate: number): void;
+    /** 设置网页全屏；必须等宿主布局与 iframe 状态确认。 */
+    setPageFullscreen(active: boolean): Promise<void>;
     /** 进入全屏(容器托管,不碰 video 原生入口,iOS 微信崩溃入口由 FullscreenGuard 中和) */
     enterFullscreen(): Promise<void>;
     /** 退出全屏 */
@@ -253,9 +258,7 @@ export interface VideoPlayerExpose {
     setDanmakuEnabled(enabled: boolean): void;
     /** 清空屏上弹幕(ADR-028) */
     clearDanmaku(): void;
-    reconnect(options?: {
-        resetCounter?: boolean;
-    }): void;
+    retry(): Promise<void>;
     destroy(): void;
     getCurrentTime(): number;
     getDuration(): number;

package/dist/use-player.d.ts

@@ -36,9 +36,9 @@ export declare function toConfig(props: VideoPlayerProps): PlayerConfig;
  * 播放器事件 → Vue emits。名字从 wire 上的小写拼写换成 camelCase 事件名,
  * 和 `vue-frame` 的 `forward` 逐条对应(cross-mode-parity):同样的事件、同样的 payload。
  *
- * **契约声明的 19 个事件必须一个不少地出现在这里**,由 `protocol/tests/consumer-surface.contract.test.ts`
+ * **契约声明的 27 个事件必须一个不少地出现在这里**,由 `protocol/tests/consumer-surface.contract.test.ts`
  * 静态断言。`video-react` 曾经漏过 4 个(seeking / seeked / waiting / playing)——
- * 而静态 iframe 模式是裸广播、19 个全发,于是同一份契约在几种接入方式下能收到的事件
+ * 而静态 iframe 模式是裸广播、27 个全发,于是同一份契约在几种接入方式下能收到的事件
  * 不一样,parity 红线实际已破。别再以"业务暂时用不到"为由少接一个。
  */
 export declare function forward(event: PlayerEvent, emit: VideoPlayerEmits): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@video-lab/vue",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -28,9 +28,9 @@
     "vue": "^3.4.0"
   },
   "dependencies": {
-    "@video-lab/protocol": "2.0.0",
-    "@video-lab/player-core": "2.0.0",
-    "@video-lab/player-ui": "2.0.0"
+    "@video-lab/protocol": "3.0.1",
+    "@video-lab/player-ui": "3.0.1",
+    "@video-lab/player-core": "3.0.1"
   },
   "devDependencies": {
     "@vitejs/plugin-vue": "^6.0.8",