trtc-electron-sdk 13.3.800-alpha.4 → 13.3.800-alpha.6

package/liteav/vod_player.d.ts

@@ -28,7 +28,6 @@ export declare class TRTCVodPlayer implements IVodPlayer {
     private nativeVodPlayer;
     private videoRender;
     private mediaFilePath;
-    private isStarted;
     private isDestroyed;
     private isRenderPrepared;
     private _setBufferRetryCount;
@@ -103,8 +102,6 @@ export declare class TRTCVodPlayer implements IVodPlayer {
      * 重复调用会被忽略。
      *
      * @note 可以先调用 {@link preload} 预加载完成后再调用 start，也可以跳过 preload 直接调用 start。
-     * @note 从 SDK 10.7 版本开始，需要通过 TXLiveBase#setLicence 设置 Licence 后方可成功播放，
-     *       否则将播放失败（黑屏），全局仅设置一次即可。
      */
     start(): void;
     /**
@@ -132,14 +129,19 @@ export declare class TRTCVodPlayer implements IVodPlayer {
      */
     seek(msPos: number): void;
     /**
-     * 无缝切换当前播放的媒体文件
+     * 切换当前播放的媒体文件
      *
-     * 在后台预加载新的媒体源，待新源就绪后无缝切换，避免切换时出现黑屏。
-     * 切换成功后触发 {@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++ 层亦有同等保护）。

package/liteav/vod_player.js

@@ -36,7 +36,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;
@@ -135,10 +134,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();
@@ -152,24 +147,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();
     }
     /**
      * 停止播放
@@ -181,14 +170,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();
     }
     /**
@@ -202,10 +185,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();
     }
@@ -215,17 +194,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）
@@ -240,7 +216,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;
         }
@@ -248,14 +224,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++ 层亦有同等保护）。
@@ -270,7 +251,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;
         }
@@ -597,7 +578,8 @@ class TRTCVodPlayer {
     _initEventCallback() {
         var _a;
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setEventCallback((args) => {
-            switch (args[0]) {
+            const event = args[0];
+            switch (event) {
                 case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStarted:
                     this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStarted, args[1].msLength);
                     break;

package/package.json

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