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

package/dist/types/index.d.ts

@@ -4,6 +4,7 @@ import I18n, { I18nTranslation } from '@ezuikit/utils-i18n';
 import { LoggerCls, LoggerOptions } from '@ezuikit/utils-logger';
 import { BasePtzOptions } from '@ezuikit/control-ptz';
 import { RecListModalOptions } from '@ezuikit/control-rec-list-modal';
+import * as _ezuikit_utils_tools from '@ezuikit/utils-tools';
 import Zoom from '@ezuikit/control-zoom';
 import { TimeLineTimeSection } from '@ezuikit/control-time-line';
 import { TimePickerOptions } from '@ezuikit/control-date-picker';
@@ -17,7 +18,7 @@ declare const THEME_SCALE_MODE_TYPE: {
     /** 视频画面做等比缩放后,完全填充canvas区域,画面不被拉伸,没有黑边,但画面显示不全 */
     readonly fullAuto: 2;
 };
-declare const THEME_PROPS: readonly ["width", "height", "playing", "volume", "muted", "loading", "recType", "isCurrentFullscreen", "orientationAngle", "zooming", "zoom", "recording", "recordList", "speed", "urlInfo", "videoLevelList", "videoLevel", "recMonth"];
+declare const THEME_PROPS: readonly ["width", "height", "playing", "volume", "muted", "loading", "recType", "isCurrentFullscreen", "orientationAngle", "zooming", "zoom", "recording", "recordList", "speed", "urlInfo", "videoLevelList", "videoLevel", "recMonth", "url"];
 /**
  *
  * 事件名
@@ -857,7 +858,7 @@ declare class Volume extends Control {
 /**
  * 全屏信息
  */
