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

package/liteav/vod_player.d.ts

@@ -103,8 +103,6 @@ export declare class TRTCVodPlayer implements IVodPlayer {
      * 重复调用会被忽略。
      *
      * @note 可以先调用 {@link preload} 预加载完成后再调用 start，也可以跳过 preload 直接调用 start。
-     * @note 从 SDK 10.7 版本开始，需要通过 TXLiveBase#setLicence 设置 Licence 后方可成功播放，
-     *       否则将播放失败（黑屏），全局仅设置一次即可。
      */
     start(): void;
     /**
@@ -132,14 +130,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

@@ -152,8 +152,6 @@ class TRTCVodPlayer {
      * 重复调用会被忽略。
      *
      * @note 可以先调用 {@link preload} 预加载完成后再调用 start，也可以跳过 preload 直接调用 start。
-     * @note 从 SDK 10.7 版本开始，需要通过 TXLiveBase#setLicence 设置 Licence 后方可成功播放，
-     *       否则将播放失败（黑屏），全局仅设置一次即可。
      */
     start() {
         var _a;
@@ -169,7 +167,6 @@ class TRTCVodPlayer {
         this._prepareRender();
         this.attachTRTC();
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.start();
-        this.isStarted = true;
     }
     /**
      * 停止播放
@@ -185,7 +182,6 @@ class TRTCVodPlayer {
             return;
         }
         if (this.isStarted) {
-            this.isStarted = false;
             (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.stop();
             this.detachTRTC();
         }
@@ -248,14 +244,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++ 层亦有同等保护）。
@@ -597,8 +598,15 @@ class TRTCVodPlayer {
     _initEventCallback() {
         var _a;
         (_a = this.nativeVodPlayer) === null || _a === void 0 ? void 0 : _a.setEventCallback((args) => {
-            switch (args[0]) {
+            const event = args[0];
+            if ((event === trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStopped || event === trtc_define_1.TRTCVodPlayerEvent.onVodPlayerError) && this.isStarted) {
+                this.isStarted = false;
+            }
+            switch (event) {
                 case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStarted:
+                    if (!this.isStarted) {
+                        this.isStarted = true;
+                    }
                     this.fire(trtc_define_1.TRTCVodPlayerEvent.onVodPlayerStarted, args[1].msLength);
                     break;
                 case trtc_define_1.TRTCVodPlayerEvent.onVodPlayerLoaded: {

package/package.json

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