npm - @ezuikit/player-theme - Versions diffs - 3.1.6-beta.1 → 3.1.7-beta.1 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.esm.js CHANGED Viewed

@@ -1,6 +1,6 @@
 /*
-* @ezuikit/player-theme v3.1.6-beta.1
-* Copyright (c) 2026-09-16 19:24: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: '取流地址或端口非法',
@@ -2966,7 +3058,8 @@ var zh = {
     cancel: '取消',
     ok: '确定',
     close: '关闭',
-    BTN_REC_LIST_TITLE: '录像片段'
+    BTN_REC_LIST_TITLE: '录像片段',
+    UNKOWN_ISSUE: '未知问题 【{{scope}}】'
 };
 // 不要出现多层的的数据, 数据铺平
@@ -3250,7 +3343,8 @@ var en = {
     cancel: 'Cancel',
     ok: 'Ok',
     close: 'Close',
-    BTN_REC_LIST_TITLE: 'Records'
+    BTN_REC_LIST_TITLE: 'Records',
+    UNKOWN_ISSUE: 'Unknown issue [{{scope}}]'
 };
 /**
@@ -3367,8 +3461,8 @@ var en = {
     }
 };
-/**
- * flv 预览
+/**
+ * flv 预览
  */ var hlsLiveTemplate = {
     autoFocus: 3,
     // poster:
@@ -3420,8 +3514,8 @@ var en = {
     }
 };
-/**
- * flv 预览
+/**
+ * flv 预览
  */ var hlsRecTemplate = {
     autoFocus: 3,
     // poster:
@@ -3479,8 +3573,8 @@ var en = {
     }
 };
