trtc-electron-sdk 13.3.801-alpha.3 → 13.3.802-beta.0

package/liteav/extensions/MediaMixingManager/MediaMixingManager.d.ts

@@ -95,6 +95,13 @@ export declare enum TRTCMediaMixingEvent {
      * @param {Number} size.height 媒体源最新高度
      */
     onMediaSourceSizeChanged = "onMediaSourceSizeChanged",
+    /**
+     * @description 本地混流服务丢失事件
+     * @deprecated
+     * @private
+     *
+     * @event TRTCMediaMixingEvent#onMediaMixingServerLost
+     */
     onMediaMixingServerLost = "onMediaMixingServerLost"
 }
 declare enum TRTCMediaMixingServerMode {
@@ -264,12 +271,15 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      */
     updateMediaSource(mediaSource: TRTCMediaSource): Promise<void>;
     /**
+     * @deprecated
+     *
      * 设置摄像头采集参数
      * @param cameraID {string} - 摄像头 ID
      * @param params {TRTCCameraCaptureParams} - 摄像头采集参数
      */
     setCameraCaptureParam(cameraID: string, params: TRTCCameraCaptureParams): void;
     /**
+     * @deprecated
      * 设置手机投屏参数
      * @private
      * @param phoneMirrorSourceId {string} - 手机投屏媒体源 ID
@@ -277,18 +287,24 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
      */
     setPhoneMirrorParam(phoneMirrorSourceId: string, param: TRTCPhoneMirrorParam): void;
     /**
+     * @deprecated
+     *
      * 设置屏幕采集参数
      * @param screenOrWindowID {String} - 屏幕 ID 或 窗口 ID
      * @param property {TRTCScreenCaptureProperty} - 屏幕采集属性
      */
     setScreenCaptureProperty(screenOrWindowID: string, property: TRTCScreenCaptureProperty): void;
     /**
+     * @deprecated
+     *
      * 设置在线视频源播放参数
      * @param url {string} - 在线视频源 URL
      * @param param {TRTCOnlineVideoParam} - 在线视频源播放参数
      */
     setOnlineVideoParam(url: string, param: TRTCOnlineVideoParam): void;
     /**
+     * @deprecated
+     *
      * 设置视频文件播放参数
      * @param videoFilePath {string} - 视频文件路径
      * @param param {TRTCVideoFileParam} - 视频文件播放参数
@@ -458,6 +474,58 @@ export declare class TRTCMediaMixingManager implements ITRTCMediaMixingManager {
     private onCallExperimentalAPIFinish;
     private recoverMediaMixingServer;
     private onDevicePixelRatioChange;
+    /**
+     * @private
+     * Apply camera capture params BEFORE native addMediaSource.
+     *
+     * Calling setCameraCaptureParam after the camera has already been added
+     * triggers an extra camera restart (the camera first starts with default
+     * params and then restarts with the new ones). To avoid this we set
+     * camera params up-front for the add path. For all other source types
+     * the corresponding setters are dispatched in the post-add callback
+     * (`onMediaSourceAdded` -> `_applyMediaSourceParams`).
+     */
+    private _applyCameraParamsBeforeAdd;
+    /**
+     * @private
+     * Apply capture params from TRTCMediaSource to the native plugin.
+     *
+     * This method is called after media source is added or updated. To avoid
+     * costly side-effects of native setters (e.g. setCameraCaptureParam will
+     * restart the camera), the setter is invoked only when params are actually
+     * provided AND differ from the previous value carried by `oldMediaSource`.
+     *
+     * Camera handling differs by phase:
+     *   - Add path (oldMediaSource is undefined): camera params have been set
+     *     before native addMediaSource via `_applyCameraParamsBeforeAdd`, so
+     *     this method skips kCamera to avoid duplicate setter invocation.
+     *   - Update path (oldMediaSource is provided): kCamera goes through the
+     *     same diff check as other types and is dispatched only when changed.
+     *
+     * @param mediaSource - The new media source carrying capture params.
+     * @param oldMediaSource - The previous media source (omit for the add path
+     *                         where no previous params exist; in that case the
+     *                         setter is always invoked when params are present).
+     */
+    private _applyMediaSourceParams;
+    /**
+     * @private
+     * Shallow-but-stable equality check on capture param objects via JSON.
+     *
+     * Returns true when both sides represent the "same" params, false otherwise.
+     * Semantics:
+     *   - both empty (undefined / null) → true (no change requested)
+     *   - exactly one side empty → false (first-time apply or transition)
+     *   - both non-empty → byte-equal after JSON.stringify
+     *
+     * Note: JSON.stringify is sensitive to key ordering. Capture param objects
+     * carried by `TRTCMediaSource` are constructed by the SDK via
+     * `JSON.parse(JSON.stringify(...))` flow, so key order is stable in
+     * practice; for caller-supplied literal objects with unstable key order,
+     * the comparison may yield a false-negative and trigger an unnecessary
+     * setter call.
+     */
+    private _isSameCaptureParams;
     private previewInNativeWindow;
     private previewInWebElement;
     private previewInNone;

package/liteav/extensions/MediaMixingManager/MediaMixingManager.js

@@ -258,6 +258,13 @@ var TRTCMediaMixingEvent;
      * @param {Number} size.height 媒体源最新高度
      */
     TRTCMediaMixingEvent["onMediaSourceSizeChanged"] = "onMediaSourceSizeChanged";
+    /**
+     * @description 本地混流服务丢失事件
+     * @deprecated
+     * @private
+     *
+     * @event TRTCMediaMixingEvent#onMediaMixingServerLost
+     */
     TRTCMediaMixingEvent["onMediaMixingServerLost"] = "onMediaMixingServerLost";
 })(TRTCMediaMixingEvent = exports.TRTCMediaMixingEvent || (exports.TRTCMediaMixingEvent = {}));
 const promiseKeys = {
@@ -598,6 +605,10 @@ class TRTCMediaMixingManager {
                     }
                 }, timeoutMs);
                 this.addMediaSourceTimers.set(key, timer);
