trtc-electron-sdk 13.1.709-beta.1 → 13.4.800-alpha.0

package/liteav/Live/video-render.js

@@ -51,7 +51,19 @@ class VideoRender {
             return;
         }
         this.pixelFormat = format;
-        this.pixelLength = this.pixelFormat === trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420 ? 1.5 : 4;
+        const newLength = this.pixelFormat === trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420 ? 1.5 : 4;
+        if (this.pixelLength !== newLength) {
+            this.pixelLength = newLength;
+            this.videoBuffer.pixelFormat = this.pixelFormat;
+            this.videoBuffer.buffer = null;
+            this.videoBuffer.buffer = (0, util_1.allocBuffer)(this.videoBuffer.width * this.videoBuffer.height * this.pixelLength);
+            this.videoBuffer.id = (0, util_1.generateUniqueId)();
+        }
+        // 像素格式变更后重建渲染器，确保渲染器与数据格式匹配
+        if (this.videoRender !== null) {
+            this.destroyRender();
+            this.createRender();
+        }
     }
     setUserId(userId) {
         this.videoBuffer.userId = userId;
@@ -85,7 +97,9 @@ class VideoRender {
             this.videoBuffer.buffer = null;
             this.videoBuffer.width = width;
             this.videoBuffer.height = height;
+            this.videoBuffer.pixelFormat = this.pixelFormat;
             this.videoBuffer.buffer = (0, util_1.allocBuffer)(this.videoBuffer.width * this.videoBuffer.height * this.pixelLength);
+            this.videoBuffer.id = (0, util_1.generateUniqueId)();
         }
     }
 }

package/liteav/Renderer/VideoRenderer/index.js

@@ -106,7 +106,12 @@ class VideoRenderer {
                         codedHeight: frameData.height,
                         timestamp: frameData.timestamp,
                     });