-/**
- * pc 预览
+/**
+ * pc 预览
  */ var pcLive = {
     autoFocus: 3,
     header: {
@@ -3579,8 +3673,8 @@ var en = {
     }
 };
-/**
- * pc 回放
+/**
+ * pc 回放
  */ var pcRec = {
     header: {
         // color: DEFAULT_COLOR,
@@ -3691,8 +3785,8 @@ var en = {
     }
 };
-/**
- * mobile 预览
+/**
+ * mobile 预览
  */ var mobileLive = {
     header: {
         // color: DEFAULT_COLOR,
@@ -3780,8 +3874,8 @@ var en = {
     }
 };
-/**
- * mobile 回放
+/**
+ * mobile 回放
  */ var mobileRec = {
     header: {
         // color: DEFAULT_COLOR,
@@ -3875,8 +3969,8 @@ var en = {
     }
 };
-/**
- * 安防版(预览/回放)
+/**
+ * 安防版(预览/回放)
  */ var security = {
     header: {
         // color: DEFAULT_COLOR,
@@ -3952,8 +4046,8 @@ var en = {
     }
 };
-/**
- * 语音版（预览）
+/**
+ * 语音版（预览）
  */ var voice = {
     header: {
         // color: DEFAULT_COLOR,
@@ -4005,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,
@@ -4039,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) {
@@ -4071,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;
@@ -4188,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) {
@@ -4236,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,
@@ -4248,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;
@@ -4270,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;
@@ -4913,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 + '')) {
@@ -4992,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) {
@@ -5071,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);
@@ -5092,8 +5186,8 @@ var ZOOM_DEFAULT_OPTIONS = {
         },
         {
             key: "active",
-            get: /**
-   * 是否激活
+            get: /**
+   * 是否激活
    */ function get() {
                 return this._active;
             },
@@ -5742,8 +5836,8 @@ function rgbOrHexToRgbaWithOpacity(color, opacity) {
     return '';
 }
-/**
- * Header
+/**
+ * Header
  */ var Component = /*#__PURE__*/ function() {
     function Component(options) {
         if (options === void 0) options = {};
@@ -5795,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);
@@ -6072,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) {
@@ -6093,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")) {
@@ -6140,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) {
@@ -6173,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;
@@ -6243,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) {
@@ -6334,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;
@@ -6380,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';
@@ -6438,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) {
@@ -6460,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;
@@ -6498,8 +6600,8 @@ var RECORD_DEFAULT_OPTIONS = {
         this._destroyTimer();
         Control.prototype.destroy.call(this);
     };
-    /**
-   * 销毁定时器和销毁节点
+    /**
+   * 销毁定时器和销毁节点
    */ _proto._destroyTimer = function _destroyTimer() {
         this._seconds = 0;
         if (this._timer) {
@@ -6514,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);
@@ -6523,8 +6625,8 @@ var RECORD_DEFAULT_OPTIONS = {
     _create_class$3(Record, [
         {
             key: "active",
-            get: /**
-   * 是否激活
+            get: /**
+   * 是否激活
    */ function get() {
                 return this._active;
             },
@@ -6717,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) {
@@ -6767,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;
@@ -6796,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) {
@@ -6832,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 {
@@ -6988,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) {
@@ -7033,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;
@@ -7063,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 {
@@ -7219,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) {
@@ -7265,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;
@@ -7295,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) {
@@ -7326,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) {
@@ -7353,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;
@@ -7366,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);
@@ -7417,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) {
@@ -7439,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;
@@ -7525,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);
@@ -7538,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，这里不额外处理
@@ -7671,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;
@@ -7703,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) {
@@ -7734,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) {
@@ -7763,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);
@@ -7837,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) {
@@ -7936,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 = [];
@@ -8023,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);
@@ -8046,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);
     };
@@ -8066,8 +8191,8 @@ var SELECT_DEFAULT_OPTIONS = {
         },
         {
             key: "disabled",
-            get: /**
-   * 是否禁用
+            get: /**
+   * 是否禁用
    */ function get() {
                 return this._disabled;
             },
@@ -8153,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) {
@@ -8227,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");
@@ -8280,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",
@@ -8294,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) {
@@ -8334,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/ 是标准流回放路径
@@ -8365,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) {
@@ -8572,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) {
@@ -8604,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) {
@@ -8667,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);
@@ -8685,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();
@@ -8699,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) {
@@ -8738,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) {
@@ -8899,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) {
@@ -8937,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;
@@ -8962,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) {
@@ -9034,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();
@@ -9047,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)) {
@@ -9077,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) {
@@ -9119,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) {
@@ -9150,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) {
@@ -9170,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");
@@ -9331,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) {
@@ -9409,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) {
@@ -9427,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;
@@ -9473,8 +9636,8 @@ var PAUSE_DEFAULT_OPTIONS = {};
             }, 300);
         }, 10);
     };
-    /**
-   * 销毁
+    /**
+   * 销毁
    */ _proto.destroy = function destroy() {
         if (this._timer) {
             clearTimeout(this._timer);
@@ -9762,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 = {};
@@ -9804,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;
@@ -9833,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");
@@ -10041,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,
@@ -10056,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);
@@ -10096,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) {
@@ -10113,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) {
@@ -10129,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) {
@@ -10145,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) {
@@ -10163,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;
@@ -10213,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);
@@ -10226,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;
 }
@@ -10457,6 +10657,11 @@ function _unsupported_iterable_to_array(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(o, minLen);
 }
+/**
+ * 语言包缺 key 时的兜底文案 key
+ *
+ * 拼写沿用语言包中既有的 `UNKOWN_ISSUE`（少了一个 N），改名属破坏性变更，故保持原样。
+ */ var UNKOWN_ISSUE_KEY = 'UNKOWN_ISSUE';
 var THEME_DEFAULT_OPTIONS = {
     dblClickFullscreen: true,
     language: 'zh',
@@ -10532,7 +10737,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 = '', /** 是否播放中 @private */ _this._playing = false, /** @private 加载中 */ _this._loading = false, /** 音量 */ _this._volume = 0, /** 静音 */ _this._muted = false, /** 正在兜底的原始 scope，非 null 表示处于兜底取值中（用于避免 customizeMissing 无限递归） */ _this._missingScope = null, /** 电子放大倍数 @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 下发，主题层据此决定日历/回放类型按钮
    * 是否渲染、片段进度条是否渲染。区间没有运行时变更入口。
@@ -10795,6 +11000,50 @@ var THEME_DEFAULT_OPTIONS = {
         }
     };
     /**
+   * 获取多语言文案
+   *
+   * 相比直接用 `theme.i18n.t()`：返回类型收窄为 `string`（底层签名是 `string | number`，
+   * 调用处不必再写 `as string`）。缺失 key 的兜底由 i18n 实例上的 `customizeMissing`
+   * 统一处理，因此两者在兜底行为上一致。
+   * @param scope 多语言 key
+   * @param variables 插值变量，如 `{ zoom: 8 }`；传 `defaultvalue` 可指定自己的兜底文案
+   * @returns 文案；scope 不存在时返回「未知问题 【scope】」
+   * @example
+   * ```ts
+   * theme.t('ZOOM_LIMIT_MAX', { zoom: 8 });
+   * theme.t('NOT_EXIST_KEY'); // 未知问题 【NOT_EXIST_KEY】
+   * theme.t('NOT_EXIST_KEY', { defaultvalue: '自定义兜底' }); // 自定义兜底
+   * ```
+   */ _proto.t = function t(scope, variables) {
+        return this.i18n.t(scope, variables);
+    };
+    /**
+   * 语言包缺 key 时的兜底文案（`customizeMissing` 的实现）
+   *
+   * 注意底层是把本方法的返回值「原样返回」、不再做插值，所以这里借
+   * `i18n.t(UNKOWN_ISSUE)` 完成插值。而这一次取值本身也可能缺失
+   * （如 `language` 传了不存在的语言，当前语言包整体不存在），
+   * 那会再次回调到这里造成无限递归，因此用重入标记兜住，退化为直接返回原始 scope。
+   *
+   * 注：`options.locales` 与内置语言包是深合并，无法移除内置的 UNKOWN_ISSUE，
+   * 因此正常配置下不会走到退化分支。
+   * @param scope 缺失的多语言 key
+   * @param variables 原始插值变量
+   */ _proto._missingText = function _missingText(scope, variables) {
+        // 兜底文案自身也缺失（如当前语言的语言包不存在）：直接返回最初的 scope，
+        // 而不是兜底 key 本身，否则用户看到的是 'UNKOWN_ISSUE' 这种无意义内容
+        if (this._missingScope !== null) return "" + this._missingScope;
+        this._missingScope = scope;
+        try {
+            // scope 放在最后，避免调用方传入同名变量把它覆盖掉
+            return this.i18n.t(UNKOWN_ISSUE_KEY, _extends({}, variables, {
+                scope: scope
+            }));
+        } finally{
+            this._missingScope = null;
+        }
+    };
+    /**
    * 销毁包括事件、控件 ...
    *
    * Destroy (including events, controls...)
@@ -10835,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;
     };
@@ -10850,6 +11099,7 @@ var THEME_DEFAULT_OPTIONS = {
     // 私有方法
     // ==============================================================================================
     /** 初始化配置项 */ _proto._initOptions = function _initOptions(options) {
+        var _this = this;
         if (options === void 0) options = {};
         var _this_options_loggerOptions, _this_options_definitionOptions_list, _this_options_definitionOptions, _this_options_videoLevelList;
         // 先对模块级默认配置做一次深拷贝，得到全新的嵌套对象/数组，
@@ -10902,7 +11152,13 @@ var THEME_DEFAULT_OPTIONS = {
         });
         // prettier-ignore
         this.i18n = new I18n(locales, {
-            defaultLocale: language
+            defaultLocale: language,
+            // 语言包缺 key 时，底层默认返回 `[missing "zh.XXX" translation]`，
+            // 这种占位串一旦透到 UI 上对用户毫无意义。挂在 i18n 实例上统一兜底，
+            // 这样控件内直接调用 `i18n.t()` 的地方也能受益，无需逐处改造。
+            customizeMissing: function customizeMissing(scope, variables) {
+                return _this._missingText(scope, variables);
+            }
         });
         // 默认清晰度列表
         if (((_this_options_definitionOptions = this.options.definitionOptions) == null ? void 0 : (_this_options_definitionOptions_list = _this_options_definitionOptions.list) == null ? void 0 : _this_options_definitionOptions_list.length) > 0 || ((_this_options_videoLevelList = this.options.videoLevelList) == null ? void 0 : _this_options_videoLevelList.length) > 0) {
@@ -11428,6 +11684,9 @@ var THEME_DEFAULT_OPTIONS = {
             },
             set: function set(url) {
                 this._url = url;
+                // 地址变了回放类型也要跟着变，否则 recType / playType 会停留在上一个地址的结果，
+                // 进而影响倍速档位过滤、回放类型控件激活态与控件支持性校验
+                this._getRecType(url);
             }
         },
         {
@@ -11441,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: /**
@@ -11927,6 +12212,6 @@ var THEME_DEFAULT_OPTIONS = {
     zh: zh,
     en: en
 };
-/** 版本号 @since 0.0.1 */ Theme.THEME_VERSION = '3.1.6-beta.1';
+/** 版本号 @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 };