@ezuikit/player-theme 3.1.3-beta.1 → 3.1.3-beta.2

package/dist/constant.js

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.3-beta.1
-* Copyright (c) 2026-08-19 16:47:24 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.3-beta.2
+* Copyright (c) 2026-08-19 17:37:07 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 /**

package/dist/index.cjs

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.3-beta.1
-* Copyright (c) 2026-08-19 16:47:24 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.3-beta.2
+* Copyright (c) 2026-08-19 17:37:07 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 'use strict';
@@ -9843,9 +9843,8 @@ function _renderTheme(theme, data) {
                     _needTimeLine = list.some(function(item) {
                         return REC_GROUP.includes(item.iconId) || item.iconId === 'recDropdown';
                     }) && ((_theme_urlInfo = theme.urlInfo) == null ? void 0 : _theme_urlInfo.type) === 'rec';
-                    // 处于播放区间约束中时不渲染日历：区间必然在同一天内，切到任何其它日期都会越界
                     _hasPlaybackRange = !!((_theme_playbackRange = theme.playbackRange) == null ? void 0 : _theme_playbackRange.begin) && !!((_theme_playbackRange1 = theme.playbackRange) == null ? void 0 : _theme_playbackRange1.end);
-                    _needDatePicker = theme.options.dateOptions !== null && !_hasPlaybackRange;
+                    _needDatePicker = theme.options.dateOptions !== null;
                     theme.$container.classList.remove("" + PREFIX_CLASS + "-has-time-line");
                     // PC 单独渲染timeLine
                     if (!Utils.isMobile && !(theme.options.timeLineOptions === null || theme.options.disabledTimeLine) && _needTimeLine) {
@@ -10382,7 +10381,7 @@ var THEME_DEFAULT_OPTIONS = {
    */ _this._footerMoreControl = null, /** 头部控件 @since 0.0.1 @private */ _this._header = null, /** 低部控件 @since 0.0.1 @private */ _this._footer = null, /** 回放底部时间轴 @since 0.0.1 @private */ _this._recFooter = null, /**
    * 移动端扩展容器, 扩展的控件渲染在指定容器以外， 仅只用端适用， 为了可以放置大的控件和方便开发接入
    * @private
-   */ _this._mobileExtend = null, /**  @since 0.0.1 @private */ _this._interactiveResult = null, /**  @since 0.0.1 @private */ _this._themeData = null, _this._fullscreen = null, _this.zoomUtil = null, /** 清除屏幕旋转 */ _this._cleanupOrientation = null, /**  resizeObserver 监听销毁 */ _this._cleanUpResizeObserver = null, /** 容器的宽 */ _this._width = 0, /** 容器的高 */ _this._height = 0, /** 当前容器的全屏状态  true: 全屏， false: 非全屏 */ _this._isCurrentFullscreen = false, /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */ _this._orientationAngle = 0, _this._url = '', /** 是否播放中 @private */ _this._playing = false, /** @private 加载中 */ _this._loading = false, /** 音量 */ _this._volume = 0, /** 静音 */ _this._muted = false, /** 电子放大倍数 @private */ _this._zoom = 1, /** 放大中  true: 可缩放状态，false: 禁止缩放状态(不能缩放) @private */ _this._zooming = false, /** 录制中 @private */ _this._recording = false, /** 对讲中 @private */ _this._talking = false, /** 倍速 @private */ _this._speed = 1, /** 自定清晰度 @private */ _this._videoLevelAuto = false, /** 清晰度列表 */ _this.videoLevelList = [], /** 回放片段列表 */ _this.recordList = [], /**
+   */ _this._mobileExtend = null, /**  @since 0.0.1 @private */ _this._interactiveResult = null, /**  @since 0.0.1 @private */ _this._themeData = null, _this._fullscreen = null, _this.zoomUtil = null, /** 清除屏幕旋转 */ _this._cleanupOrientation = null, /**  resizeObserver 监听销毁 */ _this._cleanUpResizeObserver = null, /** 容器的宽 */ _this._width = 0, /** 容器的高 */ _this._height = 0, /** 当前容器的全屏状态  true: 全屏， false: 非全屏 */ _this._isCurrentFullscreen = false, /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */ _this._orientationAngle = 0, _this._url = '', _this._urlInfoCache = null, /** 是否播放中 @private */ _this._playing = false, /** @private 加载中 */ _this._loading = false, /** 音量 */ _this._volume = 0, /** 静音 */ _this._muted = false, /** 电子放大倍数 @private */ _this._zoom = 1, /** 放大中  true: 可缩放状态，false: 禁止缩放状态(不能缩放) @private */ _this._zooming = false, /** 录制中 @private */ _this._recording = false, /** 对讲中 @private */ _this._talking = false, /** 倍速 @private */ _this._speed = 1, /** 自定清晰度 @private */ _this._videoLevelAuto = false, /** 清晰度列表 */ _this.videoLevelList = [], /** 回放片段列表 */ _this.recordList = [], /**
    * 播放区间（片段分享），null 表示不约束。
    * 由 SDK 层在初始化时通过 props 下发，主题层据此决定日历/回放类型按钮
    * 是否渲染、片段进度条是否渲染。区间没有运行时变更入口。
@@ -11283,10 +11282,16 @@ var THEME_DEFAULT_OPTIONS = {
             get: /**
    * url 信息 播放地址信息
    */ function get() {
+                if (this._urlInfoCache) {
+                    return this._urlInfoCache;
+                }
                 if (this._url) {
                     return utilsTools.parseEzopenUrl(this._url);
                 }
                 return {};
+            },
+            set: function set(info) {
+                this._urlInfoCache = info;
             }
         },
         {
@@ -11321,6 +11326,9 @@ var THEME_DEFAULT_OPTIONS = {
    * ```
    */ function get() {
                 return this._videoInfo || {};
+            },
+            set: function set(info) {
+                this._videoInfo = info;
             }
         },
         {
@@ -11763,7 +11771,7 @@ var THEME_DEFAULT_OPTIONS = {
     zh: zh,
     en: en
 };
-/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.3-beta.1';
+/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.3-beta.2';
 
 exports.Control = Control;
 exports.EVENTS = EVENTS;

package/dist/index.esm.js

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.3-beta.1
-* Copyright (c) 2026-08-19 16:47:24 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.3-beta.2
+* Copyright (c) 2026-08-19 17:37:07 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 import EventEmitter from 'eventemitter3';
@@ -9841,9 +9841,8 @@ function _renderTheme(theme, data) {
                     _needTimeLine = list.some(function(item) {
                         return REC_GROUP.includes(item.iconId) || item.iconId === 'recDropdown';
                     }) && ((_theme_urlInfo = theme.urlInfo) == null ? void 0 : _theme_urlInfo.type) === 'rec';
-                    // 处于播放区间约束中时不渲染日历：区间必然在同一天内，切到任何其它日期都会越界
                     _hasPlaybackRange = !!((_theme_playbackRange = theme.playbackRange) == null ? void 0 : _theme_playbackRange.begin) && !!((_theme_playbackRange1 = theme.playbackRange) == null ? void 0 : _theme_playbackRange1.end);
-                    _needDatePicker = theme.options.dateOptions !== null && !_hasPlaybackRange;
+                    _needDatePicker = theme.options.dateOptions !== null;
                     theme.$container.classList.remove("" + PREFIX_CLASS + "-has-time-line");
                     // PC 单独渲染timeLine
                     if (!Utils.isMobile && !(theme.options.timeLineOptions === null || theme.options.disabledTimeLine) && _needTimeLine) {
@@ -10380,7 +10379,7 @@ var THEME_DEFAULT_OPTIONS = {
    */ _this._footerMoreControl = null, /** 头部控件 @since 0.0.1 @private */ _this._header = null, /** 低部控件 @since 0.0.1 @private */ _this._footer = null, /** 回放底部时间轴 @since 0.0.1 @private */ _this._recFooter = null, /**
    * 移动端扩展容器, 扩展的控件渲染在指定容器以外， 仅只用端适用， 为了可以放置大的控件和方便开发接入
    * @private
-   */ _this._mobileExtend = null, /**  @since 0.0.1 @private */ _this._interactiveResult = null, /**  @since 0.0.1 @private */ _this._themeData = null, _this._fullscreen = null, _this.zoomUtil = null, /** 清除屏幕旋转 */ _this._cleanupOrientation = null, /**  resizeObserver 监听销毁 */ _this._cleanUpResizeObserver = null, /** 容器的宽 */ _this._width = 0, /** 容器的高 */ _this._height = 0, /** 当前容器的全屏状态  true: 全屏， false: 非全屏 */ _this._isCurrentFullscreen = false, /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */ _this._orientationAngle = 0, _this._url = '', /** 是否播放中 @private */ _this._playing = false, /** @private 加载中 */ _this._loading = false, /** 音量 */ _this._volume = 0, /** 静音 */ _this._muted = false, /** 电子放大倍数 @private */ _this._zoom = 1, /** 放大中  true: 可缩放状态，false: 禁止缩放状态(不能缩放) @private */ _this._zooming = false, /** 录制中 @private */ _this._recording = false, /** 对讲中 @private */ _this._talking = false, /** 倍速 @private */ _this._speed = 1, /** 自定清晰度 @private */ _this._videoLevelAuto = false, /** 清晰度列表 */ _this.videoLevelList = [], /** 回放片段列表 */ _this.recordList = [], /**
+   */ _this._mobileExtend = null, /**  @since 0.0.1 @private */ _this._interactiveResult = null, /**  @since 0.0.1 @private */ _this._themeData = null, _this._fullscreen = null, _this.zoomUtil = null, /** 清除屏幕旋转 */ _this._cleanupOrientation = null, /**  resizeObserver 监听销毁 */ _this._cleanUpResizeObserver = null, /** 容器的宽 */ _this._width = 0, /** 容器的高 */ _this._height = 0, /** 当前容器的全屏状态  true: 全屏， false: 非全屏 */ _this._isCurrentFullscreen = false, /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */ _this._orientationAngle = 0, _this._url = '', _this._urlInfoCache = null, /** 是否播放中 @private */ _this._playing = false, /** @private 加载中 */ _this._loading = false, /** 音量 */ _this._volume = 0, /** 静音 */ _this._muted = false, /** 电子放大倍数 @private */ _this._zoom = 1, /** 放大中  true: 可缩放状态，false: 禁止缩放状态(不能缩放) @private */ _this._zooming = false, /** 录制中 @private */ _this._recording = false, /** 对讲中 @private */ _this._talking = false, /** 倍速 @private */ _this._speed = 1, /** 自定清晰度 @private */ _this._videoLevelAuto = false, /** 清晰度列表 */ _this.videoLevelList = [], /** 回放片段列表 */ _this.recordList = [], /**
    * 播放区间（片段分享），null 表示不约束。
    * 由 SDK 层在初始化时通过 props 下发，主题层据此决定日历/回放类型按钮
    * 是否渲染、片段进度条是否渲染。区间没有运行时变更入口。
@@ -11281,10 +11280,16 @@ var THEME_DEFAULT_OPTIONS = {
             get: /**
    * url 信息 播放地址信息
    */ function get() {
+                if (this._urlInfoCache) {
+                    return this._urlInfoCache;
+                }
                 if (this._url) {
                     return parseEzopenUrl(this._url);
                 }
                 return {};
+            },
+            set: function set(info) {
+                this._urlInfoCache = info;
             }
         },
         {
@@ -11319,6 +11324,9 @@ var THEME_DEFAULT_OPTIONS = {
    * ```
    */ function get() {
                 return this._videoInfo || {};
+            },
+            set: function set(info) {
+                this._videoInfo = info;
             }
         },
         {
@@ -11761,6 +11769,6 @@ var THEME_DEFAULT_OPTIONS = {
     zh: zh,
     en: en
 };
-/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.3-beta.1';
+/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.3-beta.2';
 
 export { Control, EVENTS, Fullscreen, Loading, Message, Play, Poster, Rec, Theme, Utils, Volume };

package/dist/index.umd.js

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.3-beta.1
-* Copyright (c) 2026-08-19 16:47:24 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.3-beta.2
+* Copyright (c) 2026-08-19 17:37:07 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 (function (global, factory) {
@@ -11842,9 +11842,8 @@
 	                    _needTimeLine = list.some(function(item) {
 	                        return REC_GROUP.includes(item.iconId) || item.iconId === 'recDropdown';
 	                    }) && ((_theme_urlInfo = theme.urlInfo) == null ? void 0 : _theme_urlInfo.type) === 'rec';
-	                    // 处于播放区间约束中时不渲染日历：区间必然在同一天内，切到任何其它日期都会越界
 	                    _hasPlaybackRange = !!((_theme_playbackRange = theme.playbackRange) == null ? void 0 : _theme_playbackRange.begin) && !!((_theme_playbackRange1 = theme.playbackRange) == null ? void 0 : _theme_playbackRange1.end);
-	                    _needDatePicker = theme.options.dateOptions !== null && !_hasPlaybackRange;
+	                    _needDatePicker = theme.options.dateOptions !== null;
 	                    theme.$container.classList.remove("" + PREFIX_CLASS$1 + "-has-time-line");
 	                    // PC 单独渲染timeLine
 	                    if (!Utils.isMobile && !(theme.options.timeLineOptions === null || theme.options.disabledTimeLine) && _needTimeLine) {
@@ -12381,7 +12380,7 @@
 	   */ _this._footerMoreControl = null, /** 头部控件 @since 0.0.1 @private */ _this._header = null, /** 低部控件 @since 0.0.1 @private */ _this._footer = null, /** 回放底部时间轴 @since 0.0.1 @private */ _this._recFooter = null, /**
 	   * 移动端扩展容器, 扩展的控件渲染在指定容器以外， 仅只用端适用， 为了可以放置大的控件和方便开发接入
 	   * @private
-	   */ _this._mobileExtend = null, /**  @since 0.0.1 @private */ _this._interactiveResult = null, /**  @since 0.0.1 @private */ _this._themeData = null, _this._fullscreen = null, _this.zoomUtil = null, /** 清除屏幕旋转 */ _this._cleanupOrientation = null, /**  resizeObserver 监听销毁 */ _this._cleanUpResizeObserver = null, /** 容器的宽 */ _this._width = 0, /** 容器的高 */ _this._height = 0, /** 当前容器的全屏状态  true: 全屏， false: 非全屏 */ _this._isCurrentFullscreen = false, /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */ _this._orientationAngle = 0, _this._url = '', /** 是否播放中 @private */ _this._playing = false, /** @private 加载中 */ _this._loading = false, /** 音量 */ _this._volume = 0, /** 静音 */ _this._muted = false, /** 电子放大倍数 @private */ _this._zoom = 1, /** 放大中  true: 可缩放状态，false: 禁止缩放状态(不能缩放) @private */ _this._zooming = false, /** 录制中 @private */ _this._recording = false, /** 对讲中 @private */ _this._talking = false, /** 倍速 @private */ _this._speed = 1, /** 自定清晰度 @private */ _this._videoLevelAuto = false, /** 清晰度列表 */ _this.videoLevelList = [], /** 回放片段列表 */ _this.recordList = [], /**
+	   */ _this._mobileExtend = null, /**  @since 0.0.1 @private */ _this._interactiveResult = null, /**  @since 0.0.1 @private */ _this._themeData = null, _this._fullscreen = null, _this.zoomUtil = null, /** 清除屏幕旋转 */ _this._cleanupOrientation = null, /**  resizeObserver 监听销毁 */ _this._cleanUpResizeObserver = null, /** 容器的宽 */ _this._width = 0, /** 容器的高 */ _this._height = 0, /** 当前容器的全屏状态  true: 全屏， false: 非全屏 */ _this._isCurrentFullscreen = false, /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */ _this._orientationAngle = 0, _this._url = '', _this._urlInfoCache = null, /** 是否播放中 @private */ _this._playing = false, /** @private 加载中 */ _this._loading = false, /** 音量 */ _this._volume = 0, /** 静音 */ _this._muted = false, /** 电子放大倍数 @private */ _this._zoom = 1, /** 放大中  true: 可缩放状态，false: 禁止缩放状态(不能缩放) @private */ _this._zooming = false, /** 录制中 @private */ _this._recording = false, /** 对讲中 @private */ _this._talking = false, /** 倍速 @private */ _this._speed = 1, /** 自定清晰度 @private */ _this._videoLevelAuto = false, /** 清晰度列表 */ _this.videoLevelList = [], /** 回放片段列表 */ _this.recordList = [], /**
 	   * 播放区间（片段分享），null 表示不约束。
 	   * 由 SDK 层在初始化时通过 props 下发，主题层据此决定日历/回放类型按钮
 	   * 是否渲染、片段进度条是否渲染。区间没有运行时变更入口。
@@ -13282,10 +13281,16 @@
 	            get: /**
 	   * url 信息 播放地址信息
 	   */ function get() {
+	                if (this._urlInfoCache) {
+	                    return this._urlInfoCache;
+	                }
 	                if (this._url) {
 	                    return distExports$3.parseEzopenUrl(this._url);
 	                }
 	                return {};
+	            },
+	            set: function set(info) {
+	                this._urlInfoCache = info;
 	            }
 	        },
 	        {
@@ -13320,6 +13325,9 @@
 	   * ```
 	   */ function get() {
 	                return this._videoInfo || {};
+	            },
+	            set: function set(info) {
+	                this._videoInfo = info;
 	            }
 	        },
 	        {
@@ -13762,7 +13770,7 @@
 	    zh: zh,
 	    en: en
 	};
-	/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.3-beta.1';
+	/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.3-beta.2';
 
 	// 不要动这里的代码， 这个出口是为了编译成 umd 规范的文件
 

package/dist/style.js

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.3-beta.1
-* Copyright (c) 2026-08-19 16:47:24 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.3-beta.2
+* Copyright (c) 2026-08-19 17:37:07 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 require("./style.css");

package/dist/types/index.d.ts

@@ -4,7 +4,6 @@ import I18n, { I18nTranslation } from '@ezuikit/utils-i18n';
 import { LoggerCls, LoggerOptions } from '@ezuikit/utils-logger';
 import { BasePtzOptions } from '@ezuikit/control-ptz';
 import { RecListModalOptions } from '@ezuikit/control-rec-list-modal';
-import * as _ezuikit_utils_tools from '@ezuikit/utils-tools';
 import Zoom from '@ezuikit/control-zoom';
 import { TimeLineTimeSection } from '@ezuikit/control-time-line';
 import { TimePickerOptions } from '@ezuikit/control-date-picker';
@@ -1544,7 +1543,7 @@ declare class Theme extends EventEmitter {
             readonly volumeDestroy: "Control.volumeDestroy";
             readonly controlsBarOpenChange: "Control.controlsBarOpenChange";
             readonly headerMoreShowControlsChange: "Control.headerMoreShowControlsChange";
-            readonly headerMorePanelOpenChange: "Control.headerMorePanelOpenChange"; /** 电子放大倍数 @private */
+            readonly headerMorePanelOpenChange: "Control.headerMorePanelOpenChange";
             readonly footerMoreShowControlsChange: "Control.footerMoreShowControlsChange";
             readonly footerMorePanelOpenChange: "Control.footerMorePanelOpenChange";
             readonly deviceDestroy: "Control.deviceDestroy";
@@ -1553,12 +1552,22 @@ declare class Theme extends EventEmitter {
             readonly definitionChange: "Control.definitionChange";
             readonly definitionList: "Control.definitionList";
             readonly definitionPanelOpenChange: "Control.definitionPanelOpenChange";
+            /**
+             * 录像回放的月份列表 @private
+             */
             readonly definitionDestroy: "Control.definitionDestroy";
             readonly speedChange: "Control.speedChange";
+            /**
+             * 录像回放的月份列表 @private
+             */
             readonly speedPanelOpenChange: "Control.speedPanelOpenChange";
             readonly speedDestroy: "Control.speedDestroy";
             readonly ptzPanelOpenChange: "Control.ptzPanelOpenChange";
-            readonly ptzSpeedChange: "Control.ptzSpeedChange";
+            readonly ptzSpeedChange: "Control.ptzSpeedChange"; /**
+             * 首帧同步 Live/RecDropdown 激活态的监听器引用。
+             * 每次 `_renderTheme` 重新绑定前需先移除旧引用，避免 changeTheme 累积监听。
+             * @private
+             */
             readonly ptzError: "Control.ptzError";
             readonly ptzDestroy: "Control.ptzDestroy";
             readonly recordingChange: "Control.recordingChange";
@@ -1850,7 +1859,7 @@ declare class Theme extends EventEmitter {
             ZOOM_NOT_ENABLED: string;
             '3D_ZOOM': string;
             '3D_ZOOM_DISABLE': string;
-            '3D_ZOOM_FAILED': string;
+            '3D_ZOOM_FAILED': string; /** 音量 */
             START_3D_ZOOM: string;
             CLOSE_3D_ZOOM: string;
             DEVICE_NOT_SUPPORT_3D_ZOOM: string;
@@ -1865,7 +1874,11 @@ declare class Theme extends EventEmitter {
             WEB_FULLSCREEN_EXIT: string;
             DESTROY: string;
             GET_CAPACITY: string;
-            GET_PTZ_STATUS: string;
+            GET_PTZ_STATUS: string; /**
+             * 播放区间（片段分享），null 表示不约束。
+             * 由 SDK 层在初始化时通过 props 下发，主题层据此决定日历/回放类型按钮
+             * 是否渲染、片段进度条是否渲染。区间没有运行时变更入口。
+             */
             GET_PTZ_STATUS_FAILED: string;
             MOBILE_HIDE_PTZ: string;
             OPTION_PTZ_FAILED: string;
@@ -1873,7 +1886,8 @@ declare class Theme extends EventEmitter {
             PTZ_FAST: string;
             PTZ_MID: string;
             PTZ_SLOW: string;
-            PTZ_SPEED: string; /**
+            PTZ_SPEED: string;
+            DEVICE_ZOOM: string; /**
             //  * 记录回放的月份
             //  *
             //  * key: {序列号}_{通道号}_{rec | cloud | cloudRecord}   比如：BC7799091_1_rec  BC7799091_1_cloud BC7799091_1_cloudRecord
@@ -1881,20 +1895,10 @@ declare class Theme extends EventEmitter {
             //  * value: 月份列表  比如 ["2025-12-01", "2025-12-02"]
             //  * @private
             //  */
-            /**
-             * 录像回放的月份列表 @private
-             */
-            DEVICE_ZOOM: string;
-            /**
-             * 录像回放的月份列表 @private
-             */
             DEVICE_FOCUS: string;
             NOT_SUPPORT_DEVICE_ZOOM: string;
             NOT_SUPPORT_FOCUS: string;
             MIRROR: string;
-            /**
-             * 录像回放的月份列表 @private
-             */
             MIRROR_TYPE_ERROR: string;
             CHANGE_FEC_TYPE: string;
             DEVICE_NOT_SUPPORT: string;
@@ -2027,27 +2031,32 @@ declare class Theme extends EventEmitter {
             396508: string;
             396509: string;
             396510: string;
-            396511: string;
-            396512: string;
-            396513: string;
+            396511: string; /** 静音 */
+            396512: string; /** 放大中  true: 可缩放状态，false: 禁止缩放状态(不能缩放) @private */
+            396513: string; /** 录制中 @private */
             396514: string;
             396515: string;
-            396516: string;
+            396516: string; /** 回放片段列表 */
             396517: string;
             396518: string;
             396519: string;
             396520: string;
             396700: string;
-            /**
-             * 录像回放的月份列表 @private
-             */
             396701: string;
             397001: string;
             397002: string;
             397003: string;
-            397004: string;
+            397004: string; /**
+             * 首帧同步 Live/RecDropdown 激活态的监听器引用。
+             * 每次 `_renderTheme` 重新绑定前需先移除旧引用，避免 changeTheme 累积监听。
+             * @private
+             */
             397005: string;
-            397006: string;
+            397006: string; /**
+             * 模板请求（getDetail）的中止控制器。
+             * 重新渲染或销毁时中止在途请求，避免请求返回后在已销毁/已切换的 theme 上继续操作。
+             * @private
+             */
             397007: string;
             399000: string;
             399001: string;
@@ -2123,40 +2132,29 @@ declare class Theme extends EventEmitter {
             VIDEO_LEVEL_HEIGH: string;
             VIDEO_LEVEL_SUPER: string;
             VIDEO_LEVEL_EXTREME: string;
-            /**
-             * 视频信息
-             * @version 3.1.2
-             * ```ts
-             * theme.videoInfo // ThemeVideoInfo
-             * ```
-             */
             VIDEO_LEVEL_3K: string;
             VIDEO_LEVEL_4k: string;
             RESET_THEME: string;
             BTN_PLAY: string;
             BTN_PAUSE: string;
             BTN_VOLUME: string;
-            BTN_MUTED: string; /**
-             * 视频分辨率 宽
-             *
-             * @version 3.1.2
-             *
-             * ```ts
-             * theme.videoWidth // number
-             * ```
-             */
+            BTN_MUTED: string;
             BTN_RECORDVIDEO: string;
             BTN_CAPTURE: string;
             BTN_TALK: string;
             BTN_BROADCAST: string;
             BTN_AICHAT: string;
             BTN_LIVE: string;
-            /**
-             * 视频分辨率 高
+            BTN_REC_DROPDOWN: string;
+            BTN_ALARM_MESSAGE: string; /**
+             * 视频分辨率 宽
+             *
              * @version 3.1.2
+             *
+             * ```ts
+             * theme.videoWidth // number
+             * ```
              */
-            BTN_REC_DROPDOWN: string;
-            BTN_ALARM_MESSAGE: string;
             REC_DROPDOWN_CLOUD_REC: string;
             REC_DROPDOWN_CLOUD_RECORD: string;
             REC_DROPDOWN_LOCAL_REC: string;
@@ -2197,6 +2195,13 @@ declare class Theme extends EventEmitter {
             ZOOM_SUB: string;
             ZOOM_ADD_MAX: string;
             ZOOM_SUB_MIN: string;
+            /**
+             * 加载状态
+             * ```ts
+             * // 事件监听
+             * theme.on(Theme.EVENTS.loading, (loading: boolean) => {})
+             * ```
+             */
             ZOOM_LIMIT_MAX: string;
             ZOOM_LIMIT_MIN: string;
             ZOOM_NOT_ENABLED: string;
@@ -2327,6 +2332,7 @@ declare class Theme extends EventEmitter {
     /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */
     private _orientationAngle;
     _url: string;
+    _urlInfoCache: any;
     /** 是否播放中 @private */
     _playing: boolean;
     /** @private 加载中 */
@@ -2390,7 +2396,8 @@ declare class Theme extends EventEmitter {
     /**
      * url 信息 播放地址信息
      */
-    get urlInfo(): Partial<_ezuikit_utils_tools.EzopenURL>;
+    get urlInfo(): any;
+    set urlInfo(info: any);
     /**
      * 容器的宽(单位 px)
      * ```ts
@@ -2413,6 +2420,7 @@ declare class Theme extends EventEmitter {
      * ```
      */
     get videoInfo(): ThemeVideoInfo;
+    set videoInfo(info: ThemeVideoInfo);
     /**
      * 视频分辨率 宽
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezuikit/player-theme",
-  "version": "3.1.3-beta.1",
+  "version": "3.1.3-beta.2",
   "description": "player theme",
   "title": "theme",
   "main": "dist/index.cjs",