-interface FullscreenChangeInfo {
+interface FullscreenChangeInfo$1 {
     /** 当前窗口是否处于全屏 */
     isCurrentFullscreen: boolean;
     /** 浏览器中是否有全屏 （移动端中永远是 false） */
@@ -868,7 +869,7 @@ interface FullscreenChangeInfo {
 /**
  * 全屏变化回调
  */
-type FullscreenChange = (info: FullscreenChangeInfo) => void;
+type FullscreenChange = (info: FullscreenChangeInfo$1) => void;
 /**
  * 全屏配置项
  */
@@ -952,7 +953,7 @@ interface FullscreenOptions extends Omit<ControlOptions, 'tagName'> {
      * 全屏改变
      * @param info FullscreenChangeInfo 全屏信息
      */
-    onChange?: (info: FullscreenChangeInfo) => void;
+    onChange?: (info: FullscreenChangeInfo$1) => void;
 }
 /**
  * 全屏控件
@@ -970,7 +971,7 @@ declare class Fullscreen extends Control {
      */
     destroy(): void;
     protected _render(): void;
-    protected _fullscreenChange(info: FullscreenChangeInfo): void;
+    protected _fullscreenChange(info: FullscreenChangeInfo$1): void;
     /**
      * 点击 Control 会触发
      */
@@ -1491,9 +1492,10 @@ declare class Theme extends EventEmitter {
         readonly audioInfo: "audioInfo";
         readonly videoInfo: "videoInfo";
         readonly firstFrameDisplay: "firstFrameDisplay";
-        readonly fullscreen: "fullscreen";
+        readonly fullscreen: "fullscreen"; /** 所有私有流的模板 @since 0.0.1 */
         readonly exitFullscreen: "exitFullscreen";
         readonly fullscreenChange: "fullscreenChange";
+        /** 播放器配置项 */
         readonly resize: "resize";
         readonly orientationChange: "orientationChange";
         readonly audioCodecUnsupported: "audioCodecUnsupported";
@@ -1503,7 +1505,7 @@ declare class Theme extends EventEmitter {
         readonly speedChange: "speedChange";
         readonly recordingChange: "recordingChange";
         readonly talkingChange: "talkingChange";
-        readonly talkVolumeChange: "talkVolumeChange";
+        readonly talkVolumeChange: "talkVolumeChange"; /** 封面控件 @since 0.0.1 @private */
         readonly broadcastChange: "broadcastChange";
         readonly aichatChange: "aichatChange";
         readonly liveChange: "liveChange";
@@ -1520,9 +1522,9 @@ declare class Theme extends EventEmitter {
         readonly getOSDTime: "getOSDTime";
         readonly control: {
             readonly play: "Control.play";
-            readonly playDestroy: "Control.playDestroy"; /**  @since 0.0.1 @private */
+            readonly playDestroy: "Control.playDestroy";
             readonly capturePicture: "Control.capturePicture";
-            readonly capturePictureResult: "Control.capturePictureResult";
+            readonly capturePictureResult: "Control.capturePictureResult"; /**  @since 0.0.1 @private */
             readonly capturePictureDestroy: "Control.capturePictureDestroy";
             readonly volumechange: "Control.volumechange";
             readonly volumePanelOpenChange: "Control.volumePanelOpenChange";
@@ -1531,8 +1533,8 @@ declare class Theme extends EventEmitter {
             readonly headerMoreShowControlsChange: "Control.headerMoreShowControlsChange";
             readonly headerMorePanelOpenChange: "Control.headerMorePanelOpenChange";
             readonly footerMoreShowControlsChange: "Control.footerMoreShowControlsChange";
-            /** 放大中  true: 可缩放状态，false: 禁止缩放状态(不能缩放) @private */
             readonly footerMorePanelOpenChange: "Control.footerMorePanelOpenChange";
+            /** 录制中 @private */
             readonly deviceDestroy: "Control.deviceDestroy";
             readonly recTypeChange: "Control.recTypeChange";
             readonly recDestroy: "Control.recDestroy";
@@ -1541,7 +1543,9 @@ declare class Theme extends EventEmitter {
             readonly definitionPanelOpenChange: "Control.definitionPanelOpenChange";
             readonly definitionDestroy: "Control.definitionDestroy";
             readonly speedChange: "Control.speedChange";
-            readonly speedPanelOpenChange: "Control.speedPanelOpenChange";
+            readonly speedPanelOpenChange: "Control.speedPanelOpenChange"; /**
+             * 录像回放的月份列表 @private
+             */
             readonly speedDestroy: "Control.speedDestroy";
             readonly ptzPanelOpenChange: "Control.ptzPanelOpenChange";
             readonly ptzSpeedChange: "Control.ptzSpeedChange";
@@ -1700,6 +1704,7 @@ declare class Theme extends EventEmitter {
             397007: string;
             399000: string;
             399001: string;
+            /** 移动端竖屏, 全屏情况下不展示扩张，放置在 footer 中 */
             399002: string;
             399016: string;
             399048: string;
@@ -1764,6 +1769,7 @@ declare class Theme extends EventEmitter {
             CHANGE_VIDEO_LEVEL: string;
             CHANGE_VIDEO_LEVEL_FAIL: string;
             GET_VIDEO_LEVEL_LIST: string;
+            /** 消息提示控件 @since 0.0.1 @private */
             PLEASE_INPUT_RIGHT_VIDEO_LEVEL: string;
             VIDEO_LEVEL_NOT_SUPPORT: string;
             VIDEO_LEVEL_AUTO: string;
@@ -1786,17 +1792,18 @@ declare class Theme extends EventEmitter {
             BTN_AICHAT: string;
             BTN_LIVE: string;
             BTN_REC_DROPDOWN: string;
-            BTN_ALARM_MESSAGE: string; /** 低部控件 @since 0.0.1 @private */
+            BTN_ALARM_MESSAGE: string;
             REC_DROPDOWN_CLOUD_REC: string;
-            REC_DROPDOWN_CLOUD_RECORD: string; /** 回放底部时间轴 @since 0.0.1 @private */
+            REC_DROPDOWN_CLOUD_RECORD: string;
             REC_DROPDOWN_LOCAL_REC: string;
-            BTN_ZOOM: string;
-            BTN_3D_ZOOM: string; /**
+            BTN_ZOOM: string; /** 回放底部时间轴 @since 0.0.1 @private */
+            BTN_3D_ZOOM: string;
+            BTN_PTZ: string;
+            BTN_GLOBAL_FULLSCREEN: string;
+            /**
              * 移动端扩展容器, 扩展的控件渲染在指定容器以外， 仅只用端适用， 为了可以放置大的控件和方便开发接入
              * @private
              */
-            BTN_PTZ: string;
-            BTN_GLOBAL_FULLSCREEN: string;
             BTN_EXIT_GLOBAL_FULLSCREEN: string;
             BTN_FULLSCREEN: string;
             BTN_EXIR_FULLSCREEN: string;
@@ -1814,13 +1821,14 @@ declare class Theme extends EventEmitter {
             CAPTURE_FAILED: string;
             START_RECORD_SUCCESS: string;
             START_RECORD_FAILED: string;
-            STOP_RECORD_SUCCESS: string;
+            STOP_RECORD_SUCCESS: string; /**  resizeObserver 监听销毁 */
             STOP_RECORD_FAILED: string;
             RECORD_TIPS: string;
             RECORDS: string;
             OPEN_SOUND: string;
             CLOSE_SOUND: string;
             SOUND_OPENED: string;
+            /** 容器的宽 */
             ZOOM: string;
             START_ZOOM: string;
             CLOSE_ZOOM: string;
@@ -1829,10 +1837,10 @@ declare class Theme extends EventEmitter {
             ZOOM_ADD_MAX: string;
             ZOOM_SUB_MIN: string;
             ZOOM_LIMIT_MAX: string;
-            ZOOM_LIMIT_MIN: string; /** @private 加载中 */
-            ZOOM_NOT_ENABLED: string;
-            '3D_ZOOM': string; /** 音量 */
-            '3D_ZOOM_DISABLE': string; /** 静音 */
+            ZOOM_LIMIT_MIN: string;
+            ZOOM_NOT_ENABLED: string; /** 是否播放中 @private */
+            '3D_ZOOM': string;
+            '3D_ZOOM_DISABLE': string;
             '3D_ZOOM_FAILED': string;
             START_3D_ZOOM: string;
             CLOSE_3D_ZOOM: string;
@@ -1840,29 +1848,26 @@ declare class Theme extends EventEmitter {
             '3D_ZOOM_ACTIVED': string;
             '3D_ZOOM_NOT_ACTIVED': string;
             '3D_ZOOM_CLOSED': string;
-            CHANGE_ZOOM_TYPE: string; /** 自定清晰度 @private */
+            CHANGE_ZOOM_TYPE: string;
             FULLSCREEN: string;
             FULLSCREEN_EXIT: string;
             GET_WEB_FULLSCREEN_STATUS: string;
-            WEB_FULLSCREEN: string;
+            WEB_FULLSCREEN: string; /** 清晰度列表 */
             WEB_FULLSCREEN_EXIT: string;
             DESTROY: string;
             GET_CAPACITY: string;
             GET_PTZ_STATUS: string;
             GET_PTZ_STATUS_FAILED: string;
-            /**
-             * 录像回放的月份列表 @private
-             */
             MOBILE_HIDE_PTZ: string;
             OPTION_PTZ_FAILED: string;
             MOBILE_PTZ_TIPS: string;
-            /**
-             * 录像回放的月份列表 @private
-             */
             PTZ_FAST: string;
             PTZ_MID: string;
             PTZ_SLOW: string;
             PTZ_SPEED: string;
+            /**
+             * 录像回放的月份列表 @private
+             */
             DEVICE_ZOOM: string;
             DEVICE_FOCUS: string;
             NOT_SUPPORT_DEVICE_ZOOM: string;
@@ -1871,7 +1876,7 @@ declare class Theme extends EventEmitter {
             MIRROR_TYPE_ERROR: string;
             CHANGE_FEC_TYPE: string;
             DEVICE_NOT_SUPPORT: string;
-            TYPE_NOT_SUPPORT: string; /** 播放地址信息 */
+            TYPE_NOT_SUPPORT: string;
             FEC_SUPPORT_VERSION: string;
             NO_CANVAS_ID: string;
             SET_FEC_PARAMS: string;
@@ -1930,7 +1935,7 @@ declare class Theme extends EventEmitter {
             395558: string;
             395560: string;
             395561: string;
-            395562: string; /** 事件名称 @since 0.0.1 */
+            395562: string;
             395563: string;
             395564: string;
             395566: string;
@@ -1941,7 +1946,8 @@ declare class Theme extends EventEmitter {
             395601: string;
             395602: string;
             395610: string;
-            395620: string; /** 封面控件 @since 0.0.1 @private */
+            /** 暂停控件 @since 0.0.1 @private */
+            395620: string;
             395701: string;
             395702: string;
             395703: string;
@@ -1957,25 +1963,25 @@ declare class Theme extends EventEmitter {
             396108: string;
             396109: string;
             396110: string;
-            /**  resizeObserver 监听销毁 */
             396501: string;
             396502: string;
             396503: string;
             396504: string;
             396505: string;
+            /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */
             396506: string;
-            396508: string; /** 静音 */
+            396508: string;
             396509: string;
             396510: string;
             396511: string;
-            396512: string;
+            396512: string; /** 倍速 @private */
             396513: string;
             396514: string;
             396515: string;
+            396516: string;
             /**
              * 录像回放的月份列表 @private
              */
-            396516: string;
             396517: string;
             396518: string;
             396519: string;
@@ -2041,15 +2047,14 @@ declare class Theme extends EventEmitter {
             SPEED_RATE: string;
             SPEED_CANCEL: string;
             GET_SPEED: string;
-            /**
-             * 当前播放状态
+            MAX_SPEED_LIMIT: string;
+            MIN_SPEED_LIMIT: string;
+            SEEK_CANNOT_CROSS_DAYS: string; /**
+             * 容器的高(单位 px)
              * ```ts
-             * theme.playing // boolean
+             * theme.height // number
              * ```
              */
-            MAX_SPEED_LIMIT: string;
-            MIN_SPEED_LIMIT: string;
-            SEEK_CANNOT_CROSS_DAYS: string;
             SEEK_TIMEFORMAT_ERROR: string;
             PAUSE: string;
             PAUSE_FAILED: string;
@@ -2076,13 +2081,6 @@ declare class Theme extends EventEmitter {
             BTN_PAUSE: string;
             BTN_VOLUME: string;
             BTN_MUTED: string;
-            /**
-             * 加载状态
-             * ```ts
-             * // 事件监听
-             * theme.on(Theme.EVENTS.loading, (loading: boolean) => {})
-             * ```
-             */
             BTN_RECORDVIDEO: string;
             BTN_CAPTURE: string;
             BTN_TALK: string;
@@ -2090,9 +2088,21 @@ declare class Theme extends EventEmitter {
             BTN_AICHAT: string;
             BTN_LIVE: string;
             BTN_REC_DROPDOWN: string;
+            /**
+             * 加载中
+             * ```ts
+             * theme.loading // boolean
+             * ```
+             */
             BTN_ALARM_MESSAGE: string;
             REC_DROPDOWN_CLOUD_REC: string;
-            REC_DROPDOWN_CLOUD_RECORD: string;
+            REC_DROPDOWN_CLOUD_RECORD: string; /**
+             * 加载状态
+             * ```ts
+             * // 事件监听
+             * theme.on(Theme.EVENTS.loading, (loading: boolean) => {})
+             * ```
+             */
             REC_DROPDOWN_LOCAL_REC: string;
             BTN_ZOOM: string;
             BTN_3D_ZOOM: string;
@@ -2104,7 +2114,13 @@ declare class Theme extends EventEmitter {
             BTN_EXPEND: string;
             BTN_WEBEXPEND: string;
             BTN_HD: string;
-            BTN_SPEED: string;
+            BTN_SPEED: string; /**
+             * 音量值
+             * ```ts
+             * // 事件监听
+             * theme.on(Theme.EVENTS.volumechange, (volume: number, muted: boolean) => {})
+             * ```
+             */
             BTN_CLOUDREC: string;
             BTN_CLOUDRECORD: string;
             BTN_REC: string;
@@ -2260,6 +2276,7 @@ declare class Theme extends EventEmitter {
     private _isCurrentFullscreen;
     /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */
     private _orientationAngle;
+    _url: string;
     /** 是否播放中 @private */
     _playing: boolean;
     /** @private 加载中 */
@@ -2294,10 +2311,14 @@ declare class Theme extends EventEmitter {
     _onPauseTimingFunc: ((open: boolean) => void) | null;
     /** 销毁标识  @readonly */
     destroyed: boolean;
-    /** 播放地址信息 */
-    urlInfo: any | null;
     scaleMode: ThemeOptions['scaleMode'];
     constructor(options: ThemeOptions);
+    get url(): string;
+    set url(url: string);
+    /**
+     * url 信息 播放地址信息
+     */
+    get urlInfo(): Partial<_ezuikit_utils_tools.EzopenURL>;
     /**
      * 容器的宽(单位 px)
      * ```ts
@@ -2635,6 +2656,12 @@ declare class Theme extends EventEmitter {
      * 窗口全屏后旋转 90度判断， 然后设置控件已经旋转 90度， 为了解决控件交互问题
      */
     private _isRotated;
+    get isEzopen(): boolean;
+    /**
+     * 判断播放地址是萤石的播放地址
+     * @since 3.1.2
+     */
+    get isEzviz(): boolean;
 }
 
 /**
@@ -2755,7 +2782,7 @@ interface ThemeOptions {
     ptzOptions?: OmitControlOptions<PtzOptions> | null;
     /** 回放类型控件配置， 设置 null 不渲染控件 @since 0.0.1 */
     recOptions?: OmitControlOptions<RecOptions> | null;
-    /** 录像列表控件配置， 设置 null 不渲染控件 @since 0.0.1 */
+    /** 录像列表控件配置， 设置 null 不渲染控件 @since 3.1.1 */
     recListOptions?: OmitControlOptions<RecListOptions> | null;
     /** 录制控件配置 ，设置 null 不渲染控件 @since 0.0.1 */
     recordOptions?: OmitControlOptions<RecordOptions> | null;
@@ -2913,5 +2940,247 @@ declare class Utils {
     static resizeObserver(node: Element, callback?: (entries: ResizeObserverEntry[], observer: ResizeObserver) => void): CleanUpResizeObserver;
 }
 
+/**
+ * 事件类型定义
+ *
+ * 本文件根据 `src/constant.ts` 的 `EVENTS` 常量生成对应的「事件名」与「事件载荷」类型，
+ * 用于给 `theme.on / once / off / emit` 提供类型提示。
+ *
+ * - 事件名（`ThemeEventName` 等）直接由 `typeof EVENTS` 推导，随 `EVENTS` 自动同步。
+ * - 事件载荷（`ThemeEventMap`）依据事件文档与实际 emit 现场（`_bindEventemitter.ts` 等）手写，
+ *   键为事件的「字符串值」（如 `'play'`、`'Control.play'`、`'Theme.destroyed'`），
+ *   与 `EVENTS.play` / `EVENTS.control.play` / `EVENTS.theme.destroyed` 的取值一致。
+ * - 文件末尾有编译期断言：保证 `EVENTS` 中的每个事件都在 `ThemeEventMap` 中声明了类型，
+ *   反之亦然（防止漏写或写错事件名）。
+ *
+ * @remarks 载荷见 guide/events.md。标注为 `unknown` 的表示载荷由内核/插件决定，未固定结构。
+ */
+
+type EventsConst = typeof EVENTS;
+/** 对外事件名，如 `'play'`、`'volumechange'`、`'message'` */
+type ThemeOuterEventName = EventsConst[Exclude<keyof EventsConst, 'control' | 'theme'>];
+/** 控件事件名，如 `'Control.play'`、`'Control.volumechange'` */
+type ControlEventName = EventsConst['control'][keyof EventsConst['control']];
+/** 主题生命周期事件名，如 `'Theme.destroyed'` */
+type ThemeLifecycleEventName = EventsConst['theme'][keyof EventsConst['theme']];
+/** 所有事件名（对外 + 控件 + 生命周期）的并集 */
+type ThemeEventName = ThemeOuterEventName | ControlEventName | ThemeLifecycleEventName;
+/** 屏幕旋转角度 */
+type OrientationAngle = 0 | 90 | 180 | 270;
+/** 全屏状态变化载荷 */
+interface FullscreenChangeInfo {
+    /** 当前容器是否处于全局全屏 */
+    isCurrentFullscreen: boolean;
+    /** 是否浏览器全屏 */
+    isFullscreen: boolean;
+    /** 是否移动端（移动端为模拟全屏） */
+    isMobile: boolean;
+    /** 旋转角度 */
+    orientationAngle?: OrientationAngle;
+}
+/** 容器尺寸变化载荷 */
+interface ResizeInfo {
+    width: number;
+    height: number;
+    isCurrentFullscreen?: boolean;
+    orientationAngle?: OrientationAngle;
+}
+/** 音频信息（用于解禁音量控件） */
+interface AudioInfo {
+    /** 标准流编码类型 */
+    encType?: string;
+    /** 私有流音频格式名 */
+    audioFormatName?: string;
+    [key: string]: unknown;
+}
+/** 视频信息（用于重渲染画面） */
+interface VideoInfo {
+    width: number;
+    height: number;
+    [key: string]: unknown;
+}
+/** 云台错误信息 */
+interface PtzErrorInfo {
+    code: string | number;
+    localeKey?: string;
+    msg?: string;
+    [key: string]: unknown;
+}
+/**
+ * 事件名 → 监听器签名 的映射表。
+ *
+ * 可用于给 eventemitter3 提供泛型：`class Theme extends EventEmitter<ThemeEventMap>`，
+ * 或直接查询单个事件的处理函数类型：`ThemeEventMap['play']`。
+ */
+interface ThemeEventMap {
+    /** 加载状态变化 */
+    loading: (loading: boolean) => void;
+    /** 播放/暂停状态变化 */
+    play: (playing: boolean) => void;
+    /** 首帧显示（内部会解禁控件） */
+    firstFrameDisplay: () => void;
+    /** 截图 */
+    capturePicture: () => void;
+    /** 音量变化 */
+    volumechange: (volume: number, muted: boolean) => void;
+    /** 缩放倍数变化 */
+    zoomChange: (zoom: number) => void;
+    /** 缩放状态变化（true 可缩放 / false 禁止） */
+    zoomingChange: (zooming: boolean) => void;
+    /** 缩放平移改变（载荷来自缩放插件） */
+    zoomTranslateChange: (translate: unknown) => void;
+    /** 音频信息 */
+    audioInfo: (info: AudioInfo) => void;
+    /** 视频信息 */
+    videoInfo: (info: VideoInfo) => void;
+    /** 音频编码不支持（仅标准流 flv） */
+    audioCodecUnsupported: (flag: boolean) => void;
+    /** 进入全屏 */
+    fullscreen: () => void;
+    /** 退出全屏 */
+    exitFullscreen: () => void;
+    /** 全屏状态变化 */
+    fullscreenChange: (info: FullscreenChangeInfo) => void;
+    /** 容器尺寸变化 */
+    resize: (info: ResizeInfo) => void;
+    /** 屏幕旋转方向变化 */
+    orientationChange: (angle: OrientationAngle) => void;
+    /** 切换主题 */
+    changeTheme: (themeData: IThemeData | null) => void;
+    /** 回放类型切换 */
+    recTypeChange: (type: string) => void;
+    /** 切换清晰度 */
+    definitionChange: (definition: number, item?: DefinitionItem) => void;
+    /** 播放速度切换 */
+    speedChange: (speed: number, item?: unknown) => void;
+    /** 录制状态变化 */
+    recordingChange: (recording: boolean) => void;
+    /** 对讲状态变化 */
+    talkingChange: (talking: boolean) => void;
+    /** 麦克风音量变化（高频） */
+    talkVolumeChange: (value: number) => void;
+    /** 语音广播状态变化 */
+    broadcastChange: (active: boolean) => void;
+    /** AI 对话框状态变化 */
+    aichatChange: (active: boolean) => void;
+    /** 直播模式切换 */
+    liveChange: () => void;
+    /** 回放下拉选择变化 */
+    recDropdownChange: (type: string) => void;
+    /** 录像列表面板状态变化 */
+    recListChange: (active: boolean) => void;
+    /** 告警消息面板状态变化 */
+    alarmMessageChange: (active: boolean) => void;
+    /** 动态切换日志配置 */
+    setLoggerOptions: (options: LoggerOptions) => void;
+    /** 回放片段 */
+    records: (records: unknown) => void;
+    /** 云台速度变化 */
+    ptzSpeedChange: (speed: number) => void;
+    /** 设置清晰度列表 */
+    setVideoLevelList: (list: DefinitionItem[]) => void;
+    /** 当前清晰度 */
+    currentVideoLevel: (item: DefinitionItem | number, level: number) => void;
+    /** 当前是否自动清晰度 */
+    currentVideoLevelAuto: (auto: boolean) => void;
+    /** 设置全天回放片段（高频） */
+    setAllDayRecTimes: (data: {
+        list: unknown[];
+    }) => void;
+    /** OSD 时间（高频） */
+    getOSDTime: (time: {
+        data: number;
+    }) => void;
+    /** 统一消息提示入口（duration 单位秒） */
+    message: (message: string, type: string, duration?: number) => void;
+    /** 控件挂载前 */
+    'Control.beforeMountControls': () => void;
+    /** 控件挂载完成 */
+    'Control.mountedControls': () => void;
+    /** 控件卸载前 */
+    'Control.beforeUnmountControls': () => void;
+    /** 控件卸载完成 */
+    'Control.unmountedControls': () => void;
+    /** Header/Footer 显隐变化 */
+    'Control.controlsBarOpenChange': (open: boolean) => void;
+    /** Header 更多按钮列表变化 */
+    'Control.headerMoreShowControlsChange': (show: boolean) => void;
+    /** Header 更多面板显隐 */
+    'Control.headerMorePanelOpenChange': (open: boolean) => void;
+    /** Footer 更多按钮列表变化 */
+    'Control.footerMoreShowControlsChange': (show: boolean, controls?: unknown[]) => void;
+    /** Footer 更多面板显隐 */
+    'Control.footerMorePanelOpenChange': (open: boolean) => void;
+    /** 点击播放/暂停 */
+    'Control.play': (playing: boolean, from?: unknown) => void;
+    'Control.playDestroy': () => void;
+    'Control.capturePicture': (options?: unknown) => void;
+    'Control.capturePictureResult': (result: unknown) => void;
+    'Control.capturePictureDestroy': () => void;
+    'Control.volumechange': (volume: number, muted: boolean) => void;
+    'Control.volumePanelOpenChange': (open: boolean, volume: number, muted: boolean) => void;
+    'Control.volumeDestroy': () => void;
+    'Control.ptzPanelOpenChange': (open: boolean) => void;
+    'Control.ptzSpeedChange': (speed: number) => void;
+    'Control.ptzError': (info: PtzErrorInfo) => void;
+    'Control.ptzDestroy': () => void;
+    'Control.recordingChange': (recording: boolean) => void;
+    'Control.recordDestroy': () => void;
+    'Control.talkingChange': (talking: boolean) => void;
+    'Control.talkError': (info: unknown) => void;
+    'Control.talkDestroy': () => void;
+    'Control.broadcastChange': (active: boolean) => void;
+    'Control.broadcastDestroy': () => void;
+    'Control.aichatChange': (active: boolean) => void;
+    'Control.aichatDestroy': () => void;
+    'Control.liveChange': () => void;
+    'Control.liveDestroy': () => void;
+    'Control.recDropdownChange': (type: string) => void;
+    'Control.recDropdownDestroy': () => void;
+    'Control.alarmMessageChange': (active: boolean) => void;
+    'Control.alarmMessageDestroy': () => void;
+    'Control.recTypeChange': (type: string) => void;
+    'Control.recDestroy': () => void;
+    'Control.recListChange': (active: boolean) => void;
+    'Control.recListCardClick': (section: unknown, index: number, sections: unknown[]) => void;
+    'Control.recListDestroy': () => void;
+    'Control.definitionChange': (definition: number, item?: DefinitionItem) => void;
+    'Control.definitionList': (list: DefinitionItem[]) => void;
+    'Control.definitionPanelOpenChange': (open: boolean, definition: number, item?: DefinitionItem) => void;
+    'Control.definitionDestroy': () => void;
+    'Control.speedChange': (speed: number, item?: unknown) => void;
+    'Control.speedPanelOpenChange': (open: boolean, speed: number, item?: unknown) => void;
+    'Control.speedDestroy': () => void;
+    'Control.zoomChange': (zoom: number) => void;
+    'Control.zoomPanelOpenChange': (open: boolean) => void;
+    'Control.zoomDestroy': () => void;
+    'Control.fullscreenDestroy': () => void;
+    'Control.globalFullscreenDestroy': () => void;
+    'Control.deviceDestroy': () => void;
+    'Control.datePanelOpenChange': (open: boolean, date: Date) => void;
+    'Control.dateChange': (date: Date) => void;
+    'Control.dateMonthChange': (dates: string[]) => void;
+    /** 日历控件销毁（注意其字符串值为 `Control.datePanelDestroy`） */
+    'Control.datePanelDestroy': () => void;
+    'Control.timePanelOpenChange': (open: boolean, time: string) => void;
+    'Control.timeChange': (time: string) => void;
+    'Control.timeLineChange': (date: Date | string) => void;
+    'Control.timeLinePanelOpenChange': (open: boolean) => void;
+    'Control.timeLineDestroy': () => void;
+    'Control.posterDestroy': () => void;
+    'Control.loadingDestroy': () => void;
+    'Control.messageDestroy': () => void;
+    'Control.contentDestroy': () => void;
+    'Control.contentRerender': (info: unknown) => void;
+    'Theme.beforeDestroy': () => void;
+    'Theme.destroyed': () => void;
+    'Theme.mobileExtendDestroy': () => void;
+    'Theme.recFooterDestroy': () => void;
+}
+/** 单个事件的监听器类型，如 `ThemeEventHandler<'volumechange'>` */
+type ThemeEventHandler<K extends ThemeEventName> = K extends keyof ThemeEventMap ? ThemeEventMap[K] : (...args: unknown[]) => void;
+/** 单个事件的参数元组，如 `ThemeEventArgs<'volumechange'>` = `[number, boolean]` */
+type ThemeEventArgs<K extends ThemeEventName> = K extends keyof ThemeEventMap ? Parameters<ThemeEventMap[K]> : unknown[];
+
 export { Control, EVENTS, Fullscreen, Loading, Message, Play, Poster, Rec, Theme, Utils, Volume };
-export type { CleanUpResizeObserver, CleanUpScreenOrientationFun, ControlItem, ControlOptions, FooterOptions, FullscreenOptions, HeaderOptions, IThemeData, IThemeDataItem, LoadingOptions, MessageOptions, PlayOptions, PosterOptions, RecOptions, ScreenOrientation, ThemeOptions, VolumeOptions };
+export type { AudioInfo, CleanUpResizeObserver, CleanUpScreenOrientationFun, ControlEventName, ControlItem, ControlOptions, FooterOptions, FullscreenChangeInfo, FullscreenOptions, HeaderOptions, IThemeData, IThemeDataItem, LoadingOptions, MessageOptions, OrientationAngle, PlayOptions, PosterOptions, PtzErrorInfo, RecOptions, ResizeInfo, ScreenOrientation, ThemeEventArgs, ThemeEventHandler, ThemeEventMap, ThemeEventName, ThemeLifecycleEventName, ThemeOptions, ThemeOuterEventName, VideoInfo, VolumeOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezuikit/player-theme",
-  "version": "3.1.1",
+  "version": "3.1.2-beta.2",
   "description": "player theme",
   "title": "theme",
   "main": "dist/index.cjs",
@@ -20,13 +20,15 @@
     "./dist/constant": "./dist/constant.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/*.map"
   ],
   "keywords": [
     "player",
     "theme",
     "ezuikit",
     "ezviz",
+    "ezopen",
     "ui"
   ],
   "author": "Ezviz-OpenBiz",