@ezuikit/player-theme 3.1.6 → 3.1.7-beta.1

package/dist/index.esm.js

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.6
-* Copyright (c) 2026-09-18 12:22:27 Ezviz-OpenBiz
+* @ezuikit/player-theme v3.1.7-beta.1
+* Copyright (c) 2026-09-23 13:45:09 Ezviz-OpenBiz
 * Released under the MIT License.
 */
 import EventEmitter from 'eventemitter3';
@@ -18,6 +18,16 @@ import { DatePicker, TimePicker } from '@ezuikit/control-date-picker';
 import { MobileTimeLine, TimeLine } from '@ezuikit/control-time-line';
 import SegmentProgress from '@ezuikit/control-segment-progress';
 
+function _extends$z() {
+    _extends$z = Object.assign || function assign(target) {
+        for(var i = 1; i < arguments.length; i++){
+            var source = arguments[i];
+            for(var key in source)if (Object.prototype.hasOwnProperty.call(source, key)) target[key] = source[key];
+        }
+        return target;
+    };
+    return _extends$z.apply(this, arguments);
+}
 /**
  * 播放器的类名前缀
  */ var PREFIX_CLASS = 'ezplayer';
@@ -97,6 +107,54 @@ var THEME_PROPS = [
     'date',
     'segmentProgress'
 ];
