@ezuikit/player-theme 3.1.2-beta.2 → 3.1.2-beta.4

package/dist/constant.js

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.2-beta.2
-* Copyright (c) 2026-08-12 04:37:54 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.2-beta.4
+* Copyright (c) 2026-08-16 15:20:04 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 /**

package/dist/index.cjs

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.2-beta.2
-* Copyright (c) 2026-08-12 04:37:54 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.2-beta.4
+* Copyright (c) 2026-08-16 15:20:04 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 'use strict';
@@ -295,7 +295,7 @@ function _set_prototype_of$y(o, p) {
     function Control(options) {
         var _this;
         var _this___options;
-        _this = EventEmitter.call(this) || this, /** 具体语言对应的值 */ _this.locale = null, _this.__options = {}, _this._disabled = false, _this._active = false, _this._camelCaseName = '';
+        _this = EventEmitter.call(this) || this, /** 具体语言对应的值 */ _this.locale = null, _this.__options = {}, _this._disabled = false, _this._active = false, _this._camelCaseName = '', /** click 监听引用，销毁时需显式移除 */ _this._onClickHandler = null;
         _this.__options = options;
         _this.locale = getLocale(_this.__options.locales, _this.__options.language);
         _this._camelCaseName = _this.__options.classNameSuffix ? _this.__options.classNameSuffix.replace(/[-_\s]+(.)?/g, function(_, c) {
@@ -384,6 +384,12 @@ function _set_prototype_of$y(o, p) {
             this.emit("Control." + this._camelCaseName + "Destroy");
         }
         if (((_this___options = this.__options) == null ? void 0 : _this___options.controlType) !== 'block') this.$container.removeEventListener('dblclick', this._onDBlClick);
+        // 移除 click 监听
+        if (this._onClickHandler) {
+            var _this_$container1;
+            (_this_$container1 = this.$container) == null ? void 0 : _this_$container1.removeEventListener('click', this._onClickHandler);
+            this._onClickHandler = null;
+        }
         this._active = false;
         this.removeAllListeners();
         (_this_$container = this.$container) == null ? void 0 : (_this_$container_remove = _this_$container.remove) == null ? void 0 : _this_$container_remove.call(_this_$container);
@@ -412,14 +418,16 @@ function _set_prototype_of$y(o, p) {
    * 当点击 Control 时 触发子类的 _onControlClick
    */ _proto._onClick = function _onClick() {
         var _this = this;
-        this.$container.addEventListener('click', function(e) {
+        // 使用具名 handler 便于在 destroy 时精确移除，避免匿名监听残留
+        this._onClickHandler = function(e) {
             var _this_$container;
             // prettier-ignore
             if (!((_this_$container = _this.$container) == null ? void 0 : _this_$container.classList.contains("" + PREFIX_CLASS + "-disabled"))) {
                 // _onControlClick 来源自子类中
                 _this._onControlClick == null ? void 0 : _this._onControlClick.call(_this, e);
             }
-        });
+        };
+        this.$container.addEventListener('click', this._onClickHandler);
     };
     _proto._onDBlClick = function _onDBlClick(e) {
         e.stopPropagation();
@@ -4277,6 +4285,7 @@ function debounce(func, wait) {
             var // rerender 画面
             _theme_contentControl_emit, _theme_contentControl;
             (_theme_contentControl = theme.contentControl) == null ? void 0 : (_theme_contentControl_emit = _theme_contentControl.emit) == null ? void 0 : _theme_contentControl_emit.call(_theme_contentControl, EVENTS.videoInfo, info.width, info.height);
+            theme._videoInfo = info;
         }
     });
     theme == null ? void 0 : theme.on(EVENTS.resize, function() {
@@ -4608,8 +4617,14 @@ function debounce(func, wait) {
     }
     // 播放地址切换后同步 Live/RecDropdown 激活状态
     // changePlayUrl 后 urlInfo 已更新，firstFrameDisplay 表示新地址播放成功
+    // 注意：_controlEventemitter 每次 _renderTheme 都会执行，这里的监听挂在 theme 上，
+    // 必须先移除上一次的引用，避免 changeTheme 反复切换导致监听器无限累积（内存泄漏 + 重复执行）。
+    if (theme._onFirstFrameSync) {
+        theme.removeListener(EVENTS.firstFrameDisplay, theme._onFirstFrameSync);
+        theme._onFirstFrameSync = null;
+    }
     if (((_theme_controls11 = theme.controls) == null ? void 0 : _theme_controls11.liveControl) || ((_theme_controls12 = theme.controls) == null ? void 0 : _theme_controls12.recDropdownControl)) {
-        theme.on(EVENTS.firstFrameDisplay, function() {
+        theme._onFirstFrameSync = function() {
             var _theme_controls, _theme_controls1;
             var urlInfo = theme.urlInfo;
             if ((_theme_controls = theme.controls) == null ? void 0 : _theme_controls.liveControl) {
@@ -4618,7 +4633,8 @@ function debounce(func, wait) {
             if ((_theme_controls1 = theme.controls) == null ? void 0 : _theme_controls1.recDropdownControl) {
                 theme.controls.recDropdownControl._syncActiveByUrlInfo(urlInfo);
             }
-        });
+        };
+        theme.on(EVENTS.firstFrameDisplay, theme._onFirstFrameSync);
     }
     // 缩放控件
     if ((_theme_controls13 = theme.controls) == null ? void 0 : _theme_controls13.zoomControl) {
@@ -5191,15 +5207,20 @@ function _ts_generator$6(thisArg, body) {
  * @returns
  */ function getThemeDataByTemplate(theme, id) {
     return _async_to_generator$6(function() {
-        var _theme_options_token_httpToken, _theme_options_token, url;
+        var _theme_options_token_httpToken, _theme_options_token, // 中止上一个在途请求，并为本次请求创建可中止的信号（destroy 时会 abort）
+        _theme__templateAbortController, url, controller;
         return _ts_generator$6(this, function(_state) {
             switch(_state.label){
                 case 0:
                     url = theme.options.env.domain + "/api/service/media/template/getDetail?accessToken=" + (theme.options.accessToken || ((_theme_options_token = theme.options.token) == null ? void 0 : (_theme_options_token_httpToken = _theme_options_token.httpToken) == null ? void 0 : _theme_options_token_httpToken.url)) + "&id=" + id;
+                    (_theme__templateAbortController = theme._templateAbortController) == null ? void 0 : _theme__templateAbortController.abort();
+                    controller = new AbortController();
+                    theme._templateAbortController = controller;
                     return [
                         4,
                         fetch(url, {
-                            method: 'GET'
+                            method: 'GET',
+                            signal: controller == null ? void 0 : controller.signal
                         }).then(function(response) {
                             return _async_to_generator$6(function() {
                                 return _ts_generator$6(this, function(_state) {
@@ -5503,7 +5524,7 @@ function _filterLeftRightControls(btnList) {
  * @returns
  */ function getThemeData(theme, data) {
     return _async_to_generator$5(function() {
-        var themeData, _theme_logger, template;
+        var themeData, _theme_logger, template, e;
         return _ts_generator$5(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -5549,13 +5570,23 @@ function _filterLeftRightControls(btnList) {
                         2,
                         template
                     ];
+                    // 请求返回前已销毁则静默返回，不在已释放的 theme 上派发事件
+                    if (theme.destroyed) return [
+                        2,
+                        null
+                    ];
                     theme.emit(EVENTS.message, theme.i18n.t('FETCH_THEME_FAILED'), 'themeError');
                     return [
                         2,
                         null
                     ];
                 case 4:
-                    _state.sent();
+                    e = _state.sent();
+                    // 请求被中止（destroy/重新渲染）或已销毁：静默返回
+                    if (theme.destroyed || (e == null ? void 0 : e.name) === 'AbortError') return [
+                        2,
+                        null
+                    ];
                     theme.emit(EVENTS.message, theme.i18n.t('FETCH_THEME_FAILED'), 'themeError');
                     return [
                         2,
@@ -9245,6 +9276,11 @@ var _unmountedControls = function(theme) {
     if (theme._onPauseTimingFunc) {
         theme._onPauseTimingFunc = null;
     }
+    // 移除首帧同步监听（挂在 theme 上，需显式解绑，避免 changeTheme 累积）
+    if (theme._onFirstFrameSync) {
+        theme.removeListener(EVENTS.firstFrameDisplay, theme._onFirstFrameSync);
+        theme._onFirstFrameSync = null;
+    }
     if (hasControls) {
         theme.emit(EVENTS.control.unmountedControls);
     }
@@ -9515,6 +9551,10 @@ function _renderTheme(theme, data) {
                     ];
                 case 1:
                     themeData = _state.sent();
+                    // 异步获取主题数据期间可能已 destroy()，避免在已释放的 theme 上继续渲染/emit
+                    if (theme.destroyed) return [
+                        2
+                    ];
                     _unmountedControls(theme);
                     if (Object.prototype.toString.call(themeData) !== '[object Object]') {
                         // 主题空
@@ -10177,7 +10217,15 @@ var THEME_DEFAULT_OPTIONS = {
         // _recMonthObj: Record<string, string[]> = {};
         /**
    * 录像回放的月份列表 @private
-   */ _this.recMonth = [], /** 清理 header/footer 动画 定时器 @private */ _this._onPauseTimingFunc = null, /** 销毁标识  @readonly */ _this.destroyed = false, _this.scaleMode = 0;
+   */ _this.recMonth = [], /** 清理 header/footer 动画 定时器 @private */ _this._onPauseTimingFunc = null, /**
+   * 首帧同步 Live/RecDropdown 激活态的监听器引用。
+   * 每次 `_renderTheme` 重新绑定前需先移除旧引用，避免 changeTheme 累积监听。
+   * @private
+   */ _this._onFirstFrameSync = null, /**
+   * 模板请求（getDetail）的中止控制器。
+   * 重新渲染或销毁时中止在途请求，避免请求返回后在已销毁/已切换的 theme 上继续操作。
+   * @private
+   */ _this._templateAbortController = null, /** 销毁标识  @readonly */ _this.destroyed = false, _this.scaleMode = 0, _this._videoInfo = {};
         _this._initOptions(options);
         if (_this.options.type === 'ezopen') {
             var _this_urlInfo_searchParams1, _this_urlInfo1, _this_urlInfo2;
@@ -10220,7 +10268,7 @@ var THEME_DEFAULT_OPTIONS = {
         _this._muted = (_ref1 = (_this_options_volumeOptions_muted = (_this_options_volumeOptions1 = _this.options.volumeOptions) == null ? void 0 : _this_options_volumeOptions1.muted) != null ? _this_options_volumeOptions_muted : _this.options.muted) != null ? _ref1 : false;
         var _this_options_speedOptions_value, _ref2;
         // playbackSpeed 是 萤石标准流倍速字段
-        _this._speed = (_ref2 = (_this_options_speedOptions_value = (_this_options_speedOptions = _this.options.speedOptions) == null ? void 0 : _this_options_speedOptions.value) != null ? _this_options_speedOptions_value : (_this_urlInfo = _this.urlInfo) == null ? void 0 : (_this_urlInfo_searchParams = _this_urlInfo.searchParams) == null ? void 0 : _this_urlInfo_searchParams.playbackSpeed) != null ? _ref2 : 1;
+        _this._speed = +((_ref2 = (_this_options_speedOptions_value = (_this_options_speedOptions = _this.options.speedOptions) == null ? void 0 : _this_options_speedOptions.value) != null ? _this_options_speedOptions_value : (_this_urlInfo = _this.urlInfo) == null ? void 0 : (_this_urlInfo_searchParams = _this_urlInfo.searchParams) == null ? void 0 : _this_urlInfo_searchParams.playbackSpeed) != null ? _ref2 : 1);
         _this._mobileInnerWidthHeight = _this._mobileInnerWidthHeight.bind(_this);
         _this._throttleMobileInnerWidthHeight = throttle(_this._mobileInnerWidthHeight, 20).bind(_this);
         _this._onDblClickFullscreen = debounce(_this._onDblClickFullscreen, 20).bind(_this);
@@ -10432,12 +10480,15 @@ var THEME_DEFAULT_OPTIONS = {
    * ```
    */ _proto.destroy = function destroy() {
         var _this = this;
-        var _this_contentControl, _this_$container;
+        var // 中止在途的模板请求，避免其回调在已销毁的 theme 上继续执行
+        _this__templateAbortController, _this_contentControl, _this_$container;
         if (!this.$container || this.destroyed) {
             // 防止多次销毁
             return;
         }
         this.emit(EVENTS.theme.beforeDestroy);
+        (_this__templateAbortController = this._templateAbortController) == null ? void 0 : _this__templateAbortController.abort();
+        this._templateAbortController = null;
         this._removeEventListener();
         _unmountedControls(this);
         (_this_contentControl = this.contentControl) == null ? void 0 : _this_contentControl.destroy();
@@ -10458,6 +10509,8 @@ var THEME_DEFAULT_OPTIONS = {
         if (this.i18n) this.i18n = null;
         this.recType = '';
         this.recMonth = []; // 清空数据
+        // 重置
+        this._videoInfo = {};
         this.emit(EVENTS.theme.destroyed);
         this.removeAllListeners();
         if (this.logger) this.logger = null;
@@ -10470,7 +10523,12 @@ var THEME_DEFAULT_OPTIONS = {
     /** 初始化配置项 */ _proto._initOptions = function _initOptions(options) {
         if (options === void 0) options = {};
         var _this_options_loggerOptions, _this_options_definitionOptions_list, _this_options_definitionOptions, _this_options_videoLevelList;
-        this.options = deepmerge(THEME_DEFAULT_OPTIONS, options, {
+        // 先对模块级默认配置做一次深拷贝，得到全新的嵌套对象/数组，
+        // 避免 this.options 与 THEME_DEFAULT_OPTIONS（如 mobileExtendOptions.controls、env、loggerOptions）
+        // 共享引用而在多实例间相互污染。
+        // 仍对用户 options 使用 clone:false —— container 可能是 DOM 节点/函数，深拷贝会破坏它。
+        var defaults = deepmerge({}, THEME_DEFAULT_OPTIONS);
+        this.options = deepmerge(defaults, options, {
             clone: false
         });
         this._url = this.options.url;
@@ -10505,10 +10563,12 @@ var THEME_DEFAULT_OPTIONS = {
             this.logger.log('[options] \n', this.options);
         }
         var language = this.options.language || 'zh';
-        var locales = deepmerge({
+        // 深拷贝内置语言包，避免与模块级 zh/en 常量共享引用（I18n 若对其做合并/修改会污染全局）
+        var baseLocales = deepmerge({}, {
             zh: zh,
             en: en
-        }, this.options.locales || {}, {
+        });
+        var locales = deepmerge(baseLocales, this.options.locales || {}, {
             clone: false
         });
         // prettier-ignore
@@ -11074,6 +11134,41 @@ var THEME_DEFAULT_OPTIONS = {
                 return this._height;
             }
         },
+        {
+            key: "videoInfo",
+            get: /**
+   * 视频信息
+   * @version 3.1.2
+   * ```ts
+   * theme.videoInfo // ThemeVideoInfo
+   * ```
+   */ function get() {
+                return this._videoInfo || {};
+            }
+        },
+        {
+            key: "videoWidth",
+            get: /**
+   * 视频分辨率 宽
+   *
+   * @version 3.1.2
+   *
+   * ```ts
+   * theme.videoWidth // number
+   * ```
+   */ function get() {
+                return this._videoInfo.width || 0;
+            }
+        },
+        {
+            key: "videoHeight",
+            get: /**
+   * 视频分辨率 高
+   * @version 3.1.2
+   */ function get() {
+                return this._videoInfo.height || 0;
+            }
+        },
         {
             key: "playing",
             get: /**
@@ -11338,13 +11433,13 @@ var THEME_DEFAULT_OPTIONS = {
         {
             key: "speed",
             get: function get() {
-                return this._speed;
+                return +this._speed;
             },
             set: /**
    * 倍速
    */ function set(speed) {
                 speed = +speed;
-                if (speed !== this._speed) {
+                if (speed !== +this._speed) {
                     this._speed = speed;
                     this.emit(EVENTS.speedChange, speed);
                 }
@@ -11491,7 +11586,7 @@ var THEME_DEFAULT_OPTIONS = {
     zh: zh,
     en: en
 };
-/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.2-beta.2';
+/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.2-beta.4';
 
 exports.Control = Control;
 exports.EVENTS = EVENTS;

package/dist/index.esm.js

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.2-beta.2
-* Copyright (c) 2026-08-12 04:37:54 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.2-beta.4
+* Copyright (c) 2026-08-16 15:20:04 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 import EventEmitter from 'eventemitter3';
@@ -293,7 +293,7 @@ function _set_prototype_of$y(o, p) {
     function Control(options) {
         var _this;
         var _this___options;
-        _this = EventEmitter.call(this) || this, /** 具体语言对应的值 */ _this.locale = null, _this.__options = {}, _this._disabled = false, _this._active = false, _this._camelCaseName = '';
+        _this = EventEmitter.call(this) || this, /** 具体语言对应的值 */ _this.locale = null, _this.__options = {}, _this._disabled = false, _this._active = false, _this._camelCaseName = '', /** click 监听引用，销毁时需显式移除 */ _this._onClickHandler = null;
         _this.__options = options;
         _this.locale = getLocale(_this.__options.locales, _this.__options.language);
         _this._camelCaseName = _this.__options.classNameSuffix ? _this.__options.classNameSuffix.replace(/[-_\s]+(.)?/g, function(_, c) {
@@ -382,6 +382,12 @@ function _set_prototype_of$y(o, p) {
             this.emit("Control." + this._camelCaseName + "Destroy");
         }
         if (((_this___options = this.__options) == null ? void 0 : _this___options.controlType) !== 'block') this.$container.removeEventListener('dblclick', this._onDBlClick);
+        // 移除 click 监听
+        if (this._onClickHandler) {
+            var _this_$container1;
+            (_this_$container1 = this.$container) == null ? void 0 : _this_$container1.removeEventListener('click', this._onClickHandler);
+            this._onClickHandler = null;
+        }
         this._active = false;
         this.removeAllListeners();
         (_this_$container = this.$container) == null ? void 0 : (_this_$container_remove = _this_$container.remove) == null ? void 0 : _this_$container_remove.call(_this_$container);
@@ -410,14 +416,16 @@ function _set_prototype_of$y(o, p) {
    * 当点击 Control 时 触发子类的 _onControlClick
    */ _proto._onClick = function _onClick() {
         var _this = this;
-        this.$container.addEventListener('click', function(e) {
+        // 使用具名 handler 便于在 destroy 时精确移除，避免匿名监听残留
+        this._onClickHandler = function(e) {
             var _this_$container;
             // prettier-ignore
             if (!((_this_$container = _this.$container) == null ? void 0 : _this_$container.classList.contains("" + PREFIX_CLASS + "-disabled"))) {
                 // _onControlClick 来源自子类中
                 _this._onControlClick == null ? void 0 : _this._onControlClick.call(_this, e);
             }
-        });
+        };
+        this.$container.addEventListener('click', this._onClickHandler);
     };
     _proto._onDBlClick = function _onDBlClick(e) {
         e.stopPropagation();
@@ -4275,6 +4283,7 @@ function debounce(func, wait) {
             var // rerender 画面
             _theme_contentControl_emit, _theme_contentControl;
             (_theme_contentControl = theme.contentControl) == null ? void 0 : (_theme_contentControl_emit = _theme_contentControl.emit) == null ? void 0 : _theme_contentControl_emit.call(_theme_contentControl, EVENTS.videoInfo, info.width, info.height);
+            theme._videoInfo = info;
         }
     });
     theme == null ? void 0 : theme.on(EVENTS.resize, function() {
@@ -4606,8 +4615,14 @@ function debounce(func, wait) {
     }
     // 播放地址切换后同步 Live/RecDropdown 激活状态
     // changePlayUrl 后 urlInfo 已更新，firstFrameDisplay 表示新地址播放成功
+    // 注意：_controlEventemitter 每次 _renderTheme 都会执行，这里的监听挂在 theme 上，
+    // 必须先移除上一次的引用，避免 changeTheme 反复切换导致监听器无限累积（内存泄漏 + 重复执行）。
+    if (theme._onFirstFrameSync) {
+        theme.removeListener(EVENTS.firstFrameDisplay, theme._onFirstFrameSync);
+        theme._onFirstFrameSync = null;
+    }
     if (((_theme_controls11 = theme.controls) == null ? void 0 : _theme_controls11.liveControl) || ((_theme_controls12 = theme.controls) == null ? void 0 : _theme_controls12.recDropdownControl)) {
-        theme.on(EVENTS.firstFrameDisplay, function() {
+        theme._onFirstFrameSync = function() {
             var _theme_controls, _theme_controls1;
             var urlInfo = theme.urlInfo;
             if ((_theme_controls = theme.controls) == null ? void 0 : _theme_controls.liveControl) {
@@ -4616,7 +4631,8 @@ function debounce(func, wait) {
             if ((_theme_controls1 = theme.controls) == null ? void 0 : _theme_controls1.recDropdownControl) {
                 theme.controls.recDropdownControl._syncActiveByUrlInfo(urlInfo);
             }
-        });
+        };
+        theme.on(EVENTS.firstFrameDisplay, theme._onFirstFrameSync);
     }
     // 缩放控件
     if ((_theme_controls13 = theme.controls) == null ? void 0 : _theme_controls13.zoomControl) {
@@ -5189,15 +5205,20 @@ function _ts_generator$6(thisArg, body) {
  * @returns
  */ function getThemeDataByTemplate(theme, id) {
     return _async_to_generator$6(function() {
-        var _theme_options_token_httpToken, _theme_options_token, url;
+        var _theme_options_token_httpToken, _theme_options_token, // 中止上一个在途请求，并为本次请求创建可中止的信号（destroy 时会 abort）
+        _theme__templateAbortController, url, controller;
         return _ts_generator$6(this, function(_state) {
             switch(_state.label){
                 case 0:
                     url = theme.options.env.domain + "/api/service/media/template/getDetail?accessToken=" + (theme.options.accessToken || ((_theme_options_token = theme.options.token) == null ? void 0 : (_theme_options_token_httpToken = _theme_options_token.httpToken) == null ? void 0 : _theme_options_token_httpToken.url)) + "&id=" + id;
+                    (_theme__templateAbortController = theme._templateAbortController) == null ? void 0 : _theme__templateAbortController.abort();
+                    controller = new AbortController();
+                    theme._templateAbortController = controller;
                     return [
                         4,
                         fetch(url, {
-                            method: 'GET'
+                            method: 'GET',
+                            signal: controller == null ? void 0 : controller.signal
                         }).then(function(response) {
                             return _async_to_generator$6(function() {
                                 return _ts_generator$6(this, function(_state) {
@@ -5501,7 +5522,7 @@ function _filterLeftRightControls(btnList) {
  * @returns
  */ function getThemeData(theme, data) {
     return _async_to_generator$5(function() {
-        var themeData, _theme_logger, template;
+        var themeData, _theme_logger, template, e;
         return _ts_generator$5(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -5547,13 +5568,23 @@ function _filterLeftRightControls(btnList) {
                         2,
                         template
                     ];
+                    // 请求返回前已销毁则静默返回，不在已释放的 theme 上派发事件
+                    if (theme.destroyed) return [
+                        2,
+                        null
+                    ];
                     theme.emit(EVENTS.message, theme.i18n.t('FETCH_THEME_FAILED'), 'themeError');
                     return [
                         2,
                         null
                     ];
                 case 4:
-                    _state.sent();
+                    e = _state.sent();
+                    // 请求被中止（destroy/重新渲染）或已销毁：静默返回
+                    if (theme.destroyed || (e == null ? void 0 : e.name) === 'AbortError') return [
+                        2,
+                        null
+                    ];
                     theme.emit(EVENTS.message, theme.i18n.t('FETCH_THEME_FAILED'), 'themeError');
                     return [
                         2,
@@ -9243,6 +9274,11 @@ var _unmountedControls = function(theme) {
     if (theme._onPauseTimingFunc) {
         theme._onPauseTimingFunc = null;
     }
+    // 移除首帧同步监听（挂在 theme 上，需显式解绑，避免 changeTheme 累积）
+    if (theme._onFirstFrameSync) {
+        theme.removeListener(EVENTS.firstFrameDisplay, theme._onFirstFrameSync);
+        theme._onFirstFrameSync = null;
+    }
     if (hasControls) {
         theme.emit(EVENTS.control.unmountedControls);
     }
@@ -9513,6 +9549,10 @@ function _renderTheme(theme, data) {
                     ];
                 case 1:
                     themeData = _state.sent();
+                    // 异步获取主题数据期间可能已 destroy()，避免在已释放的 theme 上继续渲染/emit
+                    if (theme.destroyed) return [
+                        2
+                    ];
                     _unmountedControls(theme);
                     if (Object.prototype.toString.call(themeData) !== '[object Object]') {
                         // 主题空
@@ -10175,7 +10215,15 @@ var THEME_DEFAULT_OPTIONS = {
         // _recMonthObj: Record<string, string[]> = {};
         /**
    * 录像回放的月份列表 @private
-   */ _this.recMonth = [], /** 清理 header/footer 动画 定时器 @private */ _this._onPauseTimingFunc = null, /** 销毁标识  @readonly */ _this.destroyed = false, _this.scaleMode = 0;
+   */ _this.recMonth = [], /** 清理 header/footer 动画 定时器 @private */ _this._onPauseTimingFunc = null, /**
+   * 首帧同步 Live/RecDropdown 激活态的监听器引用。
+   * 每次 `_renderTheme` 重新绑定前需先移除旧引用，避免 changeTheme 累积监听。
+   * @private
+   */ _this._onFirstFrameSync = null, /**
+   * 模板请求（getDetail）的中止控制器。
+   * 重新渲染或销毁时中止在途请求，避免请求返回后在已销毁/已切换的 theme 上继续操作。
+   * @private
+   */ _this._templateAbortController = null, /** 销毁标识  @readonly */ _this.destroyed = false, _this.scaleMode = 0, _this._videoInfo = {};
         _this._initOptions(options);
         if (_this.options.type === 'ezopen') {
             var _this_urlInfo_searchParams1, _this_urlInfo1, _this_urlInfo2;
@@ -10218,7 +10266,7 @@ var THEME_DEFAULT_OPTIONS = {
         _this._muted = (_ref1 = (_this_options_volumeOptions_muted = (_this_options_volumeOptions1 = _this.options.volumeOptions) == null ? void 0 : _this_options_volumeOptions1.muted) != null ? _this_options_volumeOptions_muted : _this.options.muted) != null ? _ref1 : false;
         var _this_options_speedOptions_value, _ref2;
         // playbackSpeed 是 萤石标准流倍速字段
-        _this._speed = (_ref2 = (_this_options_speedOptions_value = (_this_options_speedOptions = _this.options.speedOptions) == null ? void 0 : _this_options_speedOptions.value) != null ? _this_options_speedOptions_value : (_this_urlInfo = _this.urlInfo) == null ? void 0 : (_this_urlInfo_searchParams = _this_urlInfo.searchParams) == null ? void 0 : _this_urlInfo_searchParams.playbackSpeed) != null ? _ref2 : 1;
+        _this._speed = +((_ref2 = (_this_options_speedOptions_value = (_this_options_speedOptions = _this.options.speedOptions) == null ? void 0 : _this_options_speedOptions.value) != null ? _this_options_speedOptions_value : (_this_urlInfo = _this.urlInfo) == null ? void 0 : (_this_urlInfo_searchParams = _this_urlInfo.searchParams) == null ? void 0 : _this_urlInfo_searchParams.playbackSpeed) != null ? _ref2 : 1);
         _this._mobileInnerWidthHeight = _this._mobileInnerWidthHeight.bind(_this);
         _this._throttleMobileInnerWidthHeight = throttle(_this._mobileInnerWidthHeight, 20).bind(_this);
         _this._onDblClickFullscreen = debounce(_this._onDblClickFullscreen, 20).bind(_this);
@@ -10430,12 +10478,15 @@ var THEME_DEFAULT_OPTIONS = {
    * ```
    */ _proto.destroy = function destroy() {
         var _this = this;
-        var _this_contentControl, _this_$container;
+        var // 中止在途的模板请求，避免其回调在已销毁的 theme 上继续执行
+        _this__templateAbortController, _this_contentControl, _this_$container;
         if (!this.$container || this.destroyed) {
             // 防止多次销毁
             return;
         }
         this.emit(EVENTS.theme.beforeDestroy);
+        (_this__templateAbortController = this._templateAbortController) == null ? void 0 : _this__templateAbortController.abort();
+        this._templateAbortController = null;
         this._removeEventListener();
         _unmountedControls(this);
         (_this_contentControl = this.contentControl) == null ? void 0 : _this_contentControl.destroy();
@@ -10456,6 +10507,8 @@ var THEME_DEFAULT_OPTIONS = {
         if (this.i18n) this.i18n = null;
         this.recType = '';
         this.recMonth = []; // 清空数据
+        // 重置
+        this._videoInfo = {};
         this.emit(EVENTS.theme.destroyed);
         this.removeAllListeners();
         if (this.logger) this.logger = null;
@@ -10468,7 +10521,12 @@ var THEME_DEFAULT_OPTIONS = {
     /** 初始化配置项 */ _proto._initOptions = function _initOptions(options) {
         if (options === void 0) options = {};
         var _this_options_loggerOptions, _this_options_definitionOptions_list, _this_options_definitionOptions, _this_options_videoLevelList;
-        this.options = deepmerge(THEME_DEFAULT_OPTIONS, options, {
+        // 先对模块级默认配置做一次深拷贝，得到全新的嵌套对象/数组，
+        // 避免 this.options 与 THEME_DEFAULT_OPTIONS（如 mobileExtendOptions.controls、env、loggerOptions）
+        // 共享引用而在多实例间相互污染。
+        // 仍对用户 options 使用 clone:false —— container 可能是 DOM 节点/函数，深拷贝会破坏它。
+        var defaults = deepmerge({}, THEME_DEFAULT_OPTIONS);
+        this.options = deepmerge(defaults, options, {
             clone: false
         });
         this._url = this.options.url;
@@ -10503,10 +10561,12 @@ var THEME_DEFAULT_OPTIONS = {
             this.logger.log('[options] \n', this.options);
         }
         var language = this.options.language || 'zh';
-        var locales = deepmerge({
+        // 深拷贝内置语言包，避免与模块级 zh/en 常量共享引用（I18n 若对其做合并/修改会污染全局）
+        var baseLocales = deepmerge({}, {
             zh: zh,
             en: en
-        }, this.options.locales || {}, {
+        });
+        var locales = deepmerge(baseLocales, this.options.locales || {}, {
             clone: false
         });
         // prettier-ignore
@@ -11072,6 +11132,41 @@ var THEME_DEFAULT_OPTIONS = {
                 return this._height;
             }
         },
+        {
+            key: "videoInfo",
+            get: /**
+   * 视频信息
+   * @version 3.1.2
+   * ```ts
+   * theme.videoInfo // ThemeVideoInfo
+   * ```
+   */ function get() {
+                return this._videoInfo || {};
+            }
+        },
+        {
+            key: "videoWidth",
+            get: /**
+   * 视频分辨率 宽
+   *
+   * @version 3.1.2
+   *
+   * ```ts
+   * theme.videoWidth // number
+   * ```
+   */ function get() {
+                return this._videoInfo.width || 0;
+            }
+        },
+        {
+            key: "videoHeight",
+            get: /**
+   * 视频分辨率 高
+   * @version 3.1.2
+   */ function get() {
+                return this._videoInfo.height || 0;
+            }
+        },
         {
             key: "playing",
             get: /**
@@ -11336,13 +11431,13 @@ var THEME_DEFAULT_OPTIONS = {
         {
             key: "speed",
             get: function get() {
-                return this._speed;
+                return +this._speed;
             },
             set: /**
    * 倍速
    */ function set(speed) {
                 speed = +speed;
-                if (speed !== this._speed) {
+                if (speed !== +this._speed) {
                     this._speed = speed;
                     this.emit(EVENTS.speedChange, speed);
                 }
@@ -11489,6 +11584,6 @@ var THEME_DEFAULT_OPTIONS = {
     zh: zh,
     en: en
 };
-/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.2-beta.2';
+/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.2-beta.4';
 
 export { Control, EVENTS, Fullscreen, Loading, Message, Play, Poster, Rec, Theme, Utils, Volume };