+                // Apply camera capture params BEFORE native addMediaSource to avoid an
+                // extra camera restart on first add. Other source types are handled in
+                // the onMediaSourceAdded callback once the C++ layer reports success.
+                this._applyCameraParamsBeforeAdd(newMediaSource);
                 this.nodeMediaMixingPlugin.addMediaSource(newMediaSource);
                 (_a = this.mediaMixingDesigner) === null || _a === void 0 ? void 0 : _a.addMedia({
                     id: `${newMediaSource.sourceType}__${newMediaSource.sourceId}`,
@@ -620,11 +631,11 @@ class TRTCMediaMixingManager {
     getAddMediaSourceTimeoutMs(sourceType) {
         switch (sourceType) {
             case types_1.TRTCMediaSourceType.kOnlineVideo:
-                return 15000;
+                return 11000;
             case types_1.TRTCMediaSourceType.kVideoFile:
-                return 10000;
+                return 6000;
             default:
-                return 8000;
+                return 5000;
         }
     }
     /**
@@ -701,6 +712,7 @@ class TRTCMediaMixingManager {
                 }
             }
             yield this.nodeMediaMixingPlugin.updateMediaSource(newMediaSource);
+            this._applyMediaSourceParams(newMediaSource, this.sourceList[index]);
             (_a = this.mediaMixingDesigner) === null || _a === void 0 ? void 0 : _a.updateMedia({
                 id: `${mediaSource.sourceType}__${mediaSource.sourceId}`,
                 rect: mediaSource.rect,
@@ -712,6 +724,8 @@ class TRTCMediaMixingManager {
         });
     }
     /**
+     * @deprecated
+     *
      * 设置摄像头采集参数
      * @param cameraID {string} - 摄像头 ID
      * @param params {TRTCCameraCaptureParams} - 摄像头采集参数
@@ -730,6 +744,7 @@ class TRTCMediaMixingManager {
         }
     }
     /**
+     * @deprecated
      * 设置手机投屏参数
      * @private
      * @param phoneMirrorSourceId {string} - 手机投屏媒体源 ID
@@ -739,6 +754,8 @@ class TRTCMediaMixingManager {
         this.nodeMediaMixingPlugin.setPhoneMirrorParam(phoneMirrorSourceId, param);
     }
     /**
+     * @deprecated
+     *
      * 设置屏幕采集参数
      * @param screenOrWindowID {String} - 屏幕 ID 或 窗口 ID
      * @param property {TRTCScreenCaptureProperty} - 屏幕采集属性
@@ -747,6 +764,8 @@ class TRTCMediaMixingManager {
         this.nodeMediaMixingPlugin.setScreenCaptureProperty(screenOrWindowID, property);
     }
     /**
+     * @deprecated
+     *
      * 设置在线视频源播放参数
      * @param url {string} - 在线视频源 URL
      * @param param {TRTCOnlineVideoParam} - 在线视频源播放参数
@@ -755,6 +774,8 @@ class TRTCMediaMixingManager {
         this.nodeMediaMixingPlugin.setOnlineVideoParam(url, param);
     }
     /**
+     * @deprecated
+     *
      * 设置视频文件播放参数
      * @param videoFilePath {string} - 视频文件路径
      * @param param {TRTCVideoFileParam} - 视频文件播放参数
@@ -1294,6 +1315,13 @@ class TRTCMediaMixingManager {
         }
         let flag = false;
         if (data.errCode === 0) {
+            const addedIndex = this.findMediaSourceIndex({
+                sourceId: data.sourceId,
+                sourceType: data.sourceType,
+            });
+            if (addedIndex !== -1) {
+                this._applyMediaSourceParams(this.sourceList[addedIndex]);
+            }
             flag = this.promiseStore.resolvePromise(promiseKey, undefined);
         }
         else {
@@ -1456,6 +1484,7 @@ class TRTCMediaMixingManager {
                     this.setStreamLayout(this.paramsStore.streamLayout);
                 }
                 this.sourceList.forEach((item) => {
+                    this._applyCameraParamsBeforeAdd(item);
                     this.nodeMediaMixingPlugin.addMediaSource(item);
                 });
                 if (((_b = this.trtcParamsStore) === null || _b === void 0 ? void 0 : _b.enterRoomParams) && ((_c = this.trtcParamsStore) === null || _c === void 0 ? void 0 : _c.enterRoomScene)) {
@@ -1497,7 +1526,108 @@ class TRTCMediaMixingManager {
         logger_1.default.debug(`${this.logPrefix}onDevicePixelRatioChange:`, window.devicePixelRatio);
         this.setDisplayRect();
     }
+    /**
+     * @private
+     * Apply camera capture params BEFORE native addMediaSource.
+     *
+     * Calling setCameraCaptureParam after the camera has already been added
+     * triggers an extra camera restart (the camera first starts with default
+     * params and then restarts with the new ones). To avoid this we set
+     * camera params up-front for the add path. For all other source types
+     * the corresponding setters are dispatched in the post-add callback
+     * (`onMediaSourceAdded` -> `_applyMediaSourceParams`).
+     */
+    _applyCameraParamsBeforeAdd(mediaSource) {
+        if (mediaSource.sourceType === types_1.TRTCMediaSourceType.kCamera && mediaSource.camera) {
+            this.setCameraCaptureParam(mediaSource.sourceId, mediaSource.camera);
+        }
+    }
+    /**
+     * @private
+     * Apply capture params from TRTCMediaSource to the native plugin.
+     *
+     * This method is called after media source is added or updated. To avoid
+     * costly side-effects of native setters (e.g. setCameraCaptureParam will
+     * restart the camera), the setter is invoked only when params are actually
+     * provided AND differ from the previous value carried by `oldMediaSource`.
+     *
+     * Camera handling differs by phase:
+     *   - Add path (oldMediaSource is undefined): camera params have been set
+     *     before native addMediaSource via `_applyCameraParamsBeforeAdd`, so
+     *     this method skips kCamera to avoid duplicate setter invocation.
+     *   - Update path (oldMediaSource is provided): kCamera goes through the
+     *     same diff check as other types and is dispatched only when changed.
+     *
+     * @param mediaSource - The new media source carrying capture params.
+     * @param oldMediaSource - The previous media source (omit for the add path
+     *                         where no previous params exist; in that case the
+     *                         setter is always invoked when params are present).
+     */
+    _applyMediaSourceParams(mediaSource, oldMediaSource) {
+        switch (mediaSource.sourceType) {
+            case types_1.TRTCMediaSourceType.kCamera:
+                // Skip kCamera on the add path to avoid an extra camera restart;
+                // it has been handled by `_applyCameraParamsBeforeAdd` already.
+                if (oldMediaSource && mediaSource.camera && !this._isSameCaptureParams(mediaSource.camera, oldMediaSource.camera)) {
+                    this.setCameraCaptureParam(mediaSource.sourceId, mediaSource.camera);
+                }
+                break;
+            case types_1.TRTCMediaSourceType.kScreen:
+                if (mediaSource.screen && !this._isSameCaptureParams(mediaSource.screen, oldMediaSource === null || oldMediaSource === void 0 ? void 0 : oldMediaSource.screen)) {
+                    this.setScreenCaptureProperty(mediaSource.sourceId, mediaSource.screen);
+                }
+                break;
+            case types_1.TRTCMediaSourceType.kOnlineVideo:
+                if (mediaSource.onlineVideo && !this._isSameCaptureParams(mediaSource.onlineVideo, oldMediaSource === null || oldMediaSource === void 0 ? void 0 : oldMediaSource.onlineVideo)) {
+                    this.setOnlineVideoParam(mediaSource.sourceId, mediaSource.onlineVideo);
+                }
+                break;
+            case types_1.TRTCMediaSourceType.kVideoFile:
+                if (mediaSource.localVideo && !this._isSameCaptureParams(mediaSource.localVideo, oldMediaSource === null || oldMediaSource === void 0 ? void 0 : oldMediaSource.localVideo)) {
+                    this.setVideoFileParam(mediaSource.sourceId, mediaSource.localVideo);
+                }
+                break;
+        }
+    }
+    /**
+     * @private
+     * Shallow-but-stable equality check on capture param objects via JSON.
+     *
+     * Returns true when both sides represent the "same" params, false otherwise.
+     * Semantics:
+     *   - both empty (undefined / null) → true (no change requested)
+     *   - exactly one side empty → false (first-time apply or transition)
+     *   - both non-empty → byte-equal after JSON.stringify
+     *
+     * Note: JSON.stringify is sensitive to key ordering. Capture param objects
+     * carried by `TRTCMediaSource` are constructed by the SDK via
+     * `JSON.parse(JSON.stringify(...))` flow, so key order is stable in
+     * practice; for caller-supplied literal objects with unstable key order,
+     * the comparison may yield a false-negative and trigger an unnecessary
+     * setter call.
+     */
+    _isSameCaptureParams(next, prev) {
+        if (next === prev) {
+            return true;
+        }
+        const nextEmpty = next === undefined || next === null;
+        const prevEmpty = prev === undefined || prev === null;
+        if (nextEmpty && prevEmpty) {
+            return true;
+        }
+        if (nextEmpty || prevEmpty) {
+            return false;
+        }
+        try {
+            return JSON.stringify(next) === JSON.stringify(prev);
+        }
+        catch (err) {
+            logger_1.default.warn(`${this.logPrefix}_isSameCaptureParams: stringify failed, treat as different.`, err);
+            return false;
+        }
+    }
     previewInNativeWindow(viewOrRegion) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             if (this.serverMode === TRTCMediaMixingServerMode.Embedded && (this.serverStatus === TRTCMediaMixingServerStatus.Started || this.serverStatus === TRTCMediaMixingServerStatus.Starting)) {
                 try {
@@ -1530,9 +1660,15 @@ class TRTCMediaMixingManager {
                 this.destroyDesigner();
                 this.nodeMediaMixingPlugin.setDisplayParams(this.windowID, viewOrRegion);
             }
+            if (!((_a = this.paramsStore) === null || _a === void 0 ? void 0 : _a.streamLayout)) {
+                this.setStreamLayout({
+                    layoutMode: types_1.TRTCStreamLayoutMode.None,
+                });
+            }
         });
     }
     previewInWebElement(viewOrRegion) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             if (this.serverMode === TRTCMediaMixingServerMode.Independent && (this.serverStatus === TRTCMediaMixingServerStatus.Started || this.serverStatus === TRTCMediaMixingServerStatus.Starting)) {
                 try {
@@ -1559,6 +1695,11 @@ class TRTCMediaMixingManager {
                         this.createDesigner();
                     }
                 }
+                if (!((_a = this.paramsStore) === null || _a === void 0 ? void 0 : _a.streamLayout)) {
+                    this.setStreamLayout({
+                        layoutMode: types_1.TRTCStreamLayoutMode.None,
+                    });
+                }
             }
             else {
                 // neither native window nor web element, stop preview
@@ -1567,12 +1708,16 @@ class TRTCMediaMixingManager {
         });
     }
     previewInNone() {
+        var _a;
         this.destroyResizeObserver();
         this.destroyLayoutManager();
         this.destroyDesigner();
         this.destroyWebRenderer();
         this.view = null;
         this.nodeMediaMixingPlugin.setDisplayParams(this.windowID, { left: 0, right: 0, top: 0, bottom: 0 });
+        if ((_a = this.paramsStore) === null || _a === void 0 ? void 0 : _a.streamLayout) {
+            this.paramsStore.streamLayout = null;
+        }
     }
     createWebRenderer(view) {
         if (this.view === view) {

package/liteav/extensions/MediaMixingManager/types.d.ts

@@ -39,6 +39,13 @@ export declare type TRTCPhoneMirrorParam = {
     frameRate: number;
     bitrateKbps: number;
 };
+export declare type TRTCOnlineVideoParam = {
+    networkCacheSizeKB: number;
+    playoutVolume: number;
+};
+export declare type TRTCVideoFileParam = {
+    playoutVolume: number;
+};
 export declare type TRTCMediaSource = {
     sourceType: TRTCMediaSourceType;
     sourceId: string;
@@ -49,6 +56,10 @@ export declare type TRTCMediaSource = {
     rotation?: TRTCVideoRotation;
     fillMode?: TRTCVideoFillMode;
     mirrorType?: TRTCVideoMirrorType;
+    camera?: TRTCCameraCaptureParams;
+    screen?: TRTCScreenCaptureProperty;
+    localVideo?: TRTCVideoFileParam;
+    onlineVideo?: TRTCOnlineVideoParam;
 };
 export declare type TRTCMediaMixingEncParam = {
     videoEncoderParams: TRTCVideoEncParam;
@@ -83,20 +94,10 @@ export declare type TRTCStreamLayout = {
     };
     streams?: Array<TRTCStreamInfo>;
 };
-export declare type TRTCOnlineVideoParam = {
-    networkCacheSizeKB: number;
-    playoutVolume: number;
-};
-export declare type TRTCVideoFileParam = {
-    playoutVolume: number;
-};
 export interface ITRTCMediaMixingManager {
     addMediaSource(mediaSource: TRTCMediaSource): Promise<void>;
     removeMediaSource(mediaSource: TRTCMediaSource): Promise<void>;
     updateMediaSource(mediaSource: TRTCMediaSource): Promise<void>;
-    setCameraCaptureParam(cameraID: string, param: TRTCCameraCaptureParams): void;
-    setPhoneMirrorParam(phoneMirrorSourceId: string, param: TRTCPhoneMirrorParam): void;
-    setScreenCaptureProperty(screenWindowID: string, property: TRTCScreenCaptureProperty): void;
     startPublish(): Promise<void>;
     stopPublish(): Promise<void>;
     updatePublishParams(params: TRTCMediaMixingEncParam): Promise<void>;

package/liteav/trtc.d.ts

@@ -1167,7 +1167,6 @@ declare class TRTCCloud extends EventEmitter implements ITRTCCloud {
      * 该接口跟 startPublishing() 类似，但 startPublishCDNStream() 支持向非腾讯云的直播 CDN 转推。
      *
      * 注意：
-     * - 使用 startPublishing() 绑定腾讯云直播 CDN 不收取额外的费用。
      * - 使用 startPublishCDNStream() 绑定非腾讯云直播 CDN 需要收取转推费用，且需要通过工单联系我们开通。
      *
      * @param {TRTCPublishCDNParam} param - 转推参数

package/liteav/trtc.js

@@ -2097,7 +2097,6 @@ class TRTCCloud extends events_1.EventEmitter {
      * 该接口跟 startPublishing() 类似，但 startPublishCDNStream() 支持向非腾讯云的直播 CDN 转推。
      *
      * 注意：
-     * - 使用 startPublishing() 绑定腾讯云直播 CDN 不收取额外的费用。
      * - 使用 startPublishCDNStream() 绑定非腾讯云直播 CDN 需要收取转推费用，且需要通过工单联系我们开通。
      *
      * @param {TRTCPublishCDNParam} param - 转推参数

package/liteav/trtc_define.d.ts

@@ -1125,85 +1125,3 @@ 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.TRTCVodPlayerEvent = exports.VideoBufferInfo = exports.TRTCSwitchRoomParam = exports.AudioMusicParam = exports.TRTCStatistics = exports.TRTCRemoteStatistics = exports.TRTCLocalStatistics = exports.TRTCAudioEffectParam = exports.TRTCAudioRecordingParams = exports.TRTCPublishCDNParam = void 0;
+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,76 +2032,3 @@ 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,5 +1,6 @@
 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, TRTCVodPlayerEventMap } 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 } from './trtc_define';
+import { TRTCVodPlayerEventMap } from './vod_player';
 export interface TRTCVideoRenderCallback {
     onRenderVideoFrame(userId: string, streamType: TRTCVideoStreamType, frame: TRTCVideoFrame): void;
 }

package/liteav/vod_player.d.ts

@@ -1,5 +1,87 @@
-import { TRTCVideoRotation, TRTCVideoFillMode, TRTCVodPlayerEventMap } from './trtc_define';
+import { TRTCVideoRotation, TRTCVideoFillMode } from './trtc_define';
 import { IVodPlayer } from './types';
+/**
+ * @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];
+}
 /**
  *
  * 腾讯云点播播放器
@@ -28,7 +110,6 @@ export declare class TRTCVodPlayer implements IVodPlayer {
     private nativeVodPlayer;
     private videoRender;
     private mediaFilePath;
-    private isStarted;
     private isDestroyed;
     private isRenderPrepared;
     private _setBufferRetryCount;
@@ -125,8 +206,6 @@ export declare class TRTCVodPlayer implements IVodPlayer {
      * 重复调用会被忽略。
      *
      * @note 可以先调用 {@link preload} 预加载完成后再调用 start，也可以跳过 preload 直接调用 start。
-     * @note 从 SDK 10.7 版本开始，需要通过 TXLiveBase#setLicence 设置 Licence 后方可成功播放，
-     *       否则将播放失败（黑屏），全局仅设置一次即可。
      */
     start(): void;
     /**
@@ -154,14 +233,19 @@ export declare class TRTCVodPlayer implements IVodPlayer {
      */
     seek(msPos: number): void;
     /**
-     * 无缝切换当前播放的媒体文件
+     * 切换当前播放的媒体文件
+     *
+     * 底层实现等价于 `stop + 加载新源`，**切换后是否自动播放取决于切换前的状态**：
+     *   - 切换前在播放中：底层会自动 Started 新源，业务方无需再调 {@link start}；
+     *   - 切换前在暂停中：底层只 Loaded 新源不自动播放，业务方需在
+     *     {@link TRTCVodPlayerEvent.onVodPlayerLoaded} 之后调 {@link start} 才会播。
      *
-     * 在后台预加载新的媒体源，待新源就绪后无缝切换，避免切换时出现黑屏。
-     * 切换成功后触发 {@link TRTCVodPlayerEvent.onVodPlayerLoaded} 事件，携带新文件的媒体信息。
+     * 切换过程中会按顺序触发：
+     *   `onVodPlayerStopped` → `onVodPlayerLoaded`(新源信息) →
+     *   `onVodPlayerStarted`(仅"切换前在播放中"路径才会有)。
      *
      * @param newMediaFile - 新的媒体文件路径或 URL
      *
-     * @note 若当前处于暂停状态，切换后仍保持暂停并展示新文件第一帧。
      * @note 切换过程中调用 {@link stop} 会取消切换并停止当前播放。
      * @note 调用前必须先 {@link preload} 或 {@link start}，否则会被忽略并打 warn 日志。
      * @note 传入空串会被忽略并打 warn 日志（C++ 层亦有同等保护）。

package/liteav/vod_player.js

@@ -1,11 +1,84 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRTCVodPlayer = void 0;
+exports.TRTCVodPlayer = exports.TRTCVodPlayerEvent = 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');
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                    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 = {}));
 /**
  *
  * 腾讯云点播播放器
@@ -36,7 +109,6 @@ class TRTCVodPlayer {
         this._dataRenderCallback = this._dataRenderCallback.bind(this);
         this.nativeVodPlayer = new NodeTRTCEngine.NodeVodPlayer(mediaFilePath, repeat);
         this.mediaFilePath = mediaFilePath;
-        this.isStarted = false;
         this.isDestroyed = false;
         this.isRenderPrepared = false;
         this._setBufferRetryCount = 0;
@@ -159,10 +231,6 @@ class TRTCVodPlayer {
             this.logger.warn('preload: player already destroyed');
             return;
         }
-        if (this.isStarted) {
-            this.logger.warn('preload: already started, ignored');
-            return;
-        }
         this.logger.info(`preload mediaFile: ${this.mediaFilePath}`);
         this._prepareRender();
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.preload();
@@ -176,24 +244,18 @@ class TRTCVodPlayer {
      * 重复调用会被忽略。
      *
      * @note 可以先调用 {@link preload} 预加载完成后再调用 start，也可以跳过 preload 直接调用 start。
-     * @note 从 SDK 10.7 版本开始，需要通过 TXLiveBase#setLicence 设置 Licence 后方可成功播放，
-     *       否则将播放失败（黑屏），全局仅设置一次即可。
      */
     start() {
-        var _a;
+        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;
-        }
         this._prepareRender();
         this.attachTRTC();
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.start();
-        this.isStarted = true;
+        (_b = this.nativeVodPlayer) === null || _b === void 0 ? void 0 : _b.resume();
     }
     /**
      * 停止播放
@@ -205,14 +267,8 @@ class TRTCVodPlayer {
             return;
         }
         this.logger.info('stop');
-        if (!this.isStarted && !this.isRenderPrepared) {
-            return;
-        }
-        if (this.isStarted) {
-            this.isStarted = false;
-            (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.stop();
-            this.detachTRTC();
-        }
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.stop();
+        this.detachTRTC();
         this._teardownRender();
     }
     /**
@@ -226,10 +282,6 @@ class TRTCVodPlayer {
             this.logger.warn('pause: player already destroyed');
             return;
         }
-        if (!this.isStarted) {
-            this.logger.warn('pause: player not started, ignored');
-            return;
-        }
         this.logger.info('pause');
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.pause();
     }
@@ -239,17 +291,14 @@ class TRTCVodPlayer {
      * @note 仅在 {@link start} 之后调用才有效；未播放时调用会被忽略并打 warn 日志。
      */
     resume() {
-        var _a;
+        var _a, _b;
         if (this.isDestroyed) {
             this.logger.warn('resume: player already destroyed');
             return;
         }
-        if (!this.isStarted) {
-            this.logger.warn('resume: player not started, ignored');
-            return;
-        }
         this.logger.info('resume');
-        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.resume();
+        (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.start();
+        (_b = this.nativeVodPlayer) === null || _b === void 0 ? void 0 : _b.resume();
     }
     /**
      * 跳转到指定播放位置（seek）
@@ -264,7 +313,7 @@ class TRTCVodPlayer {
             this.logger.warn('seek: player already destroyed');
             return;
         }
-        if (!this.isStarted && !this.isRenderPrepared) {
+        if (!this.isRenderPrepared) {
             this.logger.warn(`seek: player not preloaded or started, ignored (msPos=${msPos})`);
             return;
         }
@@ -272,14 +321,19 @@ class TRTCVodPlayer {
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.seek(msPos);
     }
     /**
-     * 无缝切换当前播放的媒体文件
+     * 切换当前播放的媒体文件
      *
-     * 在后台预加载新的媒体源，待新源就绪后无缝切换，避免切换时出现黑屏。
-     * 切换成功后触发 {@link TRTCVodPlayerEvent.onVodPlayerLoaded} 事件，携带新文件的媒体信息。
+     * 底层实现等价于 `stop + 加载新源`，**切换后是否自动播放取决于切换前的状态**：
+     *   - 切换前在播放中：底层会自动 Started 新源，业务方无需再调 {@link start}；
+     *   - 切换前在暂停中：底层只 Loaded 新源不自动播放，业务方需在
+     *     {@link TRTCVodPlayerEvent.onVodPlayerLoaded} 之后调 {@link start} 才会播。
+     *
+     * 切换过程中会按顺序触发：
+     *   `onVodPlayerStopped` → `onVodPlayerLoaded`(新源信息) →
+     *   `onVodPlayerStarted`(仅"切换前在播放中"路径才会有)。
      *
      * @param newMediaFile - 新的媒体文件路径或 URL
      *
-     * @note 若当前处于暂停状态，切换后仍保持暂停并展示新文件第一帧。
      * @note 切换过程中调用 {@link stop} 会取消切换并停止当前播放。
      * @note 调用前必须先 {@link preload} 或 {@link start}，否则会被忽略并打 warn 日志。
      * @note 传入空串会被忽略并打 warn 日志（C++ 层亦有同等保护）。
@@ -294,7 +348,7 @@ class TRTCVodPlayer {
             this.logger.warn('switchSource: newMediaFile is empty, ignored');
             return;
         }
-        if (!this.isStarted && !this.isRenderPrepared) {
+        if (!this.isRenderPrepared) {
             this.logger.warn(`switchSource: player not preloaded or started, ignored (newMediaFile=${newMediaFile})`);
             return;
         }
@@ -621,29 +675,30 @@ class TRTCVodPlayer {
     _initEventCallback() {
         var _a;
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setEventCallback((args) => {
-            switch (args[0]) {
-                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStarted:
-                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStarted, args[1].msLength);
+            const event = args[0];
+            switch (event) {
+                case TRTCVodPlayerEvent.onVodPlayerStarted:
+                    this.fire(TRTCVodPlayerEvent.onVodPlayerStarted, args[1].msLength);
                     break;
-                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerLoaded: {
+                case TRTCVodPlayerEvent.onVodPlayerLoaded: {
                     const data = args[1];
-                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerLoaded, data.durationMs, data.width, data.height);
+                    this.fire(TRTCVodPlayerEvent.onVodPlayerLoaded, data.durationMs, data.width, data.height);
                     break;
                 }
-                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerProgress:
-                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerProgress, args[1].msPos);
+                case TRTCVodPlayerEvent.onVodPlayerProgress:
+                    this.fire(TRTCVodPlayerEvent.onVodPlayerProgress, args[1].msPos);
                     break;
-                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerPaused:
-                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerPaused);
+                case TRTCVodPlayerEvent.onVodPlayerPaused:
+                    this.fire(TRTCVodPlayerEvent.onVodPlayerPaused);
                     break;
-                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerResumed:
-                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerResumed);
+                case TRTCVodPlayerEvent.onVodPlayerResumed:
+                    this.fire(TRTCVodPlayerEvent.onVodPlayerResumed);
                     break;
-                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStopped:
-                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStopped, args[1].reason);
+                case TRTCVodPlayerEvent.onVodPlayerStopped:
+                    this.fire(TRTCVodPlayerEvent.onVodPlayerStopped, args[1].reason);
                     break;
-                case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerError:
-                    this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerError, args[1].error);
+                case TRTCVodPlayerEvent.onVodPlayerError:
+                    this.fire(TRTCVodPlayerEvent.onVodPlayerError, args[1].error);
                     break;
                 default: {
                     const exhaustiveCheck = args[0];

package/package.json

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