-                    yield this.writer.write(vf);
+                    try {
+                        yield this.writer.write(vf);
+                    }
+                    finally {
+                        vf.close();
+                    }
                 }
                 else {
                     throw new Error('renderer container element is null');

package/liteav/index.d.ts

@@ -1,5 +1,6 @@
 export * from './trtc_define';
 export * from './trtc_code';
+export * from './vod_player';
 export * from './extensions/DeviceManager';
 export * from './extensions/AudioEffectManager';
 export * from './extensions/MediaMixingManager';

package/liteav/index.js

@@ -15,6 +15,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./trtc_define"), exports);
 __exportStar(require("./trtc_code"), exports);
+__exportStar(require("./vod_player"), exports);
 __exportStar(require("./extensions/DeviceManager"), exports);
 __exportStar(require("./extensions/AudioEffectManager"), exports);
 __exportStar(require("./extensions/MediaMixingManager"), exports);

package/liteav/trtc.d.ts

@@ -2345,11 +2345,21 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      *
      * - 调用 `setLocalVideoRenderCallback(TRTCVideoPixelFormat_Unknown, TRTCVideoBufferType_Unknown, null)` 可停止自定义渲染回调，恢复 SDK 内置渲染。
      * - Electron 平台仅支持回调 `TRTCVideoPixelFormat_I420` 像素格式的视频帧。
+     * @version v13.1.709
      *
      * @param {TRTCVideoPixelFormat} pixelFormat - 指定回调的像素格式
      * @param {TRTCVideoBufferType}  bufferType  - 指定视频数据结构类型
      * @param {TRTCVideoRenderCallback | null} callback - 自定义渲染回调，传入 null 表示停止自定义渲染
      * @return {number} 0：成功；<0：错误
+     *
+     * @example
+     * import TRTCCloud from 'trtc-electron-sdk';
+     * const trtcCloud = TRTCCloud.getTRTCShareInstance();
+     * trtc.setLocalVideoRenderCallback(TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420, TRTCVideoBufferType.TRTCVideoBufferType_Buffer, {
+     *   onRenderVideoFrame(userId, streamType, frame) {
+     *     // 处理本地视频帧的回调
+     *   }
+     * });
      */
     setLocalVideoRenderCallback(pixelFormat: TRTCVideoPixelFormat, bufferType: TRTCVideoBufferType, callback: TRTCVideoRenderCallback | null): number;
     /**
@@ -2359,12 +2369,22 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      *
      * - 调用 `setRemoteVideoRenderCallback(userId, TRTCVideoPixelFormat_Unknown, TRTCVideoBufferType_Unknown, null)` 可停止自定义渲染回调，恢复 SDK 内置渲染。
      * - Electron 平台仅支持回调 `TRTCVideoPixelFormat_I420` 像素格式的视频帧。
+     * @version v13.1.709
      *
      * @param {string} userId - 远端用户标识
      * @param {TRTCVideoPixelFormat} pixelFormat - 指定回调的像素格式
      * @param {TRTCVideoBufferType}  bufferType  - 指定视频数据结构类型
      * @param {TRTCVideoRenderCallback | null} callback - 自定义渲染回调，传入 null 表示停止自定义渲染
      * @return {number} 0：成功；<0：错误
+     *
+     * @example
+     * import TRTCCloud from 'trtc-electron-sdk';
+     * const trtcCloud = TRTCCloud.getTRTCShareInstance();
+     * trtc.setRemoteVideoRenderCallback('remoteUserId', TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420, TRTCVideoBufferType.TRTCVideoBufferType_Buffer, {
+     *   onRenderVideoFrame(userId, streamType, frame) {
+     *     // 处理远端视频帧的回调
+     *   }
+     * });
      */
     setRemoteVideoRenderCallback(userId: string, pixelFormat: TRTCVideoPixelFormat, bufferType: TRTCVideoBufferType, callback: TRTCVideoRenderCallback | null): number;
     /**

package/liteav/trtc.js

@@ -3983,11 +3983,21 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      * - 调用 `setLocalVideoRenderCallback(TRTCVideoPixelFormat_Unknown, TRTCVideoBufferType_Unknown, null)` 可停止自定义渲染回调，恢复 SDK 内置渲染。
      * - Electron 平台仅支持回调 `TRTCVideoPixelFormat_I420` 像素格式的视频帧。
+     * @version v13.1.709
      *
      * @param {TRTCVideoPixelFormat} pixelFormat - 指定回调的像素格式
      * @param {TRTCVideoBufferType}  bufferType  - 指定视频数据结构类型
      * @param {TRTCVideoRenderCallback | null} callback - 自定义渲染回调，传入 null 表示停止自定义渲染
      * @return {number} 0：成功；<0：错误
+     *
+     * @example
+     * import TRTCCloud from 'trtc-electron-sdk';
+     * const trtcCloud = TRTCCloud.getTRTCShareInstance();
+     * trtc.setLocalVideoRenderCallback(TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420, TRTCVideoBufferType.TRTCVideoBufferType_Buffer, {
+     *   onRenderVideoFrame(userId, streamType, frame) {
+     *     // 处理本地视频帧的回调
+     *   }
+     * });
      */
     setLocalVideoRenderCallback(pixelFormat, bufferType, callback) {
         try {
@@ -4031,12 +4041,22 @@ class TRTCCloud extends events_1.EventEmitter {
      *
      * - 调用 `setRemoteVideoRenderCallback(userId, TRTCVideoPixelFormat_Unknown, TRTCVideoBufferType_Unknown, null)` 可停止自定义渲染回调，恢复 SDK 内置渲染。
      * - Electron 平台仅支持回调 `TRTCVideoPixelFormat_I420` 像素格式的视频帧。
+     * @version v13.1.709
      *
      * @param {string} userId - 远端用户标识
      * @param {TRTCVideoPixelFormat} pixelFormat - 指定回调的像素格式
      * @param {TRTCVideoBufferType}  bufferType  - 指定视频数据结构类型
      * @param {TRTCVideoRenderCallback | null} callback - 自定义渲染回调，传入 null 表示停止自定义渲染
      * @return {number} 0：成功；<0：错误
+     *
+     * @example
+     * import TRTCCloud from 'trtc-electron-sdk';
+     * const trtcCloud = TRTCCloud.getTRTCShareInstance();
+     * trtc.setRemoteVideoRenderCallback('remoteUserId', TRTCVideoPixelFormat.TRTCVideoPixelFormat_I420, TRTCVideoBufferType.TRTCVideoBufferType_Buffer, {
+     *   onRenderVideoFrame(userId, streamType, frame) {
+     *     // 处理远端视频帧的回调
+     *   }
+     * });
      */
     setRemoteVideoRenderCallback(userId, pixelFormat, bufferType, callback) {
         try {

package/liteav/vod_player.d.ts

@@ -0,0 +1,210 @@
+import { TRTCVideoRotation, TRTCVideoFillMode } from './trtc_define';
+/**
+ * VodPlayer 播放器事件枚举
+ */
+export declare enum VodPlayerEvents {
+    /** 播放开始，参数：msLength（总时长，毫秒） */
+    onVodPlayerStarted = "onVodPlayerStarted",
+    /** 播放进度更新，参数：msPos（当前进度，毫秒） */
+    onVodPlayerProgress = "onVodPlayerProgress",
+    /** 播放暂停 */
+    onVodPlayerPaused = "onVodPlayerPaused",
+    /** 播放恢复 */
+    onVodPlayerResumed = "onVodPlayerResumed",
+    /** 播放停止，参数：reason（0=用户主动停止，1=文件播放完，2=视频断流） */
+    onVodPlayerStopped = "onVodPlayerStopped",
+    /** 播放错误，参数：error（错误码） */
+    onVodPlayerError = "onVodPlayerError"
+}
+/**
+ * VodPlayer 事件与回调参数的类型映射
+ *
+ * 用于 on/off 方法的类型约束，使事件名和回调参数在编译期匹配。
+ */
+export interface VodPlayerEventMap {
+    [VodPlayerEvents.onVodPlayerStarted]: [msLength: number];
+    [VodPlayerEvents.onVodPlayerProgress]: [msPos: number];
+    [VodPlayerEvents.onVodPlayerPaused]: [];
+    [VodPlayerEvents.onVodPlayerResumed]: [];
+    [VodPlayerEvents.onVodPlayerStopped]: [reason: number];
+    [VodPlayerEvents.onVodPlayerError]: [error: number];
+}
+/**
+ *
+ * 腾讯云点播播放器
+ *
+ * 用于播放本地或在线的音视频文件，支持视频渲染、音量控制、
+ * 进度控制、TRTC 推流等功能。
+ *
+ * @version v13.4.800
+ *
+ * @example
+ * import { VodPlayer, VodPlayerEvents } from 'trtc-electron-sdk';
+ *
+ * const player = VodPlayer.createVodPlayer('/path/to/video.mp4', false);
+ * player.on(VodPlayerEvents.onVodPlayerStarted, (msLength) => {
+ *   console.log('播放开始，总时长:', msLength);
+ * });
+ * player.setView(document.getElementById('video-container')!);
+ * player.start();
+ *
+ * // 使用完毕后销毁
+ * VodPlayer.releaseVodPlayer(player);
+ */
+export declare class VodPlayer {
+    private nativeVodPlayer;
+    private videoRender;
+    private mediaFilePath;
+    private repeat;
+    private isStarted;
+    private isDestroyed;
+    private logger;
+    private eventEmitter;
+    /**
+     * 创建 VodPlayer 实例
+     *
+     * @param mediaFilePath - 媒体文件路径（本地路径或在线 URL）
+     * @param repeat - 是否循环播放，默认 false
+     * @returns VodPlayer 实例
+     */
+    static createVodPlayer(mediaFilePath: string, repeat?: boolean): VodPlayer;
+    /**
+     * 销毁 VodPlayer 实例，释放相关资源
+     *
+     * @param player - 待销毁的 VodPlayer 实例
+     */
+    static releaseVodPlayer(player: VodPlayer): void;
+    private constructor();
+    /**
+     * 销毁播放器，释放所有资源
+     *
+     * 包括：停止播放、销毁渲染器、移除所有事件监听
+     */
+    destroy(): void;
+    /**
+     * 监听 VodPlayer 事件
+     *
+     * @param event - 事件名称，参考 {@link VodPlayerEvents}
+     * @param listener - 事件回调函数，参数类型根据事件自动推导
+     */
+    on<K extends keyof VodPlayerEventMap>(event: K, listener: (...args: VodPlayerEventMap[K]) => void): this;
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
+    /**
+     * 取消监听 VodPlayer 事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件回调函数
+     */
+    off<K extends keyof VodPlayerEventMap>(event: K, listener: (...args: VodPlayerEventMap[K]) => void): this;
+    off(event: string | symbol, listener: (...args: any[]) => void): this;
+    /**
+     * 设置视频渲染的 DOM 容器
+     *
+     * @param view - HTML 元素，用于承载视频画面
+     */
+    setView(view: HTMLElement | null): void;
+    /**
+     * 开始播放
+     *
+     */
+    start(): void;
+    /**
+     * 停止播放
+     *
+     */
+    stop(): void;
+    /**
+     * 暂停播放
+     */
+    pause(): void;
+    /**
+     * 恢复播放
+     */
+    resume(): void;
+    /**
+     * 跳转到指定播放位置
+     *
+     * @param msPos - 目标位置，单位毫秒
+     */
+    seek(msPos: number): void;
+    /**
+     * 获取媒体文件总时长
+     *
+     * @returns 总时长，单位毫秒
+     */
+    getDuration(): number;
+    /**
+     * 获取视频宽度
+     *
+     * @returns 视频宽度（像素）
+     */
+    getWidth(): number;
+    /**
+     * 获取视频高度
+     *
+     * @returns 视频高度（像素）
+     */
+    getHeight(): number;
+    /**
+     * 设置画面旋转角度
+     *
+     * @param rotation - 旋转角度，参考 TRTCVideoRotation 枚举
+     */
+    setRenderRotation(rotation: TRTCVideoRotation): void;
+    /**
+     * 设置画面填充模式
+     *
+     * @param mode - 填充模式，参考 TRTCVideoFillMode 枚举
+     */
+    setFillMode(mode: TRTCVideoFillMode): void;
+    /**
+     * 设置画面镜像
+     *
+     * @param mirror - 是否镜像
+     */
+    setMirror(mirror: boolean): void;
+    /**
+     * 静音 / 取消静音
+     *
+     * @param mute - 是否静音
+     */
+    mute(mute: boolean): void;
+    /**
+     * 设置播放音量
+     *
+     * @param volume - 音量大小，取值范围 0-100
+     */
+    setVolume(volume: number): void;
+    /**
+     * 将点播播放器关联到 TRTC 实例（用于推流）
+     */
+    attachTRTC(): void;
+    /**
+     * 将点播播放器从 TRTC 实例分离
+     */
+    detachTRTC(): void;
+    /**
+     * 开始推送视频流到 TRTC
+     */
+    publishVideo(): void;
+    /**
+     * 开始推送音频流到 TRTC
+     */
+    publishAudio(): void;
+    /**
+     * 停止推送视频流到 TRTC
+     */
+    unpublishVideo(): void;
+    /**
+     * 停止推送音频流到 TRTC
+     */
+    unpublishAudio(): void;
+    private fire;
+    private _createVideoRender;
+    private _destroyVideoRender;
+    private _setVideoRenderBuffer;
+    private _addDataRenderCallback;
+    private _removeDataRenderCallback;
+    private _dataRenderCallback;
+    private _initEventCallback;
+}

package/liteav/vod_player.js

@@ -0,0 +1,466 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VodPlayer = exports.VodPlayerEvents = 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 NodeTRTCEngine = require('../build/Release/trtc_electron_sdk.node');
+/**
+ * VodPlayer 播放器事件枚举
+ */
+var VodPlayerEvents;
+(function (VodPlayerEvents) {
+    /** 播放开始，参数：msLength（总时长，毫秒） */
+    VodPlayerEvents["onVodPlayerStarted"] = "onVodPlayerStarted";
+    /** 播放进度更新，参数：msPos（当前进度，毫秒） */
+    VodPlayerEvents["onVodPlayerProgress"] = "onVodPlayerProgress";
+    /** 播放暂停 */
+    VodPlayerEvents["onVodPlayerPaused"] = "onVodPlayerPaused";
+    /** 播放恢复 */
+    VodPlayerEvents["onVodPlayerResumed"] = "onVodPlayerResumed";
+    /** 播放停止，参数：reason（0=用户主动停止，1=文件播放完，2=视频断流） */
+    VodPlayerEvents["onVodPlayerStopped"] = "onVodPlayerStopped";
+    /** 播放错误，参数：error（错误码） */
+    VodPlayerEvents["onVodPlayerError"] = "onVodPlayerError";
+})(VodPlayerEvents = exports.VodPlayerEvents || (exports.VodPlayerEvents = {}));
+/**
+ *
+ * 腾讯云点播播放器
+ *
+ * 用于播放本地或在线的音视频文件，支持视频渲染、音量控制、
+ * 进度控制、TRTC 推流等功能。
+ *
+ * @version v13.4.800
+ *
+ * @example
+ * import { VodPlayer, VodPlayerEvents } from 'trtc-electron-sdk';
+ *
+ * const player = VodPlayer.createVodPlayer('/path/to/video.mp4', false);
+ * player.on(VodPlayerEvents.onVodPlayerStarted, (msLength) => {
+ *   console.log('播放开始，总时长:', msLength);
+ * });
+ * player.setView(document.getElementById('video-container')!);
+ * player.start();
+ *
+ * // 使用完毕后销毁
+ * VodPlayer.releaseVodPlayer(player);
+ */
+class VodPlayer {
+    // ─── 构造函数 ───────────────────────────────────────────────
+    constructor(mediaFilePath, repeat = false) {
+        this.logger = new logger_1.Logger('VodPlayer');
+        this.eventEmitter = new events_1.EventEmitter();
+        this._dataRenderCallback = this._dataRenderCallback.bind(this);
+        this.nativeVodPlayer = new NodeTRTCEngine.NodeVodPlayer(mediaFilePath, repeat);
+        this.mediaFilePath = mediaFilePath;
+        this.repeat = repeat;
+        this.isStarted = false;
+        this.isDestroyed = false;
+        this.videoRender = null;
+        this._createVideoRender();
+        this._initEventCallback();
+    }
+    // ─── 静态工厂方法 ───────────────────────────────────────────
+    /**
+     * 创建 VodPlayer 实例
+     *
+     * @param mediaFilePath - 媒体文件路径（本地路径或在线 URL）
+     * @param repeat - 是否循环播放，默认 false
+     * @returns VodPlayer 实例
+     */
+    static createVodPlayer(mediaFilePath, repeat = false) {
+        return new VodPlayer(mediaFilePath, repeat);
+    }
+    /**
+     * 销毁 VodPlayer 实例，释放相关资源
+     *
+     * @param player - 待销毁的 VodPlayer 实例
+     */
+    static releaseVodPlayer(player) {
+        player.destroy();
+    }
+    // ─── 公开方法 ───────────────────────────────────────────────
+    /**
+     * 销毁播放器，释放所有资源
+     *
+     * 包括：停止播放、销毁渲染器、移除所有事件监听
+     */
+    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;
+    }
+    off(event, listener) {
+        this.eventEmitter.off(event, listener);
+        return this;
+    }
+    /**
+     * 设置视频渲染的 DOM 容器
+     *
+     * @param view - HTML 元素，用于承载视频画面
+     */
+    setView(view) {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('setView: player already destroyed');
+            return;
+        }
+        this.logger.info(`setView view: ${view}`);
+        (_a = this.videoRender) === null || _a === void 0 ? void 0 : _a.setRenderView(view);
+    }
+    /**
+     * 开始播放
+     *
+     */
+    start() {
+        var _a, _b;
+        if (this.isDestroyed) {
+            this.logger.warn('start: player already destroyed');
+            return;
+        }
+        this.logger.info(`start mediaFile: ${this.mediaFilePath}`);
+        if (this.isStarted) {
+            this.logger.warn('start: already started, ignored');
+            return;
+        }
+        (_a = this.videoRender) === null || _a === void 0 ? void 0 : _a.createRender();
+        this._setVideoRenderBuffer();
+        this._addDataRenderCallback();
+        (_b = this.nativeVodPlayer) === null || _b === void 0 ? void 0 : _b.start();
+        this.isStarted = true;
+    }
+    /**
+     * 停止播放
+     *
+     */
+    stop() {
+        var _a, _b;
+        if (this.isDestroyed) {
+            this.logger.warn('stop: player already destroyed');
+            return;
+        }
+        this.logger.info('stop');
+        if (!this.isStarted) {
+            return;
+        }
+        this.isStarted = false;
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.stop();
+        (_b = this.videoRender) === null || _b === void 0 ? void 0 : _b.destroyRender();
+        this._removeDataRenderCallback();
+    }
+    /**
+     * 暂停播放
+     */
+    pause() {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('pause: player already destroyed');
+            return;
+        }
+        this.logger.info('pause');
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.pause();
+    }
+    /**
+     * 恢复播放
+     */
+    resume() {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('resume: player already destroyed');
+            return;
+        }
+        this.logger.info('resume');
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.resume();
+    }
+    /**
+     * 跳转到指定播放位置
+     *
+     * @param msPos - 目标位置，单位毫秒
+     */
+    seek(msPos) {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('seek: player already destroyed');
+            return;
+        }
+        this.logger.info(`seek msPos: ${msPos}`);
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.seek(msPos);
+    }
+    /**
+     * 获取媒体文件总时长
+     *
+     * @returns 总时长，单位毫秒
+     */
+    getDuration() {
+        var _a, _b;
+        if (this.isDestroyed) {
+            this.logger.warn('getDuration: player already destroyed');
+            return 0;
+        }
+        return (_b = (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.getDuration()) !== null && _b !== void 0 ? _b : 0;
+    }
+    /**
+     * 获取视频宽度
+     *
+     * @returns 视频宽度（像素）
+     */
+    getWidth() {
+        var _a, _b;
+        if (this.isDestroyed) {
+            this.logger.warn('getWidth: player already destroyed');
+            return 0;
+        }
+        return (_b = (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.getWidth()) !== null && _b !== void 0 ? _b : 0;
+    }
+    /**
+     * 获取视频高度
+     *
+     * @returns 视频高度（像素）
+     */
+    getHeight() {
+        var _a, _b;
+        if (this.isDestroyed) {
+            this.logger.warn('getHeight: player already destroyed');
+            return 0;
+        }
+        return (_b = (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.getHeight()) !== null && _b !== void 0 ? _b : 0;
+    }
+    /**
+     * 设置画面旋转角度
+     *
+     * @param rotation - 旋转角度，参考 TRTCVideoRotation 枚举
+     */
+    setRenderRotation(rotation) {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('setRenderRotation: player already destroyed');
+            return;
+        }
+        this.logger.info(`setRenderRotation rotation: ${rotation}`);
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setRenderRotation(rotation);
+    }
+    /**
+     * 设置画面填充模式
+     *
+     * @param mode - 填充模式，参考 TRTCVideoFillMode 枚举
+     */
+    setFillMode(mode) {
+        var _a, _b;
+        if (this.isDestroyed) {
+            this.logger.warn('setFillMode: player already destroyed');
+            return;
+        }
+        this.logger.info(`setFillMode mode: ${mode}`);
+        (_a = this.videoRender) === null || _a === void 0 ? void 0 : _a.setVideoFillMode(mode);
+        (_b = this.nativeVodPlayer) === null || _b === void 0 ? void 0 : _b.setFillMode(mode);
+    }
+    /**
+     * 设置画面镜像
+     *
+     * @param mirror - 是否镜像
+     */
+    setMirror(mirror) {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('setMirror: player already destroyed');
+            return;
+        }
+        this.logger.info(`setMirror mirror: ${mirror}`);
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setMirror(mirror);
+    }
+    /**
+     * 静音 / 取消静音
+     *
+     * @param mute - 是否静音
+     */
+    mute(mute) {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('mute: player already destroyed');
+            return;
+        }
+        this.logger.info(`mute: ${mute}`);
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.mute(mute);
+    }
+    /**
+     * 设置播放音量
+     *
+     * @param volume - 音量大小，取值范围 0-100
+     */
+    setVolume(volume) {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('setVolume: player already destroyed');
+            return;
+        }
+        this.logger.info(`setVolume volume: ${volume}`);
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setVolume(volume);
+    }
+    /**
+     * 将点播播放器关联到 TRTC 实例（用于推流）
+     */
+    attachTRTC() {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('attachTRTC: player already destroyed');
+            return;
+        }
+        this.logger.info('attachTRTC');
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.attachTRTC();
+    }
+    /**
+     * 将点播播放器从 TRTC 实例分离
+     */
+    detachTRTC() {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('detachTRTC: player already destroyed');
+            return;
+        }
+        this.logger.info('detachTRTC');
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.detachTRTC();
+    }
+    /**
+     * 开始推送视频流到 TRTC
+     */
+    publishVideo() {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('publishVideo: player already destroyed');
+            return;
+        }
+        this.logger.info('publishVideo');
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.publishVideo();
+    }
+    /**
+     * 开始推送音频流到 TRTC
+     */
+    publishAudio() {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('publishAudio: player already destroyed');
+            return;
+        }
+        this.logger.info('publishAudio');
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.publishAudio();
+    }
+    /**
+     * 停止推送视频流到 TRTC
+     */
+    unpublishVideo() {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('unpublishVideo: player already destroyed');
+            return;
+        }
+        this.logger.info('unpublishVideo');
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.unpublishVideo();
+    }
+    /**
+     * 停止推送音频流到 TRTC
+     */
+    unpublishAudio() {
+        var _a;
+        if (this.isDestroyed) {
+            this.logger.warn('unpublishAudio: player already destroyed');
+            return;
+        }
+        this.logger.info('unpublishAudio');
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.unpublishAudio();
+    }
+    // ─── 内部方法 ───────────────────────────────────────────────
+    fire(event, ...args) {
+        setImmediate(() => {
+            this.eventEmitter.emit(event, ...args);
+        });
+    }
+    _createVideoRender() {
+        if (this.videoRender !== null) {
+            return;
+        }
+        this.videoRender = new video_render_1.VideoRender();
+        this.videoRender.setVideoPixelFormat(trtc_define_1.TRTCVideoPixelFormat.TRTCVideoPixelFormat_BGRA32);
+    }
+    _destroyVideoRender() {
+        if (this.videoRender) {
+            this.videoRender.destroy();
+            this.videoRender = null;
+        }
+        this._removeDataRenderCallback();
+    }
+    _setVideoRenderBuffer() {
+        var _a;
+        if (this.videoRender !== null) {
+            const videoBuffer = this.videoRender.getVideoBuffer();
+            this.logger.info(`_setVideoRenderBuffer: userId=${videoBuffer.userId}, width=${videoBuffer.width}, height=${videoBuffer.height}, bufferId=${videoBuffer.id}, pixelFormat=${videoBuffer.pixelFormat}`);
+            (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setVideoBuffer(videoBuffer.userId || '', videoBuffer.buffer, videoBuffer.streamType, videoBuffer.width, videoBuffer.height, videoBuffer.pixelFormat, videoBuffer.id);
+        }
+    }
+    _addDataRenderCallback() {
+        var _a;
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setDataCallback(this._dataRenderCallback);
+    }
+    _removeDataRenderCallback() {
+        var _a;
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setDataCallback(null);
+    }
+    _dataRenderCallback(args) {
+        if (this.videoRender) {
+            const [userId, type, width, height, timestamp, rotation, valid, bufferId] = args;
+            const result = this.videoRender.renderVideoData(userId, type, width, height, timestamp, rotation, valid, bufferId);
+            if (!result) {
+                this.logger.info(`_dataRenderCallback: renderVideoData returned false, re-setting video buffer`);
+                this._setVideoRenderBuffer();
+            }
+        }
+        else {
+            this.logger.warn('_dataRenderCallback: videoRender is null, frame dropped');
+        }
+    }
+    _initEventCallback() {
+        var _a;
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setEventCallback((args) => {
+            const key = args[0];
+            const data = args[1];
+            switch (key) {
+                case VodPlayerEvents.onVodPlayerStarted:
+                    this.fire(VodPlayerEvents.onVodPlayerStarted, data.msLength);
+                    break;
+                case VodPlayerEvents.onVodPlayerProgress:
+                    this.fire(VodPlayerEvents.onVodPlayerProgress, data.msPos);
+                    break;
+                case VodPlayerEvents.onVodPlayerPaused:
+                    this.fire(VodPlayerEvents.onVodPlayerPaused);
+                    break;
+                case VodPlayerEvents.onVodPlayerResumed:
+                    this.fire(VodPlayerEvents.onVodPlayerResumed);
+                    break;
+                case VodPlayerEvents.onVodPlayerStopped:
+                    this.fire(VodPlayerEvents.onVodPlayerStopped, data.reason);
+                    break;
+                case VodPlayerEvents.onVodPlayerError:
+                    this.fire(VodPlayerEvents.onVodPlayerError, data.error);
+                    break;
+                default:
+                    this.logger.warn(`unknown vod player event: ${key}`);
+                    break;
+            }
+        });
+    }
+}
+exports.VodPlayer = VodPlayer;

package/package.json

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