@ezuikit/player-theme 3.1.2-beta.1 → 3.1.2-beta.3

package/dist/types/index.d.ts

@@ -858,7 +858,7 @@ declare class Volume extends Control {
 /**
  * 全屏信息
  */
-interface FullscreenChangeInfo {
+interface FullscreenChangeInfo$1 {
     /** 当前窗口是否处于全屏 */
     isCurrentFullscreen: boolean;
     /** 浏览器中是否有全屏 （移动端中永远是 false） */
@@ -869,7 +869,7 @@ interface FullscreenChangeInfo {
 /**
  * 全屏变化回调
  */
-type FullscreenChange = (info: FullscreenChangeInfo) => void;
+type FullscreenChange = (info: FullscreenChangeInfo$1) => void;
 /**
  * 全屏配置项
  */
@@ -953,7 +953,7 @@ interface FullscreenOptions extends Omit<ControlOptions, 'tagName'> {
      * 全屏改变
      * @param info FullscreenChangeInfo 全屏信息
      */
-    onChange?: (info: FullscreenChangeInfo) => void;
+    onChange?: (info: FullscreenChangeInfo$1) => void;
 }
 /**
  * 全屏控件
@@ -971,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 会触发
      */
@@ -1492,10 +1492,9 @@ declare class Theme extends EventEmitter {
         readonly audioInfo: "audioInfo";
         readonly videoInfo: "videoInfo";
         readonly firstFrameDisplay: "firstFrameDisplay";
-        readonly fullscreen: "fullscreen"; /** 所有私有流的模板 @since 0.0.1 */
+        readonly fullscreen: "fullscreen";
         readonly exitFullscreen: "exitFullscreen";
         readonly fullscreenChange: "fullscreenChange";
-        /** 播放器配置项 */
         readonly resize: "resize";
         readonly orientationChange: "orientationChange";
         readonly audioCodecUnsupported: "audioCodecUnsupported";
@@ -1505,15 +1504,25 @@ declare class Theme extends EventEmitter {
         readonly speedChange: "speedChange";
         readonly recordingChange: "recordingChange";
         readonly talkingChange: "talkingChange";
-        readonly talkVolumeChange: "talkVolumeChange"; /** 封面控件 @since 0.0.1 @private */
+        readonly talkVolumeChange: "talkVolumeChange";
         readonly broadcastChange: "broadcastChange";
         readonly aichatChange: "aichatChange";
         readonly liveChange: "liveChange";
+        /**
+         * @type { "rec" | "cloudRec" | "cloudRecord" } recType 回放类型
+         * ```ts
+         * theme.recType // 回放类型
+         * ```
+         */
         readonly recDropdownChange: "recDropdownChange";
         readonly recListChange: "recListChange";
         readonly alarmMessageChange: "alarmMessageChange";
         readonly setLoggerOptions: "setLoggerOptions";
-        readonly records: "records";
+        readonly records: "records"; /**
+         * 更多控件（footer more）
+         * @since 0.0.1
+         * @private
+         */
         readonly ptzSpeedChange: "ptzSpeedChange";
         readonly setVideoLevelList: "setVideoLevelList";
         readonly currentVideoLevel: "currentVideoLevel";
@@ -1523,8 +1532,8 @@ declare class Theme extends EventEmitter {
         readonly control: {
             readonly play: "Control.play";
             readonly playDestroy: "Control.playDestroy";
-            readonly capturePicture: "Control.capturePicture";
-            readonly capturePictureResult: "Control.capturePictureResult"; /**  @since 0.0.1 @private */
+            readonly capturePicture: "Control.capturePicture"; /**  @since 0.0.1 @private */
+            readonly capturePictureResult: "Control.capturePictureResult";
             readonly capturePictureDestroy: "Control.capturePictureDestroy";
             readonly volumechange: "Control.volumechange";
             readonly volumePanelOpenChange: "Control.volumePanelOpenChange";
@@ -1535,16 +1544,13 @@ declare class Theme extends EventEmitter {
             readonly footerMoreShowControlsChange: "Control.footerMoreShowControlsChange";
             readonly footerMorePanelOpenChange: "Control.footerMorePanelOpenChange";
             readonly deviceDestroy: "Control.deviceDestroy";
-            readonly recTypeChange: "Control.recTypeChange";
+            readonly recTypeChange: "Control.recTypeChange"; /** 自定清晰度 @private */
             readonly recDestroy: "Control.recDestroy";
             readonly definitionChange: "Control.definitionChange";
             readonly definitionList: "Control.definitionList";
             readonly definitionPanelOpenChange: "Control.definitionPanelOpenChange";
             readonly definitionDestroy: "Control.definitionDestroy";
             readonly speedChange: "Control.speedChange";
-            /**
-             * 录像回放的月份列表 @private
-             */
             readonly speedPanelOpenChange: "Control.speedPanelOpenChange";
             readonly speedDestroy: "Control.speedDestroy";
             readonly ptzPanelOpenChange: "Control.ptzPanelOpenChange";
@@ -1599,9 +1605,7 @@ declare class Theme extends EventEmitter {
             readonly mobileExtendDestroy: "Theme.mobileExtendDestroy";
             readonly recFooterDestroy: "Theme.recFooterDestroy";
         };
-        readonly message: "message"; /**
-         * url 信息 播放地址信息
-         */
+        readonly message: "message";
     };
     /** 语言包 @since 0.0.1 */
     static LOCALES: {
@@ -1706,7 +1710,6 @@ declare class Theme extends EventEmitter {
             397007: string;
             399000: string;
             399001: string;
-            /** 移动端竖屏, 全屏情况下不展示扩张，放置在 footer 中 */
             399002: string;
             399016: string;
             399048: string;
@@ -1761,6 +1764,7 @@ declare class Theme extends EventEmitter {
             MIN_SPEED_LIMIT: string;
             SEEK_CANNOT_CROSS_DAYS: string;
             SEEK_TIMEFORMAT_ERROR: string;
+            /** 所有控件列表, 所有控件名称规则（`${iconId}Control`）， 如音量控件 this.controls["volumeControl"]  @since 0.0.1 */
             PAUSE: string;
             PAUSE_FAILED: string;
             RESUME: string;
@@ -1771,7 +1775,6 @@ 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;
@@ -1785,6 +1788,11 @@ declare class Theme extends EventEmitter {
             RESET_THEME: string;
             BTN_PLAY: string;
             BTN_PAUSE: string;
+            /**
+             * 更多控件（header more）
+             * @since 0.0.1
+             * @private
+             */
             BTN_VOLUME: string;
             BTN_MUTED: string;
             BTN_RECORDVIDEO: string;
@@ -1794,18 +1802,14 @@ declare class Theme extends EventEmitter {
             BTN_AICHAT: string;
             BTN_LIVE: string;
             BTN_REC_DROPDOWN: string;
-            BTN_ALARM_MESSAGE: string;
+            BTN_ALARM_MESSAGE: string; /** 头部控件 @since 0.0.1 @private */
             REC_DROPDOWN_CLOUD_REC: string;
-            REC_DROPDOWN_CLOUD_RECORD: string;
+            REC_DROPDOWN_CLOUD_RECORD: string; /** 低部控件 @since 0.0.1 @private */
             REC_DROPDOWN_LOCAL_REC: string;
-            BTN_ZOOM: string; /** 回放底部时间轴 @since 0.0.1 @private */
+            BTN_ZOOM: string;
             BTN_3D_ZOOM: string;
             BTN_PTZ: string;
             BTN_GLOBAL_FULLSCREEN: string;
-            /**
-             * 移动端扩展容器, 扩展的控件渲染在指定容器以外， 仅只用端适用， 为了可以放置大的控件和方便开发接入
-             * @private
-             */
             BTN_EXIT_GLOBAL_FULLSCREEN: string;
             BTN_FULLSCREEN: string;
             BTN_EXIR_FULLSCREEN: string;
@@ -1823,14 +1827,13 @@ declare class Theme extends EventEmitter {
             CAPTURE_FAILED: string;
             START_RECORD_SUCCESS: string;
             START_RECORD_FAILED: string;
-            STOP_RECORD_SUCCESS: string; /**  resizeObserver 监听销毁 */
+            STOP_RECORD_SUCCESS: string;
             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;
@@ -1842,7 +1845,6 @@ declare class Theme extends EventEmitter {
             ZOOM_LIMIT_MIN: string;
             ZOOM_NOT_ENABLED: string;
             '3D_ZOOM': string;
-            /** @private 加载中 */
             '3D_ZOOM_DISABLE': string;
             '3D_ZOOM_FAILED': string;
             START_3D_ZOOM: string;
@@ -1850,14 +1852,14 @@ declare class Theme extends EventEmitter {
             DEVICE_NOT_SUPPORT_3D_ZOOM: string;
             '3D_ZOOM_ACTIVED': string;
             '3D_ZOOM_NOT_ACTIVED': string;
-            '3D_ZOOM_CLOSED': string;
+            '3D_ZOOM_CLOSED': string; /** 录制中 @private */
             CHANGE_ZOOM_TYPE: string;
             FULLSCREEN: string;
-            FULLSCREEN_EXIT: string; /** 自定清晰度 @private */
+            FULLSCREEN_EXIT: string;
+            /** 倍速 @private */
             GET_WEB_FULLSCREEN_STATUS: string;
             WEB_FULLSCREEN: string;
             WEB_FULLSCREEN_EXIT: string;
-            /** 回放片段列表 */
             DESTROY: string;
             GET_CAPACITY: string;
             GET_PTZ_STATUS: string;
@@ -1871,16 +1873,16 @@ declare class Theme extends EventEmitter {
             PTZ_SPEED: string;
             DEVICE_ZOOM: string;
             DEVICE_FOCUS: string;
-            /**
-             * 录像回放的月份列表 @private
-             */
             NOT_SUPPORT_DEVICE_ZOOM: string;
             NOT_SUPPORT_FOCUS: string;
             MIRROR: string;
+            /**
+             * 录像回放的月份列表 @private
+             */
             MIRROR_TYPE_ERROR: string;
-            CHANGE_FEC_TYPE: string;
+            CHANGE_FEC_TYPE: string; /** 清理 header/footer 动画 定时器 @private */
             DEVICE_NOT_SUPPORT: string;
-            TYPE_NOT_SUPPORT: string; /** 销毁标识  @readonly */
+            TYPE_NOT_SUPPORT: string;
             FEC_SUPPORT_VERSION: string;
             NO_CANVAS_ID: string;
             SET_FEC_PARAMS: string;
@@ -1950,8 +1952,8 @@ declare class Theme extends EventEmitter {
             395601: string;
             395602: string;
             395610: string;
-            /** 暂停控件 @since 0.0.1 @private */
             395620: string;
+            /** 消息提示控件 @since 0.0.1 @private */
             395701: string;
             395702: string;
             395703: string;
@@ -1972,17 +1974,19 @@ declare class Theme extends EventEmitter {
             396503: string;
             396504: string;
             396505: string;
-            /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */
-            396506: string; /** 是否播放中 @private */
+            396506: string;
             396508: string;
             396509: string;
             396510: string;
             396511: string;
             396512: string;
             396513: string;
-            396514: string;
+            396514: string; /** 回放片段列表 */
             396515: string;
             396516: string;
+            /**
+             * 录像回放的月份列表 @private
+             */
             396517: string;
             396518: string;
             396519: string;
@@ -2040,9 +2044,7 @@ declare class Theme extends EventEmitter {
             STOP_SUCCESS: string;
             CHANGE_PLAYURL_SUCCESS: string;
             CHANGE_PLAYURL_FAILED: string;
-            GET_OSD_TIME: string; /**
-             * url 信息 播放地址信息
-             */
+            GET_OSD_TIME: string;
             GET_OSD_TIME_FAILED: string;
             SET_POSTER: string;
             RESIZE: string;
@@ -2064,6 +2066,10 @@ declare class Theme extends EventEmitter {
             CHANGE_VIDEO_LEVEL: string;
             CHANGE_VIDEO_LEVEL_FAIL: string;
             GET_VIDEO_LEVEL_LIST: string;
+            /**
+             * 视频分辨率 高
+             * @version 3.1.2
+             */
             PLEASE_INPUT_RIGHT_VIDEO_LEVEL: string;
             VIDEO_LEVEL_NOT_SUPPORT: string;
             VIDEO_LEVEL_AUTO: string;
@@ -2113,6 +2119,9 @@ declare class Theme extends EventEmitter {
             CAPTURE_FAILED: string;
             START_RECORD_SUCCESS: string;
             START_RECORD_FAILED: string;
+            /**
+             * 音量值
+             */
             STOP_RECORD_SUCCESS: string;
             STOP_RECORD_FAILED: string;
             RECORD_TIPS: string;
@@ -2129,6 +2138,10 @@ declare class Theme extends EventEmitter {
             ZOOM_SUB_MIN: string;
             ZOOM_LIMIT_MAX: string;
             ZOOM_LIMIT_MIN: string;
+            /**
+             * 静音
+             *
+             */
             ZOOM_NOT_ENABLED: string;
             '3D_ZOOM': string;
             '3D_ZOOM_DISABLE': string;
@@ -2256,6 +2269,7 @@ declare class Theme extends EventEmitter {
     private _isCurrentFullscreen;
     /** 屏幕旋转角度 0 ｜ 90 ｜ 180 ｜ 270 */
     private _orientationAngle;
+    _url: string;
     /** 是否播放中 @private */
     _playing: boolean;
     /** @private 加载中 */
@@ -2291,7 +2305,10 @@ declare class Theme extends EventEmitter {
     /** 销毁标识  @readonly */
     destroyed: boolean;
     scaleMode: ThemeOptions['scaleMode'];
+    _videoInfo: ThemeVideoInfo;
     constructor(options: ThemeOptions);
+    get url(): string;
+    set url(url: string);
     /**
      * url 信息 播放地址信息
      */
@@ -2310,6 +2327,29 @@ declare class Theme extends EventEmitter {
      * ```
      */
     get height(): number;
+    /**
+     * 视频信息
+     * @version 3.1.2
+     * ```ts
+     * theme.videoInfo // ThemeVideoInfo
+     * ```
+     */
+    get videoInfo(): ThemeVideoInfo;
+    /**
+     * 视频分辨率 宽
+     *
+     * @version 3.1.2
+     *
+     * ```ts
+     * theme.videoWidth // number
+     * ```
+     */
+    get videoWidth(): number;
+    /**
+     * 视频分辨率 高
+     * @version 3.1.2
+     */
+    get videoHeight(): number;
     /**
      * 当前播放状态
      * ```ts
@@ -2627,12 +2667,18 @@ declare class Theme extends EventEmitter {
      * @param url 录像 url
      * @returns {"rec" | "cloudRecord" | "cloudRec" | ""} 录像类型， rec: 录像， cloudRec: 云录像， cloudRecord: 云录制
      */
-    protected _getRecType(url: string): "" | "cloudRec" | "cloudRecord" | "rec";
+    protected _getRecType(url: string): "" | "rec" | "cloudRec" | "cloudRecord";
     private resetControl;
     /**
      * 窗口全屏后旋转 90度判断， 然后设置控件已经旋转 90度， 为了解决控件交互问题
      */
     private _isRotated;
+    get isEzopen(): boolean;
+    /**
+     * 判断播放地址是萤石的播放地址
+     * @since 3.1.2
+     */
+    get isEzviz(): boolean;
 }
 
 /**
@@ -2796,6 +2842,11 @@ interface ThemeOptions {
     disabledTimeLine?: boolean;
     [kye: string]: any;
 }
+interface ThemeVideoInfo {
+    width?: number;
+    height?: number;
+    [key: string]: any;
+}
 /**
  * 回放控件类型
  * @since 0.0.1
@@ -2911,5 +2962,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.2-beta.1",
+  "version": "3.1.2-beta.3",
   "description": "player theme",
   "title": "theme",
   "main": "dist/index.cjs",
@@ -20,7 +20,8 @@
     "./dist/constant": "./dist/constant.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/*.map"
   ],
   "keywords": [
     "player",