+/**
+ * 全部播放类型：直播 + 三种回放
+ *
+ * 控件用静态属性 `supportedPlayTypes` 声明支持范围，默认取本数组（即全支持）。
+ * 与 {@link REC_GROUP} 的区别：REC_GROUP 是「回放类型切换控件的 iconId 分组」，
+ * 这里是「播放地址实际解析出的播放类型」，两者取值恰好在回放侧重合。
+ */ var PLAY_TYPES = [
+    'live',
+    'rec',
+    'cloudRec',
+    'cloudRecord'
+];
+/**
+ * 控件初始化完成事件名
+ *
+ * 键与 `Controls`（`src/Controls/index.ts`）的键一一对应，值为 `Control.<键>ControlInit`，
+ * 在控件实例创建成功后由 `_renderTheme` 派发一次，无载荷。
+ *
+ * 这些成员会被展开进 {@link EVENTS}.control，因此既可以 `EVENTS.control.playControlInit`
+ * 这样按名取用，也可以在只拿到 `iconId` 的场合用 `CONTROL_INIT_EVENTS[iconId]` 查表。
+ *
+ * @remarks `changeTheme` 会先卸载旧控件并重置 `theme.controls`，因此切换主题时这些事件会再次派发；
+ * 同一次渲染内则由 `!theme.controls.xxxControl` 守卫保证只派发一次。
+ */ var CONTROL_INIT_EVENTS = {
+    /** 播放/暂停控件初始化完成 */ playControlInit: 'Control.playControlInit',
+    /** 音量控件初始化完成 */ volumeControlInit: 'Control.volumeControlInit',
+    /** 设备信息控件初始化完成 */ deviceControlInit: 'Control.deviceControlInit',
+    /** 截图控件初始化完成 */ capturePictureControlInit: 'Control.capturePictureControlInit',
+    /** 云台控件初始化完成 */ ptzControlInit: 'Control.ptzControlInit',
+    /** 录制控件初始化完成 */ recordControlInit: 'Control.recordControlInit',
+    /** 对讲控件初始化完成 */ talkControlInit: 'Control.talkControlInit',
+    /** 语音广播控件初始化完成 */ broadcastControlInit: 'Control.broadcastControlInit',
+    /** AI 对话控件初始化完成 */ aiChatControlInit: 'Control.aiChatControlInit',
+    /** 直播按钮控件初始化完成 */ liveControlInit: 'Control.liveControlInit',
+    /** 回放下拉控件初始化完成 */ recDropdownControlInit: 'Control.recDropdownControlInit',
+    /** 录像列表控件初始化完成 */ recListControlInit: 'Control.recListControlInit',
+    /** 告警消息控件初始化完成 */ alarmMessageControlInit: 'Control.alarmMessageControlInit',
+    /** 电子放大控件初始化完成 */ zoomControlInit: 'Control.zoomControlInit',
+    /** 清晰度控件初始化完成 */ definitionControlInit: 'Control.definitionControlInit',
+    /** web 全屏控件初始化完成 */ fullscreenControlInit: 'Control.fullscreenControlInit',
+    /** 全局全屏控件初始化完成 */ globalFullscreenControlInit: 'Control.globalFullscreenControlInit',
+    /** 回放类型控件初始化完成 */ recControlInit: 'Control.recControlInit',
+    /** 倍速控件初始化完成 */ speedControlInit: 'Control.speedControlInit',
+    /** 日历控件初始化完成 */ dateControlInit: 'Control.dateControlInit',
+    /** 时间选择控件初始化完成 */ timeControlInit: 'Control.timeControlInit',
+    /** 时间轴控件初始化完成 */ timeLineControlInit: 'Control.timeLineControlInit',
+    /** 回放片段进度条控件初始化完成 */ segmentProgressControlInit: 'Control.segmentProgressControlInit'
+};
 /**
  *
  * 事件名
@@ -163,7 +221,7 @@ var EVENTS = {
     /** 播放区间播放结束（SDK 层 playbackRange 特性） */ playbackEnd: 'playbackEnd',
     /**
    * 控件相关
-   */ control: {
+   */ control: _extends$z({}, CONTROL_INIT_EVENTS, {
         /** 点击播放播放／暂停按钮 */ play: 'Control.play',
         /** 播放控件销毁 */ playDestroy: 'Control.playDestroy',
         /** 截图 */ capturePicture: 'Control.capturePicture',
@@ -219,12 +277,13 @@ var EVENTS = {
         /** 日期改变 */ dateMonthChange: 'Control.dateMonthChange',
         /** 日期面板展示的月份变化 */ datePanelMonthChange: 'Control.datePanelMonthChange',
         /** 日期面板展示的年份变化 */ datePanelYearChange: 'Control.datePanelYearChange',
-        /** 日期销毁 */ dateDestroy: 'Control.datePanelDestroy',
+        /** 日期销毁 */ dateDestroy: 'Control.dateDestroy',
         /** 时间面板展示隐藏变换 */ timePanelOpenChange: 'Control.timePanelOpenChange',
         /** 时间改变 */ timeChange: 'Control.timeChange',
         /** 时间轴拖动结束 */ timeLineChange: 'Control.timeLineChange',
         /** 时间轴图片列表面板 */ timeLinePanelOpenChange: 'Control.timeLinePanelOpenChange',
         /** 时间轴控件销毁 */ timeLineDestroy: 'Control.timeLineDestroy',
+        /** 控件不支持当前播放类型（仅提示，控件仍会渲染） */ unsupportedPlayType: 'Control.unsupportedPlayType',
         /** 主题控件挂载前 切换新的主题也会触发，如果想首次获取需要在 onInitializing 回调中进行监听 */ beforeMountControls: 'Control.beforeMountControls',
         /** 主题控件挂载完成, 切换新的主题也会触发，如果想首次获取需要在 onInitializing 回调中进行监听 */ mountedControls: 'Control.mountedControls',
         /** 主题控件卸载前, 已有控件卸载时才可触发 */ beforeUnmountControls: 'Control.beforeUnmountControls',
@@ -234,7 +293,7 @@ var EVENTS = {
         /** 消息控件销毁 */ messageDestroy: 'Control.messageDestroy',
         /** 播放器内容区域销毁 */ contentDestroy: 'Control.contentDestroy',
         /** 播放器内容区域重新渲染 */ contentRerender: 'Control.contentRerender'
-    },
+    }),
     /**
    * 主题控件相关
    */ theme: {
@@ -284,17 +343,17 @@ function _set_prototype_of$z(o, p) {
     };
     return _set_prototype_of$z(o, p);
 }
-/**
- * 控件基类
- * @category Control
- * @example
- * ```ts
- * // 创建控件
- * class MyControl extends Control {}
- *
- * // 使用控件
- * const myControl = new MyControl({})
- * ```
+/**
+ * 控件基类
+ * @category Control
+ * @example
+ * ```ts
+ * // 创建控件
+ * class MyControl extends Control {}
+ *
+ * // 使用控件
+ * const myControl = new MyControl({})
+ * ```
  */ var Control = /*#__PURE__*/ function(EventEmitter) {
     _inherits$z(Control, EventEmitter);
     function Control(options) {
@@ -336,22 +395,22 @@ function _set_prototype_of$z(o, p) {
         return _this;
     }
     var _proto = Control.prototype;
-    /**
-   * 重置整个控件
+    /**
+   * 重置整个控件
    */ _proto.reset = function reset(hide) {
         if (this._camelCaseName) {
             this.emit("Control." + this._camelCaseName + "Reset", hide);
         }
     };
-    /**
-   * 重置控件挂载节点
-   * @param popupContainer 重新挂载的节点
-   * @param append 添加的方式， 默认 append
-   * @param element 当 append = before 时 需要 element, 插入 element 前
-   *
-   * |     prepend   |    append       |
-   * |:-------------:|:---------------:|
-   * | 插入第一个位置 |    追加在末尾    |
+    /**
+   * 重置控件挂载节点
+   * @param popupContainer 重新挂载的节点
+   * @param append 添加的方式， 默认 append
+   * @param element 当 append = before 时 需要 element, 插入 element 前
+   *
+   * |     prepend   |    append       |
+   * |:-------------:|:---------------:|
+   * | 插入第一个位置 |    追加在末尾    |
    */ _proto.resetPopupContainer = function resetPopupContainer(popupContainer, append, element) {
         if (popupContainer !== this.$popupContainer) {
             if (this.$popupContainer.contains(this.$container)) {
@@ -373,16 +432,16 @@ function _set_prototype_of$z(o, p) {
             }
         }
     };
-    /**
-   * 隐藏整个控件
+    /**
+   * 隐藏整个控件
    */ _proto.hide = function hide() {
         if (this.$container) {
             this.$container.style.display = 'none';
             this.$container.classList.add("" + PREFIX_CLASS + "-hide");
         }
     };
-    /**
-   * 销毁控件
+    /**
+   * 销毁控件
    */ _proto.destroy = function destroy() {
         var _this___options, _this_$container_remove, _this_$container;
         if (this._camelCaseName) {
@@ -419,8 +478,8 @@ function _set_prototype_of$z(o, p) {
             (_this_$container1 = this.$container) == null ? void 0 : _this_$container1.classList.remove("" + PREFIX_CLASS + "-active");
         }
     };
-    /**
-   * 当点击 Control 时 触发子类的 _onControlClick
+    /**
+   * 当点击 Control 时 触发子类的 _onControlClick
    */ _proto._onClick = function _onClick() {
         var _this = this;
         // 使用具名 handler 便于在 destroy 时精确移除，避免匿名监听残留
@@ -438,19 +497,29 @@ function _set_prototype_of$z(o, p) {
         e.stopPropagation();
         e.preventDefault();
     };
-    /**
-   * 点击 Control 控件触发
-   * @param {Event} e
-   * @returns {void}
+    /**
+   * 点击 Control 控件触发
+   * @param {Event} e
+   * @returns {void}
    */ _proto._onControlClick = function _onControlClick(e) {
         // 这是一个空函数， 子类可以实现重新改方法
         this.__options.onClick == null ? void 0 : this.__options.onClick.call(this.__options, e);
     };
+    /**
+   * 判断某个播放类型是否被本控件支持
+   *
+   * @param playType 播放类型；传空串（无法从地址判定）时一律返回 `true`，避免误报
+   * @returns 是否支持
+   * @since 3.1.7
+   */ Control.supportsPlayType = function supportsPlayType(playType) {
+        if (!playType) return true;
+        return this.supportedPlayTypes.includes(playType);
+    };
     _create_class$9(Control, [
         {
             key: "active",
-            get: /**
-   * 是否激活
+            get: /**
+   * 是否激活
    */ function get() {
                 return this._active;
             },
@@ -465,8 +534,8 @@ function _set_prototype_of$z(o, p) {
         },
         {
             key: "disabled",
-            get: /**
-   * 是否禁用
+            get: /**
+   * 是否禁用
    */ function get() {
                 return this._disabled;
             },
@@ -478,6 +547,24 @@ function _set_prototype_of$z(o, p) {
     ]);
     return Control;
 }(EventEmitter);
+/**
+   * 该控件支持的播放类型，默认全支持
+   *
+   * 子类用 `static supportedPlayTypes = [...]` 覆盖来收窄范围。声明是**静态**的，
+   * 因为渲染层需要在不实例化控件的前提下就能读到（`Controls[iconId].supportedPlayTypes`）。
+   *
+   * 渲染时会拿 `theme.playType` 与此比对，不匹配只发警告与 `Control.unsupportedPlayType`
+   * 事件，**不阻止渲染**，控件照常创建、照常可交互，行为是否生效由 SDK 层与设备能力决定。
+   *
+   * @since 3.1.7
+   * @example
+   * ```ts
+   * class MyControl extends Control {
+   *   // 只在云存储回放下有意义
+   *   static supportedPlayTypes: ThemePlayType[] = ['cloudRec'];
+   * }
+   * ```
+   */ Control.supportedPlayTypes = [].concat(PLAY_TYPES);
 
 function _extends$y() {
     _extends$y = Object.assign || function assign(target) {
@@ -510,9 +597,9 @@ function _set_prototype_of$y(o, p) {
     return _set_prototype_of$y(o, p);
 }
 var LOADING_DEFAULT_OPTIONS = {};
-/**
- * 加载动画控件
- * @category Control
+/**
+ * 加载动画控件
+ * @category Control
  */ var Loading = /*#__PURE__*/ function(Control) {
     _inherits$y(Loading, Control);
     function Loading(options) {
@@ -537,9 +624,9 @@ var LOADING_DEFAULT_OPTIONS = {};
             this.$container.innerHTML = '\n          <span class="' + PREFIX_CLASS + "-loading-dot " + PREFIX_CLASS + '-loading-dot-load">\n            <i class="' + PREFIX_CLASS + '-loading-dot-item"></i>\n            <i class="' + PREFIX_CLASS + '-loading-dot-item"></i>\n            <i class="' + PREFIX_CLASS + '-loading-dot-item"></i>\n            <i class="' + PREFIX_CLASS + '-loading-dot-item"></i>\n          </span>\n        <div class="' + PREFIX_CLASS + '-loading-text">' + (((_this_locale = this.locale) == null ? void 0 : _this_locale.LOADING) || 'loading...') + "</div>\n        ";
         }
     };
-    /**
-   * 动画展示
-   * @param html 自定义动画内容, 如果不存在则使用默认动画
+    /**
+   * 动画展示
+   * @param html 自定义动画内容, 如果不存在则使用默认动画
    */ _proto.show = function show(html) {
         if (html) this.$container.innerHTML = html;
         // 初始化， 出流再等待中（回放出流结束不包括）
@@ -547,8 +634,8 @@ var LOADING_DEFAULT_OPTIONS = {};
         this.$container.classList.remove("" + PREFIX_CLASS + "-hide");
         this.$popupContainer.classList.add("" + PREFIX_CLASS + "-has-loading");
     };
-    /**
-   * 隐藏动画
+    /**
+   * 隐藏动画
    */ _proto.hide = function hide() {
         Control.prototype.hide.call(this);
         this.$popupContainer.classList.remove("" + PREFIX_CLASS + "-has-loading");
@@ -592,9 +679,9 @@ var DEFAULT_POSTER = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD//gAfQ29
 var POSTER_OPTIONS = {
     poster: DEFAULT_POSTER
 };
-/**
- * 封面控件
- * @category Control
+/**
+ * 封面控件
+ * @category Control
  */ var Poster = /*#__PURE__*/ function(Control) {
     _inherits$x(Poster, Control);
     function Poster(options) {
@@ -614,18 +701,18 @@ var POSTER_OPTIONS = {
         return _this;
     }
     var _proto = Poster.prototype;
-    /**
-   * 封面图片加载失败
-   * @param error
+    /**
+   * 封面图片加载失败
+   * @param error
    */ _proto._imgLoadErrorEvent = function _imgLoadErrorEvent(error) {
         var _error_target;
         // 封面加载失败， 一般只有自定义封面会出现这种情况
         // 这里不做img src重置处理  防止无限循环
         this._options.onLoadImgError == null ? void 0 : this._options.onLoadImgError.call(this._options, ((_error_target = error.target) == null ? void 0 : _error_target.getAttribute('src')) || '');
     };
-    /**
-   * 设置封面 这里不对 poster 进行缓存，如果有值优先使用，如果没有值优先使用 初始化传入的值
-   * @param {string} poster 封面地址或 base64 数据
+    /**
+   * 设置封面 这里不对 poster 进行缓存，如果有值优先使用，如果没有值优先使用 初始化传入的值
+   * @param {string} poster 封面地址或 base64 数据
    */ _proto.setPoster = function setPoster(poster) {
         var // eslint-disable-next-line @typescript-eslint/unbound-method
         // prettier-ignore
@@ -638,24 +725,24 @@ var POSTER_OPTIONS = {
         this.$container.innerHTML = '<img class="' + PREFIX_CLASS + '-poster-img" src="' + poster + '" />';
         (_this_$container_querySelector = this.$container.querySelector("." + PREFIX_CLASS + "-poster-img")) == null ? void 0 : _this_$container_querySelector.addEventListener("error", this._imgLoadErrorEvent);
     };
-    /**
-   * 展示封面 这里不对 poster 进行缓存， 如果有值优先使用， 如果没有值优先使用 初始化传入的值
+    /**
+   * 展示封面 这里不对 poster 进行缓存， 如果有值优先使用， 如果没有值优先使用 初始化传入的值
    */ _proto.show = function show() {
         if (this.$container) {
             this.$container.style.display = 'flex';
             this.$container.classList.remove("" + PREFIX_CLASS + "-hide");
         }
     };
-    /**
-   * 隐藏封面
+    /**
+   * 隐藏封面
    */ _proto.hide = function hide() {
         var // eslint-disable-next-line @typescript-eslint/unbound-method
         _this_$container_querySelector, _this_$container;
         Control.prototype.hide.call(this);
         (_this_$container = this.$container) == null ? void 0 : (_this_$container_querySelector = _this_$container.querySelector("." + PREFIX_CLASS + "-poster-img")) == null ? void 0 : _this_$container_querySelector.removeEventListener('error', this._imgLoadErrorEvent);
     };
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         this.hide();
         Control.prototype.destroy.call(this);
@@ -714,15 +801,15 @@ var Icons = {
     list: '<svg stroke="currentColor" fill="none" width="1em" height="1em" viewBox="0 0 24 24" focusable="false" aria-hidden="true" data-icon="list">\n   	<path d="M10.9995 5H21.0005" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>\n    <path d="M10.9995 12H21.0005" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>\n    <path d="M10.9995 19H21.0005" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>\n    <path fill-rule="evenodd" clip-rule="evenodd" d="M6.99951 5C6.99951 3.896 6.10351 3 4.99951 3C3.89551 3 2.99951 3.896 2.99951 5C2.99951 6.105 3.89551 7 4.99951 7C6.10351 7 6.99951 6.105 6.99951 5V5Z" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>\n    <path fill-rule="evenodd" clip-rule="evenodd" d="M6.99951 12C6.99951 10.896 6.10351 10 4.99951 10C3.89551 10 2.99951 10.896 2.99951 12C2.99951 13.105 3.89551 14 4.99951 14C6.10351 14 6.99951 13.105 6.99951 12V12Z" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>\n    <path fill-rule="evenodd" clip-rule="evenodd" d="M6.99951 12C6.99951 10.896 6.10351 10 4.99951 10C3.89551 10 2.99951 10.896 2.99951 12C2.99951 13.105 3.89551 14 4.99951 14C6.10351 14 6.99951 13.105 6.99951 12V12Z" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>\n    <path fill-rule="evenodd" clip-rule="evenodd" d="M6.99951 19C6.99951 17.896 6.10351 17 4.99951 17C3.89551 17 2.99951 17.896 2.99951 19C2.99951 20.105 3.89551 21 4.99951 21C6.10351 21 6.99951 20.105 6.99951 19V19Z" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>\n  </svg>'
 };
 
-/**
- * 创建 icon 组件
- * @param svg - svg 字符串
- * @param type - icon 类型
- * @returns icon 组件
- * @example
- * ```ts
- * createIcon('<svg>....</svg>', 'logo') // <span class="ezplayer-icon ezplayer-icon-logo"><svg>....</svg></span>
- * ```
+/**
+ * 创建 icon 组件
+ * @param svg - svg 字符串
+ * @param type - icon 类型
+ * @returns icon 组件
+ * @example
+ * ```ts
+ * createIcon('<svg>....</svg>', 'logo') // <span class="ezplayer-icon ezplayer-icon-logo"><svg>....</svg></span>
+ * ```
  */ function createIcon(svg, type, attr) {
     if (attr === void 0) attr = {};
     var attrStr = '';
@@ -923,9 +1010,9 @@ function _set_prototype_of$w(o, p) {
     return _set_prototype_of$w(o, p);
 }
 var MESSAGE_DEFAULT_OPTIONS = {};
-/**
- * 消息控件
- * @category Control
+/**
+ * 消息控件
+ * @category Control
  */ var Message = /*#__PURE__*/ function(Control) {
     _inherits$w(Message, Control);
     function Message(options) {
@@ -940,34 +1027,34 @@ var MESSAGE_DEFAULT_OPTIONS = {};
         return _this;
     }
     var _proto = Message.prototype;
-    /**
-   * info 普通消息， 内容默认字体白色
-   * @param {string} msg 消息内容
-   * @param {number} duration 认自动关闭延时，单位秒， 默认 2s后 关闭， 需手动 调用 hide()
+    /**
+   * info 普通消息， 内容默认字体白色
+   * @param {string} msg 消息内容
+   * @param {number} duration 认自动关闭延时，单位秒， 默认 2s后 关闭， 需手动 调用 hide()
    */ _proto.info = function info(msg, duration) {
         if (duration === void 0) duration = 2;
         this._toast(msg, 'info', duration);
     };
-    /**
-   * warn 警告消息， 内容默认字体黄色
-   * @param {string} msg 消息内容
-   * @param {number} duration 认自动关闭延时，单位秒， 默认 2s后 关闭， 需手动 调用 hide()
+    /**
+   * warn 警告消息， 内容默认字体黄色
+   * @param {string} msg 消息内容
+   * @param {number} duration 认自动关闭延时，单位秒， 默认 2s后 关闭， 需手动 调用 hide()
    */ _proto.warn = function warn(msg, duration) {
         if (duration === void 0) duration = 2;
         this._toast(msg, 'warn', duration);
     };
-    /**
-   * toast 错误消息（渲染在 rootContainer 上的浮层）
-   * @param {string} msg 消息内容
-   * @param {number} duration 自动关闭延时，单位秒， 默认 2s 后关闭
+    /**
+   * toast 错误消息（渲染在 rootContainer 上的浮层）
+   * @param {string} msg 消息内容
+   * @param {number} duration 自动关闭延时，单位秒， 默认 2s 后关闭
    */ _proto.toastError = function toastError(msg, duration) {
         if (duration === void 0) duration = 2;
         this._toast(msg, 'error', duration);
     };
-    /**
-   * error 错误消息， 内容默认字体红色
-   * @param {string} msg 消息内容
-   * @param {number=} duration 认自动关闭延时，单位秒， 默认 0 不关闭， 需手动 调用 hide()
+    /**
+   * error 错误消息， 内容默认字体红色
+   * @param {string} msg 消息内容
+   * @param {number=} duration 认自动关闭延时，单位秒， 默认 0 不关闭， 需手动 调用 hide()
    */ _proto.error = function error(msg, duration) {
         if (duration === void 0) duration = 0;
         this._show(this._getIcon('error') + '<div class="' + PREFIX_CLASS + '-message-msg">' + (msg || '') + "</div>", duration, 'error');
@@ -996,11 +1083,11 @@ var MESSAGE_DEFAULT_OPTIONS = {};
             }
         }
     };
-    /**
-   * 展示消息，如果同时调用多次只展示最后一次的消息
-   * @param  {string} msg 消息内容， 支持 html dom 字符串
-   * @param  {number} duration 认自动关闭延时，单位秒， 默认 0 不关闭 需手动 调用 hide()
-   * @param  {MessageType} type 消息类型
+    /**
+   * 展示消息，如果同时调用多次只展示最后一次的消息
+   * @param  {string} msg 消息内容， 支持 html dom 字符串
+   * @param  {number} duration 认自动关闭延时，单位秒， 默认 0 不关闭 需手动 调用 hide()
+   * @param  {MessageType} type 消息类型
    */ _proto._show = function _show(msg, duration, type) {
         var _this = this;
         if (duration === void 0) duration = 0;
@@ -1028,8 +1115,8 @@ var MESSAGE_DEFAULT_OPTIONS = {};
             }, duration * 1000);
         }
     };
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         var _this__$toast;
         if (this._timer) {
@@ -1044,8 +1131,8 @@ var MESSAGE_DEFAULT_OPTIONS = {};
         this.hide();
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 隐藏消息， 并清空消息内容
+    /**
+   * 隐藏消息， 并清空消息内容
    */ _proto.hide = function hide() {
         var _this = this;
         // 每次隐藏都清空内 消息内容
@@ -1118,9 +1205,9 @@ function _set_prototype_of$v(o, p) {
     };
     return _set_prototype_of$v(o, p);
 }
-/**
- * 播放/暂停控件
- * @category Control
+/**
+ * 播放/暂停控件
+ * @category Control
  */ var Play = /*#__PURE__*/ function(Control) {
     _inherits$v(Play, Control);
     function Play(options) {
@@ -1142,8 +1229,8 @@ function _set_prototype_of$v(o, p) {
         return _this;
     }
     var _proto = Play.prototype;
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         this._playing = !this._playing;
         this.emit(EVENTS.control.play, this._playing);
@@ -1166,8 +1253,8 @@ function _set_prototype_of$v(o, p) {
     _create_class$8(Play, [
         {
             key: "playing",
-            get: /**
-   * 播放状态
+            get: /**
+   * 播放状态
    */ function get() {
                 return this._playing;
             }
@@ -1176,12 +1263,12 @@ function _set_prototype_of$v(o, p) {
     return Play;
 }(Control);
 
-/**
- * 节流函数
- * @param {Function} func
- * @param {number} wait
- * @typeParam T - 函数类型
- * @returns {Function}
+/**
+ * 节流函数
+ * @param {Function} func
+ * @param {number} wait
+ * @typeParam T - 函数类型
+ * @returns {Function}
  */ // eslint-disable-next-line @typescript-eslint/ban-types
 function throttle(func, wait) {
     var timeout = null;
@@ -1237,28 +1324,28 @@ function _unsupported_iterable_to_array$2(o, minLen) {
     if (n === "Map" || n === "Set") return Array.from(n);
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
 }
-/**
- * 工具类
- * @category Util
+/**
+ * 工具类
+ * @category Util
  */ var Utils = /*#__PURE__*/ function() {
     function Utils() {}
     // /(phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|BlackBerry|IEMobile|MQQBrowser|JUC|Fennec|wOSBrowser|BrowserNG|WebOS|Symbian|Windows Phone|Opera Mini)/i.test(navigator?.userAgent) ||
     // (/Macintosh/i.test(navigator?.userAgent) && navigator?.maxTouchPoints > 1); // iPad 支持多点触控;
-    /**
-   * 监听手机旋转, 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/Screen/orientation}
-   * @param {OrientationChangeCallback} change 手机旋转回调
-   * @returns {[ScreenOrientation, CleanUpScreenOrientationFun]} [第一次的结果， 事件移除]
-   *
-   * @example
-   * ```ts
-   * const [orientation, cleanUp] = Utils.orientationEventListener((orientation) => {
-   *    console.log("orientation", orientation)
-   * })
-   *
-   * console.log("orientation", orientation)
-   * // 清除监听
-   * cleanUp()
-   * ```
+    /**
+   * 监听手机旋转, 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/Screen/orientation}
+   * @param {OrientationChangeCallback} change 手机旋转回调
+   * @returns {[ScreenOrientation, CleanUpScreenOrientationFun]} [第一次的结果， 事件移除]
+   *
+   * @example
+   * ```ts
+   * const [orientation, cleanUp] = Utils.orientationEventListener((orientation) => {
+   *    console.log("orientation", orientation)
+   * })
+   *
+   * console.log("orientation", orientation)
+   * // 清除监听
+   * cleanUp()
+   * ```
    */ // prettier-ignore
     Utils.orientationEventListener = function orientationEventListener(change) {
         var _orientationTimer = null;
@@ -1348,18 +1435,18 @@ function _unsupported_iterable_to_array$2(o, minLen) {
             }
         ];
     };
-    /**
-   * 监听节点尺寸变化， 参考 {@link https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver}
-   * @param {Element} node
-   * @param callback
-   * @returns {CleanUpResizeObserver}
-   * @example
-   * ```ts
-   * const [unobserve, disconnect] = Utils.resizeObserver(node, (entries, observer) => {});
-   *
-   * // 移除监听
-   * unobserve()
-   * ```
+    /**
+   * 监听节点尺寸变化， 参考 {@link https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver}
+   * @param {Element} node
+   * @param callback
+   * @returns {CleanUpResizeObserver}
+   * @example
+   * ```ts
+   * const [unobserve, disconnect] = Utils.resizeObserver(node, (entries, observer) => {});
+   *
+   * // 移除监听
+   * unobserve()
+   * ```
    */ // prettier-ignore
     Utils.resizeObserver = function resizeObserver(node, callback) {
         // prettier-ignore
@@ -1394,12 +1481,12 @@ function _unsupported_iterable_to_array$2(o, minLen) {
     return Utils;
 }();
 // 不要使用 window, 如果在 worker 中会报错
-/**
-   * 判断是否是移动端, (iPadOS 13+ 移除了 "iPad" 标识)
-   * @example
-   * ```ts
-   * Utils.isMobile  // true | false
-   * ```
+/**
+   * 判断是否是移动端, (iPadOS 13+ 移除了 "iPad" 标识)
+   * @example
+   * ```ts
+   * Utils.isMobile  // true | false
+   * ```
    */ Utils.isMobile = isMobile();
 
 function _defineProperties$7(target, props) {
@@ -1433,23 +1520,23 @@ var PROGRESS_DEFAULT_OPTIONS = {
         return (percent * 100).toFixed(0);
     }
 };
-/**
- * 进度条
- *
- * @category Control
- * @example
- * ```ts
- * const progress = new Progress({
- *   container: document.getElementById('progress-container'),
- *   step: 0.01,
- *   range: [0, 1],
- *   onChange: (value, range) => {
- *     console.log(`Progress changed: ${value}, Range: ${range}`);
- *  },
- *  defaultValue: 0.5,
- *  draggable: true,
- *  disabled: false,
- * })
+/**
+ * 进度条
+ *
+ * @category Control
+ * @example
+ * ```ts
+ * const progress = new Progress({
+ *   container: document.getElementById('progress-container'),
+ *   step: 0.01,
+ *   range: [0, 1],
+ *   onChange: (value, range) => {
+ *     console.log(`Progress changed: ${value}, Range: ${range}`);
+ *  },
+ *  defaultValue: 0.5,
+ *  draggable: true,
+ *  disabled: false,
+ * })
  */ var Progress = /*#__PURE__*/ function() {
     function Progress(options) {
         var _this_options_defaultValue;
@@ -1482,20 +1569,20 @@ var PROGRESS_DEFAULT_OPTIONS = {
         this.disabled = this.options.disabled;
     }
     var _proto = Progress.prototype;
-    /**
-   * 是否旋转了
-   * @param rotated
+    /**
+   * 是否旋转了
+   * @param rotated
    */ _proto.isRotate = function isRotate(rotated) {
         this._isRotated = rotated;
     };
-    /**
-   * 销毁 Progress 实例，移除事件监听器
-   * @returns {void}
-   * @memberof Progress
-   * @example
-   * ```ts
-   * progress.destroy();
-   * ```
+    /**
+   * 销毁 Progress 实例，移除事件监听器
+   * @returns {void}
+   * @memberof Progress
+   * @example
+   * ```ts
+   * progress.destroy();
+   * ```
    */ _proto.destroy = function destroy() {
         var _this__delegateSliderMouseDown_destroy, _this__delegateSliderMouseDown, _this__delegateSliderHandleMouseDown_destroy, _this__delegateSliderHandleMouseDown, _this__delegateProgressMouseDown_destroy, _this__delegateProgressMouseDown, _this__delegatePlusClick_destroy, _this__delegatePlusClick, _this__delegateMinusClick_destroy, _this__delegateMinusClick;
         (_this__delegateSliderMouseDown = this._delegateSliderMouseDown) == null ? void 0 : (_this__delegateSliderMouseDown_destroy = _this__delegateSliderMouseDown.destroy) == null ? void 0 : _this__delegateSliderMouseDown_destroy.call(_this__delegateSliderMouseDown);
@@ -1690,14 +1777,14 @@ var PROGRESS_DEFAULT_OPTIONS = {
         },
         {
             key: "value",
-            get: /**
-   * 获取进度条值
-   * @returns {number} 当前进度条值
-   * @example
-   * ```ts
-   * const value = progress.value; // 获取当前进度条值
-   * console.log(value); // 输出值
-   * ```
+            get: /**
+   * 获取进度条值
+   * @returns {number} 当前进度条值
+   * @example
+   * ```ts
+   * const value = progress.value; // 获取当前进度条值
+   * console.log(value); // 输出值
+   * ```
    */ function get() {
                 return this._value; //
             },
@@ -1707,14 +1794,14 @@ var PROGRESS_DEFAULT_OPTIONS = {
         },
         {
             key: "percent",
-            get: /**
-   * 获取进度百分比
-   * @returns {number}   当前进度条百分比
-   * @example
-   * ```ts
-   * const percent = progress.percent; // 获取当前进度条百分比
-   * console.log(percent); // 输出百分比
-   * ```
+            get: /**
+   * 获取进度百分比
+   * @returns {number}   当前进度条百分比
+   * @example
+   * ```ts
+   * const percent = progress.percent; // 获取当前进度条百分比
+   * console.log(percent); // 输出百分比
+   * ```
    */ function get() {
                 return this._percent;
             },
@@ -1777,9 +1864,9 @@ var VOLUME_DEFAULT_OPTIONS = {
     onOpenChange: function onOpenChange() {},
     onChange: function onChange() {}
 };
-/**
- * 音量调节控件
- * @category Control
+/**
+ * 音量调节控件
+ * @category Control
  */ var Volume = /*#__PURE__*/ function(Control) {
     _inherits$u(Volume, Control);
     function Volume(options) {
@@ -1853,8 +1940,8 @@ var VOLUME_DEFAULT_OPTIONS = {
         return _this;
     }
     var _proto = Volume.prototype;
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         var _this__progress_destroy, _this__progress, _this_picker;
         (_this__progress = this._progress) == null ? void 0 : (_this__progress_destroy = _this__progress.destroy) == null ? void 0 : _this__progress_destroy.call(_this__progress);
@@ -1912,8 +1999,8 @@ var VOLUME_DEFAULT_OPTIONS = {
             title: (_this_locale = this.locale) == null ? void 0 : _this_locale.BTN_VOLUME
         });
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick() {
     // this._options.onClick?.(e);
     };
@@ -1930,8 +2017,8 @@ var VOLUME_DEFAULT_OPTIONS = {
     _create_class$6(Volume, [
         {
             key: "muted",
-            get: /**
-   * 是否静音
+            get: /**
+   * 是否静音
    */ function get() {
                 return this._muted;
             },
@@ -1955,8 +2042,8 @@ var VOLUME_DEFAULT_OPTIONS = {
         },
         {
             key: "volume",
-            get: /**
-   * 当前音量值（真实值 即使静音）
+            get: /**
+   * 当前音量值（真实值 即使静音）
    */ function get() {
                 return this._lastVolume;
             },
@@ -1979,8 +2066,8 @@ var VOLUME_DEFAULT_OPTIONS = {
         },
         {
             key: "disabled",
-            get: /**
-   * 是否禁用
+            get: /**
+   * 是否禁用
    */ function get() {
                 return this._disabled;
             },
@@ -2480,9 +2567,9 @@ function _set_prototype_of$t(o, p) {
     };
     return _set_prototype_of$t(o, p);
 }
-/**
- * 全屏控件
- * @category Control
+/**
+ * 全屏控件
+ * @category Control
  */ var Fullscreen = /*#__PURE__*/ function(Control) {
     _inherits$t(Fullscreen, Control);
     function Fullscreen(options) {
@@ -2509,8 +2596,8 @@ function _set_prototype_of$t(o, p) {
         return _this;
     }
     var _proto = Fullscreen.prototype;
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         var _this__fullscreenUtil;
         this.$container.innerHTML = '';
@@ -2538,8 +2625,8 @@ function _set_prototype_of$t(o, p) {
         this._render();
         this.options.onChange == null ? void 0 : this.options.onChange.call(this.options, info);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick() {
         if (this.isCurrentFullscreen) {
             var _this__fullscreenUtil;
@@ -2583,9 +2670,9 @@ function _set_prototype_of$s(o, p) {
     };
     return _set_prototype_of$s(o, p);
 }
-/**
- * 回放类型切换（本地回放(sdk 卡)， 云存储回放， 云录制回放）控件
- * @category Control
+/**
+ * 回放类型切换（本地回放(sdk 卡)， 云存储回放， 云录制回放）控件
+ * @category Control
  */ var Rec = /*#__PURE__*/ function(Control) {
     _inherits$s(Rec, Control);
     function Rec(options) {
@@ -2604,8 +2691,8 @@ function _set_prototype_of$s(o, p) {
         return _this;
     }
     var _proto = Rec.prototype;
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         var _this__delegation;
         this.$container.removeEventListener('dblclick', this._onDBlClick);
@@ -2613,9 +2700,9 @@ function _set_prototype_of$s(o, p) {
         this._delegation = null;
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 添加回放类型图标
-   * @param {string} id 回放类型 'rec' | 'cloudRec' | 'cloudRecord'
+    /**
+   * 添加回放类型图标
+   * @param {string} id 回放类型 'rec' | 'cloudRec' | 'cloudRecord'
    */ _proto.addRecType = function addRecType(id) {
         var spanIcon = '';
         switch(id){
@@ -2682,11 +2769,16 @@ function _set_prototype_of$s(o, p) {
             }
         });
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {};
     return Rec;
 }(Control);
+/** 回放类型切换组，本身就是三种回放之间的切换入口，直播下无意义 */ Rec.supportedPlayTypes = [
+    'rec',
+    'cloudRec',
+    'cloudRecord'
+];
 
 var zh = {
     391001: '取流地址或端口非法',
@@ -3369,8 +3461,8 @@ var en = {
     }
 };
 
-/**
- * flv 预览
+/**
+ * flv 预览
  */ var hlsLiveTemplate = {
     autoFocus: 3,
     // poster:
@@ -3422,8 +3514,8 @@ var en = {
     }
 };
 
-/**
- * flv 预览
+/**
+ * flv 预览
  */ var hlsRecTemplate = {
     autoFocus: 3,
     // poster:
@@ -3481,8 +3573,8 @@ var en = {
     }
 };
 
-/**
- * pc 预览
+/**
+ * pc 预览
  */ var pcLive = {
     autoFocus: 3,
     header: {
@@ -3581,8 +3673,8 @@ var en = {
     }
 };
 
-/**
- * pc 回放
+/**
+ * pc 回放
  */ var pcRec = {
     header: {
         // color: DEFAULT_COLOR,
@@ -3693,8 +3785,8 @@ var en = {
     }
 };
 
-/**
- * mobile 预览
+/**
+ * mobile 预览
  */ var mobileLive = {
     header: {
         // color: DEFAULT_COLOR,
@@ -3782,8 +3874,8 @@ var en = {
     }
 };
 
-/**
- * mobile 回放
+/**
+ * mobile 回放
  */ var mobileRec = {
     header: {
         // color: DEFAULT_COLOR,
@@ -3877,8 +3969,8 @@ var en = {
     }
 };
 
-/**
- * 安防版(预览/回放)
+/**
+ * 安防版(预览/回放)
  */ var security = {
     header: {
         // color: DEFAULT_COLOR,
@@ -3954,8 +4046,8 @@ var en = {
     }
 };
 
-/**
- * 语音版（预览）
+/**
+ * 语音版（预览）
  */ var voice = {
     header: {
         // color: DEFAULT_COLOR,
@@ -4007,11 +4099,11 @@ var en = {
     }
 };
 
-/**
- * standard 做特殊处理
- *
- * WARN： 除了 'deviceID', 'deviceName'， 'rec', 'cloudRec', 'cloudRecord' 做特殊处理, 只能放置在顶部， 其它不做处理，如果配置渲染的有问题需要开发者自行修改
- * FIXME: 暂时不去重， 让开发者自己去修改
+/**
+ * standard 做特殊处理
+ *
+ * WARN： 除了 'deviceID', 'deviceName'， 'rec', 'cloudRec', 'cloudRecord' 做特殊处理, 只能放置在顶部， 其它不做处理，如果配置渲染的有问题需要开发者自行修改
+ * FIXME: 暂时不去重， 让开发者自己去修改
  */ var TEMPLATES = {
     pcLive: pcLive,
     pcRec: pcRec,
@@ -4041,9 +4133,9 @@ function _set_prototype_of$r(o, p) {
     };
     return _set_prototype_of$r(o, p);
 }
-/**
- * 截图控件
- * @category Content
+/**
+ * 截图控件
+ * @category Content
  */ var Content = /*#__PURE__*/ function(EventEmitter) {
     _inherits$r(Content, EventEmitter);
     function Content(options) {
@@ -4073,11 +4165,11 @@ function _set_prototype_of$r(o, p) {
         return _this;
     }
     var _proto = Content.prototype;
-    /**
-   * 重新画面区域
-   * @param {number} originWidth 画面宽度
-   * @param {number} originHeight 画面高度
-   * @returns {void}
+    /**
+   * 重新画面区域
+   * @param {number} originWidth 画面宽度
+   * @param {number} originHeight 画面高度
+   * @returns {void}
    */ _proto.rerender = function rerender(originWidth, originHeight) {
         if (originWidth === void 0) originWidth = 0;
         if (originHeight === void 0) originHeight = 0;
@@ -4190,9 +4282,9 @@ function _set_prototype_of$q(o, p) {
     };
     return _set_prototype_of$q(o, p);
 }
-/**
- * 更多控件
- * @category Control
+/**
+ * 更多控件
+ * @category Control
  */ var More = /*#__PURE__*/ function(Control) {
     _inherits$q(More, Control);
     function More(options) {
@@ -4238,9 +4330,9 @@ function _set_prototype_of$q(o, p) {
         }
     // debug
     };
-    /**
-   * 添加
-   * @param control
+    /**
+   * 添加
+   * @param control
    */ _proto.add = function add(key, part, control, props) {
         this.list.unshift({
             part: part,
@@ -4250,9 +4342,9 @@ function _set_prototype_of$q(o, p) {
             height: props.height
         });
     };
-    /**
-   * 移除
-   * @param control
+    /**
+   * 移除
+   * @param control
    */ _proto.remove = function remove(control) {
         var index = this.list.findIndex(function(item) {
             return item.control === control;
@@ -4272,20 +4364,20 @@ function _set_prototype_of$q(o, p) {
         }
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
     // this._options.onClick?.(e);
     };
     return More;
 }(Control);
 
-/**
- * 函数防抖
- * @param {Function} func
- * @param {number} wait
- * @typeParam T - 函数类型
- * @returns {Function}
+/**
+ * 函数防抖
+ * @param {Function} func
+ * @param {number} wait
+ * @typeParam T - 函数类型
+ * @returns {Function}
  */ // eslint-disable-next-line @typescript-eslint/ban-types
 function debounce(func, wait) {
     var timeout;
@@ -4915,23 +5007,23 @@ var ignoreList = [
     });
 }
 
-/**
- * 重新调整播放器窗口大小
- *
- * Adjust the player window size
- * @param {number | string} width 宽度（number 类型默认px, 支持字符串大小 "100%" | "50vw"）
- * @param {number | string} height 高度（number 类型默认px, 支持字符串大小 "100%" | "50vh"）
- * @since 0.0.1
- * @example
- * ```ts
- * theme.resize(600, 400) // 600px * 400px
- * theme.resize("600px", "400px") // 600px * 400px
- * theme.resize("50%", "1vh")
- * theme.resize("2em", "2rem")
- * // 事件监听 event, 这里是具体的宽高（单位px）
- * theme.on(Theme.EVENTS.resize, (width: number, height: number) => {})
- * ```
- * @returns {void}
+/**
+ * 重新调整播放器窗口大小
+ *
+ * Adjust the player window size
+ * @param {number | string} width 宽度（number 类型默认px, 支持字符串大小 "100%" | "50vw"）
+ * @param {number | string} height 高度（number 类型默认px, 支持字符串大小 "100%" | "50vh"）
+ * @since 0.0.1
+ * @example
+ * ```ts
+ * theme.resize(600, 400) // 600px * 400px
+ * theme.resize("600px", "400px") // 600px * 400px
+ * theme.resize("50%", "1vh")
+ * theme.resize("2em", "2rem")
+ * // 事件监听 event, 这里是具体的宽高（单位px）
+ * theme.on(Theme.EVENTS.resize, (width: number, height: number) => {})
+ * ```
+ * @returns {void}
  */ function _resize(theme, width, height) {
     var cssText = '';
     if (/^\d+(\.\d+)?$/.test(width + '')) {
@@ -4994,9 +5086,9 @@ var ZOOM_DEFAULT_OPTIONS = {
     open: false,
     max: 8
 };
-/**
- * 电子放大控件
- * @category Control
+/**
+ * 电子放大控件
+ * @category Control
  */ var Zoom = /*#__PURE__*/ function(Control) {
     _inherits$p(Zoom, Control);
     function Zoom(options) {
@@ -5073,8 +5165,8 @@ var ZOOM_DEFAULT_OPTIONS = {
         }
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         this.active = !this.active;
         Control.prototype._onControlClick.call(this, e);
@@ -5094,8 +5186,8 @@ var ZOOM_DEFAULT_OPTIONS = {
         },
         {
             key: "active",
-            get: /**
-   * 是否激活
+            get: /**
+   * 是否激活
    */ function get() {
                 return this._active;
             },
@@ -5744,8 +5836,8 @@ function rgbOrHexToRgbaWithOpacity(color, opacity) {
     return '';
 }
 
-/**
- * Header
+/**
+ * Header
  */ var Component = /*#__PURE__*/ function() {
     function Component(options) {
         if (options === void 0) options = {};
@@ -5797,8 +5889,8 @@ function rgbOrHexToRgbaWithOpacity(color, opacity) {
         this.$popupContainer.appendChild(this.$container);
     }
     var _proto = Component.prototype;
-    /**
-   * 销毁 header
+    /**
+   * 销毁 header
    */ _proto.destroy = function destroy() {
         var _this_$popupContainer;
         (_this_$popupContainer = this.$popupContainer) == null ? void 0 : _this_$popupContainer.removeChild(this.$container);
@@ -6074,10 +6166,10 @@ function _set_prototype_of$m(o, p) {
     };
     return _set_prototype_of$m(o, p);
 }
-/**
- * 全局全屏
- * 主题和播放器不提供全局全屏的api， 如果开发者想要可以参考这个组件自己实现
- * @category Control
+/**
+ * 全局全屏
+ * 主题和播放器不提供全局全屏的api， 如果开发者想要可以参考这个组件自己实现
+ * @category Control
  */ var GlobalFullscreen = /*#__PURE__*/ function(Fullscreen) {
     _inherits$m(GlobalFullscreen, Fullscreen);
     function GlobalFullscreen(options) {
@@ -6095,8 +6187,8 @@ function _set_prototype_of$m(o, p) {
             title: (_this_locale1 = this.locale) == null ? void 0 : _this_locale1.BTN_GLOBAL_FULLSCREEN
         });
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick() {
         // 网页全屏的情况下 还可以执行全局全屏
         if (this.isCurrentFullscreen && this._$rootContainer.classList.contains("" + PREFIX_CLASS + "-global-fullscreen")) {
@@ -6142,9 +6234,9 @@ function _set_prototype_of$l(o, p) {
     };
     return _set_prototype_of$l(o, p);
 }
-/**
- * 截图控件，点击后会触发截图事件， 截图数据会通过 onCapture 回调函数返回
- * @category Control
+/**
+ * 截图控件，点击后会触发截图事件， 截图数据会通过 onCapture 回调函数返回
+ * @category Control
  */ var CapturePicture = /*#__PURE__*/ function(Control) {
     _inherits$l(CapturePicture, Control);
     function CapturePicture(options) {
@@ -6175,8 +6267,8 @@ function _set_prototype_of$l(o, p) {
             title: (_this_locale = this.locale) == null ? void 0 : _this_locale.BTN_CAPTURE
         });
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         var _this = this;
         var _this_options_type, _this_options_cloudRecUpload;
@@ -6245,9 +6337,9 @@ function _set_prototype_of$k(o, p) {
     };
     return _set_prototype_of$k(o, p);
 }
-/**
- * 云台控件
- * @category Control
+/**
+ * 云台控件
+ * @category Control
  */ var Ptz = /*#__PURE__*/ function(Control) {
     _inherits$k(Ptz, Control);
     function Ptz(options) {
@@ -6336,8 +6428,8 @@ function _set_prototype_of$k(o, p) {
             }
         };
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         Control.prototype._onControlClick.call(this, e);
         this.active = !this.active;
@@ -6382,6 +6474,14 @@ function _set_prototype_of$k(o, p) {
     ]);
     return Ptz;
 }(Control);
+/**
+   * 云台是对设备的实时控制，回放场景下转动云台不影响已录制的画面。
+   *
+   * 依据是语义与 mobileRec 模板（不含云台）。`pcRec` 模板的配置里虽然还留着 `pantile`，
+   * 但实测在回放地址下它不会被渲染出来，因此这里声明为 live-only 不会对内置模板误报。
+   */ Ptz.supportedPlayTypes = [
+    'live'
+];
 
 function formatTime(seconds, format) {
     if (format === void 0) format = 'MM:SS';
@@ -6440,14 +6540,14 @@ function _set_prototype_of$j(o, p) {
 var RECORD_DEFAULT_OPTIONS = {
     maxDuration: 3600
 };
-/**
- * 录制控件，点击开始录制，再次点击停止录制，
- * 录制开始到结束会依次触发 `startRecord` 和 `stopRecord` 事件
- *
- * 注意：
- *  1. 录制过程中会占用浏览器内存, 请根据实际情况进行配置
- *  2. 录制时间很短可能会因为浏览器的限制或没有I帧而无法生成有效的视频文件
- * @category Control
+/**
+ * 录制控件，点击开始录制，再次点击停止录制，
+ * 录制开始到结束会依次触发 `startRecord` 和 `stopRecord` 事件
+ *
+ * 注意：
+ *  1. 录制过程中会占用浏览器内存, 请根据实际情况进行配置
+ *  2. 录制时间很短可能会因为浏览器的限制或没有I帧而无法生成有效的视频文件
+ * @category Control
  */ var Record = /*#__PURE__*/ function(Control) {
     _inherits$j(Record, Control);
     function Record(options) {
@@ -6462,16 +6562,16 @@ var RECORD_DEFAULT_OPTIONS = {
         return _this;
     }
     var _proto = Record.prototype;
-    /**
-   * 渲染图标
+    /**
+   * 渲染图标
    */ _proto._render = function _render() {
         var _this_locale;
         this.$container.innerHTML = IconComponents.record({
             title: (_this_locale = this.locale) == null ? void 0 : _this_locale.BTN_RECORDVIDEO
         });
     };
-    /**
-   * 渲染计时器
+    /**
+   * 渲染计时器
    */ _proto._renderTimer = function _renderTimer() {
         var _this = this;
         var _this__options_rootContainer, _this__options;
@@ -6500,8 +6600,8 @@ var RECORD_DEFAULT_OPTIONS = {
         this._destroyTimer();
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 销毁定时器和销毁节点
+    /**
+   * 销毁定时器和销毁节点
    */ _proto._destroyTimer = function _destroyTimer() {
         this._seconds = 0;
         if (this._timer) {
@@ -6516,8 +6616,8 @@ var RECORD_DEFAULT_OPTIONS = {
         }
         this._active = false;
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         this.active = !this.active;
         Control.prototype._onControlClick.call(this, e);
@@ -6525,8 +6625,8 @@ var RECORD_DEFAULT_OPTIONS = {
     _create_class$3(Record, [
         {
             key: "active",
-            get: /**
-   * 是否激活
+            get: /**
+   * 是否激活
    */ function get() {
                 return this._active;
             },
@@ -6719,14 +6819,14 @@ function _ts_generator$4(thisArg, body) {
         };
     }
 }
-/**
- * 对讲控件
- *
- * navigator.mediaDevices.getUserMedia {@link https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia} 返回一个 Promise 对象，
- * 成功后会resolve回调一个 MediaStream 对象。若用户拒绝了使用权限，或者需要的媒体源不可用，
- * promise会reject回调一个 PermissionDeniedError 或者 NotFoundError 。
- *
- * @category Control
+/**
+ * 对讲控件
+ *
+ * navigator.mediaDevices.getUserMedia {@link https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia} 返回一个 Promise 对象，
+ * 成功后会resolve回调一个 MediaStream 对象。若用户拒绝了使用权限，或者需要的媒体源不可用，
+ * promise会reject回调一个 PermissionDeniedError 或者 NotFoundError 。
+ *
+ * @category Control
  */ var Talk = /*#__PURE__*/ function(Control) {
     _inherits$i(Talk, Control);
     function Talk(options) {
@@ -6769,16 +6869,16 @@ function _ts_generator$4(thisArg, body) {
             Control.prototype.reset.call(this, hide);
         }
     };
-    /**
-   * 销毁对讲
+    /**
+   * 销毁对讲
    */ _proto.destroy = function destroy() {
         if (this.active) {
             this.reset();
         }
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         var _this = this, _superprop_get__onControlClick = function _superprop_get__onControlClick() {
             return Control.prototype._onControlClick;
@@ -6798,13 +6898,13 @@ function _ts_generator$4(thisArg, body) {
     _create_class$2(Talk, [
         {
             key: "value",
-            get: /**
-   * 获取当前值
+            get: /**
+   * 获取当前值
    */ function get() {
                 return this._value;
             },
-            set: /**
-   * 设置当前值 [0-1]
+            set: /**
+   * 设置当前值 [0-1]
    */ function set(value) {
                 // 没有激活状态，则不处理
                 if (!this.active) {
@@ -6834,6 +6934,9 @@ function _ts_generator$4(thisArg, body) {
     ]);
     return Talk;
 }(Control);
+/** 对讲是实时上行通道，只有直播场景有意义 */ Talk.supportedPlayTypes = [
+    'live'
+];
 
 function asyncGeneratorStep$3(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -6990,12 +7093,12 @@ function _ts_generator$3(thisArg, body) {
         };
     }
 }
-/**
- * 语音广播控件
- *
- * 用于触发语音广播功能的按钮控件
- *
- * @category Control
+/**
+ * 语音广播控件
+ *
+ * 用于触发语音广播功能的按钮控件
+ *
+ * @category Control
  */ var Broadcast = /*#__PURE__*/ function(Control) {
     _inherits$h(Broadcast, Control);
     function Broadcast(options) {
@@ -7035,16 +7138,16 @@ function _ts_generator$3(thisArg, body) {
             Control.prototype.reset.call(this, hide);
         }
     };
-    /**
-   * 销毁语音广播控件
+    /**
+   * 销毁语音广播控件
    */ _proto.destroy = function destroy() {
         if (this.active) {
             this.reset();
         }
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         var _this = this, _superprop_get__onControlClick = function _superprop_get__onControlClick() {
             return Control.prototype._onControlClick;
@@ -7065,6 +7168,9 @@ function _ts_generator$3(thisArg, body) {
     };
     return Broadcast;
 }(Control);
+/** 语音广播是实时上行通道，只有直播场景有意义（另需 `sdkType === 'base'`，见构造函数） */ Broadcast.supportedPlayTypes = [
+    'live'
+];
 
 function asyncGeneratorStep$2(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -7221,12 +7327,12 @@ function _ts_generator$2(thisArg, body) {
         };
     }
 }
-/**
- * AI对话框控件
- *
- * 用于触发AI对话框功能的按钮控件
- *
- * @category Control
+/**
+ * AI对话框控件
+ *
+ * 用于触发AI对话框功能的按钮控件
+ *
+ * @category Control
  */ var AIChat = /*#__PURE__*/ function(Control) {
     _inherits$g(AIChat, Control);
     function AIChat(options) {
@@ -7267,16 +7373,16 @@ function _ts_generator$2(thisArg, body) {
             Control.prototype.reset.call(this, hide);
         }
     };
-    /**
-   * 销毁AI对话框控件
+    /**
+   * 销毁AI对话框控件
    */ _proto.destroy = function destroy() {
         if (this.active) {
             this.reset();
         }
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         var _this = this, _superprop_get__onControlClick = function _superprop_get__onControlClick() {
             return Control.prototype._onControlClick;
@@ -7297,6 +7403,14 @@ function _ts_generator$2(thisArg, body) {
     };
     return AIChat;
 }(Control);
+/**
+   * 只在云存储回放下可用。
+   *
+   * 这是全部控件里证据最强的一条：构造函数里已显式要求 `recType === 'cloud'`
+   * 且排除 `busType === '7'`（云录制），不满足时直接 `display: none`。
+   */ AIChat.supportedPlayTypes = [
+    'cloudRec'
+];
 
 function _extends$e() {
     _extends$e = Object.assign || function assign(target) {
@@ -7328,12 +7442,12 @@ function _set_prototype_of$f(o, p) {
     };
     return _set_prototype_of$f(o, p);
 }
-/**
- * 直播按钮控件
- *
- * 点击切换到直播模式
- *
- * @category Control
+/**
+ * 直播按钮控件
+ *
+ * 点击切换到直播模式
+ *
+ * @category Control
  */ var Live = /*#__PURE__*/ function(Control) {
     _inherits$f(Live, Control);
     function Live(options) {
@@ -7355,9 +7469,9 @@ function _set_prototype_of$f(o, p) {
         return _this;
     }
     var _proto = Live.prototype;
-    /**
-   * 根据 urlInfo 同步激活状态
-   * 在初始化和播放地址切换后调用
+    /**
+   * 根据 urlInfo 同步激活状态
+   * 在初始化和播放地址切换后调用
    */ _proto._syncActiveByUrlInfo = function _syncActiveByUrlInfo(urlInfo) {
         var shouldBeActive = !!(urlInfo && urlInfo.type === 'live');
         this.active = shouldBeActive;
@@ -7368,13 +7482,13 @@ function _set_prototype_of$f(o, p) {
             title: ((_this_locale = this.locale) == null ? void 0 : _this_locale.BTN_LIVE) || '直播'
         });
     };
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         var _this__options_onChange, _this__options;
         Control.prototype._onControlClick.call(this, e);
@@ -7419,12 +7533,12 @@ function _set_prototype_of$e(o, p) {
     };
     return _set_prototype_of$e(o, p);
 }
-/**
- * 回放下拉控件
- *
- * 鼠标移入弹出气泡，展示云存储、云录制、本地回放三个选项
- *
- * @category Control
+/**
+ * 回放下拉控件
+ *
+ * 鼠标移入弹出气泡，展示云存储、云录制、本地回放三个选项
+ *
+ * @category Control
  */ var RecDropdown = /*#__PURE__*/ function(Control) {
     _inherits$e(RecDropdown, Control);
     function RecDropdown(options) {
@@ -7441,16 +7555,16 @@ function _set_prototype_of$e(o, p) {
             _this.$container.style.display = 'none';
         }
         // 初始化时根据 urlInfo 确定当前回放类型和激活状态
-        _this._recType = options.recType || ((_options_props = options.props) == null ? void 0 : _options_props.recType) || 'cloudRec';
+        _this._recType = options.recType || ((_options_props = options.props) == null ? void 0 : _options_props.recType) || '';
         _this._syncActiveByUrlInfo((_this___options_props1 = _this.__options.props) == null ? void 0 : _this___options_props1.urlInfo);
         _this._render();
         _this._initPicker();
         return _this;
     }
     var _proto = RecDropdown.prototype;
-    /**
-   * 根据 urlInfo 同步激活状态和回放类型
-   * 在初始化和播放地址切换后调用
+    /**
+   * 根据 urlInfo 同步激活状态和回放类型
+   * 在初始化和播放地址切换后调用
    */ _proto._syncActiveByUrlInfo = function _syncActiveByUrlInfo(urlInfo) {
         if (urlInfo && urlInfo.type === 'rec') {
             var _urlInfo_searchParams1;
@@ -7527,8 +7641,8 @@ function _set_prototype_of$e(o, p) {
             target == null ? void 0 : target.classList.add("" + PREFIX_CLASS + "-active");
         }
     };
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         var _this__delegation_destroy, _this__delegation;
         (_this__delegation = this._delegation) == null ? void 0 : (_this__delegation_destroy = _this__delegation.destroy) == null ? void 0 : _this__delegation_destroy.call(_this__delegation);
@@ -7540,8 +7654,8 @@ function _set_prototype_of$e(o, p) {
         }
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发（移动端 click 触发 picker）
+    /**
+   * 点击 Control 会触发（移动端 click 触发 picker）
    */ // eslint-disable-next-line @typescript-eslint/no-unused-vars
     _proto._onControlClick = function _onControlClick(_e) {
     // picker 自行处理 click/hover，这里不额外处理
@@ -7673,7 +7787,6 @@ function _set_prototype_of$d(o, p) {
         if (this._panelOpen) {
             this.emit(EVENTS.control.recListChange, false);
         }
-        this.emit(EVENTS.control.recListDestroy);
         if (this._modal) {
             this._modal.destroy();
             this._modal = null;
@@ -7705,6 +7818,16 @@ function _set_prototype_of$d(o, p) {
     };
     return RecList;
 }(Control);
+/**
+   * 录像片段列表，只对回放有意义。
+   *
+   * 依据是内置模板分布（仅 pcRec 含 `recList`）与语义。若后续确认本地卡回放
+   * 没有片段列表接口，把 `'rec'` 去掉即可。
+   */ RecList.supportedPlayTypes = [
+    'rec',
+    'cloudRec',
+    'cloudRecord'
+];
 
 function _extends$b() {
     _extends$b = Object.assign || function assign(target) {
@@ -7736,12 +7859,12 @@ function _set_prototype_of$c(o, p) {
     };
     return _set_prototype_of$c(o, p);
 }
-/**
- * 告警消息按钮控件
- *
- * 点击弹出告警消息列表弹窗（纯触发按钮，无激活状态）
- *
- * @category Control
+/**
+ * 告警消息按钮控件
+ *
+ * 点击弹出告警消息列表弹窗（纯触发按钮，无激活状态）
+ *
+ * @category Control
  */ var AlarmMessage = /*#__PURE__*/ function(Control) {
     _inherits$c(AlarmMessage, Control);
     function AlarmMessage(options) {
@@ -7765,16 +7888,16 @@ function _set_prototype_of$c(o, p) {
             title: ((_this_locale = this.locale) == null ? void 0 : _this_locale.BTN_ALARM_MESSAGE) || '消息'
         });
     };
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         if (this._panelOpen) {
             this.emit(EVENTS.control.alarmMessageChange, false);
         }
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         var _this__options_onChange, _this__options;
         Control.prototype._onControlClick.call(this, e);
@@ -7839,54 +7962,54 @@ var SELECT_DEFAULT_OPTIONS = {
     onChange: function onChange() {},
     onOpenChange: function onOpenChange() {}
 };
-/**
- * 选择器切换 (支持PC/Mobile)
- * @category Control
- * @example
- * ```ts
- * new Select({
- *   title: '清晰度',
- *   list: [
- *     {
- *       label: '高清',
- *       value: 'hd',
- *       streamTypeIn: 1,
- *     },
- *     {
- *       label: '超清',
- *       value: 'super',
- *       streamTypeIn: 2,
- *     }
- *   ],
- *   value: 'hd',
- *   onChange: (value, item) => {
- *     console.log('选择了', value, item);
- *   }
- * })
- *
- * // 如果想扩展 Select 组件，可以继承 Select 组件
- * // 例如清晰度切换组件
- * class Definition extends Select {
- *    options: DefinitionOptions;
- *    constructor(options: DefinitionOptions) {
- *      super({
- *        ...options,
- *        fieldNames: {  label: 'name',  value: 'level',},
- *        title: options?.locale?.definition,
- *        controlType: 'button',
- *        classNameSuffix: 'definition',
- *        onChange: (value: SelectItem['value'], item) => {
- *            options?.onChange?.(value, item);
- *            this.emit(EVENTS.control.definitionChange, value, item);
- *        },
- *        onOpenChange: (open: boolean, value: SelectItem['value'], item) => {
- *          options?.onOpenChange?.(open, value, item);
- *         this.emit(EVENTS.control.definitionPanelOpenChange, open, value, item);
- *        }
- *      });
- *   }
- * }
- * ```
+/**
+ * 选择器切换 (支持PC/Mobile)
+ * @category Control
+ * @example
+ * ```ts
+ * new Select({
+ *   title: '清晰度',
+ *   list: [
+ *     {
+ *       label: '高清',
+ *       value: 'hd',
+ *       streamTypeIn: 1,
+ *     },
+ *     {
+ *       label: '超清',
+ *       value: 'super',
+ *       streamTypeIn: 2,
+ *     }
+ *   ],
+ *   value: 'hd',
+ *   onChange: (value, item) => {
+ *     console.log('选择了', value, item);
+ *   }
+ * })
+ *
+ * // 如果想扩展 Select 组件，可以继承 Select 组件
+ * // 例如清晰度切换组件
+ * class Definition extends Select {
+ *    options: DefinitionOptions;
+ *    constructor(options: DefinitionOptions) {
+ *      super({
+ *        ...options,
+ *        fieldNames: {  label: 'name',  value: 'level',},
+ *        title: options?.locale?.definition,
+ *        controlType: 'button',
+ *        classNameSuffix: 'definition',
+ *        onChange: (value: SelectItem['value'], item) => {
+ *            options?.onChange?.(value, item);
+ *            this.emit(EVENTS.control.definitionChange, value, item);
+ *        },
+ *        onOpenChange: (open: boolean, value: SelectItem['value'], item) => {
+ *          options?.onOpenChange?.(open, value, item);
+ *         this.emit(EVENTS.control.definitionPanelOpenChange, open, value, item);
+ *        }
+ *      });
+ *   }
+ * }
+ * ```
  */ var Select = /*#__PURE__*/ function(Control) {
     _inherits$b(Select, Control);
     function Select(options) {
@@ -7938,9 +8061,9 @@ var SELECT_DEFAULT_OPTIONS = {
         return _this;
     }
     var _proto = Select.prototype;
-    /**
-   * 更新选项列表
-   * @param list - 选项列表
+    /**
+   * 更新选项列表
+   * @param list - 选项列表
    */ _proto.updateOptions = function updateOptions(list) {
         var _this = this;
         if (list === void 0) list = [];
@@ -8025,8 +8148,8 @@ var SELECT_DEFAULT_OPTIONS = {
             });
         }
     };
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         var _this__delegationOption_destroy, _this__delegationOption, _this__delegationClose_destroy, _this__delegationClose, _this__delegationCancel_destroy, _this__delegationCancel;
         (_this__delegationOption = this._delegationOption) == null ? void 0 : (_this__delegationOption_destroy = _this__delegationOption.destroy) == null ? void 0 : _this__delegationOption_destroy.call(_this__delegationOption);
@@ -8048,8 +8171,8 @@ var SELECT_DEFAULT_OPTIONS = {
         e.stopPropagation();
         e.preventDefault();
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         this._options.onClick == null ? void 0 : this._options.onClick.call(this._options, e);
     };
@@ -8068,8 +8191,8 @@ var SELECT_DEFAULT_OPTIONS = {
         },
         {
             key: "disabled",
-            get: /**
-   * 是否禁用
+            get: /**
+   * 是否禁用
    */ function get() {
                 return this._disabled;
             },
@@ -8155,15 +8278,15 @@ function __filter(list, locale) {
         };
     });
 }
-/**
- * 清晰度切换控件
- *
- * 清晰度切换控件有三套UI
- * 1. PC 端默认UI，hover 展示清晰度切换面板
- * 2. 移动端 picker选择器清晰度切换面板  + 取消按钮
- * 3. 移动端全屏模式右侧菜单清晰度切换面板
- *
- * @category Control
+/**
+ * 清晰度切换控件
+ *
+ * 清晰度切换控件有三套UI
+ * 1. PC 端默认UI，hover 展示清晰度切换面板
+ * 2. 移动端 picker选择器清晰度切换面板  + 取消按钮
+ * 3. 移动端全屏模式右侧菜单清晰度切换面板
+ *
+ * @category Control
  */ var Definition = /*#__PURE__*/ function(Select) {
     _inherits$a(Definition, Select);
     function Definition(options) {
@@ -8229,14 +8352,22 @@ function __filter(list, locale) {
         return _this;
     }
     var _proto = Definition.prototype;
-    /**
-   * 重置，恢复默认值
-   * @param hide 默认不隐藏
+    /**
+   * 重置，恢复默认值
+   * @param hide 默认不隐藏
    */ _proto.reset = function reset(hide) {
         Select.prototype.reset.call(this, hide);
     };
     return Definition;
 }(Select);
+/**
+   * 清晰度切换只在直播下有意义：回放播的是已落盘的码流，清晰度由录制时决定。
+   *
+   * 依据是内置模板分布（`hd` 只出现在 pcLive / mobileLive / security），控件本身无硬约束。
+   * 若后续确认本地卡回放支持主/子码流切换，把 `'rec'` 加进来即可。
+   */ Definition.supportedPlayTypes = [
+    'live'
+];
 
 function _assert_this_initialized(self) {
     if (self === void 0) throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
@@ -8282,13 +8413,13 @@ var SUPPORT_SPEED = [
     16
 ]; // 8, 16
 var SPEED_DEFAULT_OPTIONS = {
-    /**
-   * 默认倍速 1, 如果传入的值不在列表中会使用 1 倍速，可能会没有选中
-   * 暂时不支持初始化时设置倍速
+    /**
+   * 默认倍速 1, 如果传入的值不在列表中会使用 1 倍速，可能会没有选中
+   * 暂时不支持初始化时设置倍速
    */ // value: 1, // 对应list 中的 value
     // 这里不要设置多语言， 比较麻烦
-    /**
-   * 倍速列表, 需要是 2 的指数，不能小于 0.5， 最大 16 倍
+    /**
+   * 倍速列表, 需要是 2 的指数，不能小于 0.5， 最大 16 倍
    */ list: SUPPORT_SPEED.reverse().map(function(speed) {
         return {
             label: "" + speed + "x",
@@ -8296,13 +8427,13 @@ var SPEED_DEFAULT_OPTIONS = {
         };
     })
 };
-/**
- * 倍速切换控件, 不支持动态切换倍速列表
- *
- * 注意：
- *   1. 本地回放倍速需要设备本身支持才可以， 如果不支持切换后的倍数不会生效， 云端回放（云存储，云录制）倍速都是支持， 需要是 2 的指数，不能小于 0.5， 最大 16 倍；
- *   2. 标准流不支持；
- * @category Control
+/**
+ * 倍速切换控件, 不支持动态切换倍速列表
+ *
+ * 注意：
+ *   1. 本地回放倍速需要设备本身支持才可以， 如果不支持切换后的倍数不会生效， 云端回放（云存储，云录制）倍速都是支持， 需要是 2 的指数，不能小于 0.5， 最大 16 倍；
+ *   2. 标准流不支持；
+ * @category Control
  */ var Speed = /*#__PURE__*/ function(Select) {
     _inherits$9(Speed, Select);
     function Speed(options) {
@@ -8336,10 +8467,10 @@ var SPEED_DEFAULT_OPTIONS = {
         return _this;
     }
     var _proto = Speed.prototype;
-    /**
-   * 滤掉本地回放不支持的倍速
-   * @param optionsList 初始化配置倍速列表
-   * @param type 回放类型
+    /**
+   * 滤掉本地回放不支持的倍速
+   * @param optionsList 初始化配置倍速列表
+   * @param type 回放类型
    */ _proto._filterSpeedList = function _filterSpeedList(optionsList, type, url) {
         if (!optionsList) {
             // 非用户自定义  /openpb/ 是标准流回放路径
@@ -8367,6 +8498,16 @@ var SPEED_DEFAULT_OPTIONS = {
     };
     return Speed;
 }(Select);
+/**
+   * 倍速只对回放有意义；直播是实时流，没有倍速语义。
+   *
+   * 三类回放都支持，但档位上限不同（见 `_filterSpeedList`）：
+   * 本地卡回放与标准流 ≤ 4x，云存储 / 云录制 ≤ 16x。
+   */ Speed.supportedPlayTypes = [
+    'rec',
+    'cloudRec',
+    'cloudRecord'
+];
 
 function _extends$7() {
     _extends$7 = Object.assign || function assign(target) {
@@ -8574,6 +8715,11 @@ function _set_prototype_of$8(o, p) {
     };
     return DatePickerControl;
 }(Control);
+/** 选日期是为了定位录像，只对回放有意义（初值取自 `urlInfo.searchParams.begin`） */ DatePickerControl.supportedPlayTypes = [
+    'rec',
+    'cloudRec',
+    'cloudRecord'
+];
 
 function _extends$6() {
     _extends$6 = Object.assign || function assign(target) {
@@ -8606,9 +8752,9 @@ function _set_prototype_of$7(o, p) {
     return _set_prototype_of$7(o, p);
 }
 /** 时间格式 HH:mm:ss */ var TIME_FORMAT = 'HH:mm:ss';
-/**
- * 时间选择器控件
- * @category Control
+/**
+ * 时间选择器控件
+ * @category Control
  */ var TimePickerControl = /*#__PURE__*/ function(Control) {
     _inherits$7(TimePickerControl, Control);
     function TimePickerControl(options) {
@@ -8669,9 +8815,9 @@ function _set_prototype_of$7(o, p) {
             }
         }));
     };
-    /**
-   * 设置时间
-   * @param time 设置的时间 HH:mm:ss
+    /**
+   * 设置时间
+   * @param time 设置的时间 HH:mm:ss
    */ _proto.setTime = function setTime(time) {
         var _this_timePicker;
         (_this_timePicker = this.timePicker) == null ? void 0 : _this_timePicker.setCurrent(time);
@@ -8687,9 +8833,9 @@ function _set_prototype_of$7(o, p) {
         if (this.timePicker) this.timePicker.open = false;
         Control.prototype.reset.call(this);
     };
-    /**
-   * 销毁控件
-   * @override
+    /**
+   * 销毁控件
+   * @override
    */ _proto.destroy = function destroy() {
         if (this.timePicker) {
             this.timePicker.destroy();
@@ -8701,14 +8847,19 @@ function _set_prototype_of$7(o, p) {
     _proto._getTimeStr = function _getTimeStr() {
         return this._value;
     };
-    /**
-   * 点击 Control 会触发
-   * @overload super._onControlClick(e: Event)
+    /**
+   * 点击 Control 会触发
+   * @overload super._onControlClick(e: Event)
    */ _proto._onControlClick = function _onControlClick(e) {
         Control.prototype._onControlClick.call(this, e);
     };
     return TimePickerControl;
 }(Control);
+/** 选时间是为了定位录像，只对回放有意义（初值取自 `urlInfo.searchParams.begin`） */ TimePickerControl.supportedPlayTypes = [
+    'rec',
+    'cloudRec',
+    'cloudRecord'
+];
 
 function _extends$5() {
     _extends$5 = Object.assign || function assign(target) {
@@ -8740,8 +8891,8 @@ function _set_prototype_of$6(o, p) {
     };
     return _set_prototype_of$6(o, p);
 }
-/**
- * 回放时间轴控件
+/**
+ * 回放时间轴控件
  */ var TimeLineControl = /*#__PURE__*/ function(Control) {
     _inherits$6(TimeLineControl, Control);
     function TimeLineControl(options) {
@@ -8901,13 +9052,18 @@ function _set_prototype_of$6(o, p) {
         }
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 点击 Control 会触发
+    /**
+   * 点击 Control 会触发
    */ _proto._onControlClick = function _onControlClick(e) {
         this._options.onClick == null ? void 0 : this._options.onClick.call(this._options, e);
     };
     return TimeLineControl;
 }(Control);
+/** 时间轴展示的是录像片段，只对回放有意义（渲染层的 `_needTimeLine` 也要求 `urlInfo.type === 'rec'`） */ TimeLineControl.supportedPlayTypes = [
+    'rec',
+    'cloudRec',
+    'cloudRecord'
+];
 
 function _extends$4() {
     _extends$4 = Object.assign || function assign(target) {
@@ -8939,24 +9095,24 @@ function _set_prototype_of$5(o, p) {
     };
     return _set_prototype_of$5(o, p);
 }
-/**
- * 播放结束后忽略 OSD 回写的静默期（毫秒）
- *
- * 断流结束时 SDK 不会立刻停掉 OSD 轮询（要让时间轴光标跟到画面最后一帧，见
- * api/_playbackRange.ts 的 OSD_SETTLE_MS = 2500），这些回写的时间早于区间末端，
- * 会把刚补满的进度拉回去。取值需覆盖该窗口。
- *
- * 用静默期而不是永久忽略：用户可能从时间轴点回区间内继续看，那条 seek 不经过
- * 进度条的 onChange，永久忽略会让进度条卡死不再更新。
+/**
+ * 播放结束后忽略 OSD 回写的静默期（毫秒）
+ *
+ * 断流结束时 SDK 不会立刻停掉 OSD 轮询（要让时间轴光标跟到画面最后一帧，见
+ * api/_playbackRange.ts 的 OSD_SETTLE_MS = 2500），这些回写的时间早于区间末端，
+ * 会把刚补满的进度拉回去。取值需覆盖该窗口。
+ *
+ * 用静默期而不是永久忽略：用户可能从时间轴点回区间内继续看，那条 seek 不经过
+ * 进度条的 onChange，永久忽略会让进度条卡死不再更新。
  */ var PLAYBACK_END_SILENCE_MS = 3000;
-/**
- * 读取录像片段的起止时间（毫秒）
- *
- * 录像列表是服务端原始返回、未做字段归一化，`begin/end` 与 `startTime/endTime`
- * 两套字段名在不同回放类型下都出现过，这里统一兼容。
- *
- * @param seg 录像片段
- * @param which 取起点还是终点
+/**
+ * 读取录像片段的起止时间（毫秒）
+ *
+ * 录像列表是服务端原始返回、未做字段归一化，`begin/end` 与 `startTime/endTime`
+ * 两套字段名在不同回放类型下都出现过，这里统一兼容。
+ *
+ * @param seg 录像片段
+ * @param which 取起点还是终点
  */ function segMs(seg, which) {
     var _ref, _ref1;
     var value = which === 'start' ? (_ref = seg == null ? void 0 : seg.startTime) != null ? _ref : seg == null ? void 0 : seg.begin : (_ref1 = seg == null ? void 0 : seg.endTime) != null ? _ref1 : seg == null ? void 0 : seg.end;
@@ -8964,12 +9120,12 @@ function _set_prototype_of$5(o, p) {
     if (typeof value === 'number') return value < 1e12 ? value * 1000 : value;
     return DateTime.toDate(value).getTime();
 }
-/**
- * 回放片段进度条控件（移动端）
- *
- * 只在设置了播放区间时渲染，范围是「当前录像片段 ∩ 播放区间」。
- * 区间内跨片段的定位由时间轴承担，这里只负责当前片段的精细拖动。
- * @category Control
+/**
+ * 回放片段进度条控件（移动端）
+ *
+ * 只在设置了播放区间时渲染，范围是「当前录像片段 ∩ 播放区间」。
+ * 区间内跨片段的定位由时间轴承担，这里只负责当前片段的精细拖动。
+ * @category Control
  */ var SegmentProgressControl = /*#__PURE__*/ function(Control) {
     _inherits$5(SegmentProgressControl, Control);
     function SegmentProgressControl(options) {
@@ -9036,9 +9192,9 @@ function _set_prototype_of$5(o, p) {
         });
         this._updateVisible();
     };
-    /**
-   * 设置播放区间
-   * @param range 区间；null 表示解除约束
+    /**
+   * 设置播放区间
+   * @param range 区间；null 表示解除约束
    */ _proto._setRange = function _setRange(range) {
         if ((range == null ? void 0 : range.begin) && (range == null ? void 0 : range.end)) {
             this._rangeBeginMs = DateTime.toDate(range.begin).getTime();
@@ -9049,9 +9205,9 @@ function _set_prototype_of$5(o, p) {
         }
         this._updateVisible();
     };
-    /**
-   * 用区间裁剪录像片段
-   * @param records 全天录像片段
+    /**
+   * 用区间裁剪录像片段
+   * @param records 全天录像片段
    */ _proto._setSegments = function _setSegments(records) {
         var _this = this;
         if (!this._hasRange() || !Array.isArray(records)) {
@@ -9079,9 +9235,9 @@ function _set_prototype_of$5(o, p) {
         if (force) this._currentIndex = -1;
         this._updateVisible();
     };
-    /**
-   * 按播放进度更新片段与进度
-   * @param currentMs 当前播放时间（毫秒）
+    /**
+   * 按播放进度更新片段与进度
+   * @param currentMs 当前播放时间（毫秒）
    */ _proto._syncCurrent = function _syncCurrent(currentMs) {
         if (!this._hasRange()) return;
         var index = this._segments.findIndex(function(seg) {
@@ -9121,6 +9277,11 @@ function _set_prototype_of$5(o, p) {
     };
     return SegmentProgressControl;
 }(Control);
+/** 片段进度条拖动的是录像片段内的位置，只对回放有意义（另需移动端 + 已设置播放区间） */ SegmentProgressControl.supportedPlayTypes = [
+    'rec',
+    'cloudRec',
+    'cloudRecord'
+];
 
 function _extends$3() {
     _extends$3 = Object.assign || function assign(target) {
@@ -9152,9 +9313,9 @@ function _set_prototype_of$4(o, p) {
     };
     return _set_prototype_of$4(o, p);
 }
-/**
- * 展示设备序列号控件
- * @category Control
+/**
+ * 展示设备序列号控件
+ * @category Control
  */ var Device = /*#__PURE__*/ function(Control) {
     _inherits$4(Device, Control);
     function Device(options) {
@@ -9172,10 +9333,10 @@ function _set_prototype_of$4(o, p) {
         var _this___options_props_urlInfo, _this___options_props;
         this.$container.innerHTML = '<span class="' + PREFIX_CLASS + "-text " + PREFIX_CLASS + '-text-device">' + this._splicingString(this.__options.deviceName, (_this___options_props = this.__options.props) == null ? void 0 : (_this___options_props_urlInfo = _this___options_props.urlInfo) == null ? void 0 : _this___options_props_urlInfo.deviceSerial) + "</span>";
     };
-    /**
-   * 更新设备序列号
-   * @param deviceSerial - 设备序列号
-   * @param deviceName - 设备名称
+    /**
+   * 更新设备序列号
+   * @param deviceSerial - 设备序列号
+   * @param deviceName - 设备名称
    */ _proto.update = function update(deviceName, deviceSerial) {
         if (this.$container.querySelector("." + PREFIX_CLASS + "-text-device")) {
             var $span = this.$container.querySelector("." + PREFIX_CLASS + "-text-device");
@@ -9333,8 +9494,8 @@ function _set_prototype_of$2(o, p) {
 // const MobileExtend_DEFAULT_Options = {
 //   controls: MOBILE_EXTENDS,
 // };
-/**
- * 移动端扩展
+/**
+ * 移动端扩展
  */ var MobileExtend = /*#__PURE__*/ function(EventEmitter) {
     _inherits$2(MobileExtend, EventEmitter);
     function MobileExtend($siblingContainer) {
@@ -9411,9 +9572,9 @@ function _set_prototype_of$1(o, p) {
     return _set_prototype_of$1(o, p);
 }
 var PAUSE_DEFAULT_OPTIONS = {};
-/**
- * 暂停控件（仅在第一次非自动播放时可以点击播放）, 防止和放大有冲突
- * @category Control
+/**
+ * 暂停控件（仅在第一次非自动播放时可以点击播放）, 防止和放大有冲突
+ * @category Control
  */ var Pause = /*#__PURE__*/ function(Control) {
     _inherits$1(Pause, Control);
     function Pause(options) {
@@ -9429,8 +9590,8 @@ var PAUSE_DEFAULT_OPTIONS = {};
         return _this;
     }
     var _proto = Pause.prototype;
-    /**
-   * 展示封面 这里不对 poster 进行缓存， 如果有值优先使用， 如果没有值优先使用 初始化传入的值
+    /**
+   * 展示封面 这里不对 poster 进行缓存， 如果有值优先使用， 如果没有值优先使用 初始化传入的值
    */ _proto.show = function show(playing, always) {
         var _this = this;
         var _this_$container_classList, _this_$container;
@@ -9475,8 +9636,8 @@ var PAUSE_DEFAULT_OPTIONS = {};
             }, 300);
         }, 10);
     };
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         if (this._timer) {
             clearTimeout(this._timer);
@@ -9764,10 +9925,30 @@ var AUTH_KEY = [
     'recDropdown',
     'alarmMessage'
 ];
-/**
- * 渲染控件
- * @param $container - 控件渲染节点
- * @param btnList - 控件按钮列表
+/**
+ * 校验控件是否支持当前播放类型，不支持只提示、**不阻止渲染**
+ *
+ * 之所以只提示：控件能否真正工作还取决于设备能力与 SDK 层实现，主题层没有足够信息
+ * 直接判死；而模板可能来自开放平台配置（`getThemeData` 远程拉取）或开发者自定义的
+ * `themeData`，直接隐藏会让人无从排查。
+ *
+ * `theme.playType` 为空串（地址判不出类型，如 rtmp / webrtc / 地址未设置）时整体跳过校验。
+ *
+ * @param theme - Theme
+ * @param iconId - 控件 iconId
+ * @param ControlClass - 控件类，读其静态 `supportedPlayTypes`
+ */ function _checkPlayTypeSupport(theme, iconId, ControlClass) {
+    var playType = theme.playType;
+    if (!playType || ControlClass.supportsPlayType(playType)) return;
+    var supported = ControlClass.supportedPlayTypes;
+    // prettier-ignore
+    theme.logger.warn("[" + iconId + '] control does not support playType "' + playType + '" (supported: ' + supported.join(', ') + "). It is still rendered, but may not work as expected.");
+    theme.emit(EVENTS.control.unsupportedPlayType, iconId, playType, supported);
+}
+/**
+ * 渲染控件
+ * @param $container - 控件渲染节点
+ * @param btnList - 控件按钮列表
  */ // prettier-ignore
 function _renderControls(theme, $container, btnList, props) {
     if (props === void 0) props = {};
@@ -9806,6 +9987,8 @@ function _renderControls(theme, $container, btnList, props) {
                         }, ((_theme_options = theme.options) == null ? void 0 : _theme_options["deviceOptions"]) || {}, {
                             props: props
                         }));
+                        theme.emit(EVENTS.control.deviceControlInit);
+                        _checkPlayTypeSupport(theme, item.iconId, Controls["device"]);
                     }
                 }
                 continue;
@@ -9835,6 +10018,9 @@ function _renderControls(theme, $container, btnList, props) {
                     }, ((_theme_options1 = theme.options) == null ? void 0 : _theme_options1["" + item.iconId + "Options"]) || {}, {
                         props: props
                     }));
+                    // iconId 已由 Controls 查表校验过，这里必然能取到对应的初始化事件名
+                    theme.emit(CONTROL_INIT_EVENTS["" + item.iconId + "ControlInit"]);
+                    _checkPlayTypeSupport(theme, item.iconId, Controls[item.iconId]);
                 }
             } else {
                 theme.logger.warn("[" + item.iconId + "] control does not exist");
@@ -10043,7 +10229,7 @@ function _renderTheme(theme, data) {
                                 });
                             }
                             // 移动端：在 rec 控件旁渲染 alarmMessage 按钮
-                            if (theme.options.alarmMessageOptions !== null && !((_theme_controls2 = theme.controls) == null ? void 0 : _theme_controls2['alarmMessageControl'])) {
+                            if (theme.options.alarmMessageOptions !== null && !((_theme_controls2 = theme.controls) == null ? void 0 : _theme_controls2['alarmMessageControl']) && theme.options.sdkType === 'base') {
                                 // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
                                 theme.controls['alarmMessageControl'] = new Controls['alarmMessage'](_extends$1({
                                     rootContainer: theme.$container,
@@ -10058,6 +10244,8 @@ function _renderTheme(theme, data) {
                                 }, ((_theme_options = theme.options) == null ? void 0 : _theme_options.alarmMessageOptions) || {}, {
                                     props: props
                                 }));
+                                theme.emit(EVENTS.control.alarmMessageControlInit);
+                                _checkPlayTypeSupport(theme, 'alarmMessage', Controls['alarmMessage']);
                             }
                             if ((theme.options.timeLineOptions !== null || !theme.options.disabledTimeLine) && ((_theme_options_mobileExtendOptions5 = theme.options.mobileExtendOptions) == null ? void 0 : _theme_options_mobileExtendOptions5.controls.includes('timeLine')) && _needTimeLine) {
                                 _renderTimeLine(theme, theme._mobileExtend.$content, props);
@@ -10098,6 +10286,8 @@ var _renderTimeLine = function _renderTimeLine(theme, container, props) {
             showSectionIcon: ((_theme_options1 = theme.options) == null ? void 0 : _theme_options1["recListOptions"]) !== null ? (_ref = (_this = ((_theme_options2 = theme.options) == null ? void 0 : _theme_options2["timeLineOptions"]) || {}) == null ? void 0 : _this.showSectionIcon) != null ? _ref : true : true,
             props: props
         }));
+        theme.emit(EVENTS.control.timeLineControlInit);
+        _checkPlayTypeSupport(theme, 'timeLine', Controls['timeLine']);
     }
 };
 var _renderSegmentProgress = function _renderSegmentProgress(theme, container, props) {
@@ -10115,6 +10305,8 @@ var _renderSegmentProgress = function _renderSegmentProgress(theme, container, p
         }, ((_theme_options = theme.options) == null ? void 0 : _theme_options["segmentProgressOptions"]) || {}, {
             props: props
         }));
+        theme.emit(EVENTS.control.segmentProgressControlInit);
+        _checkPlayTypeSupport(theme, 'segmentProgress', Controls['segmentProgress']);
     }
 };
 var _renderDatePicker = function _renderDatePicker(theme, container, props) {
@@ -10131,6 +10323,8 @@ var _renderDatePicker = function _renderDatePicker(theme, container, props) {
         }, ((_theme_options = theme.options) == null ? void 0 : _theme_options["dateOptions"]) || {}, {
             props: props
         }));
+        theme.emit(EVENTS.control.dateControlInit);
+        _checkPlayTypeSupport(theme, 'date', Controls['date']);
     }
 };
 var _renderTimePicker = function _renderTimePicker(theme, container, props) {
@@ -10147,6 +10341,8 @@ var _renderTimePicker = function _renderTimePicker(theme, container, props) {
         }, ((_theme_options = theme.options) == null ? void 0 : _theme_options["timeOptions"]) || {}, {
             props: props
         }));
+        theme.emit(EVENTS.control.timeControlInit);
+        _checkPlayTypeSupport(theme, 'time', Controls['time']);
     }
 };
 var _renderRecType = function _renderRecType(theme, container, recType, props) {
@@ -10165,31 +10361,33 @@ var _renderRecType = function _renderRecType(theme, container, recType, props) {
         }, ((_theme_options = theme.options) == null ? void 0 : _theme_options["recOptions"]) || {}, {
             props: props
         }));
+        theme.emit(EVENTS.control.recControlInit);
+        _checkPlayTypeSupport(theme, 'rec', Controls['rec']);
     }
     if ((_theme_controls1 = theme.controls) == null ? void 0 : _theme_controls1['recControl']) ((_theme_controls2 = theme.controls) == null ? void 0 : _theme_controls2['recControl']).addRecType(recType);
 };
 
-/**
- * 布局溢出（More 收纳）与响应式尺寸分档的**纯函数**模块。
- *
- * @remarks
- * 这些函数只做「计算 / 判定」，不含任何 DOM 副作用，因此可以在没有布局引擎的环境（如 jsdom）
- * 中被完整单元测试。`theme.ts` 中的命令式外壳（读取 `clientWidth`、增删 class、创建 More、
- * 搬移控件）负责副作用，具体的判定逻辑全部下沉到这里。
- */ /**
- * 一次 classList 变更集合：需要添加与需要移除的类名。
- */ /**
- * 根据尺寸计算某一维度（宽或高）需要增删的响应式档位类名。
- *
- * 档位规则：
- * - `(280, 375]` → medium
- * - `(200, 280]` → small
- * - `<= 200` → mini
- * - 其它（> 375）→ 无档位（移除全部）
- *
- * @param size 尺寸（px）
- * @param axis `'width'` 或 `'height'`
- * @param prefix 类名前缀（如 `ezplayer`）
+/**
+ * 布局溢出（More 收纳）与响应式尺寸分档的**纯函数**模块。
+ *
+ * @remarks
+ * 这些函数只做「计算 / 判定」，不含任何 DOM 副作用，因此可以在没有布局引擎的环境（如 jsdom）
+ * 中被完整单元测试。`theme.ts` 中的命令式外壳（读取 `clientWidth`、增删 class、创建 More、
+ * 搬移控件）负责副作用，具体的判定逻辑全部下沉到这里。
+ */ /**
+ * 一次 classList 变更集合：需要添加与需要移除的类名。
+ */ /**
+ * 根据尺寸计算某一维度（宽或高）需要增删的响应式档位类名。
+ *
+ * 档位规则：
+ * - `(280, 375]` → medium
+ * - `(200, 280]` → small
+ * - `<= 200` → mini
+ * - 其它（> 375）→ 无档位（移除全部）
+ *
+ * @param size 尺寸（px）
+ * @param axis `'width'` 或 `'height'`
+ * @param prefix 类名前缀（如 `ezplayer`）
  */ function computeDimensionClasses(size, axis, prefix) {
     var medium = prefix + "-medium-" + axis;
     var small = prefix + "-small-" + axis;
@@ -10215,11 +10413,11 @@ var _renderRecType = function _renderRecType(theme, container, recType, props) {
         remove: remove
     };
 }
-/**
- * 计算宽、高两个维度的响应式档位类名增删集合。
- * @param width 容器宽度（px）
- * @param height 容器高度（px）
- * @param prefix 类名前缀
+/**
+ * 计算宽、高两个维度的响应式档位类名增删集合。
+ * @param width 容器宽度（px）
+ * @param height 容器高度（px）
+ * @param prefix 类名前缀
  */ function computeSizeClasses(width, height, prefix) {
     var w = computeDimensionClasses(width, 'width', prefix);
     var h = computeDimensionClasses(height, 'height', prefix);
@@ -10228,34 +10426,34 @@ var _renderRecType = function _renderRecType(theme, container, recType, props) {
         remove: [].concat(w.remove, h.remove)
     };
 }
-/**
- * header 左右控件宽度之和 + 30 是否超过容器宽度 —— 超过则需要显示 More。
+/**
+ * header 左右控件宽度之和 + 30 是否超过容器宽度 —— 超过则需要显示 More。
  */ function shouldShowHeaderMore(width, leftWidth, rightWidth) {
     return leftWidth + rightWidth + 30 > width;
 }
-/**
- * header 剩余空间是否 > 100 —— 足够则可以移除 More，把控件放回工具栏。
+/**
+ * header 剩余空间是否 > 100 —— 足够则可以移除 More，把控件放回工具栏。
  */ function shouldRemoveHeaderMore(width, leftWidth, rightWidth) {
     return width - leftWidth - rightWidth > 100;
 }
-/**
- * footer 剩余空间是否 < 16 —— 不足则需要把控件收拢进 More。
+/**
+ * footer 剩余空间是否 < 16 —— 不足则需要把控件收拢进 More。
  */ function shouldCollapseFooter(width, leftWidth, rightWidth) {
     return width - leftWidth - rightWidth < 16;
 }
-/**
- * footer 从 More 中释放控件时的展开阈值。
- *
- * 基准为 50；当 More 中已有控件时，加上首个控件宽度（保持与历史实现一致的运算与兜底：
- * `50 + firstItemWidth || 0`）。
- * @param firstItemWidth More 列表中第一个控件的宽度；未提供表示 More 为空。
+/**
+ * footer 从 More 中释放控件时的展开阈值。
+ *
+ * 基准为 50；当 More 中已有控件时，加上首个控件宽度（保持与历史实现一致的运算与兜底：
+ * `50 + firstItemWidth || 0`）。
+ * @param firstItemWidth More 列表中第一个控件的宽度；未提供表示 More 为空。
  */ function computeFooterExpandOffset(firstItemWidth) {
     var base = 50;
     if (firstItemWidth === undefined) return base;
     return base + firstItemWidth || 0;
 }
-/**
- * footer 剩余空间是否足够把一个控件从 More 释放回工具栏。
+/**
+ * footer 剩余空间是否足够把一个控件从 More 释放回工具栏。
  */ function shouldExpandFooter(width, leftWidth, rightWidth, offset) {
     return width - leftWidth - rightWidth > offset;
 }
@@ -10886,14 +11084,14 @@ var THEME_DEFAULT_OPTIONS = {
         });
         this.$container.classList.remove("" + PREFIX_CLASS);
         this._themeData = null;
-        if (this.i18n) this.i18n = null;
+        // 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;
+        // if (this.logger) this.logger = null!; // 注释是为了防止出错
         // 销毁后，将 destroyed 设置为 true
         this.destroyed = true;
     };
@@ -11486,6 +11684,9 @@ var THEME_DEFAULT_OPTIONS = {
             },
             set: function set(url) {
                 this._url = url;
+                // 地址变了回放类型也要跟着变，否则 recType / playType 会停留在上一个地址的结果，
+                // 进而影响倍速档位过滤、回放类型控件激活态与控件支持性校验
+                this._getRecType(url);
             }
         },
         {
@@ -11499,6 +11700,32 @@ var THEME_DEFAULT_OPTIONS = {
                 return {};
             }
         },
+        {
+            key: "playType",
+            get: /**
+   * 当前播放类型，由播放地址解析得出
+   *
+   * 取值 `'live' | 'rec' | 'cloudRec' | 'cloudRecord'`，无法判定时为空字符串 `''`。
+   *
+   * 与 {@link recType} 的关系：`recType` 只覆盖三种回放，直播时为空串；
+   * 本 getter 把直播也纳入同一个枚举，作为「当前播放类型」的统一出口。
+   *
+   * @remarks 空串表示无法从地址判定（如 rtmp、webrtc、地址未设置）。
+   * 此时控件支持性校验会整体跳过，避免对判不出类型的地址误报。
+   * @since 3.1.7
+   * ```ts
+   * theme.playType // 'cloudRec'
+   * ```
+   */ function get() {
+                var _this_urlInfo;
+                // 回放三类由 _getRecType 解析（含 busType=7 → cloudRecord 的区分）
+                if (this.recType) return this.recType;
+                if (((_this_urlInfo = this.urlInfo) == null ? void 0 : _this_urlInfo.type) === 'live') return 'live';
+                // 标准流直播：http(s) 且不走回放路径 /openpb/
+                if (this._url && isHttp(this._url) && !this._url.includes('/openpb/')) return 'live';
+                return '';
+            }
+        },
         {
             key: "width",
             get: /**
@@ -11985,6 +12212,6 @@ var THEME_DEFAULT_OPTIONS = {
     zh: zh,
     en: en
 };
-/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.6';
+/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.7-beta.1';
 
-export { Control, EVENTS, Fullscreen, Loading, Message, Play, Poster, Rec, Theme, Utils, Volume };
+export { CONTROL_INIT_EVENTS, Control, EVENTS, Fullscreen, Loading, Message, Play, Poster, Rec, Theme, Utils, Volume };