trtc-electron-sdk 13.3.800-alpha.2 → 13.3.801-alpha.0

package/liteav/Renderer/yuv-buffer.d.ts

@@ -25,28 +25,28 @@ export interface YUVFormat {
     displayHeight?: number;
 }
 /**
- * Represents underlying image data for a single luma or chroma plane.
- * Cannot be interpreted without the format data from a frame buffer.
- * @typedef {Object} YUVPlane
- * @property {Uint8Array} bytes - typed array containing image data bytes
- * @property {number} stride - byte distance between rows in data
- */
+  * Represents underlying image data for a single luma or chroma plane.
+  * Cannot be interpreted without the format data from a frame buffer.
+  * @typedef {Object} YUVPlane
+  * @property {Uint8Array} bytes - typed array containing image data bytes
+  * @property {number} stride - byte distance between rows in data
+  */
 export interface YUVPlane {
     bytes: Uint8Array;
     stride: number;
 }
 /**
- * Represents a YUV image frame buffer, with enough format information
- * to interpret the data usefully. Buffer objects use generic objects
- * under the hood and can be transferred between worker threads using
- * the structured clone algorithm.
- *
- * @typedef {Object} YUVFrame
- * @property {YUVFormat} format
- * @property {YUVPlane} y
- * @property {YUVPlane} u
- * @property {YUVPlane} v
- */
+  * Represents a YUV image frame buffer, with enough format information
+  * to interpret the data usefully. Buffer objects use generic objects
+  * under the hood and can be transferred between worker threads using
+  * the structured clone algorithm.
+  *
+  * @typedef {Object} YUVFrame
+  * @property {YUVFormat} format
+  * @property {YUVPlane} y
+  * @property {YUVPlane} u
+  * @property {YUVPlane} v
+  */
 export interface YUVFrame {
     format: YUVFormat;
     y: YUVPlane;

package/liteav/Renderer/yuv-buffer.js

@@ -166,12 +166,12 @@ var YUVBuffer = {
         stride = stride || this.suitableStride(width);
         this.validateDimension(stride);
         if (stride < width) {
-            throw "Invalid input stride for YUV plane; must be larger than width";
+            throw 'Invalid input stride for YUV plane; must be larger than width';
         }
         size = stride * height;
         if (source) {
             if (source.length - offset < size) {
-                throw "Invalid input buffer for YUV plane; must be large enough for stride times height";
+                throw 'Invalid input buffer for YUV plane; must be large enough for stride times height';
             }
             bytes = source; // source.slice(offset, offset + size);
         }

package/liteav/index.d.ts

@@ -1,7 +1,6 @@
 export * from './trtc_define';
 export * from './trtc_code';
 export * from './vod_player';
-export { VodPlayerEvents, VodPlayerEventMap, IVodPlayer } from './types';
 export * from './extensions/DeviceManager';
 export * from './extensions/AudioEffectManager';
 export * from './extensions/MediaMixingManager';

package/liteav/index.js

@@ -13,12 +13,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VodPlayerEvents = void 0;
 __exportStar(require("./trtc_define"), exports);
 __exportStar(require("./trtc_code"), exports);
 __exportStar(require("./vod_player"), exports);
-var types_1 = require("./types");
-Object.defineProperty(exports, "VodPlayerEvents", { enumerable: true, get: function () { return types_1.VodPlayerEvents; } });
 __exportStar(require("./extensions/DeviceManager"), exports);
 __exportStar(require("./extensions/AudioEffectManager"), exports);
 __exportStar(require("./extensions/MediaMixingManager"), exports);

package/liteav/trtc.d.ts

@@ -545,8 +545,8 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * 当房间中的某个用户使用 [sendSEIMsg()]{@link TRTCCloud#sendSEIMsg} 发送数据时，房间中的其它用户可以通过 onRecvSEIMsg 接口接收数据。
      *
      * @event TRTCCallback#onRecvSEIMsg
-     * @param {String} userId  - 用户标识
-     * @param {String} message - 数据
+     * @param {String}      userId  - 用户标识
+     * @param {ArrayBuffer} message - 原始字节（二进制安全）。文本数据可用 TextDecoder 解码。
      */
     private handleOnRecvSEIMsg;
     /**
@@ -2423,11 +2423,13 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * - 若指定多次发送（repeatCount>1），则数据会被带在后续的连续 repeatCount 个视频帧中发送出去，同样会导致视频码率增大。
      * - 如果 repeatCount>1，多次发送，接收消息 onRecvSEIMsg 回调也可能会收到多次相同的消息，需要去重。
      *
-     * @param {String} msg         - 待发送的数据，最大支持1kb（1000字节）的数据大小
+     * @param {ArrayBuffer | ArrayBufferView} msg  - 待发送的原始字节数据，最大支持 1KB（1000 字节）。
+     *   必须为 ArrayBuffer / Uint8Array / Buffer 等二进制类型，以便与其它平台（Android / iOS / 原生 C++）二进制互通。
+     *   如需发送文本，请调用方先用 `new TextEncoder().encode(text)` 编码成字节。
      * @param {Number} repeatCount - 发送数据次数
      * @return {Boolean} true：消息已通过限制，等待后续视频帧发送；false:消息被限制发送
      */
-    sendSEIMsg(msg: string, repeatCount: number): boolean;
+    sendSEIMsg(msg: ArrayBuffer | ArrayBufferView, repeatCount: number): boolean;
     /**
      * 废弃接口： 启动播放背景音乐
      *

package/liteav/trtc.js

@@ -29,8 +29,9 @@ const yuv_buffer_1 = __importDefault(require("./Renderer/yuv-buffer"));
 // @ts-ignore
 const YCbCr_1 = __importDefault(require("yuv-canvas/src/YCbCr"));
 const LocalMediaTranscoder_1 = __importDefault(require("./LocalMediaTranscoder"));
-const trtc_define_1 = require("./trtc_define");
 const utils_1 = require("./utils");
+const trtc_define_1 = require("./trtc_define");
+const utils_2 = require("./utils");
 const validate_util_1 = require("./validate-util");
 const logger_1 = __importStar(require("./logger"));
 const LocalVideoRenderController_1 = __importDefault(require("./VideoRenderControl/LocalVideoRenderController"));
@@ -1177,11 +1178,13 @@ class TRTCCloud extends events_1.EventEmitter {
      * 当房间中的某个用户使用 [sendSEIMsg()]{@link TRTCCloud#sendSEIMsg} 发送数据时，房间中的其它用户可以通过 onRecvSEIMsg 接口接收数据。
      *
      * @event TRTCCallback#onRecvSEIMsg
-     * @param {String} userId  - 用户标识
-     * @param {String} message - 数据
+     * @param {String}      userId  - 用户标识
+     * @param {ArrayBuffer} message - 原始字节（二进制安全）。文本数据可用 TextDecoder 解码。
      */
     handleOnRecvSEIMsg(userId, message) {
-        this.fire('onRecvSEIMsg', userId, message);
+        // 复制为独立 ArrayBuffer，避免底层存储被复用导致数据错乱
+        const ab = (0, utils_1.toIndependentArrayBuffer)(message);
+        this.fire('onRecvSEIMsg', userId, ab);
     }
     /////////////////////////////////////////////////////////////////////////////////
     //
@@ -4142,12 +4145,15 @@ class TRTCCloud extends events_1.EventEmitter {
      * - 若指定多次发送（repeatCount>1），则数据会被带在后续的连续 repeatCount 个视频帧中发送出去，同样会导致视频码率增大。
      * - 如果 repeatCount>1，多次发送，接收消息 onRecvSEIMsg 回调也可能会收到多次相同的消息，需要去重。
      *
-     * @param {String} msg         - 待发送的数据，最大支持1kb（1000字节）的数据大小
+     * @param {ArrayBuffer | ArrayBufferView} msg  - 待发送的原始字节数据，最大支持 1KB（1000 字节）。
+     *   必须为 ArrayBuffer / Uint8Array / Buffer 等二进制类型，以便与其它平台（Android / iOS / 原生 C++）二进制互通。
+     *   如需发送文本，请调用方先用 `new TextEncoder().encode(text)` 编码成字节。
      * @param {Number} repeatCount - 发送数据次数
      * @return {Boolean} true：消息已通过限制，等待后续视频帧发送；false:消息被限制发送
      */
     sendSEIMsg(msg, repeatCount) {
-        return this.rtcCloud.sendSEIMsg(msg, repeatCount);
+        const payload = (0, utils_1.normalizeSEIPayload)(msg);
+        return this.rtcCloud.sendSEIMsg(payload, repeatCount);
     }
     /////////////////////////////////////////////////////////////////////////////////
     //
@@ -5351,7 +5357,7 @@ class TRTCCloud extends events_1.EventEmitter {
         return rgbaData;
     }
     _isMacPlatform() {
-        return (0, utils_1.isMacOS)();
+        return (0, utils_2.isMacOS)();
     }
     _setRemoteVideoBuffer(userId, streamType) {
         const videoBufferInfo = new trtc_define_1.VideoBufferInfo({

package/liteav/trtc_define.d.ts

@@ -1125,3 +1125,85 @@ export interface TRTCInitConfig {
     };
     isIPCMode?: boolean;
 }
+/**
+ * @namespace TRTCVodPlayerEvent
+ * @description 点播播放器（VOD Player）事件
+ */
+export declare enum TRTCVodPlayerEvent {
+    /**
+     * @description 多媒体文件开始播放事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerStarted
+     * @param {Number} msLength 多媒体文件总长度，单位毫秒
+     */
+    onVodPlayerStarted = "onVodPlayerStarted",
+    /**
+     * @description 播放器就绪事件
+     *
+     * 调用 `preload()` 完成后触发，或 `switchSource()` 切换成功后触发。
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerLoaded
+     * @param {Number} durationMs 视频总时长，单位毫秒
+     * @param {Number} width 视频宽度（像素），纯音频文件时为 0
+     * @param {Number} height 视频高度（像素），纯音频文件时为 0
+     */
+    onVodPlayerLoaded = "onVodPlayerLoaded",
+    /**
+     * @description 多媒体文件播放进度改变事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerProgress
+     * @param {Number} msPos 多媒体文件当前播放进度，单位毫秒
+     */
+    onVodPlayerProgress = "onVodPlayerProgress",
+    /**
+     * @description 多媒体文件播放暂停事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerPaused
+     */
+    onVodPlayerPaused = "onVodPlayerPaused",
+    /**
+     * @description 多媒体文件播放恢复事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerResumed
+     */
+    onVodPlayerResumed = "onVodPlayerResumed",
+    /**
+     * @description 多媒体文件播放停止事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerStopped
+     * @param {Number} reason 停止原因
+     *  - 0:用户主动停止；
+     *  - 1:文件播放完；
+     *  - 2:视频断流。
+     */
+    onVodPlayerStopped = "onVodPlayerStopped",
+    /**
+     * @description 多媒体文件播放出错事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerError
+     * @param {Number} error 错误码
+     *  - -6001:未知错误；
+     *  - -6002:通用错误；
+     *  - -6003:解封装失败；
+     *  - -6005:解封装超时；
+     *  - -6006:视频解码错误；
+     *  - -6007:音频解码错误；
+     *  - -6009:视频渲染错误。
+     */
+    onVodPlayerError = "onVodPlayerError"
+}
+/**
+ * 点播播放器事件监听器类型定义
+ *
+ * key 为 {@link TRTCVodPlayerEvent}，value 为该事件回调接收的参数元组。
+ * 用于在 TS 层实现事件名到回调参数的精确类型映射，避免 any 滥用。
+ */
+export interface TRTCVodPlayerEventMap {
+    [TRTCVodPlayerEvent.onVodPlayerStarted]: [msLength: number];
+    [TRTCVodPlayerEvent.onVodPlayerLoaded]: [durationMs: number, width: number, height: number];
+    [TRTCVodPlayerEvent.onVodPlayerProgress]: [msPos: number];
+    [TRTCVodPlayerEvent.onVodPlayerPaused]: [];
+    [TRTCVodPlayerEvent.onVodPlayerResumed]: [];
+    [TRTCVodPlayerEvent.onVodPlayerStopped]: [reason: number];
+    [TRTCVodPlayerEvent.onVodPlayerError]: [error: number];
+}

package/liteav/trtc_define.js

@@ -7,7 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TRTCTranscodingConfig = exports.TRTCPluginType = exports.TRTCVoiceChangerType = exports.TRTCVoiceReverbType = exports.TRTCPublishMode = exports.TRTCAudioRecordingContent = exports.TRTCMixInputType = exports.TRTCTranscodingConfigMode = exports.TRTCMixUser = exports.Rect = exports.TRTCSpeedTestResult = exports.TRTCSpeedTestParams = exports.TRTCVolumeInfo = exports.TRTCQualityInfo = exports.TRTCNetworkQosParam = exports.TRTCRenderParams = exports.TRTCVideoEncParam = exports.TRTCParams = exports.TRTCWaterMarkSrcType = exports.TRTCVideoEncodeComplexity = exports.TRTCVideoColorSpace = exports.TRTCVideoColorRange = exports.TRTCCameraCaptureMode = exports.TRTCDeviceType = exports.TRTCDeviceState = exports.TRTCLogLevel = exports.TRTCAudioFrame = exports.TRTCVideoFrame = exports.TRTCDeviceInfo = exports.TRTCScreenCaptureProperty = exports.TRTCScreenCaptureSourceInfo = exports.TRTCImageBuffer = exports.TRTCAudioQuality = exports.TRTCScreenCaptureSourceType = exports.TRTCAudioFrameFormat = exports.TRTCVideoQosPreference = exports.TRTCQosControlMode = exports.TRTCRoleType = exports.TRTCAppScene = exports.TRTCRecordType = exports.TRTCVideoMirrorType = exports.TRTCVideoBufferType = exports.TRTCVideoPixelFormat = exports.TRTCBeautyStyle = exports.TRTCVideoRotation = exports.TRTCVideoFillMode = exports.TRTCQuality = exports.TRTCVideoStreamType = exports.TRTCVideoResolutionMode = exports.TRTCVideoResolution = void 0;
-exports.VideoBufferInfo = exports.TRTCSwitchRoomParam = exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = void 0;
+exports.TRTCVodPlayerEvent = exports.VideoBufferInfo = exports.TRTCSwitchRoomParam = exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = void 0;
 const util_1 = require("./Renderer/util");
 /////////////////////////////////////////////////////////////////////////////////
 //
@@ -2032,3 +2032,76 @@ class VideoBufferInfo {
     }
 }
 exports.VideoBufferInfo = VideoBufferInfo;
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                    TRTCVodPlayer 相关类型定义
+//
+/////////////////////////////////////////////////////////////////////////////////
+/**
+ * @namespace TRTCVodPlayerEvent
+ * @description 点播播放器（VOD Player）事件
+ */
+var TRTCVodPlayerEvent;
+(function (TRTCVodPlayerEvent) {
+    /**
+     * @description 多媒体文件开始播放事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerStarted
+     * @param {Number} msLength 多媒体文件总长度，单位毫秒
+     */
+    TRTCVodPlayerEvent["onVodPlayerStarted"] = "onVodPlayerStarted";
+    /**
+     * @description 播放器就绪事件
+     *
+     * 调用 `preload()` 完成后触发，或 `switchSource()` 切换成功后触发。
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerLoaded
+     * @param {Number} durationMs 视频总时长，单位毫秒
+     * @param {Number} width 视频宽度（像素），纯音频文件时为 0
+     * @param {Number} height 视频高度（像素），纯音频文件时为 0
+     */
+    TRTCVodPlayerEvent["onVodPlayerLoaded"] = "onVodPlayerLoaded";
+    /**
+     * @description 多媒体文件播放进度改变事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerProgress
+     * @param {Number} msPos 多媒体文件当前播放进度，单位毫秒
+     */
+    TRTCVodPlayerEvent["onVodPlayerProgress"] = "onVodPlayerProgress";
+    /**
+     * @description 多媒体文件播放暂停事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerPaused
+     */
+    TRTCVodPlayerEvent["onVodPlayerPaused"] = "onVodPlayerPaused";
+    /**
+     * @description 多媒体文件播放恢复事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerResumed
+     */
+    TRTCVodPlayerEvent["onVodPlayerResumed"] = "onVodPlayerResumed";
+    /**
+     * @description 多媒体文件播放停止事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerStopped
+     * @param {Number} reason 停止原因
+     *  - 0:用户主动停止；
+     *  - 1:文件播放完；
+     *  - 2:视频断流。
+     */
+    TRTCVodPlayerEvent["onVodPlayerStopped"] = "onVodPlayerStopped";
+    /**
+     * @description 多媒体文件播放出错事件
+     *
+     * @event TRTCVodPlayerEvent#onVodPlayerError
+     * @param {Number} error 错误码
+     *  - -6001:未知错误；
+     *  - -6002:通用错误；
+     *  - -6003:解封装失败；
+     *  - -6005:解封装超时；
+     *  - -6006:视频解码错误；
+     *  - -6007:音频解码错误；
+     *  - -6009:视频渲染错误。
+     */
+    TRTCVodPlayerEvent["onVodPlayerError"] = "onVodPlayerError";
+})(TRTCVodPlayerEvent = exports.TRTCVodPlayerEvent || (exports.TRTCVodPlayerEvent = {}));

package/liteav/types.d.ts

@@ -1,30 +1,12 @@
 import TRTCMediaMixingManager, { TRTCMediaMixingService } from './extensions/MediaMixingManager';
-import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceType, TRTCLogLevel, TRTCAudioFrame, TRTCVideoFillMode, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, TRTCPluginType, TRTCPluginInfo, TRTCVideoProcessPluginOptions, TRTCMediaEncryptDecryptPluginOptions, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams, TRTCVoiceReverbType, TRTCVoiceChangerType, TRTCMusicPlayObserver, TRTCAudioFrameCallback, TRTCAudioProcessPluginOptions, TRTCPublishTarget, TRTCStreamEncoderParam, TRTCStreamMixingConfig, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoBufferType } from './trtc_define';
+import { AudioMusicParam, Rect, TRTCAppScene, TRTCAudioQuality, TRTCBeautyStyle, TRTCDeviceType, TRTCLogLevel, TRTCAudioFrame, TRTCVideoFillMode, TRTCVideoRotation, TRTCVideoStreamType, TRTCWaterMarkSrcType, TRTCPluginType, TRTCPluginInfo, TRTCVideoProcessPluginOptions, TRTCMediaEncryptDecryptPluginOptions, TRTCAudioRecordingParams, TRTCScreenCaptureSourceInfo, TRTCScreenCaptureProperty, TRTCSpeedTestParams, TRTCRecordType, TRTCDeviceInfo, TRTCCameraCaptureParams, TRTCImageBuffer, TRTCInitConfig, TRTCAudioParallelParams, TRTCVoiceReverbType, TRTCVoiceChangerType, TRTCMusicPlayObserver, TRTCAudioFrameCallback, TRTCAudioProcessPluginOptions, TRTCPublishTarget, TRTCStreamEncoderParam, TRTCStreamMixingConfig, TRTCRenderParams, TRTCRoleType, TRTCSwitchRoomParam, TRTCVideoFrame, TRTCVideoPixelFormat, TRTCVideoBufferType, TRTCVodPlayerEventMap } from './trtc_define';
 export interface TRTCVideoRenderCallback {
     onRenderVideoFrame(userId: string, streamType: TRTCVideoStreamType, frame: TRTCVideoFrame): void;
 }
-export declare enum VodPlayerEvents {
-    onVodPlayerStarted = "onVodPlayerStarted",
-    onVodPlayerLoaded = "onVodPlayerLoaded",
-    onVodPlayerProgress = "onVodPlayerProgress",
-    onVodPlayerPaused = "onVodPlayerPaused",
-    onVodPlayerResumed = "onVodPlayerResumed",
-    onVodPlayerStopped = "onVodPlayerStopped",
-    onVodPlayerError = "onVodPlayerError"
-}
-export interface VodPlayerEventMap {
-    [VodPlayerEvents.onVodPlayerStarted]: [msLength: number];
-    [VodPlayerEvents.onVodPlayerLoaded]: [durationMs: number, width: number, height: number];
-    [VodPlayerEvents.onVodPlayerProgress]: [msPos: number];
-    [VodPlayerEvents.onVodPlayerPaused]: [];
-    [VodPlayerEvents.onVodPlayerResumed]: [];
-    [VodPlayerEvents.onVodPlayerStopped]: [reason: number];
-    [VodPlayerEvents.onVodPlayerError]: [error: number];
-}
 export interface IVodPlayer {
-    on<K extends keyof VodPlayerEventMap>(event: K, listener: (...args: VodPlayerEventMap[K]) => void): this;
+    on<K extends keyof TRTCVodPlayerEventMap>(event: K, listener: (...args: TRTCVodPlayerEventMap[K]) => void): this;
     on(event: string | symbol, listener: (...args: any[]) => void): this;
-    off<K extends keyof VodPlayerEventMap>(event: K, listener: (...args: VodPlayerEventMap[K]) => void): this;
+    off<K extends keyof TRTCVodPlayerEventMap>(event: K, listener: (...args: TRTCVodPlayerEventMap[K]) => void): this;
     off(event: string | symbol, listener: (...args: any[]) => void): this;
     setView(view: HTMLElement | null): void;
     setRenderRotation(rotation: TRTCVideoRotation): void;
@@ -46,7 +28,6 @@ export interface IVodPlayer {
     publishAudio(): void;
     unpublishVideo(): void;
     unpublishAudio(): void;
-    destroy(): void;
 }
 export interface ITRTCCloud {
     createSubCloud(config?: TRTCInitConfig): ITRTCCloud | null;
@@ -150,7 +131,7 @@ export interface ITRTCCloud {
     generateCustomPTS(): number;
     setAudioFrameCallback(callback: TRTCAudioFrameCallback): void;
     sendCustomCmdMsg(cmdId: number, msg: string, reliable: boolean, ordered: boolean): boolean;
-    sendSEIMsg(msg: string, repeatCount: number): boolean;
+    sendSEIMsg(msg: ArrayBuffer | ArrayBufferView, repeatCount: number): boolean;
     startSystemAudioLoopback(path?: string | null): void;
     stopSystemAudioLoopback(): void;
     setSystemAudioLoopbackVolume(volume: number): void;

package/liteav/types.js

@@ -1,13 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VodPlayerEvents = void 0;
-var VodPlayerEvents;
-(function (VodPlayerEvents) {
-    VodPlayerEvents["onVodPlayerStarted"] = "onVodPlayerStarted";
-    VodPlayerEvents["onVodPlayerLoaded"] = "onVodPlayerLoaded";
-    VodPlayerEvents["onVodPlayerProgress"] = "onVodPlayerProgress";
-    VodPlayerEvents["onVodPlayerPaused"] = "onVodPlayerPaused";
-    VodPlayerEvents["onVodPlayerResumed"] = "onVodPlayerResumed";
-    VodPlayerEvents["onVodPlayerStopped"] = "onVodPlayerStopped";
-    VodPlayerEvents["onVodPlayerError"] = "onVodPlayerError";
-})(VodPlayerEvents = exports.VodPlayerEvents || (exports.VodPlayerEvents = {}));

package/liteav/utils.d.ts

@@ -39,3 +39,23 @@ export declare function getOS(): string;
 export declare function isMacOS(): boolean;
 export declare function isWindows(): boolean;
 export declare function isLinux(): boolean;
+/**
+ * 把 sendSEIMsg 的 JS 入参（ArrayBuffer / TypedArray / DataView 等）规范化为 Uint8Array。
+ *
+ * - 字符串入参不再支持，由调用方自行 `TextEncoder().encode(...)` 后传入；
+ * - 对 TypedArray / DataView 视图保留原始 byteOffset / byteLength，不会把整段底层
+ *   ArrayBuffer 当成数据；
+ * - 类型不匹配时抛 `TypeError`，与 Native 层的报错文案保持一致。
+ */
+export declare function normalizeSEIPayload(input: ArrayBuffer | ArrayBufferView): Uint8Array;
+/**
+ * 把 native 回调里收到的二进制对象（Uint8Array / Buffer / ArrayBuffer）统一转成
+ * 一个 **独立的** ArrayBuffer，对外暴露给业务层。
+ *
+ * 为什么要"独立"：
+ * - Node Buffer / TypedArray 的 `.buffer` 是 native 复用的存储区，可能被后续事件
+ *   覆写；直接 fire 出去会出现"业务层拿到的 message 跟下一帧消息字节错乱"。
+ * - 这里通过 `new ArrayBuffer + Uint8Array.set` 显式拷贝，避免 `slice() as ArrayBuffer`
+ *   的不严谨断言（slice 返回类型为 `ArrayBufferLike`，可能是 SharedArrayBuffer）。
+ */
+export declare function toIndependentArrayBuffer(message: Uint8Array | ArrayBuffer): ArrayBuffer;

package/liteav/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isLinux = exports.isWindows = exports.isMacOS = exports.getOS = exports.throttle = exports.debounce = exports.convertUint8ArrayToNumber = exports.safelyParse = exports.isNullOrUndefined = exports.isUndefined = exports.isNull = void 0;
+exports.toIndependentArrayBuffer = exports.normalizeSEIPayload = exports.isLinux = exports.isWindows = exports.isMacOS = exports.getOS = exports.throttle = exports.debounce = exports.convertUint8ArrayToNumber = exports.safelyParse = exports.isNullOrUndefined = exports.isUndefined = exports.isNull = void 0;
 function isNull(val) {
     return val === null;
 }
@@ -167,3 +167,49 @@ function isLinux() {
     return getOS() === 'linux';
 }
 exports.isLinux = isLinux;
+// ─── SEI 二进制收发编解码 ───────────────────────────────────────────
+//
+// 供中文/英文两版 TRTCCloud 共用，避免在 trtc.ts / trtc_en.ts 维护两份
+// 完全一致的本地化逻辑。
+/**
+ * 把 sendSEIMsg 的 JS 入参（ArrayBuffer / TypedArray / DataView 等）规范化为 Uint8Array。
+ *
+ * - 字符串入参不再支持，由调用方自行 `TextEncoder().encode(...)` 后传入；
+ * - 对 TypedArray / DataView 视图保留原始 byteOffset / byteLength，不会把整段底层
+ *   ArrayBuffer 当成数据；
+ * - 类型不匹配时抛 `TypeError`，与 Native 层的报错文案保持一致。
+ */
+function normalizeSEIPayload(input) {
+    if (input instanceof ArrayBuffer) {
+        return new Uint8Array(input);
+    }
+    if (ArrayBuffer.isView(input)) {
+        return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+    }
+    throw new TypeError('sendSEIMsg: msg must be ArrayBuffer, TypedArray or Buffer');
+}
+exports.normalizeSEIPayload = normalizeSEIPayload;
+/**
+ * 把 native 回调里收到的二进制对象（Uint8Array / Buffer / ArrayBuffer）统一转成
+ * 一个 **独立的** ArrayBuffer，对外暴露给业务层。
+ *
+ * 为什么要"独立"：
+ * - Node Buffer / TypedArray 的 `.buffer` 是 native 复用的存储区，可能被后续事件
+ *   覆写；直接 fire 出去会出现"业务层拿到的 message 跟下一帧消息字节错乱"。
+ * - 这里通过 `new ArrayBuffer + Uint8Array.set` 显式拷贝，避免 `slice() as ArrayBuffer`
+ *   的不严谨断言（slice 返回类型为 `ArrayBufferLike`，可能是 SharedArrayBuffer）。
+ */
+function toIndependentArrayBuffer(message) {
+    if (message instanceof ArrayBuffer) {
+        // 收到的就是裸 ArrayBuffer 时也做一次拷贝，统一上层语义：
+        // "事件回调里拿到的 message 永远是一份独立内存"。
+        const copy = new ArrayBuffer(message.byteLength);
+        new Uint8Array(copy).set(new Uint8Array(message));
+        return copy;
+    }
+    // Uint8Array / Buffer 共用的视图分支。
+    const copy = new ArrayBuffer(message.byteLength);
+    new Uint8Array(copy).set(message);
+    return copy;
+}
+exports.toIndependentArrayBuffer = toIndependentArrayBuffer;

package/liteav/vod_player.d.ts

@@ -1,5 +1,5 @@
-import { TRTCVideoRotation, TRTCVideoFillMode } from './trtc_define';
-import { IVodPlayer, VodPlayerEventMap } from './types';
+import { TRTCVideoRotation, TRTCVideoFillMode, TRTCVodPlayerEventMap } from './trtc_define';
+import { IVodPlayer } from './types';
 /**
  *
  * 腾讯云点播播放器
@@ -7,25 +7,23 @@ import { IVodPlayer, VodPlayerEventMap } from './types';
  * 用于播放本地或在线的音视频文件，支持视频渲染、音量控制、
  * 进度控制、TRTC 推流等功能。
  *
- * @version v13.4.800
+ * @version v13.3.800
  *
  * @example
- * import { VodPlayer, VodPlayerEvents } from 'trtc-electron-sdk';
+ * import { TRTCVodPlayer, TRTCVodPlayerEvent } from 'trtc-electron-sdk';
  *
- * const player = VodPlayer.createVodPlayer('/path/to/video.mp4', false);
- * player.on(VodPlayerEvents.onVodPlayerStarted, (msLength) => {
+ * const player = TRTCVodPlayer.createVodPlayer('/path/to/video.mp4', false);
+ * player.on(TRTCVodPlayerEvent.onVodPlayerStarted, (msLength) => {
  *   console.log('播放开始，总时长:', msLength);
  * });
  * player.setView(document.getElementById('video-container')!);
  * player.start();
  *
  * // 使用完毕后销毁
- * VodPlayer.releaseVodPlayer(player);
+ * TRTCVodPlayer.releaseVodPlayer(player);
  */
-export declare class VodPlayer implements IVodPlayer {
-    /** `_dataRenderCallback` 中允许连续重置 video buffer 的最大次数，超过后退化为周期日志 */
+export declare class TRTCVodPlayer implements IVodPlayer {
     private static readonly MAX_BUFFER_RETRY;
-    /** 重试上限达到后，每隔多少帧打一次 warn 日志（按 30fps 估算 ≈ 2 秒一次） */
     private static readonly BUFFER_RETRY_LOG_INTERVAL;
     private nativeVodPlayer;
     private videoRender;
@@ -33,48 +31,63 @@ export declare class VodPlayer implements IVodPlayer {
     private isStarted;
     private isDestroyed;
     private isRenderPrepared;
-    /** 数据回调中连续 setVideoBuffer 失败次数（用于 _dataRenderCallback 退避策略） */
     private _setBufferRetryCount;
     private logger;
     private eventEmitter;
     /**
-     * 创建 VodPlayer 实例
+     * 当前 native 构建是否启用了 VOD 播放器。
+     *
+     * 这是一次性的"构建期能力探测"——`NodeTRTCEngine.NodeVodPlayer` 是
+     * 加载 .node 时绑定，运行期不会变化，因此结果可在模块加载时缓存为常量。
+     *
+     * 通过 {@link isSupported} 对外暴露访问入口。
+     */
+    private static readonly VOD_SUPPORTED;
+    /**
+     * 判断当前 native 构建是否启用了 VOD 播放器
+     *
+     * C++ 侧 VOD 模块为条件编译（`TRTC_VOD_PLAYER` 宏），未启用时 `NodeTRTCEngine.NodeVodPlayer`
+     * 不存在。调用方在 {@link createVodPlayer} 前应先用本方法探测，否则会拿到一个
+     * `Error: [TRTCVodPlayer][ERR_NO_VOD_SUPPORT] ...` 异常。
+     *
+     * @returns true 表示当前构建支持 VOD；false 表示未启用
+     */
+    static isSupported(): boolean;
+    /**
+     * 创建 TRTCVodPlayer 实例
      *
      * @param mediaFilePath - 媒体文件路径（本地绝对路径或在线 URL），必填且必须是非空字符串
      * @param repeat - 是否循环播放，默认 false
-     * @returns VodPlayer 实例
+     * @returns TRTCVodPlayer 实例
      *
+     * @throws {Error} 当前 native 构建未启用 VOD 时抛出，错误信息以
+     *                 `[TRTCVodPlayer][ERR_NO_VOD_SUPPORT]` 起始，便于日志聚合与告警
+     *                 （请先用 {@link isSupported} 探测）
      * @throws {TypeError} 当 `mediaFilePath` 不是非空字符串时抛出
      */
-    static createVodPlayer(mediaFilePath: string, repeat?: boolean): VodPlayer;
+    static createVodPlayer(mediaFilePath: string, repeat?: boolean): TRTCVodPlayer;
     /**
-     * 销毁 VodPlayer 实例，释放相关资源
+     * 销毁 TRTCVodPlayer 实例，释放相关资源
      *
-     * @param player - 待销毁的 VodPlayer 实例
+     * @param player - 待销毁的 TRTCVodPlayer 实例
      */
-    static releaseVodPlayer(player: VodPlayer): void;
+    static releaseVodPlayer(player: TRTCVodPlayer): void;
     private constructor();
     /**
-     * 销毁播放器，释放所有资源
+     * 监听 TRTCVodPlayer 事件
      *
-     * 包括：停止播放、销毁渲染器、移除所有事件监听
-     */
-    destroy(): void;
-    /**
-     * 监听 VodPlayer 事件
-     *
-     * @param event - 事件名称，参考 {@link VodPlayerEvents}
+     * @param event - 事件名称，参考 {@link TRTCVodPlayerEvent}
      * @param listener - 事件回调函数，参数类型根据事件自动推导
      */
-    on<K extends keyof VodPlayerEventMap>(event: K, listener: (...args: VodPlayerEventMap[K]) => void): this;
+    on<K extends keyof TRTCVodPlayerEventMap>(event: K, listener: (...args: TRTCVodPlayerEventMap[K]) => void): this;
     on(event: string | symbol, listener: (...args: any[]) => void): this;
     /**
-     * 取消监听 VodPlayer 事件
+     * 取消监听 TRTCVodPlayer 事件
      *
      * @param event - 事件名称
      * @param listener - 事件回调函数
      */
-    off<K extends keyof VodPlayerEventMap>(event: K, listener: (...args: VodPlayerEventMap[K]) => void): this;
+    off<K extends keyof TRTCVodPlayerEventMap>(event: K, listener: (...args: TRTCVodPlayerEventMap[K]) => void): this;
     off(event: string | symbol, listener: (...args: any[]) => void): this;
     /**
      * 设置视频渲染的 DOM 容器
@@ -88,12 +101,12 @@ export declare class VodPlayer implements IVodPlayer {
     /**
      * 预加载多媒体文件
      *
-     * 预加载完成后会触发 {@link VodPlayerEvents.onVodPlayerLoaded} 事件，事件参数携带
+     * 预加载完成后会触发 {@link TRTCVodPlayerEvent.onVodPlayerLoaded} 事件，事件参数携带
      * 媒体信息（时长、宽高）；同时 C++ 层会产生首帧并推送到 JS 层的视频渲染管线，
      * 在 view 上展示首帧画面。
      *
      * @example
-     * player.on(VodPlayerEvents.onVodPlayerLoaded, (durationMs, width, height) => {
+     * player.on(TRTCVodPlayerEvent.onVodPlayerLoaded, (durationMs, width, height) => {
      *   console.log('预加载完成:', durationMs, width, height);
      *   player.start();
      * });
@@ -144,7 +157,7 @@ export declare class VodPlayer implements IVodPlayer {
      * 无缝切换当前播放的媒体文件
      *
      * 在后台预加载新的媒体源，待新源就绪后无缝切换，避免切换时出现黑屏。
-     * 切换成功后触发 {@link VodPlayerEvents.onVodPlayerLoaded} 事件，携带新文件的媒体信息。
+     * 切换成功后触发 {@link TRTCVodPlayerEvent.onVodPlayerLoaded} 事件，携带新文件的媒体信息。
      *
      * @param newMediaFile - 新的媒体文件路径或 URL
      *
@@ -233,6 +246,17 @@ export declare class VodPlayer implements IVodPlayer {
      * 停止向已关联的 TRTC 实例推送音频流
      */
     unpublishAudio(): void;
+    /**
+     * @private
+     * 销毁播放器，释放所有资源
+     *
+     * 包括：解绑事件监听、停止播放、销毁渲染器、清理 native 回调。
+     *
+     * 注意：调用本方法后不再向业务方派发任何事件。即便 `stop()` 内部会异步触发
+     * `onVodPlayerStopped`，该事件也不会送达，因为监听器已在第一步被清空。
+     * 这是 `releaseVodPlayer` 的自然语义（资源释放后不再产生副作用）。
+     */
+    private _destroy;
     /**
      * @private
      * 将点播播放器关联到 TRTC 实例（用于辅助流推流，绑定后音频播放由 TRTC 接管）
@@ -244,7 +268,8 @@ export declare class VodPlayer implements IVodPlayer {
      */
     private detachTRTC;
     /**
-     * 类型安全地发射事件，参数类型由 `VodPlayerEventMap` 推导。
+     * @private
+     * 类型安全地发射事件，参数类型由 `TRTCVodPlayerEventMap` 推导。
      * 通过 `setImmediate` 让 emit 异步化，避免在 N-API 回调栈中触发用户代码。
      */
     private fire;

package/liteav/vod_player.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VodPlayer = void 0;
+exports.TRTCVodPlayer = void 0;
 const events_1 = require("events");
 const trtc_define_1 = require("./trtc_define");
 const video_render_1 = require("./Live/video-render");
 const logger_1 = require("./logger");
-const types_1 = require("./types");
 const NodeTRTCEngine = require('../build/Release/trtc_electron_sdk.node');
 /**
  *
@@ -14,25 +13,25 @@ const NodeTRTCEngine = require('../build/Release/trtc_electron_sdk.node');
  * 用于播放本地或在线的音视频文件，支持视频渲染、音量控制、
  * 进度控制、TRTC 推流等功能。
  *
- * @version v13.4.800
+ * @version v13.3.800
  *
  * @example
- * import { VodPlayer, VodPlayerEvents } from 'trtc-electron-sdk';
+ * import { TRTCVodPlayer, TRTCVodPlayerEvent } from 'trtc-electron-sdk';
  *
- * const player = VodPlayer.createVodPlayer('/path/to/video.mp4', false);
- * player.on(VodPlayerEvents.onVodPlayerStarted, (msLength) => {
+ * const player = TRTCVodPlayer.createVodPlayer('/path/to/video.mp4', false);
+ * player.on(TRTCVodPlayerEvent.onVodPlayerStarted, (msLength) => {
  *   console.log('播放开始，总时长:', msLength);
  * });
  * player.setView(document.getElementById('video-container')!);
  * player.start();
  *
  * // 使用完毕后销毁
- * VodPlayer.releaseVodPlayer(player);
+ * TRTCVodPlayer.releaseVodPlayer(player);
  */
-class VodPlayer {
+class TRTCVodPlayer {
     // ─── 构造函数 ───────────────────────────────────────────────
     constructor(mediaFilePath, repeat = false) {
-        this.logger = new logger_1.Logger('VodPlayer');
+        this.logger = new logger_1.Logger('TRTCVodPlayer');
         this.eventEmitter = new events_1.EventEmitter();
         this._dataRenderCallback = this._dataRenderCallback.bind(this);
         this.nativeVodPlayer = new NodeTRTCEngine.NodeVodPlayer(mediaFilePath, repeat);
@@ -45,56 +44,70 @@ class VodPlayer {
         this._createVideoRender();
         this._initEventCallback();
     }
-    // ─── 静态工厂方法 ───────────────────────────────────────────
     /**
-     * 创建 VodPlayer 实例
+     * 判断当前 native 构建是否启用了 VOD 播放器
+     *
+     * C++ 侧 VOD 模块为条件编译（`TRTC_VOD_PLAYER` 宏），未启用时 `NodeTRTCEngine.NodeVodPlayer`
+     * 不存在。调用方在 {@link createVodPlayer} 前应先用本方法探测，否则会拿到一个
+     * `Error: [TRTCVodPlayer][ERR_NO_VOD_SUPPORT] ...` 异常。
+     *
+     * @returns true 表示当前构建支持 VOD；false 表示未启用
+     */
+    static isSupported() {
+        return TRTCVodPlayer.VOD_SUPPORTED;
+    }
+    /**
+     * 创建 TRTCVodPlayer 实例
      *
      * @param mediaFilePath - 媒体文件路径（本地绝对路径或在线 URL），必填且必须是非空字符串
      * @param repeat - 是否循环播放，默认 false
-     * @returns VodPlayer 实例
+     * @returns TRTCVodPlayer 实例
      *
+     * @throws {Error} 当前 native 构建未启用 VOD 时抛出，错误信息以
+     *                 `[TRTCVodPlayer][ERR_NO_VOD_SUPPORT]` 起始，便于日志聚合与告警
+     *                 （请先用 {@link isSupported} 探测）
      * @throws {TypeError} 当 `mediaFilePath` 不是非空字符串时抛出
      */
     static createVodPlayer(mediaFilePath, repeat = false) {
+        if (!TRTCVodPlayer.isSupported()) {
+            // C++ 层 VOD 模块为条件编译；未启用构建下 NodeTRTCEngine.NodeVodPlayer 为 undefined，
+            // 直接 new 会得到 "NodeVodPlayer is not a constructor" 这种内部堆栈。
+            // 这里提前抛出业务级错误，明确告知调用方"当前构建不支持 VOD，应先探测再使用"。
+            // 错误信息前缀 [TRTCVodPlayer][ERR_NO_VOD_SUPPORT] 是稳定标签，调用方可用于
+            // 日志过滤、告警聚合，请勿改动该前缀。
+            throw new Error('[TRTCVodPlayer][ERR_NO_VOD_SUPPORT] createVodPlayer: ' +
+                'current native build has no VOD support. ' +
+                '请先通过 TRTCVodPlayer.isSupported() 探测再调用。');
+        }
         if (typeof mediaFilePath !== 'string' || mediaFilePath.length === 0) {
-            // 空串或非字符串透传到 C++ 后 createTXVodPlayer 行为未定义，提前抛错让调用方立刻发现
-            throw new TypeError(`VodPlayer.createVodPlayer: mediaFilePath must be a non-empty string, got: ${JSON.stringify(mediaFilePath)}`);
+            throw new TypeError(`TRTCVodPlayer.createVodPlayer: mediaFilePath must be a non-empty string, got: ${JSON.stringify(mediaFilePath)}`);
         }
-        return new VodPlayer(mediaFilePath, repeat);
+        return new TRTCVodPlayer(mediaFilePath, repeat);
     }
     /**
-     * 销毁 VodPlayer 实例，释放相关资源
+     * 销毁 TRTCVodPlayer 实例，释放相关资源
      *
-     * @param player - 待销毁的 VodPlayer 实例
+     * @param player - 待销毁的 TRTCVodPlayer 实例
      */
     static releaseVodPlayer(player) {
-        player.destroy();
+        player._destroy();
     }
-    // ─── 公开方法 ───────────────────────────────────────────────
     /**
-     * 销毁播放器，释放所有资源
+     * 监听 TRTCVodPlayer 事件
      *
-     * 包括：停止播放、销毁渲染器、移除所有事件监听
+     * @param {TRTCVodPlayerEvent} event - 事件名称
+     * @param {Function} listener - 事件回调函数，参数随事件类型不同而不同
      */
-    destroy() {
-        var _a, _b;
-        if (this.isDestroyed) {
-            this.logger.warn('destroy: player already destroyed');
-            return;
-        }
-        this.logger.info('destroy');
-        this.stop();
-        this.isDestroyed = true;
-        this._destroyVideoRender();
-        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setEventCallback(null);
-        (_b = this.nativeVodPlayer) === null || _b === void 0 ? void 0 : _b.setDataCallback(null);
-        this.nativeVodPlayer = null;
-        this.eventEmitter.removeAllListeners();
-    }
     on(event, listener) {
         this.eventEmitter.on(event, listener);
         return this;
     }
+    /**
+     * 取消监听 TRTCVodPlayer 事件
+     *
+     * @param {TRTCVodPlayerEvent} event - 事件名称
+     * @param {Function} listener - 事件回调函数，必须与 on 时传入的为同一引用
+     */
     off(event, listener) {
         this.eventEmitter.off(event, listener);
         return this;
@@ -126,12 +139,12 @@ class VodPlayer {
     /**
      * 预加载多媒体文件
      *
-     * 预加载完成后会触发 {@link VodPlayerEvents.onVodPlayerLoaded} 事件，事件参数携带
+     * 预加载完成后会触发 {@link TRTCVodPlayerEvent.onVodPlayerLoaded} 事件，事件参数携带
      * 媒体信息（时长、宽高）；同时 C++ 层会产生首帧并推送到 JS 层的视频渲染管线，
      * 在 view 上展示首帧画面。
      *
      * @example
-     * player.on(VodPlayerEvents.onVodPlayerLoaded, (durationMs, width, height) => {
+     * player.on(TRTCVodPlayerEvent.onVodPlayerLoaded, (durationMs, width, height) => {
      *   console.log('预加载完成:', durationMs, width, height);
      *   player.start();
      * });
@@ -262,7 +275,7 @@ class VodPlayer {
      * 无缝切换当前播放的媒体文件
      *
      * 在后台预加载新的媒体源，待新源就绪后无缝切换，避免切换时出现黑屏。
-     * 切换成功后触发 {@link VodPlayerEvents.onVodPlayerLoaded} 事件，携带新文件的媒体信息。
+     * 切换成功后触发 {@link TRTCVodPlayerEvent.onVodPlayerLoaded} 事件，携带新文件的媒体信息。
      *
      * @param newMediaFile - 新的媒体文件路径或 URL
      *
@@ -465,6 +478,33 @@ class VodPlayer {
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.unpublishAudio();
     }
     // ─── 内部方法 ───────────────────────────────────────────────
+    /**
+     * @private
+     * 销毁播放器，释放所有资源
+     *
+     * 包括：解绑事件监听、停止播放、销毁渲染器、清理 native 回调。
+     *
+     * 注意：调用本方法后不再向业务方派发任何事件。即便 `stop()` 内部会异步触发
+     * `onVodPlayerStopped`，该事件也不会送达，因为监听器已在第一步被清空。
+     * 这是 `releaseVodPlayer` 的自然语义（资源释放后不再产生副作用）。
+     */
+    _destroy() {
+        var _a, _b;
+        if (this.isDestroyed) {
+            this.logger.warn('destroy: player already destroyed');
+            return;
+        }
+        this.logger.info('destroy');
+        // 先清监听器，确保后续 stop 流程里通过 setImmediate 排队的事件（如 onVodPlayerStopped）
+        // 不会再回到业务方。此时 isDestroyed 尚为 false，后续 stop/detachTRTC 仍能正常走完。
+        this.eventEmitter.removeAllListeners();
+        this.stop();
+        this.isDestroyed = true;
+        this._destroyVideoRender();
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setEventCallback(null);
+        (_b = this.nativeVodPlayer) === null || _b === void 0 ? void 0 : _b.setDataCallback(null);
+        this.nativeVodPlayer = null;
+    }
     /**
      * @private
      * 将点播播放器关联到 TRTC 实例（用于辅助流推流，绑定后音频播放由 TRTC 接管）
@@ -492,7 +532,8 @@ class VodPlayer {
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.detachTRTC();
     }
     /**
-     * 类型安全地发射事件，参数类型由 `VodPlayerEventMap` 推导。
+     * @private
+     * 类型安全地发射事件，参数类型由 `TRTCVodPlayerEventMap` 推导。
      * 通过 `setImmediate` 让 emit 异步化，避免在 N-API 回调栈中触发用户代码。
      */
     fire(event, ...args) {
@@ -569,11 +610,11 @@ class VodPlayer {
         // 但若底层持续失败（例如尺寸一直对不上），不能每帧都重置 buffer——30fps 下每秒会触发 30 次
         // 跨 N-API 调用，引发明显性能抖动。这里加重试上限：前 N 次正常重置，超过后退避到周期性日志。
         this._setBufferRetryCount += 1;
-        if (this._setBufferRetryCount <= VodPlayer.MAX_BUFFER_RETRY) {
-            this.logger.info(`_dataRenderCallback: renderVideoData returned false (retry ${this._setBufferRetryCount}/${VodPlayer.MAX_BUFFER_RETRY}), re-setting video buffer`);
+        if (this._setBufferRetryCount <= TRTCVodPlayer.MAX_BUFFER_RETRY) {
+            this.logger.info(`_dataRenderCallback: renderVideoData returned false (retry ${this._setBufferRetryCount}/${TRTCVodPlayer.MAX_BUFFER_RETRY}), re-setting video buffer`);
             this._setVideoRenderBuffer();
         }
-        else if (this._setBufferRetryCount % VodPlayer.BUFFER_RETRY_LOG_INTERVAL === 0) {
+        else if (this._setBufferRetryCount % TRTCVodPlayer.BUFFER_RETRY_LOG_INTERVAL === 0) {
             this.logger.warn(`_dataRenderCallback: renderVideoData keeps failing for ${this._setBufferRetryCount} frames, giving up frame`);
         }
     }
@@ -581,28 +622,28 @@ class VodPlayer {
         var _a;
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setEventCallback((args) => {
             switch (args[0]) {
-                case types_1.VodPlayerEvents.onVodPlayerStarted:
-                    this.fire(types_1.VodPlayerEvents.onVodPlayerStarted, args[1].msLength);
+                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStarted:
+                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStarted, args[1].msLength);
                     break;
-                case types_1.VodPlayerEvents.onVodPlayerLoaded: {
+                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerLoaded: {
                     const data = args[1];
-                    this.fire(types_1.VodPlayerEvents.onVodPlayerLoaded, data.durationMs, data.width, data.height);
+                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerLoaded, data.durationMs, data.width, data.height);
                     break;
                 }
-                case types_1.VodPlayerEvents.onVodPlayerProgress:
-                    this.fire(types_1.VodPlayerEvents.onVodPlayerProgress, args[1].msPos);
+                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerProgress:
+                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerProgress, args[1].msPos);
                     break;
-                case types_1.VodPlayerEvents.onVodPlayerPaused:
-                    this.fire(types_1.VodPlayerEvents.onVodPlayerPaused);
+                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerPaused:
+                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerPaused);
                     break;
-                case types_1.VodPlayerEvents.onVodPlayerResumed:
-                    this.fire(types_1.VodPlayerEvents.onVodPlayerResumed);
+                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerResumed:
+                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerResumed);
                     break;
-                case types_1.VodPlayerEvents.onVodPlayerStopped:
-                    this.fire(types_1.VodPlayerEvents.onVodPlayerStopped, args[1].reason);
+                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStopped:
+                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStopped, args[1].reason);
                     break;
-                case types_1.VodPlayerEvents.onVodPlayerError:
-                    this.fire(types_1.VodPlayerEvents.onVodPlayerError, args[1].error);
+                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerError:
+                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerError, args[1].error);
                     break;
                 default: {
                     const exhaustiveCheck = args[0];
@@ -613,8 +654,16 @@ class VodPlayer {
         });
     }
 }
-exports.VodPlayer = VodPlayer;
-/** `_dataRenderCallback` 中允许连续重置 video buffer 的最大次数，超过后退化为周期日志 */
-VodPlayer.MAX_BUFFER_RETRY = 3;
-/** 重试上限达到后，每隔多少帧打一次 warn 日志（按 30fps 估算 ≈ 2 秒一次） */
-VodPlayer.BUFFER_RETRY_LOG_INTERVAL = 60;
+exports.TRTCVodPlayer = TRTCVodPlayer;
+TRTCVodPlayer.MAX_BUFFER_RETRY = 3;
+TRTCVodPlayer.BUFFER_RETRY_LOG_INTERVAL = 60;
+// ─── 静态工厂方法 ───────────────────────────────────────────
+/**
+ * 当前 native 构建是否启用了 VOD 播放器。
+ *
+ * 这是一次性的"构建期能力探测"——`NodeTRTCEngine.NodeVodPlayer` 是
+ * 加载 .node 时绑定，运行期不会变化，因此结果可在模块加载时缓存为常量。
+ *
+ * 通过 {@link isSupported} 对外暴露访问入口。
+ */
+TRTCVodPlayer.VOD_SUPPORTED = typeof (NodeTRTCEngine === null || NodeTRTCEngine === void 0 ? void 0 : NodeTRTCEngine.NodeVodPlayer) === 'function';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trtc-electron-sdk",
-  "version": "13.3.800-alpha.2",
+  "version": "13.3.801-alpha.0",
   "description": "trtc electron sdk",
   "main": "./liteav/index.js",
   "types": "./liteav/index.d